This README file contains the latest information about installing the IBM FAStT Host Adapter Device Driver version 8.1.5.63 on a Windows Server 2003 platform. (Microsoft signed) Refer to the IBM Support Web site or CD for the IBM FAStT Host Bus Adapter Installation and User's guide, the latest information, and updated readme file. Products supported: ----------------------------------------------------------------------------- | FAStT Adapter | Qlogic Adapter | IBM Feature Code | IBM Option P/N | ------------------------------------------------------------------------------ |FAStT Host Adapter | QLA2200F/66-IBM-SP | FC2102 | 00N6881 | ----------------------------------------------------------------------------- Last Update: 06/17/2003 ======================================================================= CONTENTS -------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer ======================================================================= 1.0 Overview ------------ 1.1 IBM FAStT Host Adapter Device Driver overview ------------------------------------------------------ The IBM FAStT Host Adapter Device Driver supports Fibre Channel point-to-point, F-port, FL-port, N-port, and Arbitrated Loop configurations. It also has the following features: - Support for Enhanced loop ID support (251 Loop IDs) in F port configuration - Support for Full-duplex operation in loop configuration - Support for Extended LUN - Support for Scan attached target device by port name - Support for Dynamic LUN Masking - Support for diagnostic loopback test - Support for QLogic Internet Protocol (IP) driver - Support for Fibre Channel Tape - Support for Reduced Interrupt Operation ======================================================================= 1.2 Limitations --------------- N/A 1.3 Enhancements ---------------- This release of driver works with all 32-bit versions of Windows Server 2003. This driver may install in Windows XP and all versions of Windows 2000. However, the driver was not tested by IBM and was not certified by Microsoft in non-Windows Server 2003 environments. ======================================================================= 1.4 Prerequisites for the update --------------------------------- The adapter BIOS can be updated by booting the server to the BIOS update diskette, available from the IBM Support website, then run the following commands: flasutil /f /l flasutil /u This will update the IBM FAStT Host Adapters or IBM FAStT Host Bus Adapters in this server. Note: The FAStT adapter BIOS update program will only update like adapters. If you have a server that contains both the IBM FAStT Host Adapters and IBM FAStT FC-2 or FC2-133 Host Bus Adapters, you must manually program each adapter at a time. Type 'flasutil" without any options to get to the list of adapters that you can select to update BIOS and NVRAM settings. ======================================================================= 2.0 Change History ------------------ Version 8.1.5.63 06/17/03 * Remove DriverParameter option buschange from INF * Too many Registered State Change Notifications(RSCNs) * High I/O hang with RSCN & LS_RJT * Fix Intermittent infinite port update occur after reboot. * Fix issue where HBA does not log back in after rezoning. * Always make NextLuRequest call for all I/Os 8.1.5.60 to 8.1.5.62: * Official release * Call nextlu for tagged I/O and nextrequest for untagged I/O * Do not notify reset detected for a RSCN 8.1.4.60 to 8.1.5.60: * NT40 & Win2k IP driver failed to ping each system if QLDirect is embedded. * win2k/ 2340 install the driver to 2nd HBA, system Blue Screen * Includes RISC code 2.2.3 TP/IP Firmware fix for the RNID issue with unplug/plug cable * Fix HCT scsi verifier failure with untagged request * GAZS fails using ztest with > 2k buffer size * Install the api library during driver installation * Work around for Scsi verifier < 5 sec * Include 3 changes to 'harden' the driver 1. Shoot the adapter if firmware reload fails earlier 2. Ensure NextRequest is called after ResetBus() 3. Use tag * Add initial support for Rubah spec * Fix HCT driver verifier test failure * Added CT pass thru related changes ======================================================================= 3.0 Installation and Setup Instructions --------------------------------------- This section is divided into the following five sections. 3.1 Initial OS installation with the IBM FAStT Host Adapter as Boot 3.2 Adding the IBM FAStT Host Adapter to the Existing OS 3.3 Updating the existing IBM FAStT Host Adapter Driver 3.4 Removing the IBM FAStT Host Adapter Driver. ======================================================================= 3.1. Initial Windows Server 2003 installation with the IBM FAStT Host Adapter as Boot. ----------------------------------------------------------------------- Contact IBM Support for supported configurations and instructions for configuring the IBM FAStT Host Adapter as the boot device. ======================================================================= 3.2 Adding the IBM FAStT Host Adapter Driver to an Existing Windows Server 2003 System. ------------------------------------------------------------------ Perform the following steps to add the driver to the existing Windows Server 2003 system. The IBM FAStT Host Adapter is Plug and Play compatible to your computer. The step-by-step procedure to install a Plug-and-Play device is: 1. Install the device to the appropriate slot on your computer according to the device manufacturer’s instructions. 2. Restart or turn on your computer. 3. Windows Server 2003 will detect the newly installed device by displaying the Found New Hardware with SCSI controller message. The Found New Hardware wizard program will start and begin the device driver installation for the newly installed adapter. 4. Select Install from a List or specific location (Advanced). Click Next. 5. Insert the IBM Device Diskette or CD-ROM into floppy or CD-ROM drive, if applicable. 6. Select Search removable media (floppy, CD-ROM) and/or specify a directory to search for the best suitable driver. Click Next to start installing the driver. 7. Click Finish on the Completing the driver updating Wizard window to close the Wizard. 8. You may be prompted with the following message: Your hardware settings have changed. You must restart your computer for these changes to take effect. Do you want to restart your computer now? If this is the only adapter in the server, click Yes to restart the computer right away. Otherwise, repeat the process for the other newly added HBAs. Notes: If the driver has already been installed once, and you are adding an additional FAStT HBA onto the system, when the system comes up, it will detect the device correctly by displaying the Found New Hardware with QLogic QLA2200 PCI Fibre Channel Adapter message. ======================================================================= 3.3 Updating the Existing IBM FAStT Host Adapter Driver ------------------------------------------------------------ o update the IBM FAStT FC-2 or FC2-133 HBAs miniport driver on an installed Windows Server 2003 system, follow this procedure: 1. Open the Computer management window by clicking Start -> Administrative Tools -> Computer management. 2. When the Computer Management window opens, select Device Manager icon under System Tools. 2. On the right window pane, use the scroll bar to scroll down the list of hardware types, double click on the SCSI and RAID controllers to display the list of configured SCSI and RAID controller devices. 3. Right-click the QLogic QLA2200 PCI Fibre Channel Adapter from the displayed device list and select Update Driver from the pull-down menu. The hardware Update Wizard window opens. 4. Select Install from a List or specific location (Advanced). Click Next. 5. Insert the IBM Device Diskette or CD-ROM into floppy or CD-ROM drive, if applicable. 6. Select Search removable media (floppy, CD-ROM) and/or specify a directory to search for the best suitable driver. Click Next to start installing the driver. 7. Click Finish on the Completing the driver updating Wizard window to close the Wizard. 8. You may be prompted with the following message: Your hardware settings have changed. You must restart your computer for these changes to take effect. Do you want to restart your computer now? If this is the only adapter in the server, click Yes to restart the computer right away. Otherwise, repeat the process for the other newly added HBAs. Note: If you are installing the IBM FAStT Host Bus Adapter in a server that previously had a Qlogic QLA2200 Adapter, you will need to use the Updating the IBM FAStT Host Bus Adapter procedure to ensure that the correct device driver ql2200.sys is loaded for the IBM FAStT Host Bus Adapters. ======================================================================= 3.4 Removing the IBM FAStT Host Adapter Driver ---------------------------------------------- You can not remove the IBM FAStT Host Bus Adapter Driver once it is installed in an Windows Server 2003 server. You can either disabling or removing the HBA from the server if you do not have any more needs for the IBM FAStT Host Bus Adapter. To remove an HBA: Turn off your computer and remove the device from your computer according to the manufacturers instructions. At a later time, if you reinstall the same type of HBA in the server, it will be automatically recognized and installed with the saved driver. Note: It is best practice to use the Add/Remove hardware function to remove/uninstall the HBA(s) before you remove it from the server. ======================================================================= 4.0 Configuration Information ----------------------------- The configurable driver parameters are divided into System Registry Parameters and NVRAM Parameters sections. ======================================================================= 4.1 NVRAM Parameters --------------------- The default adapter NVRAM settings is optimized for Windows Server 2003 environments. However, modifications to the NVRAM settings many be required depending on a given server configuration. You can configure the adapter NVRAM settings using the Fast!UTIL utility. To access Fast!UTIL utility, press Ctrl+Q during host BIOS initialization. Refer to the IBM FAStT Host Adapter Installation and User's Guide for additional information on adapter NVRAM settings. 4.1.1 Hard Loop ID ------------------ It is recommended that you set different Hard Loop IDs for each IBM FAStT HBA port in a single Host or in each Node in a cluster. For example, in Host Adapter Settings, set the Hard Loop ID to 125 for the first host in a cluster and set the Hard Loop ID to 124 for the other host in the cluster. If you do not assign different Hard Loop IDs, the Fibre Channel protocol will automatically assign soft-loop IDs when their is a hard-loop ID conflict. 4.1.2 Port Down Retry Count --------------------------- From the Advanced Adapter Settings, change the Port Down Retry Count to 70 (if you have more than 5 devices on the fibre channel loop attached to the IBM FAStT FC-2 Host Adapter). Fibre Channel Host Adapters and Storage Subsystems are counted as fiber channel devices. You can configure the adapter using the Fast!UTIL utility. ======================================================================= 4.2 System Registry Parameters ------------------------------ WARNING: - Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Use Registry Editor at your own risk. - Before you edit the registry, make sure you understand how to restore it if a problem occurs. For information about how to do this, view the "Restoring the Registry" Help topic in Regedt32.exe. Below is a description of the registry parameters used by the driver: 4.2.1 MaximumSGList ------------------- Windows Server 2003/2000 includes an enhanced scatter/gather list support for doing very large SCSI I/O transfers. Windows NT supports up to 256 scatter/gather segments of 4096 bytes each, allowing transfers up to 1048576 bytes. NOTE: The oemsetup.inf file has been updated to automatically update the registry to support 65 scatter/gather segments. Normally, no additional changes will be necessary as this results in the best overall performance. If you want to change this value, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: MaximumSGList:REG_DWORD:0x21 4. Enter a value from 16 to 255 (0x10 hex to 0xFF). A value of 255 (0xFF) enables the maximum 1 MByte transfer size. Setting a value higher than 255 results with the default of 64K transfers. The default value is 33 (0x21). 5. Click OK. 6. Exit the Registry Editor, then shutdown and reboot the system. 4.2.2 Number Of Requests ------------------------ Windows Server 2003/2000 supports the NumberOfRequests registry parameter to specify the maximum number of outstanding requests per adapter. When the IBM driver is installed, the registry will be automatically updated with this parameter set to a value of 150 (0x96). CAUTION: DO NOT increase this parameter above 150. Doing so can result in a system failure. 4.2.3 Fabric Supported ---------------------- By default, the driver supports Fibre Channel fabric (switch). Should you wish to disable fabric support please use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string FabricSupported= does not exist, append to end of string; FabricSupported=0 5. If the string FabricSupported=1 exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.4 Portname --------------- By default, the driver track devices by their port names. To configure the driver to track devices by node names, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: KEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet ->Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string Portname= does not exist, append to end of string; Portname=0 5. If the string Portname=1 exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.5 Fibre Channel Tape ------------------------ To configure the driver to support Fibre Channel tape, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string FCTape= does not exist, append to end of string; FCTape=1 5. If the string FCTape=0 exists, change the value from 0 to 1. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.6 MSCS ---------- In SAN configuration, the driver is required to handle RSCN efficiently to avoid disruption of I/O because of unnecessary re-logins. However, in Microsoft Cluster environment, it is necessary for the driver performs re-logins because the shared storage subsystems may be reset by other initiators through a ResetBus operation. The driver parameter MSCS is designed to accommodate the conflicting needs on how to handle RSCN in both environments. It accepts three values: Value RSCN Handling Environment ----- ------------------------- 0 Upon receiving RSCN, performs logins to SAN devices only if necessary 1 Upon receiving RSCN, always performs logins Cluster 2 Upon receiving RSCN, attempts to detect whether the system is running in the Cluster SAN/Cluster environment during boot. If yes, always performs logins upon receiving RSCN. If not, performs logins only if necessary By default, the oemsetup.inf file is set up to have MSCS set to 2. To change the driver to handle RSCN differently, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string MSCS= does not exist, append to end of string; MSCS=n where n = 0, 1, or 2. 5. If the string MSCS= exists, change the value to the desired value. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.7 UseSameNN --------------- By default, if you have multiple Fibre Channel HBAs on the same system, the driver will assign the world wide node name obtained from the first HBA to the rest of the HBAs. If you wish to have each HBAs to assume the world wide node name based on its own NVRAM content, you need to disable this feature by setting the UseSameNN parameter to 0. Please use the following procedure to change the UseSameNN parameter: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string UseSameNN= does not exist, append to end of string; UseSameNN=0 5. If the string UseSameNN=1 exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.8 Buschange --------------- To ensure proper operation when the HBA is used in a FAStT Storage Server environment, the buschange parameter must be set to 0. The default setting of the buschange parameter when it is not specified is 2. To set buschange parameter to 0, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM driver as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Ql2200 -> Parameters -> Device 3. Double-click: DriverParameters:REG_SZ:UseSameNN=1 4. If the string buschange= does not exist, append to end of string; buschange=0 5. If the string buschange= exists, change the value to the desired value. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. 4.2.9 Disk TimeOutValue ---------------------- To ensure the driver function properly, the driver sets the system related registry - Disk TimeOutValue - to 60. When installing clustering service, the cluster install wizard changes this value to 20. You must change this value back to 60(0x3c) to ensure proper operation of the HBA when connecting to FAStT storage servers. To modify this registry value, use the following procedure: 1. Click Start -> Run. When the Run window opens, enter REGEDT32 and click open to start the Windows Server 2003 registry modification program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the Disk TimeOutValue as follows: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Disk 3. Double-click: TimeOutValue:REG_DWORD:0x3c 4. If the value is not 60 (ox3c), change it. 5. Click OK. 6. Exit the Registry Editor, then shutdown and reboot the system. ======================================================================= 4.5 Configuration Notes ------------------------ Support for more than 8 LUNs ---------------------------- Windows 2000 uses the ANSI-approved version field of the Inquiry data returned by the target device to determine whether it should support only 8 LUNs or 255 LUNs. If the field indicates that the target device complies to SCSI-3 standard, the operating system will enable more than 8 LUNs support. Else, it will support only 8 LUNs. Enhanced Loop ID ---------------- Of 0 - FFh Loop Ids, some are preallocated for special functions and are not available for use by devices: Loop IDs Functions -------- ---------- 7Eh FL_Port (S_ID=FFFFFEh) 7Fh Switch Fabric Controller (S_ID=FFFFFDh) 80h Switch Name Server (S_ID=FFFFFCh) 81h Switch Embedded Port (FFFc4xh) used for FC-4 probing (Brocade only) FFh IP Broadcast Connection options ------------------ The following connection options are supported: Value Connection ----- ----------------- 00 Start in loop mode, by transmitting Lip F7F7 01 Start in point-to-point mode, by transmitting NOS/OLS 02 Start in loop mode first, then switch to point- to-point mode if NOS is detected. The connection option is currently stored in the NVRAM and can be changed through the FastUtil. The default value of the connection mode is 2. Fibre Channel Tape support -------------------------- There are two ways to enable Fibre Channel (FC) tape support, the first method is to enable the FC tape support NVRAM setting in the HBA Extended Firmware Setting window. You can configure the adapter NVRAM settings using the Fast!UTIL utility. To access Fast!UTIL utility, press Ctrl+Q during host BIOS initialization. The second way is to set the Fibre Channel Tape Driver Parameters in the system registry to 1. - To ensure the driver function properly, the driver changes some of the system related registry entries such as the disk timeout value of the system disk driver during driver installation through the use of the oemsetup.inf file. Those values are not being restored upon driver removal. - Notes on LUN 0 issue: In order for NT4.0 to see the device properly, LUN 0 has to be configured. ======================================================================= 5.0 Unattended Mode -------------------- The driver supports the Unattended Mode. Please follow the instructions provided by Microsoft to create necessary files and prepare systems for unattended installation. ======================================================================= 6.0 WEB Sites and Support Phone Number -------------------------------------- 6.1 IBM Support Web Site: http://www.ibm.com/pc/support 6.2 IBM eServer xSeries Marketing Web Site: http://www.ibm.com/pc/us/eserver/xseries/index.html 6.3 If you have any questions about this update, or problem applying the update go to the following Help Center World Telephone Numbers URL: http://www.ibm.com/planetwide ======================================================================= 7.0 Trademarks and Notices -------------------------- 7.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM Netfinity Qlogic is a registered trademark of QLogic Corporation. Microsoft and Windows are trademarks or registered trademarks of Microsoft Corporation. Other company, product, and service names may be trademarks or service marks of others. ======================================================================= 8.0 Disclaimer -------------- 8.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 8.2 Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.