@(#) XPARRAY_MPIO_ODM Ver 5.4.0.2 This readme includes explanation of the following fileset (1)XPARRAY_MPIO_ODM(devices.fcp.disk.HP.xparray.support.rte) This fileset is for using default MPIO functionality on AIX 5L V5.2 and ML03 or later for XP512/XP1024/XP12000/XP10000/XP24000/XP20000 product [Note] In order to install the above filesets on Virtual I/O server with AIX 5.3, oem_setup_env command is necessary to be executed. Please refer to IBM document about oem_setup_env usage. XP_MPIO_ODM history Rev 1: 5400I(04/08) First release Rev 2: 5401U(05/09) Auto Failback Support Rev 3: 5401(1)(06/10) Separate readme file to readme1 file and readme2 file Rev 4: 5402U(07/09) Distinguish XP12000/10000 and XP24000/XP20000 ############## Welcome to XPARRAY_MPIO_ODM_5402U package ###### # # # Software Attached Document # # # # Ver. 5.4.0.2 # # # # Copyright (C) 2004, 2007 Hitachi,Ltd. All rights reserved # ############################################################### 1. Introduction This attached document describes the contents by the following supported program products. XPARRAY_MPIO_ODM package (fileset name is devices.fcp.disk.HP.xparray.mpio.rte) XPARRAY_MPIO_ODM package consists of the following 3 packages (a)XPARRAY_MPIO_ODM_5400I devices.fcp.disk.HP.xparray.mpio.rte 5.4.0.0 AIX MPIO Support for XP Disk Arrays(New Install) (b)XPARRAY_MPIO_ODM_5401U devices.fcp.disk.HP.xparray.mpio.rte 5.4.0.1 AIX MPIO Support for XP Disk Arrays(Update) (c)XPARRAY_MPIO_ODM_5402U devices.fcp.disk.HP.xparray.mpio.rte 5.4.0.2 AIX MPIO Support for XP Disk Arrays(Update) In order for Default PCM(MPIO) functionality to work with XP Disk Array, the XPARRAY_MPIO_ODM_5400I needs to be installed on AIX machine before recognizing the devices. XPARRAY_MPIO_ODM_5400I has the following functionality to add its own device definitions for Hitachi and set the proper attributes to AIX ODM like PdDv(a predefined set of devices), PdAt(a predefined set of attributes), PdPathAt, andPdAtXtd that IBM provide to recognize Hitachi disk device as MPIO(Default PCM). # This odm supports XP devices with dynamic tracking and MPIO # This should only be given to customers running AIX 5.2(ML03) or greater # who want to utilize AIX dynamic tracking and AIX MPIO 2. Prerequisite operating system and Applying machine type (1) Operating System - AIX 5.2 ML03 or later(IY49013)+APARs IY56769 and IY58170 on the AIX Pseries or RS6000 Server - APAR IY49823(For FC6239) devices.fcp.disk.rte 5.2.0.40 or later devices.common.IBM.mpio.rte 5.2.0.31 or later - AIX 5.2 ML04 or later(For FC5716) For MPIO_ODM_5401, the following APAR is necessary. - AIX 5.2 ML06 or later or APAR IY67645 on the AIX Pseries or RS6000 Server - AIX 5.3 ML02 or later or APAR IY67625 on the AIX Pseries or RS6000 Server devices.common.IBM.mpio.rte.5.2.0.60 or later devices.common.IBM.mpio.rte.5.3.0.20 or later [How to confirm] (a) The result of "oslevel -r" is 5200-03 or later (b) The result of "lslpp -l devices.common.IBM.mpio.rte" is 5.2.0.31 or later (2)HBA - FC6227/FC6228/FC6239/FC5716/FC1977/FC5758/FC5759/FC1905/FC1910 (IBM branded HBA) (3)Microcode for the RAID(Evaluated) - XP512 : 01-19-62-00/00 or later - XP1024 : 21-06-37-00/00-01 or later - XP12000: 50-01-19-00/00 or later - XP10000: 50-01-19-00/00 or later - XP24000: 60-01-3x-00/00 or later - XP20000: 60-01-68-00/00 or later 3. Installation on the AIX System < Installation > (1) Log-in as superuser (2) Mount the CD-ROM (3) Copy XPMPIO2.tar to an AIX server directly(/usr/sys/inst.images): # cp XPMPIO2.tar /usr/sys/inst.images (4) Extract XPMPIO2.tar. (5) Three of XP_MPIO_ODM packages(XPARRAY_MPIO_ODM_5400I and XPARRAY_MPIO_ODM_5401U and XPARRAY_MPIO_ODM_5402U) are created. (6) Create a new .toc file # cd /usr/sys/inst.images # inutoc . (7) Use installp to install the AIX support fileset: # smitty install (8) Select Install and Update Software. (9) Select Install and Update from LATEST Available Software. (10) You will be prompted for an input device. Enter the directory where the fileset was copied. (11) Select F4 to list the available installation packages. (12) Select F7 to select "5.4.0.0 AIX MPIO Support for XP Disk Arrays(New Install)" and "5.4.0.1 AIX MPIO Support for XP Disk Arrays(Update)" and "5.4.0.2 AIX MPIO Support for XP Disk Arrays(Update)", then select Enter (13) Select Enter to start the installation process Fileset name : devices.fcp.disk.HP.xparray.mpio.rte (14) If necessary, remove any XP devices already defined as Other FC SCSI disk drive. - To remove one device: # rmdev -dl hdisk(n) - To remove all devices on a path: # rmdev -dl fscsi(n) -R (15) Confirm whether installation has completed successfully. (16) Reboot AIX. (17) Confirm that the parameters have the following values: # lsattr -E -l hdisk(n) PCM PCM/friend/xparray algorithm fail_over hcheck_cmd inquiry (when XPARRAY_MPIO_ODM 5401U is installed) hcheck_interval 60 hcheck_mode nonactive pvid *** queue_depth 2 q_type simple q_err yes clr_q no rw_timeout 60 start_timeout 60 reassign_timeout 120 # lsdev -Cc disk hdisk0 Available 1S-08-00-8,0 16 Bit LVD SCSI Disk Drive hdisk1 Available 1H-08-01 XP MPIO Disk XP12000 (Fibre) hdisk2 Available 1Z-08-01 XP MPIO Disk XP24000 (Fibre) [Note] In order to disable Auto Failback functionality, hcheck_interval is changed to 0. The hcheck_interval parameter can be changed by: Unmounting filesystems Varying off the volume groups chdev -l hdiskx -a hcheck_interval=0 [Note] When MPIO and HACMP is configured with XP Disk, the following setting is necessary. (A)Volume Groups configured as Enhanced Concurrent (B)Allow chdev command to be issued to change from gsingle_pathh to gno_reserveh, algorithm to ground_robinh Allow loadbalancing chdev -l hdiskx -a algorithm=round_robin -a reserve_policy=no_reserve [Note] The default IBM rw timeout and queue depth value are different from the recommended values for XP devices. The IBM default values are queue_depth=1 and rw timeout=60. The Hitachi default values are queue_depth=2 and rw timeout=60. Contact HP for more information on the recommended queue depth value. Confirm whether each LU is configured with several paths(device or path status) using following command. # lspath Enabled hdisk0 scsi0 Enabled hdisk1 fscsi0 Enabled hdisk2 fscsi0 Enabled hdisk3 fscsi0 Enabled hdisk4 fscsi0 Enabled hdisk1 fscsi2 Enabled hdisk2 fscsi2 Enabled hdisk3 fscsi2 Enabled hdisk4 fscsi2 < Uninstallation > (1) Remove all XP LUNs from the system using the rmdev command: - To remove one device: # rmdev -dl hdisk(n) - To remove all devices on a path: # rmdev -dl fscsi(n) -R [Note] The deinstall will fail if XP (hdisks) are not removed first. (2) Enter smitty install from command line. (3) Select Software Maintenance and Utilities. (4) Select Remove Installed Software. (5) Select F4 for SOFTWARE name to list all installed software. (6) Select (/) for Hp devices.fcp.disk.HP.xparray.mpio.rte (7) Select the package to remove pressing F7 and then Enter (8) Use either the Tab key or F4 to change PREVIEW only to No. (9) Select Enter to confirm the warning message. (10) Confirm OK whether the fileset is deleted correctly (11) Reboot AIX. (12) hdisk(n) is recognized as "Other FC SCSI Disk Drive" [Note] Alternative method to uninstall MPIO after removing hdisk devices: installp -u devices.fcp.disk.HP.xparray.mpio.rte Reboot AIX System. [Caution] (1) The AIX support non-MPIO ODM update(XP_ODM) and the MPIO ODM update(XP_MPIO_ODM) can not co-exist on the same server. [Note] For latest information, please visit the following site and follow the XP link. http://spock.corp.hp.com/index.aspx