HP StorageWorks XP128 User manual

installation
guide
hp StorageWorks
auto path for AIX
product version: 04-01
fifth edition (may 2003)
part number: B7949-96003
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.

2HP StorageWorks Auto Path for AIX: Installation Guide
© 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.
This document contains proprietary information, which is protected by copyright. No part of this document may be
photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard.
The information contained in this document is subject to change without notice.
All other product names mentioned herein may be trademarks of their respective companies.
Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The
information is provided “as is” without warranty of any kind and is subject to change without notice. The warranties
for Hewlett-Packard Company products are set forth in the express limited warranty statements accompanying such
products. Nothing herein should be construed as constituting an additional warranty.
Printed in the U.S.A.
HP StorageWorks Auto Path for AIX: Installation Guide
product version: 04-01
fifth edition (may 2003)
part number: B7949-96003

3HP StorageWorks Auto Path for AIX: Installation Guide
contents
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
HP authorized reseller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Warranty statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Installing Auto Path in AIX environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installation procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Upgrading to version 04-01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2 Configuration and operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Setting the automatic failback feature using the dlnkmgr command . . . . . . . . . . . . . . . . . . . 20
Required commands for operating DLM volume groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4HP StorageWorks Auto Path for AIX: Installation Guide
Contents

5HP StorageWorks Auto Path for AIX: Installation Guide
about this
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.
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. The
procedures described in this guide and the readme file supersede the instructions
provided in the HDLM documentation.
Intended audience
This guide is intended for use by system administrators who already have
expertise with the associated systems and software and knowledge of related
topics:
■data processing concepts
■direct-access storage device subsystems and their basic functions
■disk arrays and RAID technology
■operating system commands and utilities
Disk arrays
Unless otherwise noted, the term disk array refers to any of these disk arrays and
appliances:
HP StorageWorks Disk Array XP48
HP StorageWorks Disk Array XP128
HP Surestore Disk Array XP256
HP StorageWorks Disk Array XP512
HP StorageWorks Disk Array XP1024
HP OpenView Continuous Access Storage Appliance (CASA)

6HP StorageWorks Auto Path for AIX: Installation Guide
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. For the online version
of this guide, the reference is linked to the target.
www.hp.com Underlined, blue text represents a website on the Internet. For
the online version of this guide, the reference is linked to the
target.
literal Bold text represents literal values that you type exactly as
shown, as well as key and field names, menu items, buttons,
file names, application names, and dialog box titles.
variable Italics indicates that you must supply a value. Italics is also
used for manual titles.
input/output Monospace font denotes user input and system responses,
such as output and messages.
Example Denotes an example of input or output. The display shown in
this guide may not match your configuration exactly.
[ ] Indicates an optional parameter.
{ } Indicates that you must specify at least one of the listed
options.
| Separates alternatives in a list of options.
Caution: Text set off in this manner indicates that failure to follow directions
could result in damage to equipment or data.

HP StorageWorks Auto Path for AIX: Installation Guide 7
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.html
Be sure to have the following information available before calling:
■technical support registration number (if applicable)
■product serial numbers
■product model names and numbers
■applicable error messages
■operating system type and revision level
■detailed, specific questions
For continuous quality improvement, calls may be recorded or monitored.
HP storage website
The HP website has the latest information on this product, as well as the latest
drivers. Select the appropriate product or solution from this website:
thenew.hp.com/country/us/eng/prodserv/storage.html
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

8HP StorageWorks Auto Path for AIX: Installation Guide
About this guide
elsewhere See the HP website for locations and telephone numbers:
www.hp.com

HP StorageWorks Auto Path for AIX: Installation Guide 9
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. HP SPECIFICALLY DISCLAIMS ANY
IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY,
SATISFACTORY QUALITY, NON-INFRINGEMENT, TITLE, ACCURACY OF
INFORMATIONAL CONTENT, AND FITNESS FOR A PARTICULAR
PURPOSE. Some jurisdictions do not allow exclusions of implied warranties or
conditions, so the above exclusion may not apply to you to the extent prohibited
by such local laws. You may have other rights that vary from country to country,
state to state, or province to province.
WARNING ! YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT
USE OF THE SOFTWARE IS AT YOUR SOLE RISK. HP DOES NOT
WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE
WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE
SOFTWARE WILL BE UNINTERRUPTED, VIRUS-FREE OR ERROR-FREE,
OR THAT DEFECTS IN THE SOFTWARE WILL BE CORRECTED. THE
ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
SOFTWARE IS ASSUMED BY YOU. HP DOES NOT WARRANT OR MAKE
ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF
THE USE OF THE SOFTWARE OR RELATED DOCUMENTATION IN
TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY,
CURRENTNESS, OR OTHERWISE. NO ORAL OR WRITTEN
INFORMATION OR ADVICE GIVEN BY HP OR HP’S AUTHORIZED
REPRESENTATIVES SHALL CREATE A WARRANTY.
LIMITATION OF LIABILITY. EXCEPT TO THE EXTENT PROHIBITED
BY LOCAL LAW, IN NO EVENT INCLUDING NEGLIGENCE WILL HP OR
ITS SUBSIDIARIES, AFFILIATES, DIRECTORS, OFFICERS, EMPLOYEES,
AGENTS OR SUPPLIERS BE LIABLE FOR DIRECT, INDIRECT, SPECIAL,
INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR OTHER DAMAGES
(INCLUDING LOST PROFIT, LOST DATA, OR DOWNTIME COSTS),
ARISING OUT OF THE USE, INABILITY TO USE, OR THE RESULTS OF
USE OF THE SOFTWARE, WHETHER BASED IN WARRANTY,
CONTRACT, TORT OR OTHER LEGAL THEORY, AND WHETHER OR NOT
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Your use of the
Software is entirely at your own risk. Should the Software prove defective, you

10 HP StorageWorks Auto Path for AIX: Installation Guide
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. EXCEPT TO THE EXTENT ALLOWED BY LOCAL LAW, THESE
WARRANTY TERMS DO NOT EXCLUDE, RESTRICT OR MODIFY,
AND ARE IN ADDITION TO, THE MANDATORY STATUTORY RIGHTS
APPLICABLE TO THE LICENSE OF THE SOFTWARE TO YOU;
PROVIDED, HOWEVER, THAT THE CONVENTION ON CONTRACTS FOR
THE INTERNATIONAL SALE OF GOODS IS SPECIFICALLY DISCLAIMED
AND SHALL NOT GOVERN OR APPLY TO THE SOFTWARE PROVIDED
IN CONNECTION WITH THIS WARRANTY STATEMENT.

11HP StorageWorks Auto Path for AIX: Installation Guide
1
Installation
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.

12 HP StorageWorks Auto Path for AIX: Installation Guide
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.
■After a volume group is created on a DLM device, do not reference the
underlying hdisk (as displayed with the lsdev command).
All paths to the same LUN must have the same type of HBA with identical
firmware.
Caution: If you combine different types of HBAs, HDLM may not be able to
switch the path when an error occurs.
■The HDLM software cannot be used to manage the boot disk.
■Uninstall any previous version of Auto Path before installing the HDLM
software.
Recommendation Use the same type of fibre switch for all paths.
System prerequisites for using the HDLM software
HP supports the following operating system environments:
■AIX 4.3.3 with a maintenance level of 09 or later
■AIX 5.1 with a maintenance level of 02 or later; patch IY37437
■AIX 5.2 with patch IY39860
Use IBM FC6227 or FC6228 HBAs with current firmware installed.
Related
information
See the HDLM documentation for other user information.
Disk array firmware and software dependencies
See the readme file on the Auto Path for AIX CD for firmware revision and
software version requirements.

13HP StorageWorks Auto Path for AIX: Installation Guide
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.
Configure VA LUNs using Lun Security to enable each HBA to access the
required LUNs and connect to each controller of the array.
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.
Install VisualAge C++ (version 5.0.0.0 or later) filesets on the host if required.
AIX 4.3.3 software may be obtained at:
http://www-1.ibm.com/support/docview.wss?org=SW&doc=4001173
AIX 5.1 software is available on the 5.1 install media.
To install Auto Path:
1. Log in with root authority.
2. Create the /var/DLM directory.
# mkdir /var/DLM
3. Create the dlm.lic_key license key file.
Example # echo "123456789ABCDEF" > /var/DLM/dlm.lic_key
where the license key is 123456789ABCDEF.
If preferred, you can use vi to edit the file.
4. Insert the CD into the drive.
There is no need to mount the CD.
5. Execute the install command.
# installp –aXgd /dev/cd0 all
Or in place of /dev/cd0, specify the special file of the installation medium.
Follow the display prompts to complete the install.

14 HP StorageWorks Auto Path for AIX: Installation Guide
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.
Bourne shell
or Korn shell
# PATH=$PATH:/usr/DynamicLinkManager/bin
# export PATH
C shell # set path=( $path /usr/DynamicLinkManager/bin )
If preferred, you can edit the PATH statement in the root .profile.
8. 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.
To specify the volumes to be managed, enter the logical names of these
volumes (hdisks) in the configuration file:
/usr/DynamicLinkManager/drv/dlmfdrv.conf
Example Enter all hdisk references for paths to the same LUN. If only volumes hdisk5
and hdisk7 are used for DLM and reference paths to the same LUN,
dlmfdrv.conf will contain the following:
hdisk5
hdisk7
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
Example If physical volumes hdisk4 and hdisk6 are not to be recognized by the DLM
driver, dlmfdrv.unconf will contain the following:
hdisk4
hdisk6

15HP StorageWorks Auto Path for AIX: Installation Guide
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
dlmfdrv20 Available DLM Driver
dlmadrv Available DLM Alert Driver
. . .
dlmfdrv8 Available DLM Driver
dlmfdrv Available DLM Driver
In this example:
— dlmadrv is the special file name of the DLM alert driver.
— dlmfdrv is the driver instance for internally managing Auto Path.
— dlmfdrv20 and dlmfdrv8 are the special file names of DLM drivers where
20 and 8 are the driver’s instance numbers. dlmfdrv20 corresponds to
hdisk20 and dlmfdrv8 corresponds to hdisk8.
Verify that all DLM drivers corresponding to the physical volumes you want
recognized are displayed. If one or more drivers are not displayed, AIX error
information is in the /var/DynamicLinkManager/log/dlmcfgmgr1.log file.
For details about the log file, see the AIX documentation.
11. Make sure a volume group is available.
If a volume group and file system already exists, see the HDLM
documentation for conversion of the volume group to a DLM volume group
then continue with step 14.
If a volume group did not exist before you started installing Auto Path,
continue with step 12.
12. Create a volume group.
To specify a physical volume group, specify the lowest numbered DLM
device in the same LU.

16 HP StorageWorks Auto Path for AIX: Installation Guide
Installation
Example If hdisk4, hdisk5 and hdisk6 are in the same LU:
# dlmmkvg -s 32 -y dlmvg01 dlmfdrv4
Recommendation 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.
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. Free the mount point.
Example # umount /tmp/dlmvg01_fs
15. To make the volume groups available for Auto Path, deactivate and then
activate the volume groups to be used.
Example # dlmvaryoffvg dlmvg01
# dlmvaryonvg dlmvg01
16. Make the mount point available.
Example # mount /tmp/dlmvg01_fs
17. Verify the volume group.
# dlmlsvg
18. Activate the DLM subsystem.
# dlmcfgmgr
A system reboot also activates the DLM subsystem.
19. Verify that the DLM subsystem is active.
# lssrc –a | grep DLMManager

17HP StorageWorks Auto Path for AIX: Installation Guide
Installation
Upgrading to version 04-01
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-01 prerequisite conditions are met before proceeding with the
upgrade.
All activity to the file systems must be halted for the duration of the upgrade.
To upgrade:
1. Unmount all DLM file systems.
2. Deactivate all DLM volume groups.
Example # dlmvaryoffvg dlmvg01
3. Save the dlmfdrv.conf or dlmfdrv.unconf file to a safe place.
Example # cp /usr/DynamicLinkManager/drv/dlmfdrv.conf /tmp
4. Begin the uninstallation of the previous version.
Follow the steps in the manual for the previous version. The basic commands
are:
# dlmrmdev
# installp –u AutoPath
5. Make sure the appropriate license key is in the /var/DLM/dlm.lic_key file.
Make a backup of this file. The version 04-01 installation will delete this file
and the /var/DLM directory.
6. Insert the Auto Path 04-01 CD into the drive.
There is no need to mount the CD.
7. Execute the install command.
# installp –aXgd /dev/cd0 all
Or in place of /dev/cd0, specify the special file of the installation medium.
Follow the display prompts to complete the install.
8. Verify that the package was installed.
# lslpp -L AutoPath.rte

18 HP StorageWorks Auto Path for AIX: Installation Guide
Installation
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. Copy the dlmfdrv.conf or dlmfdrv.unconf file back to the
/usr/DynamicLinkManager/drv directory.
10. Activate the DLM subsystem.
# dlmcfgmgr
A system reboot also activates the DLM subsystem.
The dlmfdrv device files are regenerated as configured in the dlmfdrv.conf or
dlmfdrv.unconf file.
11. Activate all of the DLM volume groups.
Example # dlmvaryonvg dlmvg01
12. Make the mount point available.
Example # mount /tmp/dlmvg01_fs

19HP StorageWorks Auto Path for AIX: Installation Guide
2
Configuration and operation
This chapter provides supplementary information about Auto Path operation on
HP disk arrays.

20 HP StorageWorks Auto Path for AIX: Installation Guide
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. The recovered path is returned online.
off Automatic failback is not performed.
–intvl Specify the time interval for automatic failback with a value
between 1 and 1440 (minutes). When no value is set for this
parameter, the value previously set or 1 minute (default) is
used for failback processing.When automatic failback is
newly turned on, or the DLM manager is activated, the first
automatic failback is performed after the duration of the
specified interval.
Settings on automatic failback remain valid after the system is turned off and
restarted. The interval value is maintained even after the automatic failback is
turned off. The stored value is used when automatic failback is set on again and no
value is set for the interval at that time.
Only the paths containing an error are subject to the automatic failback operation.
The paths having an error when the DLM manager is activated are also included in
the automatic failback operation.
With the addition of the auto failback, only normal paths are subject to health
check.
Error indication on the last path
When the state of the paths is indicated 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.