File Name: README.TXT IBM FAStT Host Adapter Device Driver for NetWare 5.1 Readme.txt Version 5.50v Last Update: 02/22/01 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: ---------------------- 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 5.50v for NetWare Version 5.1. Refer to the IBM support website for the latest information and updated readme file (see section 6.1 below). 1.2 Limitations: The load balancing feature of the IBM FAStT Host Adapter Device Driver when one (1) IBM FAStT Host Adapter is connected to two (2) IBM FAStT Storage Subsystem controllers will not be available until a later release of the IBM FAStT Host Adapter device driver and QLogic Management Suite Java (QMSJ). 1.3 Enhancements: None. 1.4 Level of Recommendations and Prerequisites for the Update: - Be sure to install NetWare version 5.1. 1.5 Dependencies: None. 2.0 Change History ------------------------------ There is no prior history. This is the first release. 3.0 Installation and Setup Instructions ------------------------------------------------------- 3.1 Create the IBM FAStT Host Adapter Device 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:” 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 3.2 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. 1. Be sure that DOS is installed on your boot disk. 2. Follow the standard NetWare instructions to begin the installation. 3. When prompted to "Choose the server drivers - disk driver", press to install an unlisted driver. 4. Insert the IBM FAStT Host Adapter Device Driver diskette and press to specify the path to the FAStT Host Adapter device driver: A:\NETWARE 5. Press to select the QLogic HAM Driver. 6. Follow the standard NetWare installation procedure and complete the installation. 3.3 Initial operating system installation with the IBM FAStT Controller as an Add-On. Perform the following steps to install and the IBM FAStT Host Adapter driver on the device not attached to the IBM FAStT controller. 1. Be sure that DOS is installed on your boot disk. 2. Follow the standard NetWare instructions to begin the installation. 3. When prompted to "Choose the server drivers - disk driver", press to install an unlisted driver. 4. Insert the IBM FAStT Host Adapter Device Driver diskette and press to specify the path to the IBM FAStT device driver: A:\NETWARE 5. Press to select the QLogic HAM driver. 6. Follow the standard NetWare installation procedure and complete the installation. 3.4 Adding the IBM FAStT Controller to an existing operating system. Perform the following steps to add the driver to an existing NetWare system. 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. 3.5 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. 3.6 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". 3.7 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". 3.7.1 Setting the IBM FAStT Host Adapter Device Driver Parameters: SLOT=x Load the driver in the NetWare server prompt (:) by typing the load command with the Slot parameter. For example, LOAD QL2X00.HAM SLOT=x where x is the slot identification number. /LUNS To enable LUN support, add a LUNS switch to the end of the load command. For example, LOAD QL2X00.HAM SLOT=x /LUNS 3.8 Novell NetWare support for the 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. 3.9 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. 3.10 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. 3.11 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. 3.12 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 may be required if an upper layer failover CDM is present (the CDM is expecting to see all paths to each device). 4.0 Configuration Information ------------------------------- None. 5.0 Unattended Mode ------------------------------- None. 6.0 WEB Sites and Support Phone Number ---------------- 6.1 IBM Support Web Site: http://www.pc.ibm.com/support 6.2 IBM Marketing Netfinity Web Site: http://www.pc.ibm.com/netfinity 6.3 If you have any questions about this update, or problems applying the update, call 1-800-772-2227. 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 7.3 Other company, product, and service names may be trademarks or service marks of others. QLogic is a registered trademark of QLogic Corporation. 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 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.