Installing, Connecting, and Testing the Host Bus Adapter

This guide describes how to install and configure your new Sun StorageTektrademark Enterprise PCI Express 4 Gb Fibre Channel (FC) Single and Dual Port Host Bus Adapter (HBA). The HBA is also referred to as SG-XPCIE1FC-QF4 (single port) or SG-XPCIE2FC-QF4 (dual port).

It contains the following topics:



caution icon Caution - Be sure to keep the Sun StorageTek Enterprise PCI Express 4 Gb FC Single and Dual Port HBA in the antistatic bag until installation. The HBA contains parts that can be damaged by electrostatic discharge (ESD). Before handling the HBA, use standard methods to discharge static electricity. Place the HBA on the bag when examining it. Retain the bag for future use.



System Requirements

Your system must have at least one PCI Express 4-lane slot to support the HBA.


Installing the HBA

Follow these steps to install the HBA in your system:


procedure icon  To Verify the Packaging Contents

Verify that the HBA is shipped with the following items (see FIGURE 1):

FIGURE 1 HBA Package Contents


Figure that depicts the HBA kit contents.


procedure icon  To Install the HBA Hardware

To install the HBA, you need to open the system and identify an empty PCI Express 4 lane slot. If necessary, consult your system manual for instructions to remove the system cover.



caution icon Caution - Damage to the HBA can occur as the result of careless handling or electrostatic discharge (ESD). Always handle the HBA with care to avoid damage to electrostatic sensitive components.


To minimize the possibility of ESD-related damage, Sun strongly recommends using both a workstation antistatic mat and an ESD wrist strap. You can get an ESD wrist strap from any reputable electronics store or from Sun as part number #250-1007. Observe the following precautions to avoid ESD-related problems:

1. Record IEEE and serial numbers.

Each HBA is shipped with a unique 64-bit identifier called the IEEE address. The Fibre Channel industry uses a World Wide Name (WWN) derived from the IEEE address. This number is needed for FC connectivity.

Because the SG-XPCIE2FC-QF4 HBA has two ports, it has two IEEE addresses. The IEEE address is used when configuring your system. The serial number is used when communicating with Sun. All numbers are clearly marked on the board. Record these numbers before installation.

2. Shut down, power off, and unplug the system.

3. Remove the system case.

4. Remove the blank panel from an empty PCI Express slot.

5. (Optional) Perform the following steps to replace the PCI bracket.



Note - The HBA comes with a low-profile PCI bracket installed. This bracket is approximately 3.11 in. (7.9 cm) long. A standard mounting bracket, which is approximately 4.75 in. (12.6 cm), is provided with each X-option order.


a. Remove the mounting bracket screws from the HBA (see FIGURE 2).

FIGURE 2 Removing the Bracket Screws


Figure that shows how to remove the bracket screws.

b. Remove the bracket and store it for future use.

c. Align the new mounting bracket tabs with the holes in the HBA.



Note - Be careful not to push the bracket past the transceiver housing’s grounding tabs. Ensure that the LEDs are properly aligned with the holes in the bracket.


d. Replace the screws that attach the HBA to the bracket.

6. Insert the HBA into the empty PCI Express 4-lane slot. Press firmly until the adapter is seated.

7. Secure the HBA’s mounting bracket to the case with the panel screw or clip.

8. Replace the system case and tighten the case screws.

The HBA is now installed in the system and is ready for the optical cable attachment.


procedure icon  To Attach the Optical Cable



Note - The HBA does not allow normal data transmission on an optical link unless it is connected to another similar or compatible Fibre Channel product (that is, multimode to multimode).


Use multimode fiber-optic cable, intended for short-wave lasers, that adheres to the specifications in TABLE 1.


TABLE 1 Optical Cable Specifications

Fiber-Optic Cable

Maximum Length

Minimum Length

Connector

62.5/125 mu symbolm (multimode)

300 meters at 1.0625 Gbit/sec

150 meters at 2.125 Gbit/sec

70 meters at 4.25 Gbit/sec

2 meters

LC

50/125 mu symbolm (multimode)

500 meters at 1.0625 Gbit/sec

300 meters at 2.125 Gbit/sec

150 meters at 4.25 Gbit/sec

2 meters

LC


TABLE 2 summarizes the Power-On Self-Test (POST) conditions and results.


TABLE 2 POST Conditions and Results

States

Yellow LED

(4 Gb)

Green LED

(2 Gb)

Amber LED

(1 Gb)

Comments

Power off

OFF

OFF

OFF

Card does not have power

Power on (before firmware initialization)

ON

ON

ON

On continuously

Power on (after firmware initialization)

Flash

Flash

Flash

Flashing at the same time

Firmware fault

Flash in sequence

Flash in sequence

Flash in sequence

Flashing in sequence of

Yellow LED=> Green LED=>

Amber LED

then back to Yellow LED

1 Gbit/sec Link Up/Active

OFF

OFF

ON/Flash

On for link up

Flash if I/O activity

2 Gbit/sec Link Up/Active

OFF

ON/Flash

OFF

On for link up

Flash if I/O activity

4 Gbit/sec Link Up/Active

ON/Flash

OFF

OFF

On for link up

Flash if I/O activity

Beacon

Flash

OFF

Flash

All flashing at the same time like a heart beat


When attaching the optical cable, be sure to:

1. Connect the fiber-optic cable to an LC connector on the HBA (see FIGURE 3).

FIGURE 3 Attaching the Optical Cable


Figure that shows how to attach the opitical cable.

2. Connect the other end of the cable to the Fibre Channel device.

After the optical cable is connected to the HBA, you are ready to apply power to the system.


procedure icon  To Apply Power

1. Verify that the HBA is securely installed in the system.

2. Verify that the correct optical cable is attached.

3. Plug in and power on the system.

4. Observe light-emitting diodes (LEDs) for POST results.

Yellow, green, and amber LEDs can be seen through openings in the HBA’s mounting bracket. Each port has a corresponding set of yellow, green, and amber LEDs.


procedure icon  To Verify Proper Installation in SPARC Platforms

1. Enter the show-devs command at the ok prompt to list the installed devices.

The HBA can be identified in the output containing the SUNW,qlc@n and SUNW,qlc@n node names, where n is usually a single-digit number from 0 to 9.

2. To positively identify the port as a Sun StorageTek 4 Gb FC port, cd to the SUNW,qlc@n entries and enter .properties as shown in the example that follows.


{0} ok cd /pci@780/pci@0/pci@8/SUNW,qlc@0
{0} ok .properties
assigned-addresses 81060010 00000000 00000000 00000000 00000100
82060014 00000000 00300000 00000000 00004000
82060030 00000000 00340000 00000000 00040000
version QLE2462 Host Adapter Driver (SPARC): 1.11 10/03/05
manufacturer             QLGC
model                    QLE2462
name                     SUNW,qlc
port-wwn                 21 00 00 e0 8b 95 25 21
node-wwn                 20 00 00 e0 8b 95 25 21
reg                      00060000 00000000 00000000 00000000 00000000
01060010 00000000 00000000 00000000 00000100
03060014 00000000 00000000 00000000 00001000
compatible               pciex1077,143.1077.143.2
pciex1077,143.1077.143
pciex1077,143
pciex1077,2432.2
pciex1077,2432
pciclass,c0400
pciclass,0400
short-version            1.11 10/03/05
#size-cells              00000000
#address-cells           00000002
device_type              scsi-fcp
fcode-rom-offset         0000aa00
devsel-speed             00000000
class-code               000c0400
interrupts               00000001
latency-timer            00000000
cache-line-size          00000010
max-latency              00000000
min-grant                00000000
subsystem-id             00000143
subsystem-vendor-id      00001077
revision-id              00000002
device-id                00002432
vendor-id                00001077
{0} ok

In this example, there is one Dual Channel SG-XPCIE2FC-QF4 adapter installed:


{1} ok show-devs
/pci@7c0
/pci@780
/cpu@17
/cpu@16
/cpu@15
/cpu@14
/cpu@13
/cpu@12
/cpu@11
/cpu@10
/cpu@f
/cpu@e
/cpu@d
/cpu@c
/cpu@b
/cpu@a
/cpu@9
/cpu@8
/cpu@7
/cpu@6
/cpu@5
/cpu@4
/cpu@3                         
/cpu@2
/cpu@1
/cpu@0/virtual-devices@100
/virtual-memory
/memory@m0,800000
/aliases
/options
/openprom
/chosen
/packages
/pci@7c0/pci@0
/pci@7c0/pci@0/pci@9
/pci@7c0/pci@0/pci@8
/pci@7c0/pci@0/pci@2
/pci@7c0/pci@0/pci@1
/pci@7c0/pci@0/pci@2/network@0,1
/pci@7c0/pci@0/pci@2/network@0
/pci@7c0/pci@0/pci@1/pci@0,2
/pci@7c0/pci@0/pci@1/pci@0
/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1,1
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1
/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2/disk
/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2/tape
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1,1/fp@0,0
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1,1/fp@0,0/disk
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1/fp@0,0
/pci@7c0/pci@0/pci@1/pci@0,2/SUNW,qlc@1/fp@0,0/disk
/pci@7c0/pci@0/pci@1/pci@0/ide@8
/pci@7c0/pci@0/pci@1/pci@0/usb@6
/pci@7c0/pci@0/pci@1/pci@0/usb@5
/pci@7c0/pci@0/pci@1/pci@0/isa@2
/pci@7c0/pci@0/pci@1/pci@0/ide@8/cdrom
/pci@7c0/pci@0/pci@1/pci@0/ide@8/disk
/pci@7c0/pci@0/pci@1/pci@0/usb@6/hub@1
/pci@7c0/pci@0/pci@1/pci@0/isa@2/serial@0,3f8
/pci@780/pci@0
/pci@780/pci@0/pci@9
/pci@780/pci@0/pci@8
/pci@780/pci@0/pci@2
/pci@780/pci@0/pci@1
/pci@780/pci@0/pci@8/SUNW,qlc@0,1 ---> Dual port HBA port 2
/pci@780/pci@0/pci@8/SUNW,qlc@0 ---> Dual port HBA port 1
/pci@780/pci@0/pci@8/SUNW,qlc@0,1/fp@0,0
/pci@780/pci@0/pci@8/SUNW,qlc@0,1/fp@0,0/disk
/pci@780/pci@0/pci@8/SUNW,qlc@0/fp@0,0
/pci@780/pci@0/pci@8/SUNW,qlc@0/fp@0,0/disk
/pci@780/pci@0/pci@1/network@0,1
/pci@780/pci@0/pci@1/network@0
/virtual-devices@100/led@d
/virtual-devices@100/explorer@c
/virtual-devices@100/sunmc@b
/virtual-devices@100/sunvts@a
/virtual-devices@100/fma@9
/virtual-devices@100/echo@8
/virtual-devices@100/loop@7
/virtual-devices@100/loop@6
/virtual-devices@100/ncp@4
/virtual-devices@100/rtc@3
/virtual-devices@100/nvram@3
/virtual-devices@100/console@1
/openprom/client-services
/packages/SUNW,asr
/packages/obp-tftp
/packages/kbd-translator
/packages/dropins
/packages/terminal-emulator
/packages/disk-label           
/packages/deblocker
/packages/SUNW,builtin-dridvers
{0} ok


procedure icon  To Verify Attached Storage to the Installed HBA

If online storage is connected to the HBA, use the apply show-children command to list the attached storage.

In the example that follows, a storage JBOD has twelve targets attached to one port of the dual-ported HBA.


0} ok apply show-children  /pci@780/pci@0/pci@8/SUNW,qlc@0,1
QLogic QLE2462  Host Adapter Driver(SPARC): 1.11 10/03/05 
Firmware version 4.00.12
*****************  Local Loop Devices  *****************
Adapter loopId - 0 
Loop ID   12   Port WWN 21000004cf545de3
   Lun   0   DISK  SEAGATE ST314680FSUN146G0407
 
Loop ID   13   Port WWN 2100000c5007d0fe
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   15   Port WWN 500000e01015a131
   Lun   0   DISK  FUJITSU MAP3735F SUN72G 1601
 
Loop ID   10   Port WWN 2100000c5007cafc
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   18   Port WWN 2100000c50089c3d
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   19   Port WWN 2100000c5007c9bd
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   1b   Port WWN 500000e010159f41
   Lun   0   DISK  FUJITSU MAP3735F SUN72G 1601
 
Loop ID   16   Port WWN 2100000c50089dfb
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   1a   Port WWN 2100000c5008ba0f
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   17   Port WWN 2100000c5008697c
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   1c   Port WWN 215000c0ff00225b
   Lun   0     SUN     StorEdge 3510F D1046
 
Loop ID   11   Port WWN 2100000c5007c888
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
Loop ID   14   Port WWN 2100000c5007d519
   Lun   0   DISK  SEAGATE ST373307FSUN72G 0407
 
{0} ok 
 
{3} ok 



Note - You may need to use the reset-all command before entering apply show-children.



procedure icon  To Verify Proper Installation in x64 Based System

1. During system power on initiation the following system booting BIOS initialization screen is displayed:


QLogic Corporation
QLE2462 PCI Fibre Channel ROM BIOS version 1.04
Copyright (c) QLogic Corporation 1993-2005. All rights reserved.
www.qlogic.com
 
Press <Ctrl-Q> for Fast!UTIL 
BIOS for Adapter 0 is disabled
BIOS for Adapter 1 is disabled
ROM BIOS NOT INSTALLED

2. Immediately press Control-Q.

The following QLogic Fast!UTIL menu is displayed.


QLogic Corporation
QLE2462 PCI Fibre Channel ROM BIOS version 1.04
Copyright (c) QLogic Corporation 1993-2005. All rights reserved.
www.qlogic.com
 
Press <Ctrl-Q> for Fast!UTIL 
BIOS for Adapter 0 is disabled
 
BIOS for Adapter 1 is disabled
 
ROM BIOS NOT INSTALLED
 
<CTRL-Q> Detected, Initialization in progress, Please wait...

Then the following QLogic Fast!UTIL menu is displayed.


                    QLogic Fast!UTIL
                   Select Host Adapter
 
----------------------------------------------------------
Adapter Type   I/O Address   Slot   Bus   Device   Function
 
QLE2462               9400     01    02       01         1
QLE2462               9800     01    02       01         0

3. Use the Arrow key to move the Highlight to the HBA port which has devices connected and press Enter.

The following QLogic Fast!UTIL menu is displayed.


                   QLogic Fast!UTIL
                   Selected  Adapter
----------------------------------------------------------
Adapter Type   I/O Address   Slot   Bus   Device   Function
 
 QLE2462              9400     01    02       01          1
  
----------------------------------------------------------
   Fast!UTIL Options
 
   Configuration Settings
   Scan Fibre Deivces
   Fibre Disk Utility
   Loopback Data Test
   Select Host Adapter
   Exit Fast!UTIL

4. Use Arrow key to move the Highlight to “Scan Fibre Devices” and press Enter.

In the example that follows, a storage JBOD has 6 targets attached to one port of the dual-ported HBA.

The following QLogic Fast!UTIL menu is displayed.


                      QLogic Fast!UTIL
 
Scan Fibre Channel Loop
 
ID   Vendor           Product   Rev          Port Name Port ID
 
0   SEAGATE ST336752FSUN36G   0205   21000004CF64C8E0 0000CC
1   SEAGATE ST336752FSUN36G   0205   21000004CF6493D0 0000CB
2   SEAGATE ST336752FSUN36G   0205   21000004CF6428C4 0000CA
3   SEAGATE ST336752FSUN36G   0205   21000004CF64C5B2 0000C9
4   SEAGATE ST336752FSUN36G   0205   21000004CF6096F0 0000C7
5   SEAGATE ST336752FSUN36G   0205   21000004CF648010 0000C6
6   SUN      StorEdge 3510F D1046   215000C0FF00225B 0000CD
7   No device present
8   No device present
9   No device present
10  No device present
11  No device present
12  No device present
13  No device present
14  No device present
15  No device present

5. To exit the QLogic Fast!UTIL, press the Escape key and move the Highlight to “Exit Fast!UTIL” and press Enter.

The following QLogic Fast!UTIL menu is displayed.


                   QLogic Fast!UTIL
                   Selected  Adapter
 
----------------------------------------------------------
Adapter Type   I/O Address   Slot   Bus   Device   Function
 
QLE2462               9400     01    02       01         1
 
----------------------------------------------------------
  Fast!UTIL Options
 
  Configuration Settings
  Scan Fibre Deivces
  Fibre Disk Utility
  Loopback Data Test
  Select Host Adapter
  Exit Fast!UTIL

The following QLogic Fast!UTIL menu is displayed.


                   QLogic Fast!UTIL
 
Exit Fast!UTIL
----------------------------------
 
Reboot System
Return to Fast!UTIL


Installing the HBA Driver With the Solaris 10 OS

After you have completed the hardware installation and powered on the system, follow the instructions in this section to install the HBA driver with the Solaris 10 Operating System (OS) (SPARC or x64 Platform Edition).

To Download the Solaris Patch Cluster

1. Go to the SunSolve site at:

http://sunsolve.sun.com

2. Click on Patch Portal under Recommended and Security Patches.

3. Click on Recommended Patch Clusters under Recommended Solaris Patch Clusters, J2SE and Java Enterprise System Clusters.

4. Select and download one of the following:

Install this patch cluster before installing the qlc driver patch.


procedure icon  To Download HBA Driver Patches

The following qlc driver patches are needed to support the HBA:


Operating System

Patch Number

Location

Patch Name

Solaris 10 SPARC

119130-13 or higher

SunSolve Online at:
http://sunsolve.sun.com

qlc driver

Solaris 10 X86

119131-13 or higher

SunSolve Online at: http://sunsolve.sun.com

qlc driver




caution icon Caution - Before installing this patch, ensure that all other recommended Sun patches are installed.



procedure icon  To Install the Patch

single-step bullet  Use the patchadd command.

Diagnostic Support

The following SunVTS patches are needed to perform the diagnostic test for the HBA.


Operating System

Patch Number

Location

Patch Description

Solaris 10 SPARC

120965-01 or higher

SunSolve Online at:

http://sunsolve.sun.com

qlctest update for SunVTS 6.0

Solaris 10 X86

120966-01 or higher

SunSolve Online at: http://sunsolve.sun.com

qlctest update for SunVTS 6.0


Diagnostic support for the HBA driver with the Solaris 10 OS is available with SunVTS 6.0 with above patches.


Installing the HBA Driver With the Red Hat and SuSE OSs

After you have completed the hardware installation and powered on the system, follow the instructions in this section to install the HBA driver with the Red Hat and SUSE HBA driver and utilities.


procedure icon  To Install the HBA Driver

1. Go to the QLogic download site for Sun Microsystems at:

http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/SunOEM.aspx?oemid=124

2. Scroll to the table section that lists the SG-XPCIE1FC-QF4 and SG-XPCIE2FC-QF4 HBAs.

3. In the section of the table that contains the HBAs, view the Software for: row, and click Linux.

The Sun Recommended Software page for the Linux OS is displayed.

4. Scroll to the table that contains the drivers that you need, depending on the type of Linux OS (SUSE, Red Hat) and the type of system (x86, x64, and so on) you are using.

5. Follow the instructions in the table to download the driver to a local drive.

6. After the driver is downloaded, download the appropriate utility program (based on the type of system you are using) to a local drive.

7. Open the ReadMe and Release notes for the driver and utility, and follow the instructions for installing the driver and utility.

8. To verify the installation, follow the instructions provided in the ReadMe file.

Red Hat and SuSE OS Diagnostic Support

Diagnostic support is provided by the QLogic SANsurfer Pro or command-line interface (CLI) utility. It supports the following functions:

Details are provided in the ReadMe file.


Installing the HBA Driver With the Windows 2000 or Windows Server 2003 OS

The instructions in this section describe how to install an HBA driver for a Sun StorageTek 4 Gb FC Enterprise PCI Express Single or Dual Channel HBA connected to an external (non-boot) Fibre Channel device. Before you start this process, ensure that the operating system is installed and that your system is configured with the latest Service Pack and Windows Update.



Note - The driver is only installed once, even if you have multiple Sun StorageTek HBAs installed.



procedure icon  To Install the HBA Driver

1. Power down the system.

2. Install the Sun StorageTek 4 Gb FC Enterprise PCI Express Single or Dual Channel HBA into a PCI Express slot.

See Installing the HBA for more information.

3. Power up the system and allow Windows OS to boot.

4. When the Found New Hardware wizard appears, click Cancel.

5. Go to the QLogic download site for Sun Microsystems at:

http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/SunOEM.aspx?oemid=124

6. Scroll to the table section that lists the SG-XPCIE1FC-QF4 and SG-XPCIE2FC-QF4 HBAs.

7. In the section of the table that contains the HBAs, view the Software for: row, and click Windows.

The Sun Recommended Software page for the Windows OS is displayed.

8. Scroll to the table that contains the driver that you need, depending on the type of Windows OS (2000, 2003, 2008) and the type of system (x86, x64, and so on) you are using.

9. Click Download and save the driver file to a local directory.

10. Follow the instructions in any associated Release Notes and ReadMe files.

11. Reboot the system.


procedure icon  To Install the SANsurfer Pro and CLI for Windows

The QLogic SANsurfer FC HBA Manager and CLI provides configuration management utilities and diagnostics for the Sun StorageTek 4 Gb FC PCI Express Single and Dual Channel HBA. Follow these instructions to install the SANsurfer FC HBA Manager and CLI for Windows:

1. Go to the QLogic download site for Sun Microsystems at:

http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/SunOEM.aspx?oemid=124

2. Scroll to the table section that lists the SG-XPCIE1FC-QF4 and SG-XPCIE2FC-QF4 HBAs.

3. In the section of the table that contains the HBAs, view the Software for: row, and click Windows.

The Sun Recommended Software page for the Windows OS is displayed.

4. Scroll to the table that contains the SANsurfer software that you need, depending on the type of Windows OS (2000, 2003, 2008) and the type of system (x86, x64, and so on) you are using.

5. Download the SANsurfer software and follow the instructions in any associated Release Notes and Read Me files.