IBM XIV Host Attachment Kit for Windows Version Release Notes

IBM XIV Host Attachment Kit for Windows Version 2.1.0.1 Release Notes

First Edition (August 2013) This document edition applies to Version 2.1.0.1 of the IBM XIV Host Attachment Kit for Windows software package. Newer document editions may be issued for the same product ersion in order to add missing information or amend typographical errors. The edition is reset to "First Edition" for eery new product ersion. Copyright IBM Corporation 2009, 2013. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Oeriew................................... 1 Compatibility and requirements............................. 1 Supported Windows Serer ersions.......................... 1 Supported XIV storage systems............................ 1 Supported HBAs................................. 2 Supported multipath I/O solutions........................... 2 Required software on the host............................ 2 Change log.................................... 4 Version 2.1.0.1 (August 2013)............................. 4 Version 2.1.0 (June 2013).............................. 4 Version 2.0.0 (March 2013).............................. 5 Version 1.10.0 (September 2012)............................ 5 Version 1.9.0 (June 2012).............................. 6 Version 1.8.0 (March 2012).............................. 6 Version 1.7.1 (December 2011)............................ 7 Version 1.7.0 (September 2011)............................ 8 Version 1.6.0 (May 2011).............................. 8 Version 1.5.3 (February 2011)............................ 10 Version 1.5.2 (April 2010).............................. 10 Version 1.5.1 (December 2009)............................ 10 Version 1.5.0 (Noember 2009)............................ 10 Known issues................................... 13 Related information and publications........................... 15 Getting information, help, and serice.......................... 16 Notices................................... 17 Trademarks................................... 19 Copyright IBM Corp. 2009, 2013 iii

i IBM XIV Host Attachment Kit for Windows

Oeriew The IBM XIV Host Attachment Kit (HAK) for Windows is a software pack that simplifies the task of connecting a Microsoft Windows Serer host to the IBM XIV Storage System. The HAK proides 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 olumes, define the host on the XIV storage system, run diagnostics, and apply best practice natie multipath connectiity configuration on the host. You can download the IBM XIV Host Attachment Kit software package at any time from the IBM Fix Central website (www.ibm.com/support/fixcentral). Compatibility and requirements The IBM XIV Host Attachment Kit for Windows is compatible with different ersions of the Windows Serer operating system and the XIV storage system, as well as with different HBAs and multipath solutions. Certain software packages, patches, or driers must be installed on the host, as detailed in the following subsections. Note: This section applies to ersion 2.1.0.1. For information about the compatibility and requirements of a preious Host Attachment Kit ersion, refer to its releant release notes. Supported Windows Serer ersions The IBM XIV Host Attachment Kit for Windows supports different Windows Serer ersions, serice packs, or editions, as listed in the following table. Operating system Serice Pack Architecture Microsoft Windows Serer 2003* SP1, SP2 x86, x64 Microsoft Windows Serer 2003 R2* SP1, SP2 x64 Microsoft Windows Serer 2008* SP1, SP2 x86, x64 Microsoft Windows Serer 2008 R2* None, SP1 x64 Microsoft Windows Serer 2012* None x64 * Refer to Required software on the host on page 2 for information about required OS updates. Supported XIV storage systems The IBM XIV Host Attachment Kit for Windows supports different microcode ersions of the IBM XIV Storage System, as listed in the following table. Copyright IBM Corp. 2009, 2013 1

Storage system IBM XIV Storage System Microcode ersion 10.2.x 11.0.x, 11.1.x, 11.2.x, 11.3.0 Note: Newer microcode ersions may also be compatible. Refer to the latest XIV storage system release notes when a new XIV microcode ersion becomes aailable. You can obtain the latest XIV storage system release notes on the IBM XIV Storage System Information Center (publib.boulder.ibm.com/infocenter/ ibmxi/r2). 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 (www.ibm.com/systems/support/storage/ config/ssic). For best performance, install the latest firmware and driers for the HBAs that are in use. The HBA endor should proide the latest firmware and driers. Important: For iscsi connectiity, only iscsi initiators are supported. Hardware iscsi HBAs are not supported. Supported multipath I/O solutions The IBM XIV Host Attachment Kit for Windows supports the following multipath solutions: Natie multipath I/O (MPIO) and Microsoft DSM (MSDSM) supported only on Windows Serer 2012, Windows Serer 2008, and Windows Serer 2008 R2; installed from the Serer Manager. Veritas Dynamic Multipathing (DMP) 5.0 or 5.1 (including natie support for XIV in Veritas Storage Foundation 5.1) Important: For proper Actie/Actie multipathing using Veritas Dynamic Multipathing 5.0, install the Symantec Array Support Library for IBM XIV, which can be downloaded from the Symantec website (www.symantec.com/business/ support/index?page=content&id=tech77828). Required software on the host Prior to installing the IBM XIV Host Attachment Kit for Windows and depending on the installed Windows Serer ersion, specific operating system updates must be installed on the host. These updates are required for error-free functionality. The following table lists the required and automatically installed hotfixes in each case. 2 IBM XIV Host Attachment Kit for Windows

Important: The following table contains information that is known at the time of the General Aailability (GA) date. Newer or additional hotfixes may be required in distinct cases or in particular production enironments. Contact IBM XIV Support if you encounter errors or difficulties. Although the Host Attachment Kit automatically installs certain Microsoft hotfixes for Windows Serer, you should always ensure that the most updated and releant hotfixes are installed manually in addition to the bundled hotfixes. You can find any releant hotfix and download it from the Microsoft Support website (support.microsoft.com). Always refer to the Microsoft documentation (KB article) of any hotfix or set of hotfixes that your system requires. Operating system Windows Serer 2003 or Windows Serer 2003 R2 Serice pack Required components that must be installed manually Serice Pack 1 Microsoft iscsi Software Initiator if iscsi is used. Microsoft Hotfix KB950903 (support.microsoft.com/kb/950903) Microsoft Hotfix set* KB923830 (support.microsoft.com/kb/923830) if Windows Clustering is used. Serice Pack 2 Microsoft Hotfix KB957910 (support.microsoft.com/kb/957910) Microsoft Hotfix set* KB935640 (support.microsoft.com/kb/935640) if Windows Clustering is used. Microsoft Hotfix KB982109 (support.microsoft.com/kb/982109) Automatically installed Microsoft Hotfix KB932755 (support.microsoft.com/kb/ 932755) (Storport drier) Windows Serer 2008 Serice Pack 1 or later Microsoft Multipath I/O Framework (enable from the Serer Manager applet). Microsoft Hotfix set* KB957311 (support.microsoft.com/kb/957311) if Windows Clustering is used. Microsoft Hotfix KB979743 (support.microsoft.com/kb/ 979743) Microsoft Hotfix KB981379 (support.microsoft.com/kb/ 981379) Microsoft Hotfix KB983554 (support.microsoft.com/kb/ 983554) Microsoft Hotfix KB2522766 (support.microsoft.com/kb/ 2522766) Oeriew 3

Operating system Serice pack Required components that must be installed manually Automatically installed Windows Serer 2008 R2 None Microsoft Multipath I/O Framework (enable from the Serer Manager applet). Microsoft Hotfix set* KB980054 (support.microsoft.com/kb/980054) if Windows Clustering is used. Microsoft Hotfix KB979711 (support.microsoft.com/kb/ 979711) Microsoft Hotfix KB981208 (support.microsoft.com/kb/ 981208) Microsoft Hotfix KB2460971 (support.microsoft.com/kb/ 2460971) Microsoft Hotfix KB2522766 () Serice Pack 1 Microsoft Hotfix set* KB2468345 (support.microsoft.com/kb/2468345) Microsoft Hotfix set* KB2545685 (support.microsoft.com/kb/2545685) if Windows Clustering is used. Windows Serer 2012 None None None * Includes more than one hotfix. Refer to the Microsoft KB article on the proided link. Microsoft Hotfix KB2460971 (support.microsoft.com/kb/ 2460971) Microsoft Hotfix KB2522766 (support.microsoft.com/kb/ 2522766) Note: Refer to Known issues on page 13 for information about any additional Microsoft Hotfix that you may need to install in order to sole any specific issue that you might encounter. Change log This section summarizes the changes made in different ersion releases of the IBM XIV Host Attachment Kit for Windows. Version 2.1.0.1 (August 2013) Version 2.1.0.1 includes the following hotfix and change. Ticket ID HA-261196 Fixed: In some cases, a general error (type 'exceptions.attributeerror') might occur if xi_delist, xi_attach, xi_fc_admin, orxi_iscsi_admin is used when the online olume migration (IBM Hyper-Scale Mobility feature) is in Proxy state. HA-261181* Change: Inthexi_delist output, "OLVM State" was renamed to "Hyper-Scale Mobility". * Applies to all supported operating systems. Version 2.1.0 (June 2013) Version 2.1.0 added support for ersion 11.3.0 of XIV microcode and for the IBM Hyper-Scale Mobility (online olume migration) feature. Additional changes in ersion 2.1.0: 4 IBM XIV Host Attachment Kit for Windows

Ticket ID HA-231357* HA-253044* HA-256729* HA-258614 HA-261126* Enhancement: The --no-headers argument can be used with the xi_delist -t cs and xi_syslist -t cs commands to generate CSV output without column headers. Enhancement: An additional step in the xi_attach procedure allows scheduling a task for running the Host Profiler utility on the host. For more information, refer to the user guide. Fixed: In some cases, the xi_host_profiler --analyze command might generate notices that are unrelated to the host processor architecture. Fixed: In some cases, xi_syslist might exit with the error message: HBA API Library found no adapters. Fixed: xi_delist might exit with error messages when running on a host connected to a storage deice other than the XIV storage system. HA-8442* Fixed: xi_host_profiler and xi_syslist might exit with error messages when running on a host connected to a storage deice other than the XIV storage system. * Applies to all supported operating systems. Version 2.0.0 (March 2013) Version 2.0.0 included the following enhancements and fixes. Ticket ID HA-26055* HA-242098 HA-249721 HA-250135 Enhancement: A new host diagnostics utility, Host Profiler (xi_host_profiler), is now aailable. The utility collects comprehensie host configuration information, creates a profile based on this information, and allows detailed analysis of the collected information. For more information, refer to the Diagnostics chapter in the IBM XIV Host Attachment Guide. Note: The Host Profiler utility is compatible only with XIV microcode ersion 11.2 or later. Fixed: In some rare cases, HAK utilities might crash with a pywintypes.error error message. Fixed: xi_syslist might not detect all FC connections to an XIV system if the default FC initiator port number has been modified on that XIV system. Fixed: xi_diag might fail when collecting the list of all installed Windows hotfixes if a large number of Windows updates are installed on the host. * Applies to all supported operating systems. Version 1.10.0 (September 2012) Version 1.10.0 added support for Microsoft Windows Serer 2012, and includes the following enhancements and fixes. Oeriew 5

Ticket ID HA-239303 Enhancement: The HAK installer for Windows allows you to select Japanese as the language of the installation wizard. HA-236858* Fixed: xi_delist does not display the correct size of olumes that are larger than 2.2 TB. * Applies to all supported operating systems. Version 1.9.0 (June 2012) Version 1.9.0 included the following enhancements and fixes. Ticket ID HA-73943* Enhancement: The --path optional argument is now aailable for the xi_diag command, allowing one-step definition of the directory into which the report file should be generated. For more information, refer to the user guide. HA-233433* Fixed: In some cases, xi_syslist may fail with a general error prompt (ValueError exception). HA-233781 Fixed: After upgrading the HAK, xi_detach fails and returns an error message: Unable to uninstall the LUN0 drier. The Windows Installer return code is 1605. * Applies to all supported operating systems. Version 1.8.0 (March 2012) Version 1.8.0 included the following enhancements, changes, and fixes. Ticket ID HA-179589* HA-172829 HA-163115 Enhancement: A new utility, xi_syslist, has been added to the IBM XIV Host Attachment Kit in order to proide broader and more customized information than the output of the xi_fc_admin -L and xi_iscsi_admin -L commands. Using the xi_syslist command and its optional arguments, users can iew different details of all XIV storage systems that are connected to the host. For more information, refer to the IBM XIV Host Attachment Guide. Change: Microsoft Hotfix KB2522766 (see Required software on the host on page 2) is now automatically installed on Windows Serer 2008 or Windows Serer 2008 R2 when running xi_attach for the first time on the host. Attention: The installation of the KB2522766 hotfix may require a reboot. Change: xi_attach, xi_fc_admin, and xi_iscsi_admin now proide a warning and then exit when the minimal operating system or serice pack ersion requirements are not met. For more information about these requirements, refer to Compatibility and requirements on page 1. 6 IBM XIV Host Attachment Kit for Windows

Ticket ID HA-168483 Fixed: xi_attach or xi_detach may crash if the PATH ariable is longer than 380 characters. HA-169980 Fixed: On Windows Serer 2008 and Windows Serer 2008 R2, xi_diag does not retriee the installed Microsoft hotfixes list. HA-170632 Fixed: If the portable HAK is extracted to the Windows desktop, its path might be too long. HA-198356 Fixed: xi_attach may crash when the ProductName registry key under HKCR\installer\products does not contain a alue. * Applies to all supported operating systems. Version 1.7.1 (December 2011) Version 1.7.1 included the following enhancements and fixes. Ticket ID HA-12785 Enhancement: Detailed command information can be displayed with a new erbosity argument. HA-96281 HA-19994 HA-96378 HA-162245 You can display detailed information regarding a HAK command by using the --erbose or -i argument. For more information about this new argument, refer to the IBM XIV Host Attachment Guide. Enhancement: The HAK tries to erify and install Windows hotfixes more than once. Fixed: Unclear error message is displayed when trying to install the 32-bit HAK ersion on a 64-bit ersion of Windows. Fixed: iscsi connectiity fails when using CHAP authentication with XIV systems of microcode 10.2.4.x or 11.0.x. Fixed: The portable HAK fails and gies no indication regarding the failure if the Microsoft Visual C++ 2008 Redistributable Package is not installed on the host. HA-163382* Fixed: An exception occurs when trying to define the host on the XIV storage system with incorrect XIV credentials. HA-163718 Fixed: Errors occur when running xi_diag on non-english locales of Windows Serer 2008 R2. HA-167347 Fixed: xi_attach fails to detect an already configured host and performs a redundant reconfiguration. HA-170087 Fixed: If the potable HAK runs from an unmapped network share, xi_attach does not install the XIV LUN0 drier. * Applies to all supported operating systems. Oeriew 7

Version 1.7.0 (September 2011) Version 1.7.0 added support for the XIV Gen3 hardware configuration and for ersion 11.0 of the IBM XIV microcode. Ticket ID HA-159503* HA-23373* Enhancement: Portable HAK. Instead of installing the HAK locally on each host, it can be used from a mounted network drie or from a portable USB flash drie. For more information about this enhancement, refer to the user guide. Enhancement: xi_fc_admin -L now displays all four leels of the XIV microcode ersion number, in the x.y.z.n format. For example: 10.2.4.1 is displayed for microcode 10.2.4a, 10.2.4.2 is displayed for microcode 10.2.4b. HA-121647* Change: The IBM Storage Solutions External Runtime Components (preiously named "XPyV") are now integrated within the HAK code, rather than installed separately. HA-162418 Change: Remoed the component selection option from the installation wizard. HA-162416 Change: The License Agreement step was remoed from the Windows Installation Wizard. HA-29647 Change: The MPIO agent component has been remoed from the HAK. HA-100982 Fixed: After upgrading the HAK from ersion 1.5.2 on x64 based Windows Serer 2008, xi_attach fails. HA-119450 Fixed: HBA drier error occurs when running xi_attach on Windows Serer 2003. HA-151877 Fixed: Adding a new iscsi interface with CHAP authentication does not work on some non-english ersions of Windows Serer. HA-157159 Fixed: The silent installation option (/q) does not work. For more information about this option, refer to the user guide. * Applies to all supported operating systems. Version 1.6.0 (May 2011) Version 1.6.0 included the following enhancements, changes, and fixes. Ticket ID HA-18616* HA-21000 Enhancement: xi_diag now proides the HAK ersion number when used with the --ersion argument. Enhancement: The HAK installation checks whether the minimally required ersion leel of the HBA driers is installed. 8 IBM XIV Host Attachment Kit for Windows

Ticket ID HA-22130* HA-24970* Enhancement: More information is collected with the xi_diag command. Enhancement: xi_delist can display LUN sizes in different capacity units, by using the u or --size-unit argument. HA-26338* Enhancement: The xi_delist output can be saed to a file in CSV or XML format, by adding the f or --file argument. HA-33242 Enhancement: XIVDSM MPIO framework upgraded to ersion 1.23. HA-23276 Change: xi_attach now configures the timeout alue to 60 seconds in the following registry key: HKEY_LOCAL_MACHINE\ System\CurrentControlSet\Serices\Disk\TimeOutValue HA-18046* HA-18292 HA-18898 Fixed: Erroneous text message prompted by the xi_attach command. Fixed: xi_fc_admin crashes due to a failure in a WMI call. Fixed: The HAK erification process fails on non-english ersions of Windows Serer. HA-21456* Fixed: Redirecting the xi_delist output results in a broken pipe error. HA-21695 Fixed: Windows Serer 2008 clusters may lose disks shortly after an FC port reset. HA-22419 Fixed: xi_delist fails on Windows Serer 2008 R2. HA-22470* HA-23250* HA-25290 HA-26636 HA-30433 HA-56896 Fixed: In some cases, the xi_delist output shows "N/A" instead of the actual olume size. Fixed: xi_attach crashes when a user who is not defined as a storage admin (user type) tries to define a host. Fixed: Windows Serer 2008 R2 fails to boot in Safe Mode when the Host Attachment Kit is installed. Fixed: Terminating xi_attach by pressing CTRL+C preents further xi_attach operations. Fixed: XIVDSM causes LUNs to disappear when a path failoer occurs. Fixed: XIVDSM may report an uncorrectable write error when using a dynamic disk. HA-62263* Fixed: Entering an inalid username or password results in a wrong error message. HA-119450 Fixed: xi_attach fails when using Emulex HBA driers that contain a dash in the ersion number. * Applies to all supported operating systems. Oeriew 9

Version 1.5.3 (February 2011) Version 1.5.3 included the following fixes. Ticket ID HA-28182 Fixed: A cluster failoer occurs on Windows Serer 2003 during a module failure. HA-29166 Fixed: The XIV MPIO agent causes a Stop Error ("BSoD") on Windows Serer 2008 cluster nodes. Version 1.5.2 (April 2010) Version 1.5.2 included the following enhancement and change. Ticket ID HA-16723 HA-9356 Enhancement: Additional XIV log. xi_diag now creates the C:\Windows\Temp\*xi* log. Change: xi_delist now sorts the output by deice name. Version 1.5.1 (December 2009) Version 1.5.1 included the following changes and fixes. Ticket ID HA-11524 HA-12104 HA-12116 HA-12457 Fixed: In some cases, xi_attach fails on Windows Serer 2008 R2. Change: xi_diag now uses compressed TAR archies. Because ZIP files do not support empty directories, symbolic links, and so on, xi_diag now uses compressed TAR archies to support these exceptions. Fixed: xi_attach fails on the Japanese ersions of Windows Serer. Fixed: The host freezes when a path loss occurs. Version 1.5.0 (Noember 2009) Version 1.5.0 included the following enhancements, changes and fixes: Ticket ID HA-3965* Enhancement: Automatic host definition on undefined XIV systems. The xi_attach and admin commands automatically detect undefined XIV storage systems and define the host on those systems. 10 IBM XIV Host Attachment Kit for Windows

Ticket ID HA-4111 Enhancement: Reducing the number of reboots during installation. The installation package automatically installs hotfixes for Windows Serer. The Multipath I/O feature is installed on Windows Serer 2008 or Windows Serer 2008 R2. As a result, only one reboot is required for installing and configuring the host. HA-6151* Enhancement: Added the --ersion command argument. The --ersion command argument was added to the xi_fc_admin and xi_iscsi_admin commands. In addition, xi_attach displays the HAK ersion in the Welcome banner. HA-6565* Enhancement: Support for iscsi connectiity with CHAP authentication. The Host Attachment Kit supports attaching hosts for XIV systems using iscsi with CHAP authentication. The xi_iscsi_admin and xi_attach commands are CHAP aware. HA-6708* HA-9877* Enhancement: Colored output for host attachment binaries. Colored output added to the following commands: xi_attach xi_iscsi_admin xi_fc_admin xi_delist xi_diag Enhancement: Listing attached XIV systems. The xi_attach, xi_iscsi_admin and xi_fc_admin commands display the attached XIV systems along with basic connectiity information. Oeriew 11

Ticket ID HA-9887* HA-10204 Enhancement: Additions and changes to the xi_delist command. Added command-line arguments: -t xml proides a new XML output format --hex changes the machine ID from decimal to hexadecimal base -o adds all aailable fields to the table --xi-only lists only the XIV deices -d writes debugging information to a file Wide-terminal-aware table output. If the terminal width is long enough, each row in the table is printed on a single line. Alternatiely, if the terminal width is shorter than needed, the columns are wrapped where necessary. Changed the machine ID format to decimal base. Added erification that the user is running with root/administrator permissions. Enhancement: Added a new multipathing agent. The new multipathing agent monitors the health state of all multipath deices (XIV and non XIV), reports eents to the Windows Eent 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 remoed or rolled-back during uninstallation. xi_detach allows you to remoe the multipath configuration before uninstalling the Host Attachment Kit. HA-9888 Fixed: Runner wrapper crashes due to Python path issues. HA-9827 Fixed: MSCS failoer issues. HA-11058 Fixed: xi_delist may show XIV deices as non-xiv deices. * Applies to all supported operating systems. 12 IBM XIV Host Attachment Kit for Windows

Known issues This section details the known issues in ersion 2.1.0, along with possible workarounds (if workarounds are aailable). Ticket ID HA-100800 Mapping the LUN0 olume causes errors. Due to the distinctie properties of the XIV LUN0 olume (on any storage pool), mapping it to the host causes numerous errors or performance problems. HA-6459 HA-9894 HA-9895 HA-100946 Accordingly, mapping the LUN0 olume is not recommended. When using the VMware Raw Deice Mapping (RDM), xi_delist 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). Windows Serer 2003 failure with stop error: 0x000000D1 DRIVER_IRQL_NOT_LESS_OR_EQUAL To resole this issue, download and install Microsoft Hotfix KB945119. Windows Serer 2003 Serice Pack 2 failure with stop error: 0x0000009C MACHINE_CHECK_EXCEPTION To resole this issue, download and install Microsoft Hotfix KB939315. When running xi_attach, xi_fc_admin, or xi_iscsi_admin for the first and second time (during the initial host configuration) on x64-based Windows Serer 2008, two reboots are required. This occurs due to the automatic installation of two Microsoft hotfixes. HA-163121 HA-171418 Currently there is no workaround for this limitation (HA-100946). 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). On Windows Serer 2003, xi_diag triggers an error exception when LUN number 252 is mapped. To aoid this issue, do not map olumes to LUN number 252 if Windows Serer 2003 is used. Oeriew 13

Ticket ID HA-206774 xi_attach fails to connect to XIV systems of microcode ersion 10.2.2.a or older oer 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 xi_delist and xi_syslist) does not work with more than one parameter. To aoid this issue, use single quotes to enclose all the parameter names. For example: xi_delist -o deice,size HA-230235 On Windows Serer 2003, when using the portable HAK from a shared network drie to attach the host, the XIV DSM installation (required for attachment) and xi_attach fail to run. To resole this issue, use the portable HAK from a local drie to run xi_detach and then xi_attach. HA-235121 When xi_delist is run immediately after xi_fc_admin -R or xi_iscsi_admin -R, the deices list might report "N/A" as the size of some deices. This occurs due to a delay limitation in Windows Serer. To resole this issue, wait a few seconds before running xi_delist. HA-248145 On Windows Serer 2012, Pythonwin.exe (bundled in the HAK package for Windows) may record Side-by-Side eents in the eent log. These eents hae no effect on system functionality. To aoid seeing these eents, delete the Pythonwin.exe file from the following folder location: <HAK installation directory>\xpy\lib\site-packages\ pythonwin\ HA-253188 xi_diag might fail to gather cluster reports on non-english Windows Serer cluster nodes. If needed, the cluster reports can be obtained manually from: C:\Windows\Cluster\Reports\ HA-253089 After upgrading from HAK ersion 1.5.x to ersion 1.10.0 or later, the newer xi_attach utility might fail in the 'Verifying XIV MPIO Load Balancing' configuration task. To resole this issue: 1. Start the Windows command prompt utility (cmd.exe), and then run the following commands: sc stop ximpioagent sc delete ximpioagent 2. Run xi_attach again. 14 IBM XIV Host Attachment Kit for Windows

Ticket ID HA-254647 If ersion 1.0.2.1 of the IBM Storage Enabler for Windows Failoer Clustering is installed on the host, the Host Profiler utility (xi_host_profiler) returns a alue of 0.0.0 as the ersion number. This does not affect the functionality of the IBM Storage Enabler for Windows Failoer Clustering, and no other erroneous information is returned by the Host Profiler utility. Currently there is no workaround for this issue (HA-254647). HA-255825 The upload of the host profile to the XIV storage system fails silently (without any indication) in the following host configuration: 1. The host is connected to the XIV storage system oer iscsi, and 2. The host HBA FC ports are zoned with the FC targets of the XIV storage system, but are not registered with it. To resole this issue, remoe the host HBA FC port zoning with the FC targets of the XIV storage system. HA-261160 During the installation and configuration of the Windows MPIO feature, if the host is shut down or restarted in an unordered manner, xi_attach, xi_fc_admin, and xi_iscsi_admin later fail and exit with an error message. To resole this issue: 1. Disable the MPIO feature by running the following command: dism.exe /online /disable-feature:multipathio 2. Run xi_attach and restart the host in an ordered manner when prompted to do so. Related information and publications You can find additional information and publications related to the IBM XIV Host Attachment Kit for Windows on the following websites. IBM Storage Host Software Solutions Information Center (publib.boulder.ibm.com/infocenter/strhosts/ic) IBM XIV Storage System Information Center (publib.boulder.ibm.com/ infocenter/ibmxi/r2) Microsoft TechNet website for Windows Serer (technet.microsoft.com/en-us/ windowsserer) Microsoft Windows Serer TechCenter (technet.microsoft.com/en-us/library/ bb625087.aspx) Microsoft TechNet oeriew page for Multipath I/O (MPIO) (technet.microsoft.com/en-us/library/cc725907.aspx) Oeriew 15

Getting information, help, and serice If you need help, serice, technical assistance, or want more information about IBM products, you can find arious sources to assist you. You can iew the following websites to get information about IBM products and serices and to find the latest technical information and support. IBM website (ibm.com ) IBM Support Portal website (www.ibm.com/storage/support) IBM Directory of Worldwide Contacts website (www.ibm.com/planetwide) 16 IBM XIV Host Attachment Kit for Windows

Notices These legal notices pertain to IBM Storage Host Software Solutions product documentation. This information was deeloped for products and serices offered in the U.S.A. IBM may not offer the products, serices, or features discussed in this document in other countries. Consult your local IBM representatie for information on the products and serices currently aailable in your area. Any reference to an IBM product, program, or serice is not intended to state or imply that only that IBM product, program, or serice may be used. Any functionally equialent product, program, or serice that does not infringe any IBM intellectual property right may be used instead. Howeer, it is the user's responsibility to ealuate and erify the operation of any non-ibm product, program, or serice. IBM may hae patents or pending patent applications coering 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 Drie 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 proisions 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 improements 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, 2013 17

Any references in this information to non-ibm Web sites are proided for conenience only and do not in any manner sere 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 beliees appropriate without incurring any obligation to you. Licensees of this program who wish to hae 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 aailable, 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 aailable for it are proided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equialent agreement between us. Any performance data contained herein was determined in a controlled enironment. Therefore, the results obtained in other operating enironments may ary significantly. Some measurements may hae been made on deelopment-leel systems and there is no guarantee that these measurements will be the same on generally aailable systems. Furthermore, some measurements may hae been estimated through extrapolation. Actual results may ary. Users of this document should erify the applicable data for their specific enironment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly aailable 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 objecties 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 indiiduals, 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. 18 IBM XIV Host Attachment Kit for Windows

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 serice names might be trademarks of IBM or other companies. A current list of IBM trademarks is aailable on the Copyright and trademark information website (www.ibm.com/legal/us/en/copytrade.shtml). Microsoft, Windows Serer, 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 serice names might be trademarks of IBM or other companies. Notices 19

20 IBM XIV Host Attachment Kit for Windows

Printed in USA