File Name: README.TXT IBM FAStT Host Adapter Device Driver for NetWare 5.1 Readme.txt Version 6.50h Last Update: 07/06/01 CONTENTS -------- 1.0 Overview 2.0 Release History 3.0 Creating the Driver Diskette 4.0 Installing the IBM FAStT Host Adapter Device Driver 4.1 Initial operating system installation with the IBM FAStT controller as Boot 4.2 Initial operating system installation with the IBM FAStT Controller as an Add-On. 4.3 Adding the IBM FAStT Controller to an existing operating system 4.3.1 Adding the Driver for the First Time 4.3.2 Adding an additional IBM FAStT Controller 4.4 Updating the existing IBM FAStT device driver 5.0 Removing the IBM FAStT Host Adapter Device driver 6.0 Driver Optional Parameters 6.1 System Parameters 6.2 NVRAM Parameters 7.0 Limitations 8.0 Additional Notes 8.1 Novell NetWare support of IBM FAStT Host Adapter Device driver 8.2 PCI Hot Plug 8.3 256 LUN support 8.4 Support for DMI 8.5 Multipath support 8.6 Server Memory Recommendations 9.0 Configuration Information 10.0 Unattended Mode 11.0 WEB Sites and Support Phone Number 12.0 Trademarks and Notices 13.0 Disclaimer 1.0 Overview: --------------- Use this procedure to install the IBM FAStT Host Adapter Device Driver for NetWare Version 5.1. 1.1 Overview about this code ----------------------------- This README file contains the latest information about installing IBM FAStT Host Adapter Device Driver Version 6.50h for NetWare Version 5.1. Refer to the IBM support website for the latest information and updated readme file (see section 11.0 below). This package contains the following files: ql2100.ham - Device driver for the IBM Netfinity QLA2100 PCI Fibre Channel Adapter ql2100.ddi - Installation file for the IBM Netfinity QLA2100 PCI Fibre Channel Adapter ql2100d.ham - Degug driver version of the above driver (See section 6.3 for description) ql2100d.ddi - Installation file for the above driver. ql2200.ham - Device driver for the IBM FAStT Host Adapter ql2200.ddi - Installation file for the IBM FAStT Host Adapter ql2200d.ham - Degug driver version of the above driver (See section 6.3 for description) ql2200d.ddi - Installation file for the above driver. Release.txt - Driver revision history Readme.txt - This file 1.2 Enhancements: None. 1.3 Level of Recommendations and Prerequisites for the Update: - Be sure to install NetWare version 5.1. 1.4 Dependencies: None. ================================================================================ 2.0 Release History --------------------- Please refer to Release Notes. ================================================================================ 3.0 Creating the Driver Diskette ---------------------------------------------------------------- 1. Download the IBM FAStT Host Adapter Device Driver: - Refer to the IBM website at http://www.pc.ibm.com and locate the IBM FAStT Host Adapter Device Driver. Click "Link to driver." 2. If prompted with "What would you like to do with this file?” choose "Save this program to disk". 3. Specify a temporary location on your hard drive and download the IBM FAStT Host Adapter device driver. 4. Insert a blank diskette in the diskette drive. Run the self-extracting file you just downloaded specifying A:\ for "Unzip To Folder:” ================================================================================ 4.0 Installing the IBM FAStT Host Adapter Device Driver ------------------------------------------------------- The IBM FAStT Host Adapter Device Driver installation section is divided into the following four sections. · Initial operating system installation with the IBM FAStT Controller as Boot · Initial operating system installation with the IBM FAStT Controller as Add-on · Adding the IBM FAStT controller to the existing operating system · Updating the existing IBM FAStT Host Adapter Device Driver ================================================================================= 4.1 Initial operating system installation with the IBM FAStT controller as Boot -------------------------------------------------------------------------------- Perform the following steps to initially install NetWare on the Fibre Channel disk drive attached to the IBM FAStT controller. 0. Enable the BIOS on the IBM FAStT Host Adapter, and select the FC as the boot device. 1. If you haven't already done so, install DOS on the boot disk. 2. Follow the standard NetWare instructions to begin the installation. 3. When prompted to "Choose Storage Drivers - Disk Drivers", press to install an unlisted driver. 4. Insert the IBM FAStT Host Adapter Device Driver diskette and press to specify the path to the QLogic HAM driver: A:\NETWARE 5. Press to select the QLogic HAM driver. 6. Follow the standard NetWare installation procedure and complete the installation. ================================================================================= 4.2 Initial operating system installation with the IBM FAStT Controller as an Add-On. --------------------------------------------------------------------------- Perform the following steps to install Netware and the QLogic driver on the device not attached to the QLA2x00 controller. Same as section 4.1, except that at step 0, the IBM FAStT Host Adapter BIOS should be disabled. ================================================================================= 4.3 Adding the IBM FAStT Controller to an existing operating system -------------------------------------------------------------------- Perform the following steps to add the driver to the existing NetWare system. 4.3.1 Adding the Driver for the First Time ------------------------------------------ 1. From the NetWare server prompt, load the appropriate NetWare program: LOAD NWCONFIG 2. Select "Driver options" from the main menu. 3. Select "Configure disk and storage device drivers". 4. Select "Select an additional driver" 5. Press to install an unlisted driver. 6. Insert the IBM FAStT Host Adapter driver diskette and press to specify the path to the FAStT device driver: A:NETWARE 7. Press to select the QLogic HAM driver and select "Yes" to copy the driver from the diskette to the server directory. 4.3.2 Adding an additional IBM FAStT Controller ------------------------------------------------ To support multiple adapters, add one LOAD command per adapter to your STARTUP.NCF file (LOAD QL2x00.HAM SLOT=n). The "SLOT=n" command line parameter is provided for specifying which adapter to configure for each load instance. If the driver is loaded manually from the server prompt and there are multiple adapters, the user will be required to pick a slot number from a list. The IBM FAStT Host Adapter driver reads the onboard NVRAM and supports all of the customized configuration parameters for the adapter and the attached devices. Press during boot to access the adapter's configuration options. ================================================================================= 4.4 Updating the existing IBM FAStT device driver ------------------------------------------------- Perform the following steps if the driver is already installed and you require an updated version. 1. From the NetWare server prompt, load the appropriate NetWare program: LOAD NWCONFIG 2. Select "Driver options" from the main menu. 3. Select "Configure disk and storage device drivers". 4. Select "Deselect a selected driver". 5. Choose the QL2x00 driver. 6. Select "Select an additional driver". 7. Press to install an unlisted driver. 8. Insert the IBM FAStT Host Adapter software diskette and press to specify the path to the host adapter device driver: A:\NETWARE 9. Press to select the QLogic HAM Driver and select "Yes" to copy the driver from the diskette to the server directory. 10. Select "Select/Modify drivers parameter". 11. Insert the Slot Number and press . 12. Select "Save parameters and load driver". ================================================================================= 5.0 Removing the IBM FAStT Host Adapter Device driver ------------------------------------------------------ 1. From the NetWare server prompt, load the appropriate NetWare program: LOAD NWCONFIG 2. Select "Driver options" from the main menu. 3. Select "Configure disk and storage device drivers". 4. Select "Deselect a selected driver". ================================================================================= 6.0 Driver Optional Parameters ------------------------------ The HAM driver has two types of optional parameters: 1. System parameters (specified at driver load time) 2. NVRAM parameters (stored in the adapter nvram) These are described in the following subsections. ================================================================================= 6.1 System Parameters ---------------------- Driver optional system parameters are specified on the driver load line. There are two types of driver opional parameters: 1. Global - the parameter acts on all driver instances. 2. Instance - the parameter acts only on the individual driver instance in which it is specified. NOTE: "QL2x00" below refers to one of the following: 2300, 2200, 2100. The exception to this is the configuration file "QL2x00.CFG" where the "x" character is literal. SLOT=n (Instance) Specifies to NetWare the PCI slot number n of the adapter for which to load this driver instance. LOAD QL2x00.HAM SLOT=3 /LUNS (Instance) Specifies to NetWare to scan for all luns during the load of this driver instance (otherwise NetWare will only scan for lun zero devices); this is required for all RAID susbsystems. LOAD QL2x00.HAM SLOT=3 /LUNS /ALLPATHS (Global) Disables failover and reports to NetWare all devices on all adapter paths; this is required when failover is being handled by an upper layer driver or CDM such as the IBMSAN driver. LOAD QL2x00.HAM SLOT=3 /LUNS /ALLPATHS /CFGOFF (Global) Avoids reading the configuration file QL2x00.CFG; this file is located in the default DOS directory (C:\NWSERVER), and is written by the QLogic SAN Failover Management Software. LOAD QL2x00.HAM SLOT=3 /LUNS /CFGOFF /LUNZERO (Instance) Reports to NetWare lun 0 regardless of existence; this is used for RAID subsystems that do not report any luns on a WWN until the subsystem is configured for the first time; otherwise, this is not required. LOAD QL2x00.HAM SLOT=3 /ALLPATHS /LUNZERO /QUALIFIED (Instance) Extends the Inquiry data device present test to allow non-standard RAID subsystems to correctly report all luns on each WWN; this is not required on the newer standard compliant RAID subsystems. LOAD QL2x00.HAM SLOT=3 /LUNS /QUALIFIED /PORTNAMES (Global) Internally tracks devices by portname rather than nodename; this is required when storage luns do not have a 1:1 correspondence across portnames. LOAD QL2x00.HAM SLOT=3 /LUNS /PORTNAMES /BACKOFF (Global) Disables failback of I/O after a broken link or a broken port has been restored; used during debug. LOAD QL2x00.HAM SLOT=3 /LUNS /BACKOFF /GNNFT (Instance) Uses a single GNNFT rather than a GAN sequence to query the fabric name server. ================================================================================= 6.2 NVRAM Parameters --------------------- The IBM FAStT Host Adapter NVRAM settings are modified by entering Fast!UTIL during server hardware boot (press ALT-Q when prompted by the adapter). In Fast!UTIL, first select the host adapter, and then select "Configuration Settings". Then, under the following headings, you will see these parameters: Host Adapter Settings --------------------- + Frame Size : Loop Reset Dealy + Adapter Hard Loop Id + Hard Loop Id Advanced Adapter Settings ------------------------- + Exexcution Throttle + Fast Command Posting : >4GB Addressing + Luns Per Target + Enable LIP Reset + Enable LIP Full Login + Enable Target Reset : Login Retry Count + Port Down Retry Count + Drivers Load Risc Code = Enable Database Updates : Disable Database Load : IOCB Allocation : Extended Error Logging Extended Firmware Settings -------------------------- = Exteneded Control Block @ RIO Operation Mode + Connection Options @ Class 2 Service @ ACK0 + Fibre Channel Tape Support + Fibre Channel Confirm @ Command Reference Number @ Read Transfer Ready @ Response Timer @ Interrupt Delay Timer + Data Rate Key: + Used by Ham driver (change effects behaviour) @ Default value expected by Ham driver (do Not change) = Overridden by Ham driver (change has no effect) : Not used by Ham driver (change has no effect) NOTES ----- 1. Enable the following to support FC-Tape (see "Extended Firmware Settings" above): Fibre Channel Tape Support Fibre Channel Confirm ================================================================================ 6.3 Debug Driver Information ---------------------------- This package also includes the debug version of the QL2100 and QL2200 adapter driver. These drivers are identified as ql2100d.HAM and ql2200d.HAM. The debug driver provides additional driver information that is dumped to an additional console screen. The format for the debug information is as followes. HAM DRIVER DEBUG SCREEN ======================= Every 1 second: A0=0/1234 <0,0> {0,0} 5678 A1=0/1234 <0,0> {0,0} 5678 A0 adapter instance index 0 A1 adapter instance index 1 0/1234 0 unresolved interrupts / 1234 total number of interrupts <0,0> 0 io command timeouts , 0 mailbox command timeouts {0,0} 0 io commands in pending queue structures , 0 io commands currently executing on fibre 5678 5678 seconds since last interrupt occurred Notes: a. Unresolved interrupt is when the isp indicates that it has an interrupt pending, but when the driver reads the completion registers it finds no work to do. b. The total number of io commands outstanding from Netware is the sum x+y of the numbers inside braces {x,y}. Every 10 seconds: FindTimedOutCommands(An): Searching... An adapter instance index n This indicates that the driver is searching for any IO commands that have not completed and have expired their timeout counter; when none are found, nothing is printed; otherwise the timed out IO commands are identfied and then requeued for retry. ================================================================================ 7.0 Limitations --------------- See Server Memory Recommendations below. ================================================================================ 8.0 Additional Notes ------------------- 8.1 Novell NetWare support of IBM FAStT Host Adapter Device driver ------------------------------------------------------------------- The following drivers are provided with Novell NetWare supporting various Fibre Channel devices through the Fibre Channel HAM driver: SCSIHD.CDM NetWare CDM driver for supporting SCSI hard disk devices SCSICD.CDM NetWare CDM driver for supporting SCSI CD-ROM devices SCSIMO.CDM NetWare CDM driver for supporting SCSI magneto-optical storage devices NWTAPE.CDM NetWare CDM driver for supporting SCSI tape devices (SBACKUP requires this driver) NWASPI.CDM NetWare CDM driver for supporting SCSI devices through the ASPI interface (see note below) CDROM.NLM NetWare CD-ROM driver for supporting CD-ROM devices After the IBM FAStT Host Adapter Device Driver is loaded, the CDM drivers will be loaded automatically by NetWare as needed. ================================================================================ 8.2 PCI Hot Plug ---------------- NOTE: This procedure addresses only the driver-related portion of the PCI Hot Swap operation. The server must have PCI slots that are capable of being powered-up and powered-down independently. Depending on the server platform, this entire operation may be controlled by a platform specific software module supplied by the platform vendor. In such a case, these commands are issued directly to the driver and do not require the operator to enter them. The IBM Netfinity PCI Hot Plug System Bus Driver for Novell NetWare V4.11, V4.2, and V5.1 can be downloaded from the IBM Support Site for your specific server model at http://www.ibm.com/pc/. The PCI Hot Plug works by unloading a specific instance of the driver associated with a specific host adapter. It allows a failed adapter to be removed and replaced by an adapter of the same type without disrupting the operation of other adapters of the same type. The steps necessary to perform a hot swap operation are listed below. 1. Type "List storage adapters" at the server console. You will see a list similar to this example: [V596-A2] QL2200 PCI FC-AL Host Adapter Module [V596-A2-D1:1F] IBM Universal Xport rev:0400 [V596-A2-D0:0] IBM 3526 rev:0400 [V596-A2-D0:1] IBM 3526 rev:0400 [V596-A2-D0:1F] IBM Universal Xport rev:0400 [V596-A2-D1:0] IBM 3552 rev:0400 [V596-A2-D1:1] IBM 3552 rev:0400 [V596-A3] QL2200 PCI FC-AL Host Adapter Module 2. Refer to the IBM Netfinity PCI Hot Plug System Bus Driver for Novell NetWare V4.11, V4.2, and V5.x readme for Installation steps. 3. To remove the host adapter instance 2 controlling the first two hard drives, enter the following command: All SCSI controller drivers must be unloaded from the system console. Use the following command to remove a single adapter and its volumes from the system: REMOVE STORAGE ADAPTER A2 4. After the host adapter has been replaced, make the new adapter operational by loading another instance of the driver using the normal load command syntax. For example: LOAD QL2x00.HAM SLOT=3 NOTE: This procedure addresses only the driver-related portion of the PCI Hot Swap operation. The server must have PCI slots that are capable of being powered-up and powered-down independently. Depending on the server platform, this entire operation may be controlled by a platform specific software module supplied by the platform vendor. In such a case, these commands are issued directly to the driver and do not require the operator to enter them. PCI Hot Plug works by unloading a specific instance of the driver associated with a specific host adapter. It allows a failed adapter to removed and replaced by an adapter of the same type without disrupting the operation of other adapters of the same type. ================================================================================ 8.3 256 LUN support ------------------- To find all LUNS, load the driver with the /LUNS qualifier. For example: LOAD QL2x00.HAM SLOT=3 /LUNS Or, if the driver is already loaded, use the command SCAN ALL LUNS at the server console prompt to find all LUNS (new and existing LUNS). NOTE: The following applies ONLY to QL2x00.HAM Version 5.xx drivers: · The driver reports actual LUN numbers without ID/LUN mapping. · The driver reports virtual ID numbers due to the dynamic nature of fabrics. To use more than 8 LUNs per ID, the following modules MUST be updated: a. SCSIHD.CDM for use with hard disk drives b. SCSICD.CDM for use with CD-ROM drives c. SCSIMO.CDM for use with magneto-optical disk drives d. SCSI2TP.CDM for use with tape drives e. SCSICHGR.CDM for use with media changers The new versions of these modules are available from Novell. IMPORTANT: With the new CDM modules, set the LUNs Per Target parameter in Fast!Util to the required number of LUNs per target ID. With the old CDM modules, only 8 LUNs per target ID are allowed. Set the LUNs Per Target parameter to 8 in Fast!Util. If not using multiple LUNs per ID, set this parameter to 0. To set the LUNs Per Target parameter: 1. Reboot the hardware, and press ALT-Q when the QL2x00 banner appears. 2. Select the adapter. 3. Select Configuration Settings. 4. Select Advanced Adapter Settings. 5. Select LUNs Per Target and change the LUNs Range. 6. Press ESC twice and select Save. 7. Press ESC again and select Reboot. ================================================================================ 8.4 Support for DMI ------------------- This driver supports DMI (Desktop Management Interface) host adapter information and statistics to be queried by a remote Windows NT client running the IBM FAStT Check application. Please refer to the README file for the IBM FAStT Check application for more information. This driver also supports FAStT MSJ (IBM FAStT Management Software Java) allowing SAN connected storage to be configured for failover. Please refer to the README file for the IBM FAStT Check application, and IBM FAStT MSJ for more information. ================================================================================ 8.5 Multipath support --------------------- The driver by default will present only one path to NetWare if multiple adapters are connected to the same storage device. This prevents volumes from being double mapped and causing mount corruption. To disable multi-path mode and allow Netware to see all paths, load the driver with the /ALLPATHS option, as shown here: LOAD QL2x00.HAM SLOT=3 /LUNS /ALLPATHS The /ALLPATHS option is required if an upper layer failover CDM is present such as the IBMSAN driver for NetWare (the CDM is expecting to see all paths to each device). ================================================================================ 8.6 Server Memory Recommendations --------------------------------- In general, at least 256MB of memory is recommended. For large numbers of large volumes, in excess of 512MB is required. ================================================================================ 9.0 Configuration Information ------------------------------- None. ================================================================================ 10.0 Unattended Mode ------------------------------- None. ================================================================================ 11.0 WEB Sites and Support Phone Number ----------------------------------------- 11.1 IBM Support Web Site: http://www.ibm.com/pc/support 11.2 IBM eServer xSeries Marketing Web Site: http://www.ibm.com/pc/us/eserver/xseries/index.html 11.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 ================================================================================ 12.0 Trademarks and Notices ----------------------------- 12.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM Microsoft, Windows, and Windows 2000 are trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. ================================================================================ 13.0 Disclaimer ----------------- 13.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. 13.2 Note to Government Users 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.