EMC 300-000-978 REV A03 manual

EMC Corporation Cor porate Headquarter s : Hopkinto n, MA 01748- 9103 (800) 424-EM C2 http:/ /www.EMC.co m PowerPath fo r UNIX Version 4.0 INSTA LLATION AND ADMINISTRATION GUIDE P/N 300-00 0-978 REV A0 3[...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e ii Copyrig ht © 1997-2 003 EMC Corporatio n. All rig hts reserved. Printed July, 200 3 EMC believes the informati on in this publ ication is accurate as of its publication da te. The informatio n is s ubject t o chang e with out not ice. THE INFORMATION IN THIS PUBLICATION IS PROVI[...]

P owerPath f or UNIX In stallation and Adminis tration Guide iii Preface ........................ ...................... ................. ....................... ................. ...................... i x Cha pter 1 Installing Po werP ath Befor e Y ou Install ................. ....................... ................. .................... 1-2 Ob[...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e iv Contents Integrating/ Upgrad ing Po werPath I nto an Ex isting AAM 5.1 (or later) Cluster .................... ................. ...................... ....... 2-3 PowerPath in a Sun Cluster 2.2 ........................ ...................... ....... 2-4 Installing PowerPath in a[...]

v P owerPath f or UNIX In stallation and Adminis tration Guide Conte nts Boot Device Support ............ ....................... ................. ................... 5- 3 R1/R2 Boot Failover Support .............. ....................... ................ ... 5-4 R1/R2 Supported Configurations ................ ................. ........ 5-4 R1/R2 [...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e vi Contents Appendix B Customer S upport Overview of Detecting and Resolving Problems ................ ...... B- 2 T roubleshooting the Pr oblem ............... ................. ....................... B-3 Befor e Calling the Customer Support Center ...................... ...... B-[...]

P owerPath f or UNIX In stallation and Adminis tration Guide vii Ta b l e s 5-1 Native Devices versus emcpower Devices ...................... ......................... 5-8 5-2 Support for Native and Pseudo Devices ............... ...................... .............. 5-9 Ta b l e s[...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Ta b l e s viii[...]

P owerPath f or UNIX In stallation and Adminis tration Guide ix Preface As part o f its effo rt to cont inuousl y improve an d enhan ce the performa nce and capabilities of the EMC product line, EMC period ically releases new versio ns of the P owerPa th software. Th erefore, some func tions d escribe d in this manual may not be supported by all ve[...]

x P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Preface Organization Here is an overview of the informa tion contained in this guide: ◆ Chapter 1, Installing PowerPath , describes how to in stall PowerPath on a Solar i s host, h o w to upgrade from an earli er version of PowerPa th, and how to install the P owerPath V olu me [...]

P owerPath f or UNIX In stallation and Adminis tration Guide xi Preface Related Documenta tion Here is the complete set of Powe rPat h doc umenta tion; all manu als are availa ble f rom EMC Corpo rati on: ◆ PowerPath Pr oduct Guide , EM C P/N 300-0 00- 979 ◆ PowerPath f or UNIX V olume Manager Us er ’ s Guide , EMC P/N 300- 000-992 ◆ PowerP[...]

xii P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Preface Conv entions U sed in This Guide EMC us es the followi ng co nvent ion s for notes, cautions, warnin gs, and danger n otices. A no te pr esents in format ion that is import ant, but no t haza rd-r elated. CAUTION ! A caution contains inf ormation essent ial to avo id dam[...]

P owerPath f or UNIX In stallation and Adminis tration Guide xiii Preface Where to Get Help For questions a bout technical su pport, call your loca l sales office or service provider . If you have a valid EMC service cont ract, contact EMC Customer Service at: Follow the voice men u prompts to open a service call and select the applicable product s[...]

xiv P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Preface[...]

Installing P owerPath 1-1 1 Invisible Body T ag This chapter des cribes how to instal l PowerPath 4 .0 on a Sol aris host and how to upgrade fr o m an earlier version of PowerPath. The chapter also de scribes how to in stall the Pow erPath V olum e Manager VCS Agent for a VERIT AS Cluster Server (VCS) environment. The Power Path V olume Manager Leg[...]

1 1-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath Bef ore Y ou Instal l The sequence in which you configure the storage and install PowerPath ® depends on the storage system you use: Symmetrix ® storage syste ms. Install PowerPa th after you set up the Symmetrix system. V erify that the Symmetrix syste[...]

1 Before Y ou Insta ll 1-3 Installing Po werPath Locat e Y our Lic ense K ey The PowerPath licens e registration key is on th e License Key Card delivered with the PowerPath media kit. If you are u pgradin g from an ear lier versio n of PowerPath, you need not rer egister; Po werPath will use your old key . Prep are t he Host and Storage Sys tem T [...]

1 1-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath ❑ Uninstall any earlier version of PowerPath . The PowerPath ins tallat ion program exits if it detects a n existing version of PowerPath. Important: Befo r e you unin stall the ea rlier vers ion, sav e your configuratio n using the powermt save command[...]

1 Before Y ou Insta ll 1-5 Installing Po werPath For example: local0.Warn /dev/sysmsg The separator between local X .Warn and /dev/sysmsg mus t be a tab char acter . 2. S et th e RAD_LOG_FACILITY environment variable to LOG_LOCAL X , wher e X is the number you used in the local setting of the /etc/syslog.conf file. For example, for csh , enter: set[...]

1 1-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath Installing Po werP a th 4.0 This section d escribes ho w to insta ll, or rein stall, P owerPat h 4.0 whe n no earlier version of PowerPath has been installed on the host. If yo u ar e upgrading to Power Path 4.0 fr om PowerPat h 3.0.x o r 2.1, ref e r i n[...]

1 Installing P owerPath 4.0 1-7 Installing Po werPath 4. Y ou see the follo wing prompt: The following packages are available: 1 EMCpow er EMC PowerPath (all) 4.0.0_bxxx 2 EMCvg EMC Enterprise Cluster PowerPath Volume Manager VCS Agent (sparc) 1.0 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,[...]

1 1-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath 8. Y ou are prompted for a major number th at can be assi gned to the PowerPath device driver ( emcp ) on ev ery hos t in th e c lust er : Assign major number for the device dri ver [?]: Ente r a maj or numb er an d press E NTER . Y ou must specif y a maj[...]

1 Installing P owerPath 4.0 1-9 Installing Po werPath 1 1. The screen displays info rmation ab out the instal lation, end ing with: -------------------------------------- -------------- * EMCpower installation: * * Installation is successful. * * If you have a license key card, regi ster now. Then * REBOOT the host to complete the rema ining steps [...]

1 1-10 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath Upgrading to P ow erP ath 4.0 This se ctio n descr ibes how t o upgr ade to Pow erPath 4. 0 from an earlier version of PowerPath. Abou t Upgr ading Y ou can u pgr ade to Pow erPat h 4.0 from the fol lowing release s: ◆ PowerPath 3.0.x ◆ PowerPath 2.1[...]

1 Upgr ading to P ow erPath 4.0 1-11 Installing Po werPath Upgrad ing Fr om Po werP ath 3.0. x or 2.1 Mount the CD-ROM 1. Log in as root. 2. I nsert the CD- ROM i nto the CD-ROM driv e. If the CD m ounts a utomatica lly , con tinue with Inst all the Software , which fol lows. If the CD does not mou nt automatica lly , you must mo unt it manual ly .[...]

1 1-12 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath 5. Y ou are pr o mpted for the dir ectory where the PowerPath program files will be installed : Enter package base directory (default: /opt,?): Press E NTER to accept the default base directory ( /opt ), or type the path to an alternate base directory an[...]

1 Upgr ading to P ow erPath 4.0 1-13 Installing Po werPath 9. Y ou are pr ompted to confirm the major number: Major major wil l be assigned to the device driver [y,n,q,?] (def ault: y): Press E NTER to confirm the major number . 10. Y ou see the follo wing prompt: Configuration for PowerPath ve rsion exists - want to upgrade [y,n,q,?] (default: y):[...]

1 1-14 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath 12. The screen display s informatio n about the ins tallation . Provided the upgrade is successful (that is, conversion of the configuration files succeeds) the displa y ends with: -------------------------------------- --------------------------------- [...]

1 Upgr ading to P ow erPath 4.0 1-15 Installing Po werPath T roubl eshootin g the Upgrade U pgrading to Pow erPath 4. 0 could fail for the following reasons : ◆ The PowerPat h 3.0. x or 2.1 configura t ion files are co rrupted. ◆ Y ou inadv ertently chose not to upgrade; that is, you answered n instead of y to the followi ng prompt: Configurati[...]

1 1-16 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath After Y ou Install After installi ng the Powe rPath so ftware: ❑ Regi ster Pow erPath on the host (fir st-time installa tion on ly). ❑ Remove the CD- ROM. ❑ Reboot the ho st. ❑ V erify the PowerPath install ation. ❑ V erify th e PowerPath c omm[...]

1 Aft er Y ou Ins tall 1-17 Installing Po werPath 3. Enter the PowerPath r egistration key and press E NTER . If you entered a valid key , you see the fol lowing outpu t: 1 key(s) successfully added. Key successfully installed. Key (Enter if done): 4. Press E NTER . Y ou see the following output: 1 key(s) successfully registered. Registerin g Power[...]

1 1-18 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath V erify the Po werP ath Installation 1. V erify that PowerPath is installed pr operly on the host. Enter: pkginfo -l EMCpower Y ou s hould see outp ut like the followin g: PKGINST: EMCpower NAME: EMC PowerPath CATEGORY: system ARCH: sparc VERSION: 4.0.0_[...]

1 Aft er Y ou Ins tall 1-19 Installing Po werPath 3. V er ify t hat the Powe rPat h an d Pow erPat h V ol ume M ana ger kernel extensions ar e lo aded on the host. Enter: modinfo | grep -i emc Y ou s hould see outp ut like the follo wing: 30 125c08b 74a05 255 1 emcp (PP Driver 4.0.0) 31 127ec94 18c1e - 1 emcpmp (PP MP Ext 4.0.0) 32 1295a42 21ac2 - [...]

1 1-20 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath 2. If the o utput of powermt display dev=all indicates that some storage system logical devices ar e not configured as PowerPath devices: a. Configure any mis sing logica l devices. Enter: powercf -q powermt config b. Rerun powermt display dev=all to con[...]

1 Installing th e P owerPath V ol ume Mana ger V CS Ag ent 1-21 Installing Po werPath Installing the Po werP ath V o lum e Manager VCS A gent Y ou can install the VCS Agent at the time you install PowerPath, or you can ins tall the agent separately . Thi s section d escribes how to install the agen t separately . Mount the CD-ROM 1. Log in as root.[...]

1 1-22 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath 4. Y ou see the follo wing prompt: The following packages are available: 1 EMCpower EMC PowerPath (all) 4.0.0_bxxx 2 EMCvg EMC Enterprise Cluster PowerPath Volume Manager VCS Agent (sparc) 1.0 Select package(s) you wish to process (or 'all' to [...]

1 Err or Messages 1-23 Installing Po werPath T o verify that the agent is installed pr operly on the host, enter: pkginfo -l EMCvg Y ou s hould out put similar to th is: PKGINST: EMCvg NAME: EMC Enterprise Cluster PowerPath Volume Manager VCS Ag ent CATEGORY: system ARCH: sparc VERSION: 1.0 VENDOR: EMC Corporation DESC: EMC Enterprise Cluster Power[...]

1 1-24 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Installing Pow erPath[...]

P ow erPath in a Cluster Environment 2-1 2 Invisible Body T ag This chapter des cribes how to ins tall an d configure PowerPath in Solaris cluster environments. For more general information on clustering, refer to the Symmetrix High Availability Envir onment Pr oduct Guide or the Installation Roadmap for FC- Series St orage Sy stems . PowerP ath V [...]

2 2-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment P ow erPath in a Legato 5. 1 (or later) AAM C luster This section d escribes how to: ◆ Install Po werPath and L egato Auto mated A vaila bility Manag er (AAM) in a new clu ster , that is, wh ere neither the PowerPath nor the AAM softw are[...]

2 P owerPath in a Legato 5.1 (or later) AA M Cluste r 2-3 Po werPath in a Cluster En vironment Integr atin g/ Upgr ading Po werP ath Into an Exis ting AAM 5. 1 (or later) Clust er T o integr ate PowerP ath into an e xis ting AAM 5.1 (or later) cluster , follow these steps on each cluster node, o ne node at a time: 1. Stop cluster services on the no[...]

2 2-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment P o werP ath in a Sun Cluster 2.2 This section d escribes how to: ◆ Insta l l PowerP ath and Su n Cluster 2.2 i n a new c luster , that is, where neither the PowerPath nor the Sun Cluster 2.2 software is installed on any host to be includ[...]

2 P ow erP ath in a Sun Clust er 2. 2 2-5 Po werPath in a Cluster En vironment Inte grating/ U pgrading Po werP ath Int o an Exis ting S un Cluster 2.2 T o integ rate PowerPath i nto an existing Sun Cluster 2.2, follow these steps on each cluster node, o ne node at a time: 1. Stop cluster services on the n ode using th e scadmin stopnode command. 2[...]

2 2-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment P o werP ath in a Sun Cluster 3.0 This section d escribes how to: ◆ Insta l l PowerP ath and Su n Cluster 3.0 i n a new c luster , that is, where neither the PowerPath nor the Sun Cluster 3.0 software is installed on any host to be includ[...]

2 P ow erP ath in a Sun Clust er 3. 0 2-7 Po werPath in a Cluster En vironment Inte grating/ U pgrading Po werP ath Int o an Exis ting S un Cluster 3.0 T o integ rate PowerPath into an existing Sun Cluster 3.0 , follow these steps on each cluster node, o ne node at a time. 1. S top cluster services on the node. Enter: boot -x 2. Ins tall or upg rad[...]

2 2-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment P o werP ath in a VERIT AS Cluster Ser v er Cluster This section d escribes how to: ◆ Insta l l PowerP ath and V CS in a new cluster , that is, wh ere neither the PowerPath no r the VCS softwa re is installed on any ho st to be included i[...]

2 P owerPath in a VERIT A S Cluster Ser ver Cluster 2-9 Po werPath in a Cluster En vironment 2. If you are using PowerP ath V olu me Manager , configu re VCS to recognize the PowerPath V olu me Manager VCS Agent as a resource type by editing the /etc/VRTSvcs/conf/config/main.cf f i le on one host in the cluster . Refer to C onfiguring VCS to Recogn[...]

2 2-10 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment 6. On each node in the cluster: a. V erify th at the service grou p is up and running, and u se either the VCS GUI or the hagrp command to verify that the service group can successfull y fail over to all hosts in the cluster . b. Se t a co[...]

2 P owerPath in a VERIT A S Cluster Ser ver Cluster 2-11 Po werPath in a Cluster En vironment Config uring VC S to Recognize Powe r Pa th V o l u m e Manage r Resources After the PowerPath V olume Manager VCS Agent has been installed on a host, you must configure VCS to r ecognize the agent. T o do so, edit the VCS config uration file, main.cf , to[...]

2 2-12 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment Editing main.cf to Include EMCTypes .cf Edit the /etc/VRTSvcs/conf/config/main.cf file on one node. The changes are p ropagated to the other nodes in the cluster when you start VCS on thos e nodes. Y ou do not n eed to perform this procedu[...]

2 Setti ng Major an d Minor Number s 2-13 Po werPath in a Cluster En vironment Setting Major and Minor Numbers W ith NFS in a cluster environment: ◆ The PowerPath driver , emcp , must use the same major nu mber o n every node in the cluster . ◆ Every PowerPath V olume Mana ger volume in the clus ter must use the same minor number on every node [...]

2 2-14 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath in a Cluster Envir onment 3. On every node in the cluster (except any node that is already using the minor num ber), run the powervol setmino r command to set the minor number you chose in step 2. Refer to the powervol (1) man page for info rmation o n powervol set[...]

Con f i gur ing a P owerPath Boot D evice on Sola ris 3-1 3 Invisible Body T ag This chapter d escribes how to co nfigur e a PowerPath device as the boot device for a So laris host and how to r emove PowerPath control over a storage sy stem boot device. ◆ Intro duction ................. ...................... ................. ...................[...]

3 3-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is Intr oduction On some storage sy stems, you can use e ither a Pow erPath nativ e device or an emcpower device as a bo ot device—the device that contains the startup image. (Ref er to the EMC Suppor t Matri x to see whether yo[...]

3 Configuring a P ow erPath Native Device as the Boot Device 3-3 Configuring a P owerP ath Boot Device on Solar is Conf igur ing a Po werP ath Nativ e De vice as the Boot De vice P ar titioning the Boot Device Partition the boot device. 1. Use the format com mand to verify th at the siz es of th e partitions on the storage system device chosen for [...]

3 3-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is Informatio n similar to th e following is displayed: AVAILABLE SELECTIONS ... 1. c0t0d0 <SUN4,2G cyl 3880 alt 2 hd 1 6 sec 135> /pci@1f,4000/scsi@3/sd@0,0 2. c3t0d0 <EMC-SYMMETRIX-5265 cyl 4088 alt 2 hd 15 sec 64> /[...]

3 Configuring a P ow erPath Native Device as the Boot Device 3-5 Configuring a P owerP ath Boot Device on Solar is Inst allin g a Bootblk Instal l a bootblk (the information requir ed by th e host to boot the operating system) on the r o ot partition of the storage system boot device. 1. Use the uname -a command to determine the architecture of the[...]

3 3-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is 3. In th e /mnt/etc directory update th e vfstab file to indicate the storage sys tem boot device addr ess to be mounted during boot. Modify all partitio ns that wil l be located on the sto rage system boot device. a. At the %&[...]

3 Configuring a P ow erPath Native Device as the Boot Device 3-7 Configuring a P owerP ath Boot Device on Solar is Modifying OpenBoot Y ou need modify OpenBo ot only if y ou use Fibre Channel HBAs. The procedur e for modifying OpenBoot depends on your HBAs. Refer to the followin g documentation : Setti ng Up th e Boot Alias Se t up a new alias for [...]

3 3-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is Mo ving the Boot Devic e to an emc pow er De vice T o mo ve a boot device fr om a native device to an emcpower device: 1. Boo t from the native device. 2. Ins tall Po werPa th. R efer t o Cha pter 1 , Installin g PowerPath . 3.[...]

3 Mo ving the Boot Device to an emcpow er Device 3-9 Configuring a P owerP ath Boot Device on Solar is 6. Using a text edito r such as vi , make the follow ing changes to th e /etc/system file: • Add this line above the forceload: drv/emcp statement: forceload: drv/sd • Add this line belo w the forceload: drv/emcp statement: rootdev: /pseudo/em[...]

3 3-10 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is 6. Shut down the host. Enter: shutdown –y –g5 –i0 7. At t he ok prompt, enter: eject 8. Remove the Solaris Operating System CD-ROM from the host’s CD-ROM drive. 9. Rebo ot the host. Enter: boot[...]

3 Removing P owerP a th Co ntrol Over a Boot D evice 3-11 Configuring a P owerP ath Boot Device on Solar is Remo ving Po w erP ath Control Ov er a Boot De vice If your Power Path instal lat ion use s a sto rag e syste m dev ice as t he boot device, use the following pr ocedure to r emove PowerPath 4.0 control over the boot device: 1. Determ ine whe[...]

3 3-12 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Configuring a P owerP ath Boot Device on Solar is 5. If you did not reboot the host after removing PowerPath, do so now . Ente r: reboot -- -r Important: If you plan t o r einstal l PowerPat h 4.0, o r upgrade t o a late r version of PowerPath, you need no t r eboot the h ost[...]

Remo ving P owerP ath 4-1 4 Invisible Body T ag This chapter describes how to remove PowerPath and the PowerPath V olume Ma nager VCS Agent fr om a So laris ho st. ◆ Befor e Removing PowerPath ..... ........... ................. .......................... 4-2 ◆ Removing PowerPath ...... ............................. ...................... .....[...]

4 4-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Rem oving Power Path Bef ore Remo ving P ow erP ath Be f o re y o u re m ov e P o w e r Pa t h f ro m th e h o s t : ❑ Check the Powerlin k website ( http://powerlink.emc.com ) for the most current information. W e update the PowerPath release notes periodical ly and post th[...]

4 Remo ving P owerP ath 4-3 Remo ving P ow erPath Remo ving P ow erP ath Follow thes e steps to remove PowerPath f rom a Solaris host: 1. Log i n as root. 2. S tart the uninstall program. Enter: /usr/sbin/pkgrm EMCpower The screen displays informa tion like this : The following package is currently ins talled: EMCpower EMC PowerPath (all) 4.0.0_bxx[...]

4 4-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Rem oving Power Path 5. The r emov al pr oces s sa ves the fo llowin g files i n /etc/emc/emcpxarchive , with the .400.saved exten sion: • /kernel/drv/emcp.conf • /etc/powermt.custom • /etc/emcp_registration • /etc/emcp_devicesDB.dat • /etc/emcp_devicesDB.idx • /et[...]

4 Remo ving P owerP ath 4-5 Remo ving P ow erPath 6. Rebo ot the host. Enter: reboot -- -r Important: If you plan t o r einstal l PowerPat h 4.0, o r upgrade t o a late r version of PowerPath, you need no t reb oot the host at thi s time.[...]

4 4-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Rem oving Power Path Rem o ving the Po werP a th V olume Manager V CS Agent CAUTION Do not try to remove the EMCvg package while VCS cluster is up and running. Complete the follow ing steps to remove the PowerPath V olume Manager VCS Agent: 1. Log i n as root. 2. Close the VCS[...]

4 Remo ving th e P owerP a th V olume Manager VC S Agent 4-7 Remo ving P ow erPath The screen displays informa tion like this : The following package is currently ins talled: 1 EMCvg EMC Enterprise Cluster PowerPath Volume Manager VCS Agent (sparc) 1.0 Do you want to remove this package? [y,n,?,q] 9. Ente r y an d p ress E NTER to remove the packag[...]

4 4-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Rem oving Power Path[...]

P owerP ath Admi nistration on Solar is 5-1 5 visible Body T ag This chapte r discusses Po werPath issue s and admi nistrati ve tasks specific to Solari s. Throughout this chapter , many procedural steps use powermt commands. For deta iled descriptions of these commands, ref er to the PowerPath Pr oduct Guide . ◆ PowerPath and CLARiiON Storage Sy[...]

5 5-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris P o w erPath and CLARiiON S torage Systems PowerPath events or actions th at entail LUN trespasses (for example, SP fail over s or powermt restore commands) can cause the Solaris disk driver to log warning and /or error messages. Y ou ca n [...]

5 Rebooting and Custom Setti ngs 5-3 Po werPath Administration on So laris socal connection s, run the following commands to restor e th e paths in Pow erPath: Rebooting and Custom Settings On ev er y reb oot , all sav ed cus tom fi les ( /etc/powermt.custom. [ 0 - 2 ] ) are in cremented by one version. Thus, at any time, the custom configurations [...]

5 5-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris R1/R2 Boot Failo ver Suppor t If a storage sys tem device corresponding to a boot able emcpower device is mirror ed via SRDF ® , it is possible in the event of a server failure at th e local storage system to fail over the boot disk to the[...]

5 Devi ce Naming 5-5 Po werPath Administration on So laris When the host on the R2 side boo t s, it is connected to a differ ent Symmetrix system and set of volume IDs. Ther efor e, the emcp.conf and powermt.custom files (which ar e identical to the R1 files since the boot disk is identical) ar e m odified to crea te a valid mappin g between the em[...]

5 5-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris Pseudo Devices A pseudo d evice desc ribes a de vice special file of one of t he fol lowing forms: ◆ Block device— /dev/dsk/emcpower # [ a-h ] ◆ Raw device— /de v/rdsk/emcpower # [ a-h ] where: ◆ # is the disk number . ◆ [a-h] i[...]

5 Devi ce Naming 5-7 Po werPath Administration on So laris Pseudo (emcpower) devices of fer the following advantages: ◆ There is only one pseudo device name for each multipathed logical device. (There are multiple native device names for each multipath ed logical device, wh ich is harder to manage.) ◆ Pseudo device names ar e easier to manage b[...]

5 5-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris T able 5-1 summarizes the functional differ ences between native devices and emcpower devices in the S olaris environment. Ta b l e 5 - 1 Native De vices versus emcpo wer Devices Function Native Device Pseudo Device I/O f ailov e r ✔ ✔ [...]

5 Devi ce Naming 5-9 Po werPath Administration on So laris T able 5-2 indicates when native and pseudo devi ces ar e supported, and wh ich device na ming conventio ns we prefer in environments with specified softwar e requir ements. If no pre f erence is s pecified, both supported options are equally good. Ta b l e 5 - 2 Support for Native and P se[...]

5 5-10 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris Reconfiguring Po werP a th Devices Online Whenever the physical configuration of the storage system or the host chan ges, you must reconfigure the PowerPath devices to avoid data loss. Configuratio n changes that requi re you to r e config[...]

5 Recon f i gur ing P owerPath Devices Onli ne 5-11 Po werPath Administration on So laris The screen displays the emcpower device’s inquiry data; fo r example: Vendor: EMC Product: SYMMETRIX Revision: 5x6x format> 5. Ente r quit , to end the format pro cess. 6. Create the ne w device nodes. Enter: powercf -q PowerPath dis plays the follo wing [...]

5 5-12 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris Dynamic Reco nfiguration The Solari s Dynami c Reconfigu ration (DR) fe ature allows you to add or remove an HBA from a So laris sys tem while th e system con tinues running. Y ou can logica lly attach and detach s ystem boards from the op[...]

5 Dyna mic Reconfiguration 5-13 Po werPath Administration on So laris Remo ving an HBA From a P owe rPath Config uration T o use DR to remove an HBA fr om a Solaris host in a PowerPath configuration, follow these steps: 1. Cor relat e th e c # t # d # s # device special files of the HBA being removed with the PowerPath adapter number for that HBA. [...]

5 5-14 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris The comman d returns output like the fo llowing: pseudo name=emcpower0a Symmetrix ID=000000003269; logical device ID=048 state=alive; policy=SymmOpt; priority= 0; queued-IOs=0 ====================================== ========================[...]

5 Upgrading S olaris 5-15 Po werPath Administration on So laris Upgrading Solaris PowerPath 4.0 s upports Sola ris Live Upgrade, which lets you upgrade the operatin g system with out uninsta lling PowerPath . Solaris Live Upgrad e is supported for upgrades to S olaris 9 only . If you ar e upgrad ing to an ea rlier ver sion of Solaris, y ou must uni[...]

5 5-16 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris 7. Run t he sol9_liveup.sh script and then activate the inactive boot environment: a. Mount the root of the inactive boot environment to a directory such as /mnt . b. Run the script sol9_liveup.sh . Enter: cd / install_dir /EMCpower/script[...]

5 powercf Conf iguration Utility 5-17 Po werPath Administration on So laris po wercf Conf iguration Utility During s ystem boo t on Solari s hosts, th e powercf utility configu res PowerPa th de vices by scan ning HBAs for both s ingle -ported and multiported storage system l ogical devices . (A multiported logica l device sh ows up on two o r more[...]

5 5-18 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Po werPath Administration on Solaris Argument s powercf scans HB As for single-po rted and multip orted stor age system logical d evices and compares thos e logical devices with PowerPath device ent ries in emcp.conf . -q Runs powercf in q uiet mode. powercf -q updates the em[...]

Files Ch anged B y P owerPath A-1 A Invisible Body T ag This appendix list s files that are created or modified by PowerPath installa tion and upgra de. ◆ Files Created or Mo dified by Pow erPath In stallation ... .............. A-2 ◆ Files Created or Modified by VCS Agent Installation ............... A-1 1 Files Changed By Powe r Pa t h[...]

A A-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath Files Created or Modif ied b y P ow erPath Ins tallation The following files ar e crea t ed (or , where indicated, modified) when PowerPath i s instal led on a Solaris h ost: /etc This directory conta ins Powe rPath CLI com mands and u tiliti es: ?[...]

A Files Crea ted or Mo dified by P owerPath Instal lation A-3 Fil es Chan ged B y Po wer Pa th / basedir /EMCpo we r/bi n This dir ectory cont ains 32- and 64-bit versio ns of the PowerPath V olume Manag er CLI c omman ds: ◆ 64 <symbolic link> ◆ emcpminor <symbolic link> ◆ emcpminor_32 ◆ powervadm <symbolic link> ◆ power[...]

A A-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath ◆ emcpcg_5_9 <symbolic link> ◆ emcpdpm <symbolic link> ◆ emcpdpm_32 ◆ emcpdpm_32_5_9 ◆ emcpdpm_5_9 <symbolic link> ◆ emcpevm <symbolic link> ◆ emcpevm_32 ◆ emcpevm_32_5_9 ◆ emcpevm_5_9 <symbolic link>[...]

A Files Crea ted or Mo dified by P owerPath Instal lation A-5 Fil es Chan ged B y Po wer Pa th ◆ sparcv9/emcpcg_64 ◆ sparcv9/emcpcg_64_5_9 ◆ sparcv9/emcpdpm <symbolic link> ◆ sparcv9/emcpdpm_5_9 <symbolic link> ◆ sparcv9/emcpdpm_64 ◆ sparcv9/emcpdpm_64_5_9 ◆ sparcv9/emcpevm <symbolic link> ◆ sparcv9/emcpevm_5_9 <[...]

A A-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath / basedir /EMC pow e r/lib This dir ectory cont ains 32- and 64-bit versio ns of the PowerPath libraries: ◆ 64 <symbolic link> ◆ libdpmh.so <symbolic link> ◆ libdpmh_32.so ◆ libdpmhmt.so <symbolic link> ◆ libdpmhmt_32.so[...]

A Files Crea ted or Mo dified by P owerPath Instal lation A-7 Fil es Chan ged B y Po wer Pa th ◆ libpn.so <symbolic link> ◆ libpn_32.so ◆ libradcommon.so <symbolic link> ◆ libradcommon_32.so ◆ libradcommonmt.so <symbolic link> ◆ libradcommonmt_32.so ◆ libraddebug.so <symbolic link> ◆ libraddebug_32.so ◆ lib[...]

A A-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath ◆ sparcv9/libevm_64.so ◆ sparcv9/libevmmt.so <symbolic link> ◆ sparcv9/libevmmt_64.so ◆ sparcv9/libgm.so <symbolic link> ◆ sparcv9/libgm_64.so ◆ sparcv9/libgmmt.so <symbolic link> ◆ sparcv9/libgmmt_64.so ◆ sparcv9/[...]

A Files Crea ted or Mo dified by P owerPath Instal lation A-9 Fil es Chan ged B y Po wer Pa th / basedir /EMCpo we r/sc r ipts This directory contains PowerPath scripts: ◆ emcpv_cleanup ◆ emcpv_cron_remove.sh ◆ emcpv_cron_setup.sh ◆ emcpv_logchecker ◆ emcpv_setup.csh ◆ emcpv_setup.sh ◆ emcpv_slv2devinfo ◆ sol9_liveup.sh /usr/bin Thi[...]

A A-10 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath Solar is Files Modified by P ow erPath Installation Installin g PowerPath o n a Solaris ho st modifies th e: ◆ /etc/system configuration file: • Adds for celo ad statements for the PowerPath driver an d miscellaneo us kernel modules. • Adds [...]

A Files Created or M odi f i ed by VCS Age nt In stallation A-11 Fil es Chan ged B y Po wer Pa th Files Created or Modifi e d b y VCS Agent Installation The following files are cr eated when the PowerPath V olume Manager VCS Age nt is install ed on a Solaris ho st. / basedir /VR TSvcs /EMC ◆ bin/EMCvgAgent ◆ lib/libEMCvg.so ◆ messages.EMC ◆[...]

A A-12 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Files Changed B y Pow erPath[...]

Custom er Suppor t B-1 B nvisible Body T ag This appendix reviews the EMC process for detectin g and resolving software problems, and provides essenti al question s that you sh ould answer before contacting the EMC Customer Support Center . This appendix covers the f ollowin g topics: ◆ Overview of Detecting and Resolving Pro blems ..............[...]

B B-2 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Customer Suppor t Ov er view of D e tecting and Resol ving Problems EMC software pr oducts are s upported dir ectly by the EMC Customer Support Center in the United States . EMC uses th e following process to resolve customer problems wit h its software products (Figure B-1). [...]

B Tr oub leshooting the P roblem B-3 Customer Su pport T ro ubleshoot ing the Pr oblem Please perform the r elevant diagnostic steps before yo u contact the EMC Customer Support Center: 1. Rea d the doc ume ntat ion caref ul ly . 2. Reco nstruct the events leadin g up to the problem and describe them in writin g. 3. Run so me test cases to reproduc[...]

B B-4 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Customer Suppor t Bef ore Calling the Customer Suppor t Center Have the follo wing informatio n availa ble before calling the Cus tomer Support Center or your support r epres entative (if one has been assig ned to yo u): ❑ Y our company name ❑ Yo u r n a m e ❑ Y our phon[...]

B Docu menting the Problem B-5 Customer Su pport Documenting the Pr oblem If the EMC Customer S upport Center req uests information regar d ing the problem, please document it com pletely , making sure to include the follow ing info rmatio n: ❑ Y our company name a nd addr es s ❑ Yo u r n a m e ❑ Y our telephone number ❑ The importance of t[...]

B B-6 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Customer Suppor t Reporting a New Pr oblem For a new problem, please provide the following i nformation: ❑ Release level of the softw are that you are running ❑ Software installation para meters ❑ Host type on which you are r unning ❑ Operating system yo u are running [...]

B Sending P roblem Doc umentatio n B-7 Customer Su pport Sending Problem Documentatio n Use on e of the fo llowi ng metho ds to s end doc umenta tion o f the problem to the EMC Cus tomer Support Center: ◆ E-mail ◆ FT P ◆ U.S. mail to the f ollowing address: EMC Customer Support Center 45 South St reet Hopkinto n, MA 01748-9103 If the problem [...]

B B-8 P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e Customer Suppor t[...]

P owerPath f or UNIX In stallation and Adminis tration Guide i-1 Symbols /etc/. logi n file 1-19 /etc/profi le file 1-19 A AAM. Se e L egato AAM C Clusters. See Legat o AAM, Sun C luster 2.2, Sun Clust er 3.0, V CS Configur ation, r estoring 5-3 Configur ing Power Path d evices usin g powercf 5-17 Customer support B-3 Customer Support Center B-7 D [...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e i-2 Index M Major number 1-5, 1-8, 1-12, 2-1 3 Minor number 2-13 N Naming conven tions Solar is 5-5 Nat ive d evic es Solar is 5-5 P powerc f configu ration ut ility (So laris) 5-17 Powerlink website B-3 Powe rPat h boot de vice, So laris configuring 3-2 troubleshootin g 3-9 Power P[...]

i-3 P owerPath f or UNIX In stallation and Adminis tration Guide Inde x agen t, PowerP ath Vo lume Mana ger. See Powe rPath Volu me Manager V CS Agent EMCvg reso u rce type 2-11 installi ng with PowerPath 2-8 integra ting Pow erPath in to 2-10 VERIT A S Cluste r Server . See VCS VERIT AS V olume Manag er and em cpower devices 5-6 W W arning message[...]

P owerPath f o r UN IX Instal lation a nd A dminist r ation Guid e i-4 Index[...]