Glogic Simplify SANblade 4000 Series User Manual

Simplify
SANblade 4000 Series User’s Guide
1-Gb iSCSI to PCI Host Bus Adapter
IS0053301-00 A Page i
No part of this document may be copied nor reproduced by any means, nor translated nor transmitted to any magnetic medium without the express written consent of QLogic Corporation.
Microsoft, Windows NT, and Windows 2000 are trademarks of Microsoft Corporation.
QLogic is a trademark of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of
their respective owners.
Rev A release, 4/30/02
Document Revision History
© 2002 QLogic Corporation
First Printed: February 2002
All Rights Reserved Worldwide.
Printed in U.S.A.
QLogic Corporation, 26600 Laguna Hills Drive, Aliso Viejo, CA 92656
Page ii IS0053301-00 A
(800) 662-4471 or (949) 389-6000
Table of Contents
Section 1 Introduction
1.1 How to Use this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.2 General Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1.3 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.4 Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.5 Release Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Part I Hardware
Section 2 QLA4000-DEV
2.1 QLA4000-DEV Components . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.1.1 LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
2.1.2 Jumpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
2.2 Installation in the Computer. . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
2.3 Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.4 Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.5 Agency Certification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Part II Software
Section 3 Windows 2000 Driver Installation
3.1 Supported Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
3.2 Driver Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
3.3 Creating the Driver Disk (Optional) . . . . . . . . . . . . . . . . . . . . 3-1
3.4 Installing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.4.1 Initial OS Installation with the QLA4000-DEV as
an Add-On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.4.2 Adding the QLA4000-DEV to the Existing OS . . . . . . . . . 3-3
3.4.3 Updating the Existing Driver . . . . . . . . . . . . . . . . . . . . . . 3-4
3.5 Removing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.6 System Registry Parameters. . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.6.1 MaximumSGList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.6.2 NumberofRequests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
IS0053301-00 A Page iii
SANblade 4000 Series Users Guide 1-Gb iSCSI to PCI Host Bus Adapter
Section 4 Windows NT Driver Installation
4.1 Supported Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.2 Driver Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.3 Creating the Driver Disk (Optional). . . . . . . . . . . . . . . . . . . . 4-1
4.4 Installing the Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.4.1 Initial OS Installation with the QLA4000-DEV as an
Add-on Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.4.2 Adding the QLA4000-DEV Driver to the Existing OS . . . 4-2
4.4.3 Updating the Existing Driver . . . . . . . . . . . . . . . . . . . . . . 4-3
4.5 Removing the Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.6 System Registry Parameters . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.6.1 MaximumSGList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.6.2 NumberofRequests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.6.3 LargeLuns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4.7 Additional Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Part III SANblade Control IX
Section 5 SANblade Control IX
5.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.2 Installation Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.3 Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.3.1 Selection Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5.3.2 Configuring the QLA4000-DEV . . . . . . . . . . . . . . . . . . . . 5-6
5.3.3 Configuring Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
5.3.3.1 Configuring Specific Targets . . . . . . . . . . . . . . . . . . . 5-8
5.3.3.2 Configuring Using Discovery . . . . . . . . . . . . . . . . . . . 5-8
5.3.4 Firmware Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
5.3.5 Default Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Page iv IS0053301-00 A
SANblade 4000 Series Users Guide
1-Gb iSCSI to PCI Host Bus Adapter
FIGURES
Figure Page
2-1 QLA4000-DEV Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2-2 QLA4000-DEV LED Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
5-1 HBA Options with Firmware Tabbed Page . . . . . . . . . . . . . . . . . 5-2
5-2 Target Settings Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
5-3 Target Information Tabbed Page. . . . . . . . . . . . . . . . . . . . . . . . . 5-4
5-4 HBA Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
5-5 Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
5-6 HBA Options with Network Tabbed Page . . . . . . . . . . . . . . . . . . 5-7
5-7 Update Firmware Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
TABLES
Table Page
2-1 QLA4000-DEV Operating Environment . . . . . . . . . . . . . . . . . . . . 2-4
5-1 Initial Login Parameters, Discovery Session . . . . . . . . . . . . . . . . 5-11
5-2 Initial Login Parameters, Normal Session . . . . . . . . . . . . . . . . . . 5-11
IS0053301-00 A Page v
SANblade 4000 Series Users Guide 1-Gb iSCSI to PCI Host Bus Adapter
Page vi IS0053301-00 A
Section 1
Introduction
1.1
How to Use this Guide
This users guide is for the SANblade QLA4000-DEV iSCSI host bus adapter (HBA). This guide contains installation instructions for the hardware (QLA4000-DEV), supported software drivers, and the SANblade Control IX GUI. Install these components in the following order:
1. Install the QLA4000-DEV in your PC.
2. Install the software driver according to the directions in the appropriate section.
3. Install the SANblade Control IX GUI.
1.2
General Description
The QLA4000 is an iSCSI HBA that provides PCI connectivity to SCSI using the iSCSI protocol. This release of the QLA4000 implements draft 0.8 of the IETF iSCSI standard, which creates a new industry standard SAN technology based on internet protocols: TCP/IP. Updates to later iSCSI drafts will be available for downloads to the HBA. iSCSI enables new IP based SANs, which are similar to Fibre Channel SANs, as well as a new set of storage applications, for example, remote storage.
The QLA4000-DEV implements the complete protocol stack, including TCP/IP, on the HBA and off-loads the host of any I/O protocol processing. Off-loading the host frees the system to perform other tasks and deliver optimum total system performance. The QLA4000-DEV handles complete SCSI transactions, iSCSI, TCP/IP and Ethernet.
The QLA4000-DEV is a development product and is not intended for mass distribution.
IS0053301-00 A 1-1
1 – Introduction Features
1.3
Features
Compliance with PCI Local Bus Specification revision 2.2
Supports iSCSI standards with soft upgrades as the standard evolves
32/64-bit, 33/66-MHz universal PCI
1-Gbps, full-duplex Ethernet
Complete TCP/IP protocol off-load
iSCSI initiator and target modes
Jumper selectable to copper or fiber optic gigabit Ethernet interface: RJ45 gigabit Ethernet connector
Small form factor (LC) fiber optic connector
1.4
Contact Information
QLogic encourages all feedback. iSCSI is in its infancy, so new issues arise daily. We at QLogic are looking forward to working in partnership with you to develop your iSCSI solution. We will continue to have software upgrades that improve functionality and performance. While we will notify you when any official release becomes available, we seek your input on what needs you have that we should address in future updates.
If you have questions, problems, or feedback on this product, please contact your local QLogic representative/FAE.
1.5
Release Contents
This QLA4000 release contains the following key pieces:
QLA4000 iSCSI HBA
One CD-ROM (CD) with the following contents: This document Driver directory with drivers for:
Windows NT Windows 2000
SANblade Control IX directory with:
GUI application installation (setup.exe) Support files
1-2 IS0053301-00 A
Part I
Hardware
This part of the SANblade 4000 User’s Guide describes the host bus adapters (HBAs) and how to install and configure them. See the section that corresponds to your HBA.
HBA Section
QLA4000-DEV 2
ISO053301-00 A I-1
I – Hardware
I-2 ISO053301-00 A
Section 2
QLA4000-DEV
2.1
QLA4000-DEV Components
Figure 2-1 identifies the QLA4000-DEV components referenced throughout this
section. Each QLA4000-DEV has a unique serial number; its location on the HBA is noted
in figure 2-1. Take a minute to write down the serial number of the QLA4000-DEV.
SERIAL NUMBER
J1
LED1
J2
J6
2 1
Figure 2-1. QLA4000-DEV Layout
10 9
IS0053301-00 A 2-1
2 – QLA4000-DEV Installation in the Computer
2.1.1
LEDs
Figure 2-2 identifies and describes the activity of QLA4000-DEV LEDs.
CONNECTOR
Amber LED (LNK): ON = link established OFF = no link found
Green LED (ACT): ON = receive/transmit activity OFF = no activity
GREEN LED AMBER LED
CONNECTOR
Figure 2-2. QLA4000-DEV LED Activity
2.1.2
Jumpers
The J6 jumper block (also identified as CONFIG) controls which gigabit Ethernet interface is selected. Pins 5–6 (INT SEL) select which connector is used:
To use the copper connector (J1), put a jumper plug on pins 5–6.
To use the fiber optic connector (J2), do not put a jumper plug on pins 5–6.
NOTE: You cannot use both connectors at the same time.
2.2
Installation in the Computer
Before you install the QLA4000-DEV in your computer, you need the following:
A screwdriver (usually a Phillips #1)
An optical mutimode cable with an LC-style duplex connector if using the J2
connector (selected by no jumper plug on pins 5–6 of the J6 jumper block)
A Cat5e or Cat6 straight-through cable (not cross-over cable) with an RJ45
connector if using the J1 connector (selected by putting a jumper plug on page 5–6 of the J6 jumper block)
2-2 IS0053301-00 A
2 – QLA4000-DEV
Installation in the Computer
CAUTION! The QLA4000-DEV contains parts that can be damaged by ESD.
Before handling the QLA4000-DEV, use standard methods to discharge static electricity. Keep the QLA4000-DEV in the antistatic bag until you are ready to install it. Place the HBA on the bag when you examine or configure it. Retain the bag for future use.
Perform the following steps to install the QLA4000-DEV in your PC:
1. Check the motherboard and make any configuration changes necessary to accommodate the QLA4000-DEV.
The QLA4000-DEV is self-configuring; however, some motherboards require manual configuration. For example, some systems have a PCI Device Configuration menu in the motherboard setup BIOS where you must enable HBAs, bus master slots, and IRQ levels. If the motherboard supports triggering, use level triggering for the QLA4000-DEV. See the documentation supplied with your computer, or contact your computer dealer to determine if your motherboard requires configuration.
2. Power down the peripherals, then the computer.
3. Remove the computer cover and save the screws.
4. Choose any PCI bus slot that supports bus mastering. Most motherboards automatically assign an IRQ level and interrupt line; if your motherboard does not, you must assign the IRQ level and use interrupt line A for this slot.
NOTE:
Some motherboards have two kinds of PCI bus slots: master
and slave. The QLA4000-DEV must be in a PCI bus master slot. (Some motherboards have PCI bus master slots that are shared with onboard devices. QLA4000-DEVs do not work in shared slots.)
PCI connectors vary among system HBA manufacturers. The
QLA4000-DEV is a 64-bit PCI device that can function in a 32-bit PCI slot; the slot conforms to the PCI specification (the rear edge of the PCI slot is notched). If you try to install the QLA4000-DEV into a PCI slot that does not conform to the PCI specification, you may damage the QLA4000-DEV.
PCI and PCI-X slots look the same. If the PC contains both PCI
and PCI-X slots, refer to the PC manufacturers instructions to determine the slot type.
The QLA4000-DEVs are designed and tested to operate at PCI
bus speeds of up to 66 MHz.
5. Remove the slot cover for the slot in which you will install the QLA4000-DEV.
6. Place the QLA4000-DEV into the slot. Carefully press the HBA into the slot until it seats firmly.
IS0053301-00 A 2-3
2 – QLA4000-DEV Specifications
7. Secure the QLA4000-DEV to the chassis. Follow the PC manufacturer’s instructions.
8. Connect the appropriate cable from the devices to the corresponding connector.
9. Carefully reinstall the computer cover. Insert and tighten the computer cover screws.
10. Power up the PC.
See the appropriate section for detailed instructions on how to install the software drivers. See section 5 for detailed instruction on how to install the SANblade Control IX GUI.
2.3
Specifications
Ta bl e 2 - 1 defines the QLA4000-DEV specifications.
Table 2-1. QLA4000-DEV Operating Environment
Environment Minimum Maximum
Operating temperature 0°C/32°F 55°C/131°F Storage temperature –20°C/–4 °F 70°C/158°F Relative humidity (noncondensing) 10% 90% Storage humidity (noncondensing) 5% 95%
2.4
Label
The transceiver on the QLA4000-DEV is a Class I laser product. It complies with IEC 825-1 and FDA 21 CFR 1040.10 and 1040.11. The transceiver must be operated under recommended operating conditions.
CLASS I LASER PRODUCT
2.5
Agency Certification
This information was not available at the time of publication.
2-4 IS0053301-00 A
Part II
Software
This part of the SANblade 4000 Series Users Guide describes how to install the software drivers for the supported operating systems.
Software Section
Windows 2000 driver 3 Windows NT driver 4
Before you install the software drivers, you need to locate and download the appropriate drivers for your operating system. Please contact your sales representative for the latest firmware.
IS0053301-00 A II-1
II – Software
II-2 IS0053301-00 A
Section 3
Windows 2000 Driver Installation
(QL4000.SYS)
3.1
Supported Features
The Windows 2000 driver (QL4000.sys) supports the iSCSI features provided by the QLogic QLA4000-DEV iSCSI PCI HBA.
3.2
Driver Files
The following files are provided for installation of the Windows 2000 driver:
\W2K\QLOGICDiskette identification file
\W2K\TXTSETUP.OEMDriver installation script for text mode installation
\W2K\W2K\OEMSETUP.INFDriver installation script
\W2K\W2K\QL4000.CATCatalog file
\W2K\W2K\QL4000.SYSQLogic QL4000 PCI miniport driver
\W2K\W2K\RELEASE.TXTRelease notes
\W2K\W2K\README.TXTHelpful hints about the driver
Be sure to review the README.TXT file for both new and changed information.
3.3
Creating the Driver Disk (Optional)
Follow these steps to create the driver disk:
1. Insert a blank disk in the floppy disk drive.
2. Select the appropriate driver directory on the QLogic CD-ROM (CD).
3. Click, then drag the driver directory from the CD to the blank disk. The disk should have the following file structure:
QLOGICDiskette identification file TXTSETUP.OEMDriver installation script for text mode installation W2K\OEMSETUP.INFDriver installation script W2K\QL4000.CATCatalog file W2K\QL4000.SYSQLogic QL4000 PCI Miniport driver W2K\RELEASE.TXTRelease notes \W2K\README.TXTHelpful hints about the driver
IS0053301-00 A 3-1
3 – Windows 2000 Driver Installation Installing the Driver
3.4
Installing the Driver
This section is divided into the following three sections:
Initial OS Installation with the QLA4000-DEV as an Add-on
Adding the QLA4000-DEV to the Existing OS
Updating the Existing Driver
NOTE: The system cannot boot from the device attached to the QLA4000-DEV.
3.4.1
Initial OS Installation with the QLA4000-DEV as an Add-On
NOTE:
The system cannot boot from a device attached to the QLA4000;
consequently, the OS cannot be installed on the device attached to the QLA4000.
You must create a driver disk (see section 3.3) when installing the OS
and the QL4000.SYS driver. You cannot install the QL4000.SYS driver directly from the QLogic CD.
Perform the following steps to install Windows 2000 and the QL4000.SYS driver when the QLA4000-DEV is attached to a nonbootable device:
1. Start the Windows 2000 installation procedure using the Setup disks or CD.
2. If you are booting from the CD and the following message displays, press F6:
Press F6 if you want to install a third party SCSI or RAID Driver... After all the standard devices have been loaded, press S to Specify
Additional Device. Go to step 5.
3. If you are booting from the floppy disk, after the standard devices have been detected and configured, press S to Specify Additional Device.
4. Select Other and press ENTER.
5. Insert the QLogic driver disk created in section 3.3 and press ENTER.
6. Select the QLogic QLA4000 PCI iSCSI Adapter, then press ENTER.
7. Continue with standard installation procedure.
3-2 IS0053301-00 A
3 – Windows 2000 Driver Installation
3.4.2
Installing the Driver
Adding the QLA4000-DEV to the Existing OS
Perform the following steps to add the QL4000.SYS driver to an existing Windows 2000 system:
1. Install the QLA4000-DEV in the appropriate slot on your computer (see
section 2.2).
2. Restart or power up your computer.
3. When your computer powers up, Windows 2000 detects the newly installed device, then displays the Found New Hardware with SCSI Host Bus Adapter message. The Found New Hardware Wizard program is launched to begin installing the QL4000.SYS driver for the QLA4000-DEV.
4. Click Next.
5. Select Search for a suitable driver for my device (recommended). Click Next.
6. Select specify a location. Click Next.
7. In the Install From Disk dialog box, type the path to the QLogic driver directory on the CD and click OK. For example:
D:\W2K\W2k
8. Click Next.
9. In the Start Device Driver Installation dialog box, click Next.
10. When the Digital Signature Not Found dialog box displays, click Yes.
11. In the Upgrade Device Driver Wizard/Completing the Upgrade Device Driver Wizard dialog box, click Finish.
12. The following message displays:
Your hardware settings have changed. You must restart your computer for these changes to take effect.
Do you want to restart your computer now?
Click Yes.
IS0053301-00 A 3-3
3 – Windows 2000 Driver Installation Removing the Driver
3.4.3
Updating the Existing Driver
Perform the following steps if the QL4000.SYS driver is already installed and you want to install an updated version of the driver:
1. To start the Device Manager, click Start, point to Settings, click Control Panel, double-click the System applet, select the Hardware tab, and click the Device Manager button.
2. Use the scroll bar to scroll down the list of hardware types. Double-click SCSI and RAID Host Bus Adapter.
3. Double-click QLogic QLA4000 PCI iSCSI Adapter from the devices list. The Adapter Property window displays.
4. Click the Driver tab, then click Update Driver to start the Upgrade Device Driver Wizard. Click Next.
5. Select Display a list of the known device drivers for this device so that I can choose a specific driver. Click Next.
6. Click Have Disk. Insert the QLogic CD in an appropriate drive.
7. In the Copy manufacturer’s files from dialog box, type the path to the QLogic driver directory on the CD and click OK. For example:
D:\W2K\W2k
8. In the Upgrade Device Driver Wizard/Select a Device Driver dialog box, click Next.
9. In the Upgrade Device Driver Wizard/Start Device Driver Installation dialog box, click Next.
10. When the Digital Signature Not Found dialog box displays, click Yes.
11. In the Upgrade Device Driver Wizard/Completing the Upgrade Device Driver Wizard dialog box, click Finish.
12. The following message displays:
Your hardware settings have changed. You must restart your computer for these changes to take effect. Do you want to restart your computer now?
Click Yes to restart the computer.
3.5
Removing the Driver
To uninstall the QLA4000-DEV, power down your computer and remove the device from your computer according to the manufacturers instructions.
3-4 IS0053301-00 A
3 – Windows 2000 Driver Installation
NOTE: You do not have to use the Device Manager or the Hardware Wizard to
uninstall the QLA4000-DEV. After you have removed the QLA4000-DEV and restarted your computer, Windows 2000 recognizes that it has been removed.
3.6
System Registry Parameters
System Registry Parameters
The following system registry parameters are available with the QLA4000-DEV:
MaximumSGList
NumberofRequests
3.6.1
MaximumSGList
Windows 2000 includes enhanced scatter/gather list support for doing large SCSI I/O transfers. Windows 2000 supports up to 256 scatter/gather segments of 4096 bytes each, allowing transfers up to 1,048,576 bytes.
NOTE: The OEMSETUP.INF file automatically updates the registry to support
65 scatter/gather segments. This setting provides the best overall performance.
To change this value, follow these steps:
1. Click Start, click Run, and open the REGEDT32 program.
2. Select HKEY_LOCAL_MACHINE and follow the tree structure to the
QLogic driver:
HKEY_LOCAL_MACHINE
SYSTEM
CurrentControlSet
Services
Ql4000
Parameters
Device
3. Double-click MaximumSGList:REG_DWORD:0x41.
4. Enter a value from 16 to 255 (10h to FFh). A value of 255 (FFh) enables the maximum 1-MB transfer size. Any value above 255 enables 64K transfers. The default value is 33 (21h).
5. Click OK.
6. Exit the REGEDT32 program, then restart the system.
IS0053301-00 A 3-5
3 – Windows 2000 Driver Installation System Registry Parameters
3.6.2
NumberofRequests
Windows 2000 supports the NumberOfRequests registry parameter to specify the maximum number of outstanding requests per HBA. When the QLogic driver is installed, the registry is automatically updated with this parameter set to a value of 150 (96h).
WARNING!!
Do not increase this parameter above 150. Doing so can result in a system failure.
3-6 IS0053301-00 A
Section 4
Windows NT Driver Installation
(QL4000.SYS)
4.1
Supported Features
The Windows NT driver (QL4000.sys) supports the iSCSI features provided by the QLogic QLA4000-DEV iSCSI PCI HBA. This driver works with the Windows NT (x86) release with SP6. Earlier versions of Windows NT and SP are not supported.
4.2
Driver Files
The following files are provided for installation of the Windows NT driver:
\NT4\QLOGICDiskette identification file
\NT4\TXTSETUP.OEMDriver installation script for text mode installation
\NT4\NT4\OEMSETUP.INFDriver installation script
\NT4\NT4\QL4000.CATCatalog file
\NT4\\T4\QL4000.SYSQLogic QL4000 miniport driver
\NT4\NT4\RELEASE.TXTRelease notes
\NT4\NT4\README.TXTHelpful hints about the driver
Be sure to review the README.TXT file for both new and changed information.
4.3
Creating the Driver Disk (Optional)
Follow these steps to create the driver disk:
1. Insert a blank disk in the floppy disk drive.
2. Select the appropriate driver directory on the QLogic CD-ROM (CD).
3. Click, then drag the driver directory from the CD to the blank disk.
4.4
Installing the Driver
This section is divided into the following three sections:
Initial OS Installation with the QLA4000-DEV as an Add-on Device
Adding the QLA4000-DEV Driver to the Existing OS
Updating the Existing Driver
NOTE: The system cannot boot from the device attached to the QLA4000-DEV.
IS0053301-00 A 4-1
4 – Windows NT Driver Installation Installing the Driver
4.4.1
Initial OS Installation with the QLA4000-DEV as an Add-on Device
NOTE:
The system cannot boot from a device attached to the QLA4000;
consequently, the OS cannot be installed on the device attached to the QLA4000.
You must create a driver disk (see section 4.3) when installing OS and
the QL4000.SYS driver. You cannot install the QL4000.SYS driver directly from the QLogic CD.
Perform the following steps to install Windows NT and the QL4000.SYS driver when the QLA4000-DEV is attached to a nonbootable device:
1. Start the installation procedure using the Windows NT Setup disks.
2. After the standard devices have been detected and configured, press S to
Specify Additional Device.
3. Select Other and press ENTER.
4. Insert the QLogic driver disk created in section 4.3 in an appropriate drive and press ENTER.
5. Select the QLogic QLA4000 PCI iSCSI Adapter and press ENTER.
6. Continue with the standard installation procedure.
4.4.2
Adding the QLA4000-DEV Driver to the Existing OS
Perform the following steps to add the QL4000.SYS driver to an existing Windows NT system:
1. Click Start, point to Settings, then click Control Panel.
2. Double-click the SCSI Adapters icon.
3. Click the Drivers tab, and then click the Add button.
4. Click Have Disk. Insert the QLogic CD in an appropriate drive.
5. In the Copy manufacturers files from dialog box, type the path to the QLogic driver directory on the CD and click OK. For example:
D:\QLA4000 drivers\NT4.0\NT4
6. Select QLogic QLA4000 PCI iSCSI Adapter, then click OK.
7. Click Yes to restart system.
4-2 IS0053301-00 A
4 – Windows NT Driver Installation
4.4.3
System Registry Parameters
Updating the Existing Driver
Perform the following steps if the QL4000.SYS driver is already installed and you want to install an updated version of the driver:
1. Click the Start button, point to Programs, then click Command Prompt.
2. Change the current directory to the Windows NT driver directory:
CD %SystemRoot%\SYSTEM32\DRIVERS
3. Make a backup copy of the old driver:
COPY QL4000.SYS QL4000.SAV
4. Insert the QLogic CD in an appropriate drive and copy it over the old driver:
COPY D:\QLA4000 drivers\NT4.0\NT4\QL4000.SYS
5. Power down, then restart the system to use the updated driver.
4.5
Removing the Driver
Perform the following steps to uninstall the QL4000.SYS driver from Windows NT:
1. Click Start, point to Settings, then click Control Panel.
2. Double-click the SCSI Adapters icon.
3. Click the Drivers tab, then click QLogic QLA4000 PCI iSCSI Adapter.
4. Click Remove.
5. Click Yes to restart system.
4.6
System Registry Parameters
The following system registry parameters are available with the QLA4000-DEV:
MaximumSGList
NumberofRequests
LargeLuns
IS0053301-00 A 4-3
4 – Windows NT Driver Installation System Registry Parameters
4.6.1
MaximumSGList
Windows NT includes enhanced scatter/gather list support for doing large SCSI I/O transfers. Windows NT supports up to 256 scatter/gather segments of 4096 bytes each, allowing transfers up to 1,048,576 bytes.
NOTE: The OEMSETUP.INF file automatically updates the registry to support
33 scatter/gather segments. This setting provides the best overall performance.
To change this value, follow these steps:
1. Click Start, click Run, and open the REGEDT32 program.
2. Select HKEY_LOCAL_MACHINE and follow the tree structure to the QLogic driver:
HKEY_LOCAL_MACHINE
SYSTEM
CurrentControlSet
Services
Ql4000
Parameters
Device
3. Double-click MaximumSGList:REG_DWORD:0x21.
4. Enter a value from 16 to 255 (10h to FFh). A value of 255 (FFh) enables the maximum 1-MB transfer size. Any value above 255 enables 64K transfers. The default value is 33 (21h).
5. Click OK.
6. Exit the REGEDT32 program, then restart the system.
4.6.2
NumberofRequests
Windows NT supports the NumberOfRequests registry parameter to specify the maximum number of outstanding requests per board. When the QLogic driver is installed, the registry is automatically updated with this parameter set to a value of 150 (96h).
WARNING!!
Do not increase this parameter above 150. Doing so can result in a system failure.
4-4 IS0053301-00 A
4 – Windows NT Driver Installation
4.6.3
Additional Notes
LargeLuns
Windows NT with service pack 4 or higher supports 255 LUNs. Through the SCSI Miniport driver, set the LargeLuns parameter in the registry.
The QLogic OEMSETUP.INF file has this registry enabled.
4.7
Additional Notes
To ensure correct driver function, the driver changes some of the system-related registry entries in the OEMSETUP.INF file during driver installation, for example, the disk timeout value of the system disk driver. These values are not restored when the driver is removed.
IS0053301-00 A 4-5
4 – Windows NT Driver Installation Additional Notes
4-6 IS0053301-00 A
Part III
SANblade Control IX
This part of the SANblade 4000 Series Users Guide describes the SANblade Control IX GUI, a stand-alone application for configuring your QLA4000 HBA, referred to as HBA or adapter.
Section 5 contains the following information:
An overview of SANblade Control IX
Installation instructions
Operating instructions
IS0053301-00 A III-1
III – SANblade Control IX
III-2 IS0053301-00 A
Section 5
SANblade Control IX
5.1
Introduction
The QLA4000-DEV includes the SANblade Control IX GUI. The SANblade Control IX GUI interface runs on the Windows NT and Windows 2000 operating systems. SANblade Control IX configures the QLA4000-DEV that resides in the host PC and allows you to:
Set the QLA4000-DEVs basic configuration (IP address, iSCSI name, etc.)
Enter iSCSI target information (IP addresses of targets to which you want
to connect)
Read back useful QLA4000-DEV and target information.
5.2
Installation Procedure
Follow these steps to install the SANblade Control IX GUI:
1. Insert the QLogic CD in an appropriate drive.
2. Click Start menu, then click Run. Type the following, then click OK.
<drive>:\SANblade Control IX \setup.exe
3. Select the directory in which you want SANblade Control IX to reside.
4. Click on the icon to install SANblade Control IX.
5. To run SANblade Control IX, click Start, select Programs, select the install group (the default is QLogic), then click SANblade Control IX.
5.3
Operation
The following sections describe SANblade Control IX and provide instructions on how to configure the QLA4000-DEV, configure targets, and upgrade the firmware.
NOTE: You must configure the QLA4000-DEV (see section 5.3.2) before you can
configure targets or perform a firmware upgrade.
IS0053301-00 A 5-1
5 – SANblade Control IX Operation
5.3.1
Selection Tabs
The SANblade Control IX selection tabs are summarized in the following paragraphs.
Use the HBA Options tabbed page first to set basic QLA4000-DEV information, such as IP address, iSCSI alias, etc. You can also view firmware configuration values and upgrade the firmware (see figure 5-1).
Figure 5-1. HBA Options with Firmware Tabbed Page
5-2 IS0053301-00 A
5 – SANblade Control IX
Target Settings is the primary tabbed page for interactive use. Use this page to select iSCSI targets (see figure 5-2).
Operation
Figure 5-2. Target Settings Tabbed Page
IS0053301-00 A 5-3
5 – SANblade Control IX Operation
The Target Information tabbed page provides information about iSCSI targets (you cannot configure iSCSI targets on this page) (see figure 5-3).
Figure 5-3. Target Information Tabbed Page
5-4 IS0053301-00 A
5 – SANblade Control IX
The HBA Information tabbed page is for information only. It provides code versions, etc. (see figure 5-4).
Operation
Figure 5-4. HBA Information Tabbed Page
The Statistics tabbed page is reserved for future use.
IS0053301-00 A 5-5
5 – SANblade Control IX Operation
5.3.2
Configuring the QLA4000-DEV
The first step in using SANblade Control IX is to configure the QLA4000-DEV. After starting SANblade Control IX (see step 5 in section 5.2), double-click the name of your host PC (left side of the screen), then highlight the QLA4000-DEVs iSCSI name (see figure 5-5).
Figure 5-5. Information Tabbed Page
The selection tabs are displayed. Click the HBA Options tab, then follow these steps:
1. Insert the desired IP address in the top section of the screen.
2. Insert the subnet mask:
a. From the Select Options list, click Network (see figure 5-6). b. Enter the subnet mask.
5-6 IS0053301-00 A
5 – SANblade Control IX
Operation
Figure 5-6. HBA Options with Network Tabbed Page
Entering the following information in the HBA Options tabbed page is optional:
Gateway information
iSCSI alias (the default is none)
iSCSI name (the default is per the iSCSI standard, you can change it).
Firmware configuration settings (viewing): From the Select Options list, click Firmware. Click View. This dialog box allows you to see various firmware
configuration values, iSCSI parameters, timeouts, etc.
Upgrade the firmware (see section 5.3.4).
After inputting your desired configuration, click Save. NOTE: When entering information for the IP address, gateway, and subnet mask,
enter a tab to move to the next field.
IS0053301-00 A 5-7
5 – SANblade Control IX Operation
5.3.3
Configuring Targets
After configuring the QLA4000-DEV, you can enter iSCSI targets you want to discover. Start SANblade Control IX (see step 5 in section 5.2), select your host and HBA, then click the Target Settings tab. When the QLA4000-DEV arrives from the factory, there are no targets listed. Add iSCSI targets by either entering specific iSCSI target information (IP address and iSCSI name, see section 5.3.3.1) or by entering an IP address and discovering the devices behind that address (see
section 5.3.3.2).
5.3.3.1
Configuring Specific Targets
To configure a specific iSCSI target, follow these steps:
1. Start SANblade Control IX, select your host and HBA, then click the Target Settings tab.
2. Click the first available line under IP Address (see figure 5-2).
3. Enter the IP address of the target to which you want to connect.
4. Enter the iSCSI name of the target.
5. Enter other targets as desired.
6. Click Save. The QLA4000-DEV does the following: a. Resets (reboots the HBA only) b. Connects to the target c. Queries the target through a SendTargets command d. Discovers all devices allowed by the target e. Makes these new targets available on the SANblade Control IX Target
Settings tabbed page
7. Restart the host PC for the operating system to recognize the new targets.
8. The QLA4000-DEV restarts and attempts to connect to the configured targets.
5.3.3.2
Configuring Using Discovery
Use the discovery mechanism to configure a target that supports and responds to the SendTargets command by following these steps:
1. Start SANblade Control IX, select your host and HBA, then click the Target Settings tab.
2. Click the first available line under IP Address (see figure 5-2).
5-8 IS0053301-00 A
5 – SANblade Control IX
3. Enter the IP address of the target to which you want to connect. This target must support the SendTargets command.
4. Leave the iSCSI Name field blank.
5. Click Save. The QLA4000-DEV does the following: a. Resets (reboots the HBA only)
b. Connects to the target c. Queries the target through a SendTargets command d. Discovers all devices allowed by the target e. Makes these new targets available on the SANblade Control IX Target
Settings tabbed page
6. Restart the host PC for the operating system to recognize the new targets.
The discovery method is an excellent timesaver for finding and entering iSCSI targets. You can use this method to find all available targets, delete targets you don’t want, and then have access only to the remaining devices. This method prevents you from having to enter iSCSI names for each target. In the following example, there is an iSCSI target at IP address 10.14.64.150. Behind this target are two available drives with iSCSI alias’ Drive1 and Drive2.
Operation
1. On the Target Settings tabbed page, under IP Address, enter IP address
10.14.64.150.
2. Leave the iSCSI Name field blank.
3. Click Save.
4. Click the Target Settings tab. The following three targets appear:
IP address 10.14.64.150 IP address 10.14.64.150 with iSCSI alias Drive1 IP address 10.14.64.150 with iSCSI alias Drive2
5. Restart the host PC for the operating system to recognize the new targets.
CAUTION! The iSCSI port number defaults to 3260. Do not change this number
unless required by the configured target.
5.3.4
Firmware Upgrade
If you are receiving a QLA4000-DEV for the first time, the current version of firmware is already loaded.
If you are upgrading a QLA4000-DEV, follow the instructions in this section to load the latest firmware from the CD. The HBA Information tab in SANblade Control IX displays the firmware version you are using.
IS0053301-00 A 5-9
5 – SANblade Control IX Operation
To upgrade the firmware, follow these steps:
1. Start SANblade Control IX: click Start, select Programs, select the install group (the default is QLogic), then click SANblade Control IX.
2. Select your HBA.
3. Click the HBA Options tab.
4. From the Select Options list, select Firmware.
5. Click the Select File to Download button.
6. When the Update FW dialog box displays, click Browse.
7. The Choose File to Download dialog box displays. Select the firmware file from the CD: cd\firmware\iscsidemo.ver_xx_xx_xx_xx, then click Open
(see figure 5-7).
Figure 5-7. Update Firmware Dialog Boxes
8. Click Save.
9. Follow the instructions to reset the QLA4000-DEV.
10. Restart the host PC for the operating system to recognize the new firmware.
5-10 IS0053301-00 A
5 – SANblade Control IX
Operation
5.3.5
Default Parameters
Table 5-1 lists the initial login parameters sent during discovery session login.
Table 5-1. Initial Login Parameters, Discovery Session
Parameter Setting
InitiatorName Inq-2000-04.com.qlogic.qla-4000.snXXXXXXXX
SessionType discovery
InitiatorAlias theConfiguredAlias
Table 5-2 lists the initial login parameters sent during normal session login.
Table 5-2. Initial Login Parameters, Normal Session
Parameter Setting
InitiatorName Inq-2000-04.com.qlogic.qla-4000.snXXXXXXXX
TargetName theConfiguredTargetName
SessionType normal
InitiatorAlias theConfiguredAlias
ImmediateData Yes
DataPDULength 128
MaxBurstSize 128
FirstBurstSize 128
MaxOutstandingR2T 256
DataPDUInOrder Disabled
DataSequenceInOrder Disabled
For login parameters not included in negotiation, the iSCSI Draft-8 defaults are assumed. For example, InitialR2T=yes and ErrorRecoveryLevel=0.
IS0053301-00 A 5-11
5 – SANblade Control IX Operation
5-12 IS0053301-00 A
Loading...