installation guide hp StorageWorks auto path for AIX product version: 04-02 seventh edition (september 2003) part number: B7949-96005 This guide is a supplement to the HDLM product documentation and describes how to install and configure Auto Path for AIX with HP disk arrays.
© Copyright 2003 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 Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Disk arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 4 HP StorageWorks Auto Path for AIX: Installation Guide
about this guide About this guide This guide provides information about configuring the HP StorageWorks Auto Path for AIX product on supported HP disk arrays. About this guide The Auto Path product requires Hitachi Dynamic Link Manager (HDLM) software. This guide is a supplement to the HDLM documentation. Before installing Auto Path, refer to the readme file for instructions and restrictions.
About this guide Related documentation HP provides the following related documentation: ■ HP StorageWorks Disk Array XP128: Owner’s Guide ■ HP StorageWorks Disk Array XP1024: Owner’s Guide For information about operating system commands and third-party products, refer to the manufacturer’s documentation: ■ Hitachi Dynamic Link Manager User’s Guide Conventions This guide uses the following text conventions. Figure 1 Blue text represents a cross-reference.
About this guide 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: thenew.hp.com/country/us/eng/support.
About this guide elsewhere 8 See the HP website for locations and telephone numbers: www.hp.
About this guide 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.
About this guide assume the entire cost of all service, repair or correction. Some jurisdictions do not allow the exclusion or limitation of liability for incidental or consequential damages, so the above limitation may not apply to you to the extent prohibited by such local laws. NOTE.
Installation 1 This chapter describes how to install HP StorageWorks Auto Path for AIX (Auto Path) on HP disk arrays. Use these instructions instead of the procedures provided in the HDLM documentation.
Installation 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 is required before installation. ■ After DLM devices have been created, 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.
Installation Disk array firmware and software dependencies See the readme file on the Auto Path for AIX CD for firmware revision and software version requirements.
Installation Installation procedure Configure the disk array LUNs to be accessible to at least one port in each cluster of the array. That is 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 adaptors (HBA) and switches if used. See the HBA product documentation for the method and contents of settings. If Fibre Channel is connected, verify that the connection method (such as Fabric or AL) matches the settings.
Installation 6. 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. 7. (Optional) Add the PATH environment variable to the execution environment.
Installation Note: If dlmfdrv.unconf and dlmfdrv.conf do not exist, the DLM configuration manager automatically creates the instances of the DLM devices for all of the disks supported by DLM. 9. Start the DLM configuration manager. # dlmcfgmgr 10. Verify that the DLM 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 . . .
Installation Example Recommendation If hdisk4, hdisk5 and hdisk6 are in the same LU and represented by DLM device file dlmfdrv1: # dlmmkvg -s 32 -y dlmvg01 dlmfdrv1 Use a SMIT Window for volume operations. This window automatically display the physical volume that has the smallest physical volume number in the corresponding LU. For SMIT Window information see the HDLM documentation. 13. Create a file system.
Installation Upgrading to version 04-02 Recommendation Before changes such as this are made to file systems, prepare a backup copy of data stored on the system. Ensure that all 04-02 prerequisite conditions are met before proceeding with the upgrade. All activity to the file systems must be halted for the duration of the upgrade. Note: It is no longer necessary to uninstall the previous version of Auto Path. To upgrade: 1. Unmount all DLM file systems. 2. Deactivate all DLM volume groups.
Installation 9. 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. 10. Verify that the dlmfdrv.conf or dlmfdrv.unconf file is in the /usr/DynamicLinkManager/drv directory. 11. Activate the DLM subsystem. # dlmcfgmgr A system reboot also activates the DLM subsystem.
Installation 20 HP StorageWorks Auto Path for AIX: Installation Guide
Configuration and operation 2 This chapter provides supplementary information about Auto Path operation on HP disk arrays.
Configuration and operation 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 the the automatic fail-back is used for failed paths. on Automatic failback of the failed paths is performed at a specified interval.
Configuration and operation ■ The dlnkmgr online command or automatic failback returns the Online(E) path online only. Using the dlnkmgr online command If –pathid is not specified in the dlnkmgr online operation, all the paths in hold state are subject to online processing. If there is a path that cannot be recovered, the following message is output: A path which failed to go online was detected during online operation of the KAPL01039-W DLM command.
Configuration and operation Required commands for operating DLM volume groups Auto Path cannot use devices that are recognized by AIX unless you take some special measures. This product provides utility commands for operating volume groups so that Auto Path running on AIX can recognize disks. A volume group created using the commands from DLM can be used only for Auto Path.
Configuration and operation To operate a volume group created using Auto Path, use the commands from the utility for operating DLM volume groups. If you operate a volume group without using the commands from the utility for operating DLM volume groups, the volume group may become invalid. In this case, use the AIX commands to rectify the volume group. (See the example.) Do not specify any volume group other than a volume group created using the commands from the utility for operating DLM volume groups.
Configuration and operation 26 HP StorageWorks Auto Path for AIX: Installation Guide