Qlogic Solaris x86

Symmetrix Fibre Channel with Qlogic QLA2200F-EMC Host Bus Adapters in the Solaris X86 Environment
Rev 4, October 2000
Copyright 2000 EMC Corporation. All rights reserved.

No part of this publication may be reproduced or distributed in any form or by any means, or stored in a database or retrieval system, without the prior written consent of EMC Corporation. The information contained in this document is subject to change without notice. EMC Corporation assumes no responsibility for any errors that may appear. All computer software programs, including but not limited to microcode, described in this document are furnished under a license, and may be used or copied only in accordance with the terms of such license. EMC either owns or has the right to license the computer software programs described in this document. EMC Corporation retains all rights, title and interest in the computer software programs. EMC Corporation makes no warranties, expressed or implied, by operation of law or otherwise, relating to this document, the products or the computer software programs described herein. EMC CORPORATION DISCLAIMS ALL IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. In no event shall EMC Corporation be liable for (a) incidental, indirect, special, or consequential damages or (b) any damages whatsoever resulting from the loss of use, data or profits, arising out of this document, even if advised of the possibility of such damages.
Trademark Information
EMC2 (the EMC logo), EMC, MOSAIC:2000, and Symmetrix are registered trademarks, and EMC Enterprise Storage, EMC Storage Logic, Celerra, Connectrix, CopyPoint, DataReach, Extended-Online, FarPoint, InfoMover, PowerPath, SDMS, SRDF, TimeFinder, The EMC Effect, and The Enterprise Storage Company are trademarks of EMC Corporation. Sun, Solaris X86, and Ultra are trademarks of Sun Microsystems, Inc. x86 and Ultrax86 are trademarks of x86 International, Inc., licensed exclusively to Sun Microsystems, Inc. All other trademarks used herein are the properties of their respective owners.
Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts
Introduction
Introduction
This document describes the procedures for installing a Qlogic QLA2200F-EMC host bus adapter (HBA) into a Solaris X86 (version 7) host and configuring the host for connection to EMC Symmetrix over Fibre Channel arbitrated loop or fabric. Check the EMC Host Support Matrix for the latest information on approved connectivity equipment. This document includes the following sections: Arbitrated Loop Configurations on page 4 Contains steps that are required if you are installing a QLA2200F-EMC HBA into a Solaris X86 host that will connect to Symmetrix over Fibre Channel arbitrated loop. Fabric Configurations on page 23 Contains steps that are required if you are installing a QLA2200F-EMC HBA into a Solaris X86 host that will connect to Symmetrix over Fibre Channel fabric.
Arbitrated Loop Configurations

This section describes the procedures required to install one or more Qlogic QLA2200F-EMC host bus adapters into a Solaris 7 X86 host and configure the host for Symmetrix Fibre Channel arbitrated loop.
Setup Checklist
The following is a step-by-step checklist of the procedures used to integrate a Solaris X86 host with the Symmetrix using the Qlogic QLA2200F-EMC HBA in an FC-AL environment. Each step includes references to the specific procedures. Follow these steps in order, to ensure proper HBA setup.
This installation should be performed only by personnel having a basic knowledge of Solaris X86 system administration.
Step
Done?
Before beginning configuration to integrate the Solaris 7 X86 with the Symmetrix, ensure that all hardware and patch configurations are EMC-qualified. Obtain all EMC-qualified configurations from your EMC customer representative. Verify the following: a. b. c. The host server is EMC-qualified. The hub (if required) is EMC-qualified. The patch configuration for the Solaris 7 X86 host is EMC-qualified.
n/a
Verify that the QLA2200F-EMC HBA is installed in the Solaris X86 host system, and that the Symmetrix is connected to the HBA, either directly or through a hub. a. For information on installing the HBA, refer to the Qlogic Hardware Install Guide QLA2000/2000F/2100/2100F/ 2200/2200.
Step
Done?
Boot the host and verify the correct HBA BIOS version (1.59) and firmware settings. Upgrade the HBA BIOS if necessary. a. b. c. To verify the BIOS version, refer to Verifying the Correct HBA BIOS Version on page 6. To verify the firmware settings, refer to Setting the Firmware Variables on page 7. To upgrade the HBA BIOS, refer to Upgrading HBA Firmware/BIOS on page 8.
n/a
Use the scan utility function of the HBA firmware utility to verify that the HBA "sees" the Symmetrix. (Refer to Scanning for the Symmetrix on an HBA BIOS Level on page 9.) Obtain the latest EMC-approved disk image driver for the QLA2200F-EMC HBA; then create a driver installation diskette and install the driver into the host: a. b. c. To obtain the latest disk image driver, refer to Obtaining the QLA2200 Driver Disk Image Driver on page 11. To create a driver diskette, refer to Creating the Driver Diskette on page 12. To install the driver, refer to Installing or Upgrading the HBA Driver from a Diskette on page 12. n/a n/a
Configure the driver file /kernel/drv/qla2200.conf by creating an instance number for each HBA for all variables, and verifying all settings: a. To verify that there is an HBA instance number for every setting in qla2200.conf, refer to Driver Configuration in the qla2200.conf File on page 14. To verify that all settings are configured properly, refer to Variable Settings on page 15.
b.
Step
Done?
Verify that the following system files are configured properly: a. b. /kernel/drv/sd.conf. Refer to /kernel/drv/sd.conf on page 19. /etc/system. Refer to /etc/system on page 22.
n/a
After steps 1 through 7 are complete and the system has been rebooted, you will be able to see all Symmetrix devices in the /dev/rdsk/ directory. For a list of all targets and LUNs recognized by the host, issue the format command.
HBA BIOS-Level Configurations
Setup Checklist step 3 After installing all QLA2200F-EMC HBAs into the host, follow these steps for each QLA2200F-EMC. There are some redundant settings between the firmware utility and the driver configuration file (QLA2200.conf). However, the driver configuration variable settings supersede the corresponding settings in firmware utility. Setup Checklist step 3a HBA BIOS version 1.59 is required. You can determine the HBA BIOS version at boot time from the QLA2200 banner or from the QLA2200 Fast!Util Options menu. To determine the HBA BIOS version from the QLA2200 banner, boot the host and watch for the QLA2200F banner (shown in Figure 1). The banner disappears quickly, so watch carefully. If the ROM BIOS version is not 1.59, upgrade the HBA BIOS as described under Upgrading HBA Firmware/BIOS on page 8. If the ROM BIOS version is 1.59, continue to Setting the Firmware Variables on page 7.
Verifying the Correct HBA BIOS Version
Figure 1

Qlogic Corporation QLA2200 PCI Fibre Channel ROM BIOS Version 1.59 Copyright Qlogic Corporation 1993-1999 All rights reserved Press <ALT - Q> for Fast!UTIL www.qlogic.com
QLA2200F-EMC Banner Example
To determine the HBA BIOS version from the QLA2200 Fast!Util Options menu: a. Boot the host. As soon as the QLA2200F banner (Figure 1) appears, press ALT-Q to display the Fast!Util Options menu. b. Select Configuration Settings from the menu. c. Select Host Adapter Settings from the Configuration Settings menu. d. Under Host Adapter Settings, note the BIOS Version: > If the version is not 1.59, upgrade the HBA BIOS as described under Upgrading HBA Firmware/BIOS on page 8, then go to Setting the Firmware Variables on page 7. > If the version is 1.59, continue to Setting the Firmware Variables on page 7.
Setting the Firmware Variables
Setup Checklist step 3b This procedure assumes that you are already in Fast!Util. If you are not, boot the host, and as soon as the QLA2200F banner (see Figure 1 on page 6) appears, press ALT-Q to display the Fast!Util Options menu. 1. From the Fast!Util Options menu, select Configuration Settings. 2. On the Configuration Settings menu, select Restore Default Values. 3. On the Configuration Settings menu, select Advanced Adapter Settings. 4. Change the setting for Execution Throttle to 20. 5. Change the setting for Luns Per Target to 128. (The factory setting is 8, but this must be changed to utilize all 128 LUNs available from the Symmetrix.) 6. Press ESC to return to the Configuration Settings menu. 7. On the Configuration Settings menu, select Extended Firmware Settings. 8. Change the setting for Connection Options to 0. 9. Press ESC twice and save all changes.
10. Reboot and use the Fibre Disk utility to verify the disk media, as described under Scanning for the Symmetrix on an HBA BIOS Level on page 9. Upgrading HBA Firmware/BIOS Setup Checklist step 3c This section contains information specific to creating HBA BIOS installation disks and upgrading the BIOS to a host bus adapter. This procedure is necessary only if you need to upgrade the QLA2200F-EMC BIOS version. (Refer to Verifying the Correct HBA BIOS Version on page 6.) Create an Installation Diskette: To create a QLA2200 BIOS installation diskette, follow these steps: 1. Contact your EMC customer representative to obtain the HBA BIOS. The latest version might be available on the Qlogic website, as described in the steps below: a. Access this website: http://www/qlogic.com. b. Click Driver Downloads. c. Scroll to the bottom of the Qlogic Drivers License Agreement and click Use Qlogic Drivers/Software. d. Click EMC Approved Drivers. e. Click EMC Approved QLA22xx Drivers. f. Click Link to ROM BIOS in the ROM BIOS v1.59 section. g. Save the file as c:\22emc03bios159.zip. 2. The file is a self-extracting ZIP file that must be extracted to a bootable diskette drive, as follows: a. Open any DOS window. b. At the DOS prompt, type cd \ ENTER, to go to the root directory. c. Type 22emc03bios159 a: ENTER.
Upgrade the BIOS After the QLA2200-EMC HBA is installed in an EMC-qualified host, complete the following steps to upgrade the HBA BIOS: 1. Insert the BIOS upgrade installation diskette into the diskette drive. 2. Reboot the host. 3. After the host has rebooted, a DOS prompt appears. Type Ql2xutil /L /F ENTER.
The HBA BIOS upgrade might take a few minutes.
4. After the upgrade is complete, remove the diskette and reboot the host. During boot-up, the QLA2200F banner (see Figure 1 on page 6) should display BIOS Version 1.59.
Scanning for the Symmetrix on an HBA BIOS Level
Setup Checklist step 4 Before running Solaris 7 X86, it is prudent to verify that Symmetrix devices are seen on an HBA BIOS level. The QLA2200 has a built in utility to verify connection to the Symmetrix port, and also to verify an individual Symmetrix device. To verify that the HBA can "see" the Symmetrix, use the Fibre Disk utility to scan and verify disk media. 1. Under the Fast!UTIL Options menu, select FIBRE DISK UTILITY.
This step assumes that you are already in Fast!Util. If you are not, boot the host, and as soon as the QLA2200F banner (see Figure 1) appears, press ALT-Q to display the Fast!Util Options menu.
2. You should see SYMMETRIX in a Fibre Channel device list of all possible 125 targets, as shown below. (Page down if necessary to display all targets in the list.)
ID <Hard loop ID> VENDOR EMC PRODUCT SYMMETRIX REV <micro code revision> NODE NAME 01000006048___
If SYMMETRIX appears in the list, go to step 3. If SYMMETRIX does not appear in the list, verify the following, then start this procedure again at step 1: that the correct Symmetrix port is connected to the host that the Symmetrix is on line that the cables are not damaged 3. Use the arrow keys to highlight SYMMETRIX from the list of targets, then press ENTER. 4. A list of LUNs appears. Select any LUN from the list. 5. A Disk Utility Options menu appears. Select VERIFY DISK MEDIA. 6. Select CONTINUE WITH VERIFY. 7. After media verification has completed: If the message Media Verification Complete appears, press ESC repeatedly to exit Fast!Util and reboot the host, then continue with Installing the HBA Driver on page 11. If the media verification fails, verify: > that the Hard Loop IDs are unique between the host bus adapter and the Symmetrix. > that the cables and connectors are not damaged.
10

Installing the HBA Driver
Setup Checklist step 5 The Solaris X86 operating system interface to the Symmetrix Fibre Channel director requires HBA driver software. The driver functions at a layer below the Solaris SCSI driver to present Fibre Channel devices to the operating system as if they were standard SCSI devices. Refer to the release notes provided with the current driver for information that may be unique to new driver revisions. The driver is in a disk image format and must be copied to a diskette before driver installation. Setup Checklist step 5a The EMC-approved QLA2220 driver can be obtained from the EMC release media CD or from the Qlogic Web site. Contact your EMC Customer service representative for the Qlogic driver release CD-ROM. To copy the EMC-approved driver from the release media: 1. Insert the EMC release media into the CD drive, then log in as root. 2. Type volcheck ENTER, to ensure that the volume manager scans for a newly inserted CD. 3. Type cd /cdrom/solaris/x86/5.7/ ENTER, to go to the proper driver directory on the CD. 4. From the/cdrom/solaris/x86/5.7/ directory, type cp du2200.Z /tmp ENTER, to copy the disk image driver to the /tmp directory. 5. Proceed to Creating the Driver Diskette on page 12. To obtain the EMC-approved driver from the Qlogic Web site: 1. Access http://www/qlogic.com. 2. Click Driver Downloads. 3. Scroll to the bottom of the Qlogic Drivers License Agreement and click Use Qlogic Drivers/Software. 4. Click EMC Approved Drivers. 5. Click EMC Approved QLA22xx Drivers. 6. Click the link corresponding to the EMC-approved Solaris 7 X86 driver for QLA2200 version 3.01.
Obtaining the QLA2200 Driver Disk Image Driver
11
7. Save the compressed disk image driver file as /tmp/du2200.Z. 8. Proceed to Creating the Driver Diskette. Creating the Driver Diskette Setup Checklist step 5b 1. Copy EMC-approved version 3.01 driver du2200.Z to the /tmp directory. 2. From the /tmp directory, type uncompress du2200.Z ENTER, to uncompress a disk image of the driver. 3. From the /tmp directory, type /etc/init.d/volmgt stop ENTER, to stop the Volume Manager. 4. From the /tmp directory, type
dd if=du2200 of=/dev/rdiskette0 ENTER, to transfer the DU
diskette image file to a diskette. 5. Proceed to Installing or Upgrading the HBA Driver from a Diskette. Installing or Upgrading the HBA Driver from a Diskette Setup Checklist step 5c 1. Log on to the system as root. 2. Insert the EMC-qualified driver diskette into the diskette drive. 3. If necessary, type /etc/init.d/volmgt start ENTER to start the Volume Manager 4. Type volcheck ENTER, to run the Volume Check program. 5. Start the driver installation process by typing the following command from any directory:
/floppy/floppy0/DU/sol_27/i86pc/Tools/install.sh ENTER
6. If you are upgrading the driver and have a previously installed version of the QLA2200 driver on your system: a. Type n ENTER when prompted to create a new instance of the package. b. Type y ENTER when prompted to overwrite an installed instance of the QLA2200 driver package.
12
7. As the driver is being installed, the following information appears:

Using </> as the package base directory. ## Processing package information. ## Processing system information. 11 package pathnames are already properly installed ## Verifying package dependencies. ## Verifying disk space requirements. Installing QLogic QLA2200 PCI-SCSI Adapter as <QLA2200> ## Installing part 1 of 1. /kernel/drv/qla2200 /kernel/drv/qla2200.conf /platform/i86pc/boot/solaris/drivers/notisa.010/qla2200.bef [ verifying class <none> ] [ verifying class <master> ] ## Executing postinstall script Installation of <QLA2200> was successful.
8. Remove the driver diskette. 9. Type reboot -- -r ENTER, to reboot the system.
13
Driver Configuration in the qla2200.conf File
Setup Checklist step 6 The proper configuration of the /kernel/drv/qla2200.conf file is crucial for Symmetrix host integration and driver behavior. The driver configuration file contains important information about how the driver should behave. The file is created automatically when the HBA driver is installed. Setup Checklist step 6a There are 17 Variable settings in the qla2200.conf file. Each HBA should be given its own settings for each of the 17 variables. Each HBA variable line in QLA2200.conf corresponds to the instance number of the HBA in the file /var/adm/messages. In the example shown under Example below, hba0 of hba0-enable-adapter-hard-loop-ID=1 corresponds to instance #0 in /var/adm/messages.
unix: unix: unix: unix: unix: unix: unix: unix: unix: unix: QLogic QLA2200 Fibre Channel Driver v2.20 Instance : 0 pcplusmp: pci1077,1 (QLA2200) instance #0 vector 0x10 ioapic 0x4 intin 0x23is bound to cpu 1 PCI-device: pci1077,1@4, QLA22000 QLA22000 is /pci@2,0/pci1077,1@4 QLogic QLA2200 Fibre Channel Driver v2.20 Instance : 1 pcplusmp: pci1077,1 (QLA2200) instance #1 vector 0 x11 ioapic 0x4 intin 0x1f is bound to cpu 1 PCI-device: pci1077,1@5, QLA22001 QLA22001 is /pci@2,0/pci1077,1@5.
Configuring qla2200.conf Variables
Example:
In the following example, a separate variable line is dedicated to each HBA (hba0, hba1, and hba2).
# Adapter hard loop ID enable. # 0 = disable, 1 = enabled hba0-enable-adapter-hard-loop-ID=1; hba1-enable-adapter-hard-loop-ID=1; # Adapter hard loop ID. # Range: 0 - 126 hba0-adapter-hard-loop-ID=125; hba1-adapter-hard-loop-ID=125; Using the same hard loop ID for all HBAs is a valid configuration only in a hubless loop connection.
14
Variable Settings
Setup Checklist step 6b Table 1 lists the required settings for the configuration file variables, and descriptions of the variables follow the table. Verify that all variables are set as shown, and change any if necessary.
Changes to qla2200.conf will not take effect until the host is rebooted.
Table 1
/kernel/drv/qla2200.conf Settings for Solaris X86 Host on Loop Required Setting
Variable hba0-max-frame-length hba0-max-iocb-allocation hba0-execution-throttle hba0-login-timeout hba0-login-retry-count
Default Value 1024 bytes 256 31 4 (sec) 10
If No Hub 1024 bytes 512 20 4 (sec) 10 1 (enable) see note b 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (sec) 5 0 (enable) 60 (sec) 0 0 0
If Hub(s) 1024 bytes 512 20 4 (sec) 10 1 (enable) see note b 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (sec) 5 0 (enable) 60 (sec) 0 0 0
If PowerPath a 1024 bytes 512 20 4 (sec) 10 1 (enable) see note b 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (sec) 5 1 (disable) 60 (sec) 0 0 0
hba0-enable-adapter-hard-loop-ID 0 (disable) hba0-adapter-hard-loop-ID hba0-enable-64bit-addressing hba0-enable-LIP-reset hba0-enable-LIP-full-login hba0-enable-target-reset hba0-reset-delay hba0-port-down-retry-count hba0-link-down-error hba0-loop-down-timeout hba0-connection-options hba0-device-configuration-mode hba0-fc-tape 0 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (sec) 30 1 (disable) 60 (sec) 2 0 0
a. PowerPath is not currently supported in a hub environment. b. Each HBA and each Symmetrix port must have a unique hard loop ID.
15
Descriptions of qla2200.conf Variables hba0-frame-payload-size Configuration flag (512, 1024 or 2048 bytes) for maximum frame length. hba0-max-iocb-allocation Number of commands (1 to 750) queued internally within the HBA. Exceeding the adapters buffers causes unnecessary retries, which impact performance. The maximum setting might be less, depending on the size of the firmware. hba0-execution-throttle Maximum number of commands (1 to 65635) sent to the LUN by the firmware. Exceeding a devices capabilities causes unnecessary command retries, which impact performance. hba0-login-timeout Sets the login timeout (in seconds). hba0-login-retry-count Maximum number (0 to 255) of retries to attempt when login into a device fails. Large values can cause long delays during initialization. hba0-enable-adapter-hard-loop-ID Enables/disables the hard loop ID and activates (if enabled) the setting for variable hba0-adapter-hard-loop-ID. (See the next item.) hba0-adapter-hard-loop-ID Sets (if activated) the hard loop ID (in the range 1 to 125) for the HBA during the Loop Initialization Process (LIP). This variable becomes crucial in a hub environment, since no device (Symmetrix target or host bus adapter) can have the same hard loop ID. The host HBA is conventionally assigned the highest Hard Loop ID, starting from 125 and working down (124, 123, 122, etc.). The Symmetrix is conventionally assigned a lowest Hard Loop ID for each port, starting with 0 and working up (1, 2, 3, etc.). Example: The following example is a configuration for three QLA2200F-EMC HBAs with separate Hard Loop IDs:
# Adapter hard loop ID. # Range: 0 - 126 hba0-adapter-hard-loop-ID=125; hba1-adapter-hard-loop-ID=124; hba2-adapter-hard-loop-ID=123;
hba0-enable-64bit-addressing Enables/disables the adapter to directly access memory above 4 gigabytes with 64-bit Direct Memory Access addressing.
16
hba0-enable-LIP-reset Enables/disables the adapter to issue a LIP reset during Fibre Channel reset.
Only one of the variables hba0-enable-LIP-reset, hba0-enable-LIP-full-login, and hba0-enable-target-reset should be enabled at the same time.
hba0-enable-LIP-full-login Enables/disables the adapter to issue a LIP full login reset during Fibre Channel reset. (See the note below hba0-enable-LIP-reset.) hba0-enable-target-reset Enables/disables the adapter to issue a LIP target reset during Fibre Channel reset. (See the note below hba0-enable-LIP-reset.) hba0-enable-database-storage Enables/disables the driver to save device position on the Fibre Channel bus. hba0-reset-delay Delay after a reset before sending commands to the devices on the Fibre Channel bus. hba0-port-down-retry-count Number of command retries to be done when devices are not responding on the Fibre Channel bus. Large values may cause long delays for fail over software to detect a failing device. hba0-link-down-error Disables (if set to 0) all link_down time out values. The sd driver will not be notified of any and error conditions if the QLA2200 driver detects a link_down condition. If the Symmetrix goes off line or the link with the host is broken for any reason, the QLA2200 driver holds all pending I/Os indefinitely until the link is restored or the Symmetrix rejoins the loop. In a Power Path environment, set this variable to 1, so the PowerPath driver will be notified of any error conditions. hba0-loop-down-timeout Time the driver waits for a Fibre Channel loop to come up before reporting the failure. Small values may report transient errors that should be ignored. hba0-connection_options Is always 0 for host-to-Symmetrix arbitrated loop connections. (Other settings are possible, but should not be used.)
17
hba0-device-configuration-mode Configure loop devices, using either port or node name. This field specifies which type of Fibre Channel name will be saved in the driver database for each of the Fibre Channel device discovered. 0 = node name 1 = port name hba0-fc-tape Should always have a value of 0.
18
Editing Host Files to Incorporate Symmetrix
Setup Checklist step 7 To insure smooth integration and maximum performance from the host and Symmetrix, you must edit these files (as described in detail later): Host driver configuration file sd.conf Refer to /kernel/drv/sd.conf below. System specification file /etc/system Refer to /etc/system on page 41.
After editing either of these files, type reboot -- -r ENTER to reboot the host with the -r (reconfigure) option, which rebuilds the kernel and implements the changes. /kernel/drv/sd.conf Setup Checklist step 7a The sd.conf file is used to alert the sd driver to scan for LUNs for a specific target. There can be only one target ID per Symmetrix port. A target ID can have up to 128 LUNs. By default, Solaris X86 searches only for target IDs; if LUN addressing is required, you must modify the lower-level driver configuration file /kernel/drv/sd.conf. Definition lines must be added to sd.conf for every LUN of every target configured to the host in the Symmetrix. Device definition files are available on the EMC FTP server, ftp.emc.com, in /pub/symm3000/solaris. The file sd.conf.fibre is a device definition file for Fibre Channel devices. You can copy/paste the contents of the file into the file /kernel/drv/sd.conf in the Solaris X86 host. Use only those lines from sd.conf.fibre that apply to your host's configuration. Refer to Symmetrix Device Definition Files in the Symmetrix Open Systems Environment Product Guide for instructions on how to transfer these files to your host.
Changes to sd.conf will not take effect until the host is rebooted.
19
Example of sd.conf for Arbitrated Loop in a Hubless Environment The following example is for a hubless loop configuration with a Target ID (Symmetrix Hard loop ID) of 0:
name=sd class=scsi target=0 lun=0; name=sd class=scsi target=0 lun=1; . . . name=sd class=scsi target=0 lun=126; name=sd class=scsi target=0 lun=127;
Add only those Target/Lun definitions that are needed. In a direct-connect configuration, it is recommended that all Symmetrix ports be given the same Target ID. If different Hard Loop IDs are used for each port, lines must be added to sd.conf for each LUN of each target. The fewer Target/Lun definitions in sd.conf, the less time it takes to boot.
20
Example of sd.conf for Arbitrated Loop in a Hub Environment The following example is for a hub loop configuration with two Target IDs of 0 and 1. Each target has 128 luns. For every Symmetrix port assigned to a host, there must be a target and series of LUNs configured in sd.conf. Targets are determined from the Symmetrix Hard Loop ID. In this example, 256 separate Target/LUN definitions are added to sd.conf.
name="sd" class="scsi" target=0 lun=0; name="sd" class="scsi" target=0 lun=1; . . . name="sd" class="scsi" target=0 lun=126; name="sd" class="scsi" target=0 lun=127; name="sd" class="scsi" target=1 lun=0; name="sd" class="scsi" target=1 lun=1; . . . name="sd" class="scsi" target=1 lun=126; name="sd" class="scsi" target=1 lun=127;
Add only those target/LUN definitions that are needed. The fewer target/LUN definitions in sd.conf, the less time it takes to boot.
21
/etc/system
Setup Checklist step 7b To maximize system performance, the following three variables should be added as the last lines in the file /etc/system.
Changes to /etc/system will not take effect until the host is rebooted.
1. Add set sd:sd_max_throttle=20 2. Add set scsi_options = 0x7F8 The bit meaning for scsi_options is as follows:
Bit 3 4 5 6 7 8 9 10 Mask 0x8 0x10 0x20 0x40 0x80 0x100 0x200 0x400 Meaning Disconnect enable Link enable Sync xfer enable Parity support enable Tag commands enable Fast SCSI enable Wide SCSI enable Ultra SCSI enable
Since /etc/system can also affect other disks in the system, consider the effects of implementing the scsi_options=0x7f8 mask on the other disks. If it is not set, Symmetrix operations will not benefit from these options.
3. The third variable depends on whether the host will run PowerPath: If no, add
set sd:sd_io_time = 0x78
If yes, add set sd:sd_io_time = 0x3C
This setting prevents the host from issuing warning messages when non-disruptive operations are performed on Symmetrix.
22
Fabric Configurations
This section describes the procedures required to install one or more Qlogic QLA2200F-EMC host bus adapters into a Solaris 7 X86 host and configure the host for Symmetrix Fibre Channel fabric.
Setup Checklist
The following is a step-by-step checklist of the procedures used to integrate a Solaris X86 host with the Symmetrix using the Qlogic QLA2200F-EMC HBA in an FC-SW environment. Each step includes references to the specific procedures. Follow these steps in order, to ensure proper HBA setup.
This installation should be performed only by personnel having a basic knowledge of Solaris X86 system administration.
Step
Done?
Before beginning configuration to integrate the Solaris 7 X86 with the Symmetrix, ensure that all hardware and patch configurations are EMC-qualified. Obtain all EMC-qualified configurations from your EMC customer representative. Verify the following: a. b. c. The host server is EMC-qualified. The switch is EMC-qualified. The patch configuration for the Solaris 7 X86 host is EMC-qualified.
n/a
Verify that the QLA2200F-EMC HBA is installed in the Solaris X86 host system, and that the Symmetrix is connected to the HBA through a switch a. b. For information on installing the HBA, refer to the Qlogic Hardware Install Guide QLA2000/2000F/2100/2100F/2200/2200 For information regarding qualified hosts, qualified switches, and Symmetrix configuration, see your EMC Customer Representative
23
Step
Done?
Boot the host and verify the correct HBA BIOS version (1.59) and firmware settings. Upgrade the HBA BIOS if necessary. a. b. c. To verify the firmware version, refer to Verifying the Correct HBA BIOS Version on page 26. To verify the firmware settings, refer to Setting the Firmware Variables on page 28. To upgrade the HBA BIOS, refer to Upgrading HBA Firmware/BIOS on page 27.
n/a
Use the scan utility function of the HBA firmware utility to verify that the HBA "sees" the Symmetrix. Refer to Scanning for the Symmetrix on an HBA BIOS Level on page 29. Obtain the latest EMC-approved disk image driver for the QLA2200F-EMC HBA; then create a driver installation diskette and install the driver into the host: a. b. c. To obtain the latest disk image, refer to Obtaining the QLA2200 Driver Disk Image on page 30. To create a driver diskette, refer to Creating the Driver Diskette on page 31. To install the driver, refer to Installing or Upgrading the HBA Driver from a Diskette on page 31. n/a
24
Step
Done?
Configure the settings in driver configuration file /kernel/drv/qla2200.conf by configuring persistent binding, creating an instance number for each HBA for all variables, and configuring all settings: a. b. For conceptual knowledge of persistent binding, read Persistent Binding Requisite Information on page 33. To obtain persistent binding information from the /var/adm/messages file, refer to Obtaining Persistent Binding Information on page 33. To configure persistent binding in /kernal/drv/qla2200.conf file, refer to Configuring Persistent Binding on page 34. To create an HBA instance number for every setting in qla2200.conf, refer to Configuring qla2200.conf Variables on page 35. To verify that all settings are configured properly, refer to Variable Settings on page 36.
n/a
c. d. e. 7
Verify that the following files are configured properly: a. b. /kernel/drv/sd.conf. Refer to /kernel/drv/sd.conf on page 39. /etc/system. Refer to /etc/system on page 41.
n/a
After steps 1 through 7 are complete and the system has been rebooted, you will be able to see all Symmetrix devices in the /dev/rdsk/ directory. For a list of all targets and LUNs recognized by the host, issue the format command.
25
HBA BIOS-Level Configurations
Setup Checklist step 3 After installing all QLA2200F-EMC HBAs into the host, follow these steps for each QLA2200F-EMC. There are some redundant settings between the firmware utility and the driver configuration file (QLA2200.conf). However, the driver configuration variable settings supersede the corresponding settings in firmware utility. Setup Checklist step 3a HBA BIOS version 1.59 is required. You can determine the HBA BIOS version at boot time from the QLA2200 banner or from the QLA2200 Fast!Util Options menu. To determine the HBA BIOS version from the QLA2200 banner, boot the host and watch for the QLA2200F banner (shown in Figure 2). The banner disappears quickly, so watch carefully. If the ROM BIOS version is not 1.59, upgrade the HBA BIOS as described under Upgrading HBA Firmware/BIOS on page 27. If the ROM BIOS version is 1.59, continue to Setting the Firmware Variables on page 28.
Verifying the Correct HBA BIOS Version
Figure 2
To determine the HBA BIOS version from the QLA2200 Fast!Util Options menu: a. Boot the host. As soon as the QLA2200F banner (Figure 2) appears, press ALT-Q to display the Fast!Util Options menu. b. Select Configuration Settings from the menu. c. Select Host Adapter Settings from the Configuration Settings menu. d. Under Host Adapter Settings, note the BIOS Version: If the version is not 1.59, upgrade the BIOS as described under Upgrading HBA Firmware/BIOS on page 27, then go to Setting the Firmware Variables on page 28. If the version is 1.59, go to Setting the Firmware Variables on page 28.
26

Qlogic Corporation QLA2200 PCI Fibre Channel ROM BIOS Version 1.59 Copyright Qlogic Corporation 1993-1999 All rights reserved Press <ALT - Q> for Fast!UTIL www.qlogic.com
QLA2200F-EMC Banner Example
Upgrading HBA Firmware/BIOS
Setup Checklist step 3b This section contains information specific to creating HBA BIOS installation disks and upgrading the BIOS to a host bus adapter. This procedure is necessary only if you need to upgrade the QLA2200F-EMC BIOS version. (Refer to Verifying the Correct HBA BIOS Version on page 26.) Create an Installation Diskette: To create a QLA2200 BIOS installation diskette, follow these steps: 1. Contact your EMC customer representative to obtain the HBA BIOS. The latest version might be available on the Qlogic website, as described in the steps below: a. Access this website: http://www/qlogic.com. b. Click Driver Downloads. c. Scroll to the bottom of the Qlogic Drivers License Agreement and click Use Qlogic Drivers/Software. d. Click EMC Approved Drivers. e. Click EMC Approved QLA22xx Drivers. f. Click Link to ROM BIOS in the ROM BIOS v1.59 section. g. Save the file as c:\22emc03bios159.zip. 2. The file is a self-extracting ZIP file that must be extracted to a bootable diskette drive, as follows: a. Open any DOS window. b. At the DOS prompt, type cd \ ENTER, to go to the root directory. c. Type 22emc03bios159 a: ENTER. Upgrade the BIOS After the QLA2200-EMC HBA is installed in an EMC-qualified host, complete the following steps to upgrade the HBA BIOS: 1. Insert the BIOS upgrade installation diskette into the diskette drive. 2. Reboot the host. 3. After the host has rebooted, a DOS prompt appears. Type Ql2xutil /L /F ENTER.
27
The HBA BIOS upgrade might take a few minutes.
4. After the upgrade is complete, remove the diskette and reboot the host. During boot-up, the QLA2200F banner (see Figure 2 on page 26) should display BIOS Version 1.59. Setting the Firmware Variables Setup Checklist step 3c This procedure assumes that you are already in Fast!Util. If you are not, boot the host, and as soon as the QLA2200F banner (see Figure 2) appears, press ALT-Q to display the Fast!Util Options menu. 1. From the Fast!Util Options menu, select Configuration Settings. 2. On the Configuration Settings menu, select Restore Default Values. 3. On the Configuration Settings menu, select Advanced Adapter Settings. 4. Change the setting for Execution Throttle to 20. 5. Change the setting for Max Luns to 128. (The factory setting is 8, but this must be changed to utilize all 128 LUNs available from the Symmetrix.) 6. Press ESC to return to the Configuration Settings menu. 7. On the Configuration Settings menu, select Extended Firmware Settings. 8. Change the setting for Connection Option to 1. 9. Press ESC and save all changes. 10. Reboot and use the Fibre Disk utility to verify the disk media, as described under Scanning for the Symmetrix on an HBA BIOS Level on page 29.
28
Scanning for the Symmetrix on an HBA BIOS Level
Setup Checklist step 4 Before running Solaris 7 X86, it is prudent to verify that Symmetrix devices are seen on an HBA BIOS level. The QLA2200 has a built in utility to verify connection to the Symmetrix port, and also to verify an individual Symmetrix device. To verify that the HBA can "see" the Symmetrix, use the Fibre Disk utility to scan and verify disk media. 1. Under the Fast!UTIL Options menu, select FIBRE DISK UTILITY.
This step assumes that you are already in Fast!Util. If you are not, boot the host, and as soon as the QLA2200F banner (see Figure 2) appears, press ALT-Q to display the Fast!Util Options menu.
2. You should see SYMMETRIX in a Fibre Channel device list of all possible 125 targets, as shown below. (Page down if necessary to display all targets in the list.)
ID <Hard loop ID> VENDOR EMC PRODUCT SYMMETRIX REV <micro code revision> NODE NAME 01000006048___
If SYMMETRIX appears in the list, go to step 3. If SYMMETRIX does not appear in the list, verify the following, then start this procedure again at step 1: that the correct Symmetrix port is connected to the host that the Symmetrix is on line that the cables are not damaged 3. Use the arrow keys to highlight SYMMETRIX from the list of targets, then press ENTER. 4. A list of LUNs appears. Select any LUN from the list. 5. A Disk Utility Options menu appears. Select VERIFY DISK MEDIA. 6. Select CONTINUE WITH VERIFY.

29
7. After media verification has completed: If the message Media Verification Complete appears, press ESC repeatedly to exit Fast!Util and reboot the host, then continue with Installing the HBA Driver on page 30. If the media verification fails, verify that the cables and connectors are not damaged.
Installing the HBA Driver
Setup Checklist step 5 The Solaris X86 operating system interface to the Symmetrix Fibre Channel director requires HBA driver software. The driver functions at a layer below the Solaris SCSI driver to present Fibre Channel devices to the operating system as if they were standard SCSI devices. Refer to the release notes provided with the current driver for information that may be unique to new driver revisions. The driver is in a disk image format and must be copied to a diskette before driver installation. Setup Checklist step 5a The EMC-approved QLA2220 driver can be obtained from the EMC release media CD or from the Qlogic Web site. Contact your EMC Customer service representative for the Qlogic driver release CD-ROM. To copy the EMC-approved driver from the release media: 1. Insert the EMC release media into the CD drive, then log in as root. 2. Type volcheck ENTER, to ensure that the volume manager scans for a newly inserted CD. 3. Type cd /cdrom/solaris/x86/5.7/ ENTER, to go to the proper driver directory on the CD. 4. From the/cdrom/solaris/x86/5.7/ directory, type cp du2200.Z /tmp ENTER, to copy the disk image driver to the /tmp directory. 5. Proceed to Creating the Driver Diskette on page 31.
Obtaining the QLA2200 Driver Disk Image
30
To obtain the EMC-approved driver from the Qlogic Web site: 1. Access http://www/qlogic.com. 2. Click Driver Downloads. 3. Scroll to the bottom of the Qlogic Drivers License Agreement and click Use Qlogic Drivers/Software. 4. Click EMC Approved Drivers. 5. Click EMC Approved QLA22xx Drivers. 6. Click the link corresponding to the EMC-approved Solaris 7 X86 driver for QLA2200 version 3.01. 7. Save the compressed disk image driver file as /tmp/du2200.Z. 8. Proceed to Creating the Driver Diskette. Creating the Driver Diskette Setup Checklist step 5b 1. Copy EMC-approved version 3.01 driver du2200.Z to the /tmp directory. 2. From the /tmp directory, type uncompress du2200.Z ENTER, to uncompress a disk image of the driver. 3. From the /tmp directory, type /etc/init.d/volmgt stop ENTER, to stop the Volume Manager. 4. From the /tmp directory, type
dd if=du2200 of=/dev/rdiskette0 ENTER, to transfer the DU
diskette image file to a diskette. 5. Proceed to Installing or Upgrading the HBA Driver from a Diskette. Installing or Upgrading the HBA Driver from a Diskette Setup Checklist step 5c 1. Log on to the system as root. 2. Insert the EMC-qualified driver diskette into the diskette drive. 3. If necessary, type /etc/init.d/volmgt start ENTER to start the Volume Manager 4. Type volcheck ENTER, to run the Volume Check program. 5. Start the driver installation process by typing the following command from any directory:
/floppy/floppy0/DU/sol_27/i86pc/Tools/install.sh ENTER
31
6. If you are upgrading the driver and have a previously installed version of the QLA2200 driver on your system: a. Type n ENTER when prompted to create a new instance of the package. b. Type y ENTER when prompted to overwrite an installed instance of the QLA2200 driver package. 7. As the driver is being installed, the following information appears:
Using </> as the package base directory. ## Processing package information. ## Processing system information. 11 package pathnames are already properly installed ## Verifying package dependencies. ## Verifying disk space requirements. Installing QLogic QLA2200 PCI-SCSI Adapter as <QLA2200> ## Installing part 1 of 1. /kernel/drv/qla2200 /kernel/drv/qla2200.conf /platform/i86pc/boot/solaris/drivers/notisa.010/qla2200.bef [ verifying class <none> ] [ verifying class <master> ] ## Executing postinstall script Installation of <QLA2200> was successful.
8. Remove the driver diskette. 9. Type reboot-- -r ENTER, to reboot the system.
32
Driver Configuration in the qla2200.conf File
Setup Checklist step 6 The proper configuration of the /kernel/drv/qla2200.conf file is crucial for Symmetrix host integration and driver behavior. The driver configuration file contains important information about how the driver should behave. The file is created automatically when the HBA driver is installed. Setup Checklist step 6a A requisite knowledge of persistent binding concepts is needed to configure the qla2200 driver in an FC-SW environnent. Read the information in this section for conceptual information regarding persistent binding and an explanation of configuration steps. Persistent binding is a method that ensures consistent device numbering on a target level during a power cycle or reboot in an FC-SW environment. Without persistent binding, the Fibre Channel switch assigns the target device numbers. The switch determines target numbers through the scan order of the switch port. If Fibre Channel targets are added to or removed from a switch port, the scan order and subsequent target numbers could change. Example: c2t2d0s0 could change to c2t1d0s0 The Qlogic implementation of FC-SW persistent binding takes a Symmetrix ports Worldwide Name (WWN) and binds it to an established target number. The target number is established during the reboot after the driver is installed. Target numbers and Symmetrix port WWNs are output to the /var/adm/messages file during the first reboot after the driver is installed. This information must be used to configure the /kernel/drv/qla2200.conf file. After proper persistent binding configuration, the target number/WWN relationship in /kernel/drv/qla2200.conf file will take precedence over the switchs target assignments.
Persistent Binding Requisite Information
Obtaining Persistent Binding Information
Setup Checklist step 6b Persistent binding can be configured only if the following steps have been completed and a reboot -- -rv has been issued: 1. A properly configured QLA2200 HBA is installed and the host is connected to the Symmetrix port though an EMC-approved fabric switch. 2. The EMC-qualified QLA2200 3.01 driver is installed.
33
After steps 1 and 2 are completed, the Symmetrix port WWNs and corresponding target number can be found in the /var/adm/messages file in a format similar to the following:
HBA Instance Number Symmetrix Port Target ID
Aug Aug Aug Aug Aug Aug Aug Aug Aug Aug Aug Aug 9 9 9 9 9 9 9 9 9 9 9 9 host host host host host host host host host host host host unix: unix: unix: unix: unix: unix: unix: unix: unix: unix: unix: unix: QLogic qla2200 Fibre Channel Driver v3.01 Instance: 1. Firmware v2.1.16. pcplusmp: pci1077,2200 (qla2200) instance #1 vector 0x1c ioapic 0x4 intin 0x17 is bound to cpu 0 qla2200-hba1-adapter-node-name="200000e08b0087ba"; HBA WWN qla2200-hba1-adapter-port-name="210000e08b0087ba"; HBA WW Port Name qla2200-hba1-SCSI-target-id-0-fibre-channel-name="50060482c031799f"; Symmetrix Port WWN qla2200-hba1-SCSI-target-id-1-fibre-channel-name="50060482c031f998"; QLogic qla2200 Fibre Channel Driver v3.01 Instance: 2. Firmware v2.1.16. pcplusmp: pci1077,2200 (qla2200) instance 2 vecto r 0x18 ioapic 0x4 intin 0x1b is bound to cpu 0 qla2200-hba2-adapter-node-name="200000e08b0192bf"; qla2200-hba2-adapter-port-name="210000e08b0192bf"; qla2200-hba2-SCSI-target-id-0-fibre-channel-name="50060482c031799f"; qla2200-hba2-SCSI-target-id-1-fibre-channel-name="50060482c031f998";
Configuring Persistent Binding
Setup Checklist step 6c From the above information in the /var/adm/messages file, the following lines would be the last lines added to the /kernel/drv/qla2200.conf file:
HBA Instance Number
hba1-adapter-node-name="200000e08b0087ba"; HBA WWNN hba1-adapter-port-name="210000e08b0087ba"; HBA WWPN hba1-SCSI-target-id-0-fibre-channel-name="50060482c031799f"; hba1-SCSI-target-id-1-fibre-channel-name="50060482c031f998"; hba2-adapter-node-name="200000e08b0192bf"; hba2-adapter-port-name="210000e08b0192bf"; hba2-SCSI-target-id-0-fibre-channel-name="50060482c031799f"; hba2-SCSI-target-id-1-fibre-channel-name="50060482c031f998";
Symmetrix Port WWN
Symmetrix Port Target ID
In the above example: The hba#- is the HBA instance number in the driver. The adapter-node-name and adapter-port-name correspond to the WWNN and the WWPN of the HBA. The line with SCSI-target-id binds the HBA instance number with a specific target ID and a specific Symmetrix port WWN. The fibre-channel-name is the target WWPN of the Symmetrix.
Setup Script The following script can be used to assist the persistent binding setup of the /kernel/drv/qla2200.conf file.
tail -1000 /var/adm/messages | /usr/bin/grep qla2200-hba | /usr/bin/sed -e's/.*qla2200-//' >> /kernel/drv/qla2200.conf
34
Configuring qla2200.conf Variables
Setup Checklist step 6d There are 17 Variable settings in the qla2200.conf file. Each HBA should be given its own settings for each of the 17 variables. Each HBA variable line in QLA2200.conf corresponds to the instance number of the HBA in the file /var/adm/messages. In the following example, a separate variable line is dedicated to each HBA (hba0 and hba2). The instance number 2 comes from the /var/adm/messages log. (Refer to the example under Setup Checklist step 6c on page 34.)
Example:
# Amount of time to wait for loop to come up after it has gone down # before reporting I/O errors. # Range: 0 - 240 seconds hba1-loop-down-timeout=60; hba2-loop-down-timeout=60; # Connection options # 0 = loop only # 1 = point-to-point only # 2 = loop preferred, otherwise point-to-point # 3 = point-to-point preferred, otherwise loop hba1-connection-options=1; hba2-connection-options=0;
In the above example, hba1 is set for FC-SW and hba2 is set for FC-AL. The loop down timeout values for both HBAs are set to 60 seconds.
35
Variable Settings
Setup Checklist step 6e Table 2 lists the required settings for the configuration file variables, and descriptions of the variables follow the table. Verify that all variables are set as shown, and change any if necessary.
Changes to QLA2200.conf will not take effect until the host is rebooted.
Table 2
/kernel/drv/qla2200.conf Settings for Solaris X86 Host on Fabric Required Setting Variable hba0-max-frame-length hba0-max-iocb-allocation hba0-execution-throttle hba0-login-timeout hba0-login-retry-count Default Value 1024 bytes 256 31 4 (seconds) 10 If No PowerPath 2048 bytes 512 20 4 (seconds) 10 0 (disable) 0 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (seconds) 30 0 (disable) 60 (sec) 1 0 0 If PowerPath 2048 bytes 512 20 4 (seconds) 10 0 (disable) 0 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (seconds) 30 1 (enable) 60 (sec) 1 0 0
hba0-enable-adapter-hard-loop-ID 0 (disable) hba0-adapter-hard-loop-ID hba0-enable-64bit-addressing hba0-enable-LIP-reset hba0-enable-LIP-full-login hba0-enable-target-reset hba0-reset-delay hba0-port-down-retry-count hba0-link-down-error hba0-loop-down-timeout hba0-connection-options hba0-device-configuration-mode hba0-fc-tape 0 0 (disable) 0 (disable) 1 (enable) 0 (disable) 5 (seconds) 30 1 (enable) 60 (sec) 2 0 0
36
Descriptions of qla2200.conf Variables hba0-frame-payload-size Configuration flag (512, 1024 or 2048 bytes) for "maximum frame length." hba0-max-iocb-allocation Number of commands (1 to 750) queued internally within the HBA. Exceeding the adapters buffers causes unnecessary retries, which impact performance. The maximum setting might be less, depending on the size of the firmware. hba0-execution-throttle Maximum number of commands (1 to 65635) sent to the LUN by the firmware. Exceeding a devices capabilities causes unnecessary command retries, which impact performance. hba0-login-retry-count Maximum number (0 to 255) of retries to attempt when login into a device fails. Large values can cause long delays during initialization. hba0-enable-adapter-hard-loop-ID Should be set to 0. Although this variable is not applicable to a fabric environment, it must remain in the qla2200.conf file. (It will be ignored if set to 0.) hba0-adapter-hard-loop-ID Should be set to 0. Although this variable is not applicable to a fabric environment, it must remain in the qla2200.conf file. (It will be ignored if set to 0.) hba0-login-timeout Sets the login timeout (in seconds). hba0-enable-64bit-addressing Enables/disables the adapter to directly access memory above 4 gigabytes with 64-bit Direct Memory Access addressing. hba0-enable-LIP-reset Enables/disables the adapter to issue a LIP reset during Fibre Channel reset.
Only one of variables hba0-enable-LIP-reset, hba0-enable-LIP-full-login, and hba0-enable-target-reset should be enabled at the same time.
hba0-enable-LIP-full-login Enables/disables the adapter to issue a LIP full login reset during Fibre Channel reset. (See the note below hba0-enable-LIP-reset.) hba0-enable-target-reset Enables/disables the adapter to issue a LIP target reset during Fibre Channel reset. (See the note below hba0-enable-LIP-reset.)
37
hba0-enable-database-storage Enables/disables the driver to save device position on the Fibre Channel bus. hba0-reset-delay Delay after a reset before sending commands to the devices on the Fibre Channel bus. hba0-link-down-error Disables all link_down time out values. The sd driver will not be notified of any and error conditions if the Qlogic driver detects a link_down condition. If the Symmetrix goes off line or the link with the host is broken for any reason, the Qlogic driver holds all pending I/Os indefinitely until the link is restored or the Symmetrix rejoins the loop. In a Power Path or Veritas DMP environment, this variable should be enabled (1) so the PowerPath or Veritas DMP driver will be notified of any error conditions. hba0-port-down-retry-count Number of command retries to be done when devices are not responding on the Fibre Channel bus. Large values might cause long delays for fail over software to detect a failing device. hba0-loop-down-timeout Time the driver waits for a Fibre Channel loop to come up before reporting the failure. Small values might report transient errors that should be ignored. hba0-connection-options Connection mode the driver firmware will use: 0 = loop only 1 = point-to-point only 2 = loop preferred, otherwise point-to-point 3 = point-to-point preferred, otherwise loop hba0-device-configuration-mode Configure loop devices, using either port or node name. This field specifies which type of Fibre Channel name will be saved in the driver database for each of the Fibre Channel device discovered. 0 = node name 1 = port name hba0-fc-tape Should always have a value of 0.
38
Editing Host Files to Incorporate Symmetrix
Setup Checklist step 7 To insure smooth integration and maximum performance from the host and Symmetrix, you must edit these files (as described in detail later): Host driver configuration file sd.conf Refer to /kernel/drv/sd.conf below. System specification file /etc/system Refer to /etc/system on page 41.
After editing either of these files, type reboot -- -r ENTER to reboot the host with the -r (reconfigure) option, which rebuilds the kernel and implements the changes. /kernel/drv/sd.conf Setup Checklist step 7a The sd.conf file is used to alert the sd driver to scan for LUNs for a specific target. In an FC-SW environment, Symmetrix devices are addressed using persitent binding in the qla2200.conf file. There can be only one target ID per Symmetrix port. A target ID can have up to 128 LUNs. By default, Solaris X86 searches only for target IDs; if LUN addressing is required, you must modify the lower-level driver configuration file /kernel/drv/sd.conf. Definition lines must be added to sd.conf for every LUN of every target configured to the host in the Symmetrix. Device definition files are available on the EMC FTP server, ftp.emc.com, in /pub/symm3000/solaris. The file sd.conf.fibre is a device definition file for Fibre Channel devices. You can copy/paste the contents of the file into the file /kernel/drv/sd.conf in the Solaris X86 host. Use only those lines from sd.conf.fibre that apply to your host's configuration. Refer to Symmetrix Device Definition Files in the Symmetrix Open Systems Environment Product Guide for instructions on how to transfer these files to your host.
Changes to sd.conf will not take effect until the host is rebooted.
39
Sample sd.conf file: The following example is for an FC-SW configuration with target IDs 0 and 1 configured in qla2200.conf. With this sd.conf configuration, the driver will scan for 128 LUNs for target 0 and 32 LUNs for target 1.
name=sd class=scsi target=0 lun=0; name=sd class=scsi target=0 lun=1; . . . name=sd class=scsi target=0 lun=126; name=sd class=scsi target=0 lun=127; name=sd class=scsi target=1 lun=0; name=sd class=scsi target=1 lun=1; . . . name=sd class=scsi target=1 lun=31; name=sd class=scsi target=1 lun=32;
Add only those target/LUN definitions that are needed. The fewer target/LUN definitions in sd.conf, the less time it takes to boot.
40
/etc/system
Setup Checklist step 7b To maximize system performance, the following three variables should be added as the last lines in the file /etc/system.
Changes to /etc/system will not take effect until the host is rebooted.
1. Add set sd:sd_max_throttle=20 2. Add set scsi_options = 0x7F8 The bit meaning for scsi_options is as follows:
Bit 3 4 5 6 7 8 9 10 Mask 0x8 0x10 0x20 0x40 0x80 0x100 0x200 0x400 Meaning Disconnect enable Link enable Sync xfer enable Parity support enable Tag commands enable Fast SCSI enable Wide SCSI enable Ultra SCSI enable
Since /etc/system can also affect other disks in the system, consider the effects of implementing the scsi_options=0x7f8 mask on the other disks. If it is not set, Symmetrix operations will not benefit from these options.
3. The third variable depends on whether the host will run PowerPath: If no, add
set sd:sd_io_time = 0x78
If yes, add set sd:sd_io_time = 0x3C
This setting prevents the host from issuing warning messages when non-disruptive operations are performed on Symmetrix.
41

Qlogic Solaris x86

Încărcat de

Informații document

Descriere originală:

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Qlogic Solaris x86

Încărcat de

Drepturi de autor:

Formate disponibile

Symmetrix Fibre Channel with Qlogic QLA2200F-EMC Host Bus Adapters in the Solaris X86 Environment

Rev 4, October 2000

Copyright 2000 EMC Corporation. All rights reserved.

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

HBA BIOS-Level Configurations

Verifying the Correct HBA BIOS Version

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

QLA2200F-EMC Banner Example

Arbitrated Loop Configurations

Setting the Firmware Variables

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Scanning for the Symmetrix on an HBA BIOS Level

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Installing the HBA Driver

Obtaining the QLA2200 Driver Disk Image Driver

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

7. As the driver is being installed, the following information appears:

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Driver Configuration in the qla2200.conf File

Configuring qla2200.conf Variables

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

/kernel/drv/qla2200.conf Settings for Solaris X86 Host on Loop Required Setting

Variable hba0-max-frame-length hba0-max-iocb-allocation hba0-execution-throttle hba0-login-timeout hba0-login-retry-count

Default Value 1024 bytes 256 31 4 (sec) 10

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Editing Host Files to Incorporate Symmetrix

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Arbitrated Loop Configurations

If yes, add set sd:sd_io_time = 0x3C

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

Symmetrix Fibre Channel with QLA2200F-EMC HBAs on Solaris X86 Hosts

HBA BIOS-Level Configurations