AIX HP StorageWorks Auto Path for AIX installation guide product version: 04.40-/B tenth edition (November 2004) part number: B7949-96009 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 Refer to the manufacturer’s documentation for information about operating system commands and third-party products. 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 Visit the support website for the most current information about HP StorageWorks XP products: http://h18006.www1.hp.com/storage/arraysystems.html Consult your HP account representative for information about product availability, configuration, and connectivity. 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 November 2004 Minor update for product version 04.
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, conforming to the following requirements: • Make sure you have a license key or a license file containing a license key. • 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.
/var/tmp/hdlm_license Otherwise, enter the license key as follows: Create the /var/DLM directory: # mkdir /var/DLM Example # echo "123456789ABCDEF" > /var/DLM/dlm.lic_key where “123456789ABCDEF” is the license key number. Optional Use a text editor to enter the key in the /var/DLM/dlm.lic_key file. 3. Insert the CD into the drive. There is no need to mount the CD. 4.
7. Define the physical volumes to be managed by Auto Path. If you want to let the DLM driver recognize all volumes that can be managed by the DLM driver, this step is unnecessary. Continue with step 9. To limit the volumes to be managed, you may either specify the volumes to be managed or specify the volumes you do not want managed. Example To specify the volumes to be managed, enter the logical names of these volumes (hdisks) in the configuration file: /usr/DynamicLinkManager/drv/dlmfdrv.
8. Execute the Auto Path configuration manager command: # dlmcfgmgr 9. Verify that the Auto Path subsystem (DLMManager) is active: # lssrc –a | grep DLMManager A system reboot also activates the Auto Path subsystem. 10. Verify that the Auto Path drivers (dlmfdrvn) and alert driver (dlmadrv) are installed on an active kernel and available. Example # lsdev -C | grep dlm dlmfdrv0 Available HDLM Driver dlmadrv Available HDLM Alert Driver . . .
Recommendation Use a SMIT Window for volume operations. For SMIT Window information see the Hitachi Dynamic Link Manager User’s Guide. 12. Verify the volume group: # dlmlsvg 13. Create a file system. Example To create a file system having the size 8192000 at the mount point /tmp/dlmvg01_fs for the dlmvg01 volume group: # crfs -v jfs -g' dlmvg01' -a size='8192000' -m'/tmp/dlmvg01_fs' 14. Make the mount point available. Example # mount /tmp/dlmvg01_fs 15.
Upgrading to version 04.40-/B Recommendation Make a backup copy of data stored on the system before making changes (such as this upgrade) to the file systems. Be sure that all 04.40-/B prerequisite conditions are met before proceeding with the upgrade. Halt all activity with the file systems for the duration of the upgrade. Versions older than 04.02 must be uninstalled before you install version 04.40. This includes removing the /opt/hitachi/HNTRLib files.
b. Change the attribute fc_err_recov of the parent device (fscsin) to fast_fail. # chdev -l fscsin -a fc_err_recov=fast_fail c. Confirm that the setup of the parent device (fscsin) to fast_fail is effective. # lsattr -El fscsin Example fc_err_recov fast_fail FC Fabric Event Error RECOVERY Policy True 6. Make sure the license key is in the /var/DLM/dlm.lic_key file, or a /var/tmp/hdlm_license file is present. Important Make a backup of this file. The version 04.
11. Activate the Auto Path subsystem: # dlmcfgmgr A system reboot also activates the Auto Path subsystem (DLMManager). The dlmfdrv device files are regenerated as configured in the dlmfdrv.conf or dlmfdrv.unconf file. 12. After verifying that hdisk to LUN associations are correct, activate all of the Auto Path (HDLM) volume groups. Example # dlmvaryonvg dlmvg01 13. Make the mount point available.
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 19 audience, intended 5 authorized reseller, HP 8 error indication 27 messages 28 path 27 B before installation 14 F failback feature, automatic 26 C commands for volume group operations 28 conventions, documentation 6 H HBA 14 help output 28 help, obtaining 7 Hitachi Dynamic Link Manager User’s Guide 13 HP authorized reseller 8 technical support 7 D dependencies 15 disk arrays, supported 5 dlm commands 14 dlmodmset command 14 dlnkmgr command 26 dlnkmgr online command 27 dlnkmgr
license key 14, 17, 22 O operation 25–29 P PATH environment variable 17 path error 27 persistent reservation 14 physical volumes 18 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.