@(#) HTC_ODM(Hitachi.aix.support.rte) @(#) Ver. 5.0.52.3(8) This readme includes explanation of the following fileset (1)HTC_ODM(Hitachi.aix.support.rte) This fileset is for using non default MPIO functionality on AIX 5L V5.2 and ML01 or later for RAID400/RAID450/RAID500(USP)/RAID600(USP V)/RAID700(VSP)/HM700(HUS VM)/RAID800(VSP G1000)/RAID850(VSP G1500 and F1500)/HM800(VSP Gx00)/HM850(VSP Gx00 and VSP Fx00) product [Note] In order to install the above filesets on Virtual I/O server with AIX 5.3 or later , oem_setup_env command is necessary to be executed. Please refer to IBM docume nt about oem_setup_env usage. HTC_ODM history Rev 1: 5005U(03/08) First release Rev 2: 50521U(05/03) Dynamic Tracking Support Rev 3: 50522U(05/09) Modification for HTC_ODM and XP_ODM co-existence issue on same server Rev 4: 50522(1)(07/09) Correction of readme Rev 5: 50523U(07/11) The device recognition method of multiplatform volumes was changed Rev 6: 50523U(1)(09/03) SANBoot info is included and OS/HBA info is updated Rev 7: 50523U(2)(10/06) RAID700(VSP) is included and correction of readme Rev 8: 50523U(3)(12/05) HM700 is included and correction of readme Rev 9: 50523U(4)(12/06) HM700(HUS VM) is included and correction of readme Rev 10: 50523U(5)(13/09) RAID800(VSP G1000) is included and correction of readme Rev 11: 50523U(6)(15/02) HM800(VSP Gx00) is included and correction of readme Rev 12: 50523U(7)(16/09) Correction of readme Rev 13: 50523U(8)(17/11) Support HM850(VSP Gx00 and VSP Fx00) and correction of readme (addition of RAID850 (VSP G1500 and F1500) ) ############## Welcome to HTC_ODM package ##################### # # # Software Attached Document # # # # Ver. 5.0.52.3(8) # # # # Copyright (C) 2003, 2017 Hitachi,Ltd. All rights reserved # ############################################################### 1. Introduction This attached document is describing as for the supported contents by the following program products. HTC_ODM package(fileset name is Hitachi.aix.support.rte) HTC_ODM package consists of the following 5 packages (a)HTC_FC_ODM_5001I Hitachi.aix.support.rte 5.0.0.1 AIX Support for Hitachi Disk (b)HTC_FC_ODM_5005U Hitachi.aix.support.rte 5.0.0.5 AIX Support for Hitachi Disk(Update) (c)HTC_FC_ODM_50521U Hitachi.aix.support.rte 5.0.52.1 AIX Support for Hitachi Disk(Update) (d)HTC_FC_ODM_50522U Hitachi.aix.support.rte 5.0.52.2 AIX Support for Hitachi Disk(Update) (e)HTC_FC_ODM_50523U Hitachi.aix.support.rte 5.0.52.3 AIX Support for Hitachi Disk(Update) From AIX 5.2 and ML01 enhancement, device recognition was changed from "Other FC SCSI Disk Drive" into "MPIO Other FC SCSI Disk Drive" for Hitachi Disk Array because of MPIO(Default PCM) support. Especially JP1/Hicommand Dynamic Link Manager does not work on this environment. In order to work the already supported products with AIX 5.2 and ML01 and later for Hitachi Disk Array, this HTC_ODM needs to be installed on AIX machine before recognizing devices. HTC_ODM has the following functionality to add its own device definitions for Hitachi and set the proper attributes to AIX ODM like as PdDv(a predefined set of devices), PdAt(a predefined set of attributes) that IBM provide to recognize Hitachi disk device. 2. Prerequisite operating system and Applying machine (1) Operating System - AIX 5.2(ML01 or later) on the AIX Pseries or Power 5 or RS6000 Server - AIX 5.3(or later) on the AIX Pseries or Power 5 or Power 6 or RS6000 Server - AIX 6.1(or later) on the AIX Pseries or Power 5 or Power 6 or Power 7 Server - AIX 7.1(or later) on the AIX Pseries or Power 5 or Power 6 or Power 7 Server - AIX 7.2(or later) on the AIX Pseries or Power 5 or Power 6 or Power 7 Server devices.common.IBM.mpio.rte 5.2.0.10 or later [How to confirm] (a) The result of "oslevel -r" is 5200-01 or later (b) The result of "lslpp -l devices.common.IBM.mpio.rte" is 5.2.0.10 or later (2)HBA - FC6227/FC6228/FC6239/FC5716/FC5758/FC5759/FC1910/FC1905/FC1957/FC1977/FC5773/FC5774/FC5735/EN0A/EN0B (IBM blanded HBA) (3)Microcode for the RAID - RAID400: 01-18-00 or higher - RAID450: 21-05-00 or higher - RAID500(USP) : 50-01-19-00 or higher - RAID500(NSC) : 50-03-93-00 or higher - RAID600(USP V): 60-01-3x-00 or higher - RAID600(USP VM): 60-01-68-00 or higher - RAID700(VSP ): 70-01-xx-00 or higher - HM700 (HUS VM): 73-01-xx-00 or higher - RAID800(VSP G1000): 80-01-xx-00 or higher - RAID850(VSP G1500 and F1500): 80-05-xx-00 or higher - HM800 (VSP Gx00) : 83-01-xx-00 or higher - HM850 (VSP Gx00 and VSP Fx00): 88-01-xx-00 or higher 3. Installation on the AIX System < Installation > To install the new version of HTC_ODM updates for AIX: (1) Log-in as superuser (2) Mount the CD-ROM (3) Copy HTCODM3.tar file into AIX directly(/usr/sys/inst.images): # cp HTCODM3.tar /usr/sys/inst.images (4) Extract HTCODM3.tar # cd /usr/sys/inst.images # tar xvf HTCODM3.tar (5) Four of HTC_ODM packages(HTC_FC_ODM_5001I and HTC_FC_ODM_5005U and HTC_FC_ODM_50521U and HTC_FC_ODM_50522U and HTC_FC_ODM_50523U) 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 Software. (10) You will be prompted for an input device. Enter the directory whether the fileset was copied. (11) Select F4 to list the available installation packages. (12) Select F7 to select both "5.0.0.1 AIX Support for Hitachi Disk Arrays" and "5.0.0.5 AIX Support for Hitachi Disk Arrays(Update)" and "5.0.52.1 AIX Support for Hitachi Disk Arrays(Update)" and "5.0.52.2 AIX Support for Hitachi Disk Arrays(Update)" and "5.0.52.3 AIX Support for Hitachi Disk Arrays(Update)" and then select Enter (Note) In case that some packages are already installed, select the necessary package only. For example, when Hitachi.aix.support.rte 5.0.0.5 or 5.0.1.4 is installed, "5.0.52.1 AIX Support for Hitachi Disk Arrays(Update)" is necessary to be selected. (13) Select Enter to start the installation process (14) If necessary, remove any Hitachi 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) Reboot AIX. (16) Confirm that the parameters have the following values: # lsattr -E -l hdisk(n) pvid *** queue_depth 2 q_type simple q_err yes clr_q no rw_timeout 60 start_timeout 60 reassign_timeout 120 reserve_policy single_path (17) If the value is changed by applying HTC_ODM, change the value after committing HTC_ODM if necessary. For example, if the queue_depth was set to 4, the chdev command will have to be run to change it back for all hdisks. [Note] As for Queue Depth and rw timeout value, the default IBM rw timeout and queue depth value are different from the recommended values for Hitachi devices. Contact Hitachi for more information on the recommended queue depth value. < Uninstallation > (1) Remove all Hitachi 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 (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 Hitachi (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) Reboot AIX. [Caution] (1) When sharing ports on Hitachi Disk Array with multiple AIX servers, all servers must be at the same HTC ODM level. (2) The AIX support non-MPIO ODM update(HTC_ODM) and the MPIO ODM update(HTC_MPIO_ODM) can not co-exist on the same server. (3) The AIX support non-MPIO ODM update(HTC_ODM) and the devices.fcp.sanrise fileset can not co-exist on the same server. (4) The AIX support fileset must be committed. If it is applied and then rejected, the ODM update level is 5.0.0.4. This may have unexpected results if the AIX support fileset 5.0.1.4 or 5.0.0.5 is installed. [Note] There are various possible implemenations of SAN boot with AIX. (1) To implement SAN boot on a system with an already installed AIX operating system, you can: a. Use the alt_disk_install system utility. b. Do this by mirroring of the rootvg volume to the SAN disk. (2)To implement SAN boot for a new system, you can: a. Start the AIX installation from a bootable AIX CD install package. b. Or, use the Network Installation Manager (NIM). The methods known as Alt_disk_install or mirroring are simpler