AIX HP StorageWorks Auto Path for AIX installation guide product version: 04.40 ninth edition (August 2004) part number: B7949-96008 This guide is a supplement to the Hitachi Dynamic Link Manager User’s Guide and describes how to install and configure Auto Path for AIX with HP disk arrays.
© Copyright 2003-2004 Hewlett-Packard Development Company, L.P., all rights reserved Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About this guide 5 Intended audience 5 Disk arrays 5 Related documentation 6 Conventions 6 Getting help 7 HP technical support 7 HP storage website 8 HP authorized reseller 8 Revision history 9 Warranty statement 10 1 2 Installation 13 Installing Auto Path in AIX environments 14 System prerequisites for using the Auto Path software Disk array firmware and software dependencies 15 Installation procedure 16 Upgrading to version 04.
HP StorageWorks Auto Path for AIX: Installation Guide
About this guide This guide provides information about configuring the HP StorageWorks Auto Path for AIX software for supported HP disk arrays. Auto Path requires Hitachi Dynamic Link Manager (HDLM) software. This guide is a supplement to the Hitachi Dynamic Link Manager User’s Guide. Before installing Auto Path, refer to the readme file for instructions and restrictions.
Related documentation HP provides the following related documentation: • HP StorageWorks Disk Array XP128: Owner’s Guide • HP StorageWorks Disk Array XP1024: Owner’s Guide • HP StorageWorks XP12000 Disk Array Owner’s Guide • HP StorageWorks Command View XP for XP Disk Arrays: User Guide For information about operating system commands and third-party products, refer to the manufacturer’s documentation. Conventions This guide uses the following text conventions.
Getting help If you still have a question after reading this guide, contact an HP authorized service provider or access our website: www.hp.com HP technical support In North America, call technical support at 1-800-652-6672, available 24 hours a day, 7 days a week. Outside North America, call technical support at the nearest location. Telephone numbers for worldwide technical support are listed on the HP website under support: http://h18006.www1.hp.com/storage/arraysystems.
HP storage website For the most current information about HP StorageWorks XP products, visit the support website: http://h18006.www1.hp.com/storage/arraysystems.html For information about product availability, configuration, and connectivity, consult your HP account representative. HP authorized reseller For the name of your nearest HP authorized reseller, you can obtain information by telephone: United States 1-800-345-1518 Canada 1-800-263-5868 Or contact: www.hp.
Revision history About this guide January 2004 Minor update for product version 04.03. August 2004 Update for version 04.40.
Warranty statement HP warrants that for a period of ninety calendar days from the date of purchase, as evidenced by a copy of the invoice, the media on which the Software is furnished (if any) will be free of defects in materials and workmanship under normal use. DISCLAIMER. EXCEPT FOR THE FOREGOING AND TO THE EXTENT ALLOWED BY LOCAL LAW, THIS SOFTWARE IS PROVIDED TO YOU “AS IS” WITHOUT WARRANTIES OF ANY KIND, WHETHER ORAL OR WRITTEN, EXPRESS OR IMPLIED.
LIMITATION OF LIABILITY.
HP StorageWorks Auto Path for AIX: Installation Guide
1 Installation This chapter describes how to install HP StorageWorks Auto Path for AIX for use with HP disk arrays. Use these instructions instead of the procedures provided in the Hitachi Dynamic Link Manager User’s Guide.
Installing Auto Path in AIX environments Before beginning installation, configure the AIX environment for Auto Path support and observe the following requirements. • A license key or a license file containing a license key is required before installation. • After you create DLM devices, use only dlm commands for these devices. Do not use standard operating system commands. For example, use /usr/DynamicLinkManager/bin/dlmmkvg instead of /usr/sbin/mkvg.
System prerequisites for using the Auto Path software This version of Auto Path works with the AIX 4.3.3, AIX 5.1, and AIX 5.2 operating systems. Refer to the Auto Path User’s Guide or the Readme file on the release media for minimum maintenance and patch levels required for Auto Path to operate properly. Additional patch level requirements apply if you also run HACMP and GPFS.
Installation procedure Configure the disk array LUNs to be accessible through at least one port in each cluster of the array—one port in CL1 and the other in CL2. Make the appropriate connections between the host HBAs and the disk array ports. Configure host bus adapters (HBAs) and switches. See the HBA product documentation for the configuration method and settings. Verify that the Fibre Channel connection method (such as Fabric or AL) matches the settings.
3. Insert the CD into the drive. There is no need to mount the CD. 4. Execute the install command: # installp –aXgd /dev/cd0 all Alternatively, you can specify the special file of the installation medium in place of /dev/cd0. 5. Verify that the package was installed: # lslpp -L AutoPath.rte Verify that AutoPath.rte appears among the file set items in the output list and that its status is C (Commit). See the readme file on the Auto Path for AIX CD for the current level. 6.
hdisk5 hdisk7 Example To specify the volumes to not be managed, enter the logical names of these volumes (hdisks) in the unconf file: /usr/DynamicLinkManager/drv/dlmfdrv.unconf If physical volumes hdisk4 and hdisk6 are not to be recognized by the DLM driver, dlmfdrv.unconf will contain the following: hdisk4 hdisk6 If dlmfdrv.unconf and dlmfdrv.conf do not exist, the Auto Path configuration manager automatically creates the instances of the devices for all of the disks supported by Auto Path. 8.
Auto Path driver name does not relate to the hdisk or LU names. The instances start with dlmfdrv0 and increment sequentially. Verify that all Auto Path drivers representing the disk array LUNs you want recognized are displayed. If one or more drivers are not displayed, AIX error information is logged to the following file: /var/DynamicLinkManager/log/dlmcfgmgr1.log. For details about the log file, see the AIX documentation. 11. Create a volume group.
Upgrading to version 04.40 Recommendation Before making changes to the file systems (such as this upgrade), make a backup copy of data stored on the system. Be sure that all 04.40 prerequisite conditions are met before proceeding with the upgrade. Halt all activity with the file systems for the duration of the upgrade. For versions 04.02 or later, you no longer need to uninstall the previous version of Auto Path. Versions older than 04.02 must be uninstalled before you install version 04.40.
7. Execute the install command: # installp –aXgd /dev/cd0 all Alternately, you can specify the special file of the installation medium in place of /dev/cd0. 8. Verify that the package was installed: # lslpp -L AutoPath.rte Verify that AutoPath.rte appears among the file set items in the output list and that its status is C (Commit). See the readme file on the Auto Path for AIX CD for the current level. 9. Verify that the dlmfdrv.conf or dlmfdrv.unconf file is in the /usr/DynamicLinkManager/drv directory.
HP StorageWorks Auto Path for AIX: Installation Guide
2 Operation This chapter provides information about Auto Path operations with HP disk arrays.
Setting the automatic failback feature using the dlnkmgr command Use the dlnkmgr command to set up automatic failback. dlnkmgr set –afb { on [–intvl Interval_Time] | off } [–s] The dlnkmgr command sets whether automatic failback is used for failed paths. The default setting is off. –afb Specify whether or not automatic failback is used for failed paths. on Automatic failback of the failed paths is performed at a specified interval. The recovered path is returned online.
Error indication on the last path When the state of the paths is displayed with dlnkmgr view –path command, the last path for a device remains online. It does not go offline even if an error occurs. The path containing an error is now indicated as Online(E). • The Online(E) path returns online if input and output can be successfully executed. • The dlnkmgr online command or automatic failback returns the Online(E) path online only.
Commands for operations with Auto Path volume groups Auto Path cannot use disks that are recognized by AIX unless you take some special measures. Auto Path provides utility commands for operations on Auto Path volume groups. A volume group created using the commands from Auto Path can be used only for Auto Path. The Auto Path utility commands for operations with Auto Path volume groups correspond to the commands executed in the SMIT screen “HDLM Volume Group.
When you use an Auto Path volume group command, specify the AIX name (for example, hdisk1) as the physical volume name. However, after you have performed operations on the volume group, the volume name is changed to an Auto Path name (for example, dlmfdrv1). Do not specify any volume group other than a volume group created using the Auto Path volume group utility commands. Doing so may cause the volume group to become invalid.
HP StorageWorks Auto Path for AIX: Installation Guide
Index A alert driver 18 audience intended 5 authorized reseller, HP 8 B before installation 14 C commands for volume group operations 26 conventions documentation 6 D dependencies 15 disk arrays supported 5 dlm commands 14 dlmodmset command 14 dlnkmgr command 24 dlnkmgr online command 25 dlnkmgr view -path command 25 documentation conventions 6 related 6 Index E environment variable, PATH 17 error indication 25 error messages 26 F failback feature, automatic 24 H HBA 14 help obtaining 7 help output 26 Hi
license key 14, 16, 20 P PATH environment variable 17 path error 25 persistent reservation 14 physical volumes 17 prerequisites 15 R related documentation list of 6 S software dependencies 15 system administrator required knowledge 5 T technical support HP 7 U upgrading to version 04.