Documente Academic
Documente Profesional
Documente Cultură
Version 1.9.0
Release Notes
First Edition (June 2012) This document edition applies to Version 1.9.0 of the IBM XIV Host Attachment Kit for Windows 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
Compatibility and requirements . . . Supported Windows Server versions Supported XIV storage systems . . Supported HBAs . . . . . . . Supported multipath I/O solutions . Required software on the host . . Change log . . . . . . . . . . Version 1.9.0 (June 2012) . . . . Version 1.8.0 (March 2012) . . . . Version 1.7.1 (December 2011) . . Version 1.7.0 (September 2011) . . Version 1.6.0 (May 2011) . . . . Version 1.5.3 (February 2011) . . . Version 1.5.2 (April 2010) . . . . Version 1.5.1 (December 2009) . . Version 1.5.0 (November 2009) . . Known issues . . . . . . . . . Related information and publications . Getting information, help, and service Documentation format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 . 1 . 1 . 2 . 2 . 2 . 3 . 3 . 4 . 4 . 5 . 6 . 7 . 7 . 7 . 7 . 9 . 10 . 11 . 11
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
iii
Overview
The IBM XIV Host Attachment Kit (HAK) for Windows is a software pack that simplifies the task of connecting a Microsoft Windows Server 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 an array), detect XIV volumes, define the host on the XIV storage system, run diagnostics, and apply best practice native multipath connectivity configuration on the host. You can download the IBM XIV Host Attachment Kit software package at any time from the IBM Fix Central website at: www.ibm.com/support/fixcentral
* Refer to Required software on the host on page 2 for information about required OS updates.
Supported HBAs
The IBM XIV Host Attachment Kit for Windows supports different host bus adapter (HBA) brands and types. For the latest support information and compatibility matrix, see the IBM System Storage Interoperation Center website at: 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.
Required components that must be installed manually v Microsoft iSCSI Software Initiator if iSCSI is used. v Microsoft Hotfix KB950903 v Microsoft Hotfix set* KB923830 if Windows Clustering is used.
Service Pack 2
v Microsoft Hotfix KB957910 v Microsoft Hotfix set* KB935640 if Windows Clustering is used.
v Microsoft Multipath I/O Framework (enable from the Server Manager applet). v Microsoft Hotfix set* KB957311 if Windows Clustering is used.
v Microsoft Hotfix KB979743 v Microsoft Hotfix KB981379 v Microsoft Hotfix KB983554 v Microsoft Hotfix KB2522766 v Microsoft Hotfix KB979711 v Microsoft Hotfix KB981208 v Microsoft Hotfix KB2460971 v Microsoft Hotfix KB2522766 v Microsoft Hotfix KB2460971 v Microsoft Hotfix KB2522766
None
v Microsoft Multipath I/O Framework (enable from the Server Manager applet). v Microsoft Hotfix set* KB980054 if Windows Clustering is used.
Service Pack 1
v Microsoft Hotfix set* KB2468345 v Microsoft Hotfix set* KB2545685 if Windows Clustering is used.
* Includes more than one hotfix. Refer to the Microsoft KB article on the provided link.
Note: Refer to Known issues on page 9 for information about any additional Microsoft Hotfix that you may need to install in order to solve any specific issue that you might encounter.
Change log
This section summarizes the changes made in different version releases of the IBM XIV Host Attachment Kit for Windows.
HA-233433* HA-233781
Overview
Change: xiv_attach, xiv_fc_admin, and xiv_iscsi_admin now provide a warning and then exit when the minimal operating system or service pack version requirements are not met. For more information about these requirements, refer to Compatibility and requirements on page 1. Fixed: xiv_attach or xiv_detach may crash if the PATH variable is longer than 380 characters. Fixed: On Windows Server 2008 and Windows Server 2008 R2, xiv_diag does not retrieve the installed Microsoft hotfixes list. Fixed: If the portable HAK is extracted to the Windows desktop, its path might be too long. Fixed: xiv_attach may crash when the ProductName registry key under HKCR\installer\products does not contain a value.
HA-96378 HA-162245
Fixed: iSCSI connectivity fails when using CHAP authentication with XIV systems of microcode 10.2.4.x or 11.0.x. Fixed: The portable HAK fails and gives no indication regarding the failure if the Microsoft Visual C++ 2008 Redistributable Package is not installed on the host. Fixed: An exception occurs when trying to define the host on the XIV storage system with incorrect XIV credentials. Fixed: Errors occur when running xiv_diag on non-English locales of Windows Server 2008 R2. Fixed: xiv_attach fails to detect an already configured host and performs a redundant re-configuration. Fixed: If the potable HAK runs from an unmapped network share, xiv_attach does not install the XIV LUN0 driver.
Overview
HA-157159
Fixed: The silent installation option (/q) does not work. For more information about this option, refer to the user guide.
HA-18046* HA-18292 HA-18898 HA-21456* HA-21695 HA-22419 HA-22470* HA-23250* HA-25290 HA-26636 HA-30433 HA-56896
HA-62263* HA-119450
Fixed: Entering an invalid username or password results in a wrong error message. Fixed: xiv_attach fails when using Emulex HBA drivers that contain a dash in the version number.
Overview
HA-4111
Enhancement: Reducing the number of reboots during installation. The installation package automatically installs hotfixes for Windows Server. The Multipath I/O feature is installed on Windows Server 2008 or Windows Server 2008 R2. As a result, only one reboot is required for installing and configuring the host.
HA-6151*
Enhancement: Added the --version command argument. The --version command argument was added to the xiv_fc_admin and xiv_iscsi_admin commands. In addition, xiv_attach displays the HAK version in the Welcome banner.
HA-6565*
Enhancement: Support for iSCSI connectivity with CHAP authentication. The Host Attachment Kit supports attaching hosts for XIV systems using iSCSI with CHAP authentication. The xiv_iscsi_admin and xiv_attach commands are CHAP aware.
HA-6708*
Enhancement: Colored output for host attachment binaries. Colored output added to the following commands: v xiv_attach v xiv_iscsi_admin v xiv_fc_admin v xiv_devlist v xiv_diag
HA-9877*
Enhancement: Listing attached XIV systems. The xiv_attach, xiv_iscsi_admin and xiv_fc_admin commands display the attached XIV systems along with basic connectivity information.
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-only lists only the XIV devices -d writes debugging information to a file 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. v Changed the machine ID format to decimal base. v Added verification that the user is running with root/administrator permissions.
HA-10204
Enhancement: Added a new multipathing agent. The new multipathing agent monitors the health state of all multipath devices (XIV and non XIV), reports events to the Windows Event Log, and accepts connections from the XIV MPIO GUI.
HA-6956*
Change: Restructured host attachment tree. The host attachment tree was restructured so that it will be consistent across all operating systems.
HA-9893
Change: The multipath configuration is not removed or rolled-back during uninstallation. xiv_detach allows you to remove the multipath configuration before uninstalling the Host Attachment Kit.
Fixed: Runner wrapper crashes due to Python path issues. Fixed: MSCS failover issues. Fixed: xiv_devlist may show XIV devices as non-XIV devices.
Known issues
This section details the known issues in version 1.9.0, along with possible workarounds (if workarounds are available). HA-100800 Mapping the LUN0 volume causes errors. Due to the distinctive properties of the XIV LUN0 volume (on any storage pool), mapping it to the host causes numerous errors or performance problems. Accordingly, mapping the LUN0 volume is not recommended. HA-6459 When using the VMware Raw Device Mapping (RDM), xiv_devlist and the multipath management agent erroneously report that Windows has only one path to the disk. Currently there is no workaround for this limitation (HA-6459). HA-9894 Windows Server 2003 failure with stop error: 0x000000D1 DRIVER_IRQL_NOT_LESS_OR_EQUAL To resolve this issue, download and install Microsoft Hotfix KB945119. HA-9895 Windows Server 2003 Service Pack 2 failure with stop error: 0x0000009C MACHINE_CHECK_EXCEPTION To resolve this issue, download and install Microsoft Hotfix KB939315.
Overview
HA-100946
When running xiv_attach, xiv_fc_admin, or xiv_iscsi_admin for the first and second time (during the initial host configuration) on x64-based Windows Server 2008, two reboots are required. This occurs due to the automatic installation of two Microsoft hotfixes. Currently there is no workaround for this limitation (HA-100946).
HA-163121
An error occurs when using the \h (help) argument with the HAK installation command in the Windows command prompt. Currently there is no workaround for this limitation (HA-163121).
HA-171418
On Windows Server 2003, xiv_diag triggers an error exception when LUN number 252 is mapped. To avoid this issue, do not map volumes to LUN number 252 if Windows Server 2003 is used.
HA-206774
xiv_attach fails to connect to XIV systems of microcode version 10.2.2.a or older over iSCSI with CHAP authentication. Currently there is no workaround for this limitation (HA-206774).
HA-213964
When using the HAK from Windows PowerShell, the -o command argument (used with xiv_devlist and xiv_syslist) does not work with more than one parameter. To avoid this issue, use single quotes to enclose all the parameter names. For example: xiv_devlist -o device,size
HA-230235
When using the portable HAK from a shared network drive while the host uses iSCSI connectivity with the XIV storage system, xiv_attach causes iSCSI-connected volumes to become undetectable, and the host stops responding to all iSCSI operations. If you have already encountered this issue, perform the following workaround: 1. Copy the portable HAK folder from the network drive to a local directory on the host. 2. Run xiv_detach. 3. Run xiv_attach.
10
v Microsoft Windows Server TechCenter: http://technet.microsoft.com/en-us/library/bb625087.aspx v Microsoft TechNet overview page for Multipath I/O (MPIO): http://technet.microsoft.com/en-us/library/cc725907.aspx
Documentation format
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.
Overview
11
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.
13
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.
14
Trademarks
IBM, the IBM logo, and ibm.com 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 Microsoft, Windows Server, Windows, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States, other countries, or both. 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
15
Printed in USA