IBM XIV Host Attachment Kit for AIX Version 1.8.0 Release Notes
First Edition (March 2012) This document edition applies to Version 1.8.0 of the IBM IBM XIV Host Attachment Kit for AIX software package. Newer document editions may be used for the same product version in order to add missing information or amend typographical errors. The edition is reset to "First Edition" for every new product version. Copyright IBM Corporation 2009, 2012. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents Overview................................... 1 Download site................................... 1 Compatibility and requirements............................. 1 Supported AIX versions.............................. 1 Supported XIV storage systems............................ 2 Supported HBAs................................. 2 Supported multipath I/O solutions........................... 2 Required software on the host............................ 2 Change log.................................... 2 Version 1.8.0 (March 2012).............................. 2 Version 1.7.1 (December 2011)............................ 3 Version 1.7.0 (September 2011)............................ 3 Version 1.6.0 (May 2011).............................. 3 Version 1.5.2 (April 2010).............................. 4 Known issues................................... 5 Related information and publications........................... 6 Getting information, help, and service........................... 6 Documentation format................................ 6 Notices.................................... 7 Trademarks.................................... 9 Copyright IBM Corp. 2009, 2012 iii
iv IBM XIV Host Attachment Kit for AIX
Overview The IBM XIV Host Attachment Kit (HAK) for AIX is a software pack that simplifies the task of connecting an IBM AIX host to the IBM XIV Storage System. The HAK provides a set of command line interface (CLI) tools that help host administrators perform different host-side tasks, such as: detect any physically connected XIV storage system (single system or multiple systems), detect XIV volumes, define the host on the XIV storage system, run diagnostics, and apply best practice native multipath connectivity configuration on the host. Download site This section describes download site information. The IBM XIV Host Attachment Kit for AIX is available for download from the IBM Fix Central website at the following web address: http://www.ibm.com/support/ fixcentral. Compatibility and requirements The IBM XIV Host Attachment Kit for AIX is compatible with different versions of the AIX operating system and the XIV storage system, as well as with different HBAs and multipath solutions. Certain software packages, patches, or drivers must be installed on the host, as detailed in the following subsections. Note: This section applies to version 1.8.0. For information about the compatibility and requirements of a previous host attachment kit version, refer to its relevant release notes. Supported AIX versions The IBM XIV Host Attachment Kit for AIX can be used with the following AIX versions and editions. Operating system Edition Architecture Compatibility note AIX 5.3 AIX 6.1 TL07, TL08, TL09, TL10, TL11, TL12 TL00, TL01, TL02, TL03, TL04, TL05, TL06, TL07 IBM System p, IBM Power Systems IBM System p, IBM Power Systems AIX 7.1 TL00, TL01 IBM System p, IBM Power Systems TL11 requires one of the following: v XIV-provided efix* v Service Pack 2 TL04 requires one of the following: v XIV-provided efix* v Service Pack 2 You can download all AIX efixes from the following FTP address: ftp://ftp.software.ibm.com/aix/efixes. Copyright IBM Corp. 2009, 2012 1
Supported XIV storage systems The IBM XIV Host Attachment Kit for AIX supports different microcode versions of the IBM XIV Storage System, as listed in the following table. This table describes supported XIV storage systems. Storage system Microcode version Compatibility note IBM XIV Storage System 10.1.x N/A 10.2.x N/A 11.0.x N/A 11.1.x N/A Supported HBAs The IBM XIV Host Attachment Kit for AIX supports different host bus adapter (HBA) brands and types. For the latest support information and compatibility matrix, see the IBM System Storage Interoperability Center at the following web address: http://www.ibm.com/systems/support/storage/config/ssic. Note: For best performance, install the latest firmware and drivers for the HBAs that are in use. The HBA vendor should provide the latest firmware and drivers. Attention: The IBM XIV Host Attachment Kit for AIX does not support iscsi connectivity. Only Fibre Channel (FC) is supported. Supported multipath I/O solutions The IBM XIV Host Attachment Kit for AIX supports the following multipath solutions: v Native multipath I/O (MPIO) v Veritas Dynamic Multipathing (DMP) 5.0 v IBM Virtual I/O Server (VIOS) 2.1.x, 2.2.0 Required software on the host Prior to installing the IBM XIV Host Attachment Kit for AIX, the bos.adt.libm package must be installed on the host. For more information, refer to the IBM Fileset information on the following web address: https://www-304.ibm.com/ support/docview.wss?uid=isg1fileset-1318926131 Change log This section summarizes the changes made in different version releases of the IBM XIV Host Attachment Kit for AIX. Version 1.8.0 (March 2012) Version 1.8.0 includes the following enhancements and fixes: HA-170070 HA-172254 Fixed: xiv_devlist does not display LUN numbers. Fixed: In some cases, xiv_devlist -o returns an exception error on AIX 7.1. 2 IBM XIV Host Attachment Kit for AIX
HA-209965 Fixed: When using xiv_devlist on AIX 6.1, Vertias multipath devices appear to have only one path. * Applies to all supported operating systems. Version 1.7.1 (December 2011) Version 1.7.1 included the following fixes: HA-163382* Fixed: An exception occurs when trying to define the host on the XIV storage system with incorrect XIV credentials. HA-166443 Fixed: xiv_attach may fail and display the following error message: NameError: global name 'shutil' is not defined * Applies to all supported operating systems. Version 1.7.0 (September 2011) Version 1.7.0 added support for the XIV Gen3 hardware configuration and for version 11.0 of the IBM XIV microcode. In addition, version 1.7.0 included the following enhancements and changes: HA-159503* Enhancement: Portable HAK Instead of installing the HAK locally on each host, it can be used from a mounted network drive or a portable USB flash drive. For more information, refer to the user guide. HA-121647* Change: The IBM Storage Solutions External Runtime Components (previously named "XPyV") are now integrated within the HAK code, rather than installed separately. * Applies to all supported operating systems. Version 1.6.0 (May 2011) Version 1.6.0 included the following enhancements and fixes: HA-18616* HA-22130* HA-24970* HA-26338* HA-13610 HA-18046* HA-21456* Enhancement: xiv_diag now provides the HAK version number when used with the --version argument. Enhancement: More information is collected with the xiv_diag command. Enhancement: xiv_devlist can display LUN sizes in different capacity units, by using the u or --size-unit argument. Enhancement: The xiv_devlist output can be saved to a file in CSV or XML format, by adding the f or --file argument. Fixed: The xiv_diag command does not remove a temporary directory that it creates. Fixed: Erroneous text message prompted by the xiv_attach command. Fixed: Redirecting the xiv_devlist output results in a broken pipe error. Overview 3
HA-22470* HA-23250* HA-26601* Fixed: In some cases, the xiv_devlist output shows "N/A" instead of the actual volume size. Fixed: xiv_attach crashes when a user who is not defined as a storage admin (user type) tries to define a host. Fixed: xiv_devlist may cause a few non-ibm RAID controllers to lose a disk due to incorrect SCSI Test-Unit-Ready parsing. HA-62263* Fixed: Entering an invalid username or password results in a wrong error message. * Applies to all supported operating systems. Version 1.5.2 (April 2010) Version 1.5.2 included the following enhancements, changes, and fixes: HA-9887* Enhancement: Additions and changes to the xiv_devlist command. v Added command-line arguments: -t xml provides a new XML output format --hex changes the machine ID from decimal to hexadecimal base -o adds all available fields to the table --xiv lists only the XIV devices -d writes debugging information to a file v v v Wide-terminal-aware table output. If the terminal width is long enough, each row in the table is printed on a single line. Alternatively, if the terminal width is shorter than needed, the columns are wrapped where necessary. Changed the machine ID format to decimal base. Added verification that the user is running with root/administrator permissions. HA-13124 Fixed: During installation, the disk.fcp.2810 package is not automatically upgraded by the install.sh script. HA-11339 Fixed: The xiv_devlist tool does not sort the devices numerically in the output table. HA-100192 Fixed: The xiv_devlist command crashes when previously detected XIV devices are removed. HA-100197 Fixed: xiv_devlist command shows malfunctioned disks. HA-100202 Fixed: xiv_devlist creates a data directory that is not automatically deleted when the process is completed. * Applies to all supported operating systems. 4 IBM XIV Host Attachment Kit for AIX
Known issues This section details the known issues in version 1.8.0, along with possible workarounds (if workarounds are available). HA-101673 AIX does not recognize the LUN0 controller on the XIV storage system. Because the LUN0 controller is not recognized on AIX: v xiv_attach configures the host locally, without defining the host on the XIV storage system. v xiv_fc_admin -L returns an empty list. v xiv_syslist returns the message: No LUN0 XIV devices were detected. Currently there is no workaround for this limitation (HA-101673). HA-17383 AIX with native XIV ODM does not support SCSI-persistent reservations. Upgrading to a release of AIX that has native ODM results in SCSI reservation problems in clusters. To resolve this, add the correct ODM entries into the native AIX ODM. HA-19873 When using xiv_devlist, a volume that is reserved by another host appears as an unreachable device. Currently there is no workaround for this limitation (HA-19873). HA-28242 The cfgmgr and rescan options may display a message stating that the devices.fcp array package is not found. If you receive this message, map the LUN0 volume and then retry the command. Return to the working volumes afterwards. HA-65405 xiv_attach shows Unknown type for the Hitachi HBA driver. Currently there is no workaround for this limitation (HA-65405). HA-101034 After a volume is remapped to a different logical unit number (LUN), xiv_devlist erroneously displays double the amount of available paths for the volume. Currently there is no workaround for this limitation (HA-101034). HA-209680 When using the Veritas multipathing framework, xiv_devlist displays the native device names of newly mapped volumes. To resolve this issue, run the Veritas device rescan command: vxdctl enable HA-230326 If the OS boots from SAN and volumes are mapped to the host, running xiv_devlist after an FC target (WWPN) or its initiator is removed from the FC zoning causes the host to hang. Currently there is no workaround for this limitation (HA-230326). Overview 5
Related information and publications You can find additional information and publications related to the IBM XIV Host Attachment Kit for AIX on the following web addresses. v v v v IBM XIV Host Attachment Kit Host Attachment Guide, available under Publications on the IBM XIV Storage System Information Center: http://publib.boulder.ibm.com/infocenter/ibmxiv/r2 IBM XIV Storage System Product Overview, Planning Guide, available under Publications on the IBM XIV Storage System Information Center (see the previous web address). IBM Power Systems software website for AIX: http://www.ibm.com/systems/ power/software/aix IBM System p website: http://www.ibm.com/systems/p Getting information, help, and service Documentation format If you need help, service, technical assistance, or want more information about IBM products, you can find various sources to assist you. You can view the following websites to get information about IBM products and services and to find the latest technical information and support. v IBM website (ibm.com ) v IBM Support Portal website (www.ibm.com/storage/support) v IBM Directory of Worldwide Contacts website (www.ibm.com/planetwide) The publications for this product are in Adobe Portable Document Format (PDF) and should be compliant with accessibility standards. If you experience difficulties when you use the PDF files and want to request a web-based format or accessible PDF document for a publication, send a request by e-mail to starpubs@us.ibm.com. In the request, be sure to include the IBM publication number and title. Note: When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. 6 IBM XIV Host Attachment Kit for AIX
Notices These legal notices pertain to IBM Storage Host Software Solutions product documentation. This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Copyright IBM Corp. 2009, 2012 7
Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Attn: Office of Legal Counsel 650 Harry Road San Jose, CA 95120-6099 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. 8 IBM XIV Host Attachment Kit for AIX
Trademarks IBM, the IBM logo, ibm.com, AIX, and the AIX logo are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Copyright and trademark information website: http://www.ibm.com/legal/us/en/copytrade.shtml UNIX is a registered trademark of The Open Group in the United States and other countries. Veritas is a trademark or registered trademark of Symantec Corporation in the United States and other countries. Other product and service names might be trademarks of IBM or other companies. Notices 9
10 IBM XIV Host Attachment Kit for AIX
Printed in USA