C H A P T E R 1

Installation

The Sun StorEdge 2 Gb FC PCI Dual Channel Network Adapter Installation Guide describes how to install the Sun StorEdge 2G FC PCI Dual Channel Network Adapter card in a system. These instructions are designed for an experienced system administrator or trained service provider.

Software Requirements

Device Drivers

Please refer to the Release Notes for the complete list of Operating System support (for example, Solaris x86, Linux and Windows) on this HBA. The minimum Solaris trademark SPARC operating environment releases to support the device drivers for the Sun StorEdge 2G FC PCI Dual Channel Network Adapter card is Solaris 8 update 4.

All of the drivers are unbundled with Solaris 8 SPARC operating environmen. See the Sun StorEdge 2G FC PCI Dual Channel Network Adapter Product Notes for a list of packages and patches and instructions for downloading them.

Note - If the required packages and patches are note installed, you can not use the network adapter.

Once installed, Sun StorEdge 2G FC PCI Dual Channel Network Adapter boards will have device paths similar to
/devices/pci@b,2000/pci@2/SUNW,qlc@x.

Under these nodes, there will be two instances of the qlc driver that has a device node similar to:
/devices/pci@b,2000/pci@2/SUNW,qlc@x/fp@0,0

qlc driver also has a devctl node for administrative use with a name similar to
/devices/pci@b,2000/pci@2/SUNW,qlc@x,1/fp@0,0:devctl

For devices found, the nodes are created depending on the WWN of the device. For a WWN of 2100002037182670, the device path is similar to
/devices/pci@b,2000/pci@2/SUNW,qlc@x/fp@0,0/ssd@2100002037182670,0:a

Go to the http://www.sun.com/products-n-solutions/hardware/docs Web site, click Storage and then click Adapters and read the Sun StorEdge 2G FC PCI Dual Channel Network Adapter Product Notes to obtain software patch IDs.

Go to the URL listed in the Sun StorEdge 2G FC PCI Dual Channel Network Adapter Product Notes to download the Fibre Channel transport device driver patches or, for updates, go to: http://sunsolve.sun.com.

Tools and Equipment Needed

You may need to order fiber optic cables. You can order them in the following lengths:

0.4 meter, part number X9721

two-meter, part number X9722

five-meter, part number X9723A

15-meter, part number X9724

SC-SC coupler X9720A

You will also need:

A No. 2 Phillips screwdriver

An antistatic wrist strap

A padded antistatic mat

Preparing for Installation

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:

Leave the HBA in its antistatic bag until you are ready to install it in the system.

Always use a properly fitted and grounded wrist strap or other suitable ESD protection when handling the HBA and observe proper ESD grounding techniques.

Hold the HBA by the edge of the PCB or mounting bracket, not the connectors.

Place the HBA on a properly grounded antistatic work surface pad when it is out of its protective antistatic bag.

Sun Enterprise Systems

The Sun StorEdge 2G FC PCI Dual Channel Network Adapter card does not support JTAG. When you install the PCI host adapter in a Sun Enterprise trademark system, be sure that the corresponding PCI riser card has the JTAG jumper removed (FIGURE 1-1).

Note - If the JTAG jumper is installed, the PCI I/O board will not be recognized or initialized during POST (power-on self-test) nor will it subsequently be recognized by the operating system.

FIGURE 1-1 JTAG Jumper

Preparing for a Sun StorEdge A5x00 Installation

1. Use the array's front panel module (FPM) to ensure that the firmware level of the interface boards is at least 1.05.

FIGURE 1-2 Checking the Sun StorEdge A5x00 Array Interface Board Firmware Level

If the firmware level is less than 1.05, you must upgrade the firmware using an
SBus-based host system before you can connect the array to the Sun StorEdge PCI Dual Fibre Channel Host Adapter. The instructions for obtaining the upgrade patch are in Step 3.

2. Determine which version of the Solaris trademark operating environment you are using.

Look at the /etc/release file and make sure the operating environment installed is at least Solaris 8. If you do not have an /etc/release file, you probably need to upgrade you operating environment to at least Solaris 8.

3. Get the required software:

qlc driver

SunVTS

a. Go to the http://docs.sun.com Web site and read the Sun StorEdge A5000 Installation Supplement.

b. Go to the http://www.sun.com/products-n-solutions/hardware/docs Web site, click Storage and read the Sun StorEdge 2G FC PCI Dual Channel Network Adapter Product Notes for the software patch IDs.

c. Download the software patches from the URL listed in the Sun StorEdge 2G FC PCI Dual Channel Network Adapter Product Notes or, for updates, go to: http://sunsolve.sun.com.

Contact your support service provider if you cannot access these Web sites.

Note - Be sure to read and follow the directions in the README file for each patch.

4. Log in as root on your system.

5. Verify that the SUNWses, SUNWssad, and SUNWvts packages have been installed on your system.

Use the /usr/bin/pkginfo command and grep for each of the above patches. For example:

# /usr/bin/pkginfo | grep SUNWvts

system SUNWvts Online Validation Test Suite

If you are missing any of these patches, you can get them from the Updates for
Solaris Operating Environment of your Solaris operating environment distribution.

6. Exit the operating environment.

To inform any mounted users that the system will be going down, use the shutdown command. Otherwise, use the init 0 command. See the Man Pages for these commands or the Solaris AnswerBook online documentation.

7. Power off the system.

Refer to the service documentation that came with your system.

Caution - Do not disconnect the power cord at this time. This connection provides the ground path necessary to remove and install printed circuit boards and components without damage.

8. Choose a slot into which to install the host adapter.

Follow the procedures in the documentation supplied with your system.

For systems that have more than one system board, you must also select and remove a system board that has an available PCI slot. Refer to your system documentation for specific instructions.

9. Attach the antistatic wrist strap to your wrist and to a metal component on the system chassis.

The wrist strap between you and the chassis provides the ground path necessary to safely remove and install the printed circuit boards and components without damaging them.

10. For systems with a standby-type power switch, disconnect the power cord.

Standby-type power switches have a icon.

11. Open the system.

Refer to your system documentation for specific instructions.

Caution - If you need to remove a system board for installation, place the board on a padded antistatic mat to prevent damage.

Installing the Host Adapter

1. Pull the two dust covers out of the 2x5 optical transceiver (OT) connectors (FIGURE 1-3).

FIGURE 1-3 Sun StorEdge 2G FC PCI Dual Channel Network Adapter Dust Covers

2. Install the host adapter in the PCI slot you have chosen.

Installation details vary for each system. Refer to your system documentation for specific instructions.

3. Reassemble the system.

Refer to your system documentation for specific instructions.

4. Disconnect the wrist strap.

5. Push the fiber optic cable connector into the OT connector until you hear a click (FIGURE 1-4).

Caution - Fiber optic cables have keyed connectors; they can only be inserted into OT connectors as shown in FIGURE 1-4.

FIGURE 1-4 Connecting a Fiber Optic Cable to an OT Connector

6. Connect the other end of the fiber optic cable to a device such as an array, switch or hub.

Caution - In multiple-initiator configurations, when a Sun StorEdge 2G FC PCI Dual Channel Network Adapter is directly connected to a Sun StorEdge A5x00, each port on the host adapter must be connected to a separate loop on the A5x00.

Refer to the documentation that came with the device for specific instructions.

7. Power on your peripherals and then your system.

Note - When you power on the system, the LED lights on the host bus adapter might blink. The LEDs are intended for manufacturing use only.

Note - If your system starts to reboot, interrupt the reboot process by pressing the Stop-A keys.

The system should now be at the ok prompt. If a > prompt is showing, type n to switch to the ok prompt.

8. Make sure that the system recognizes the host adapter.

See FIGURE 1-5 on "Invalid Cross-Reference Format" and "Invalid Cross-Reference Format". "Invalid Cross-Reference Format" is a continuation of "Invalid Cross-Reference Format".

CODE EXAMPLE 1-1 System Recognition of the Host Adapter, Part 1
ok show-devs /counter-timer@f,1c00 /pci@f,2000 /pci@f,4000 /counter-timer@e,1c00 /fhc@e,f8800000 /pci@e,2000 /pci@e,4000 /counter-timer@b,3c00 /fhc@a,f8800000 /sbus@a,0 /counter-timer@3,3c00 /sbus@3,0 /fhc@2,f8800000 /disk-board@6,0 /SUNW,UltraSPARC-II@5,0 /SUNW,UltraSPARC-ii@4,0 /fhc@4,f8800000 /SUNW,UltraSPARC-II@1,0 /SUNW,UltraSPARC-11@0,0 /fhc@0,f8800000 /central@1f,0 /virtual-memory /memory@0,0 /aliases /options /openprom /chosen /packages /pci@f,4000/SUNW,isptwo@3 /pci@f,4000/SUNW,isptwo@3/st /pci@f,4000/SUNW,isptwo@3/sd /fhc@e,f8800000/sbus-speed@0,500000 /fhc@e,f8800000/eeprom@0,300000 /fhc@e,f8800000/flashprom@0,0 /fhc@e,f8800000/environment@0,400000 /fhc@e,f8800000/ac@0,1000000 /pci@e,2000/pci@2 /pci@e,2000/pci@2/SUNW,qlc@1 /pci@e,2000/pci@2/SUNW,qlc@1,1 /pci@e,2000/pci@2/SUNW,qlc@1/fp@0,0 /pci@e,2000/pci@2/SUNW,qlc@1/fp@0,0/disk /pci@e,2000/pci@2/SUNW,qlc@1,1/fp@0,0 /pci@e,2000/pci@2/SUNW,qlc@1,1/fp@0,0/disk

CODE EXAMPLE 1-1 System Recognition of the Host Adapter, Part 1

ok show-devs

/counter-timer@f,1c00

/pci@f,2000

/pci@f,4000

/counter-timer@e,1c00

/fhc@e,f8800000

/pci@e,2000

/pci@e,4000

/counter-timer@b,3c00

/fhc@a,f8800000

/sbus@a,0

/counter-timer@3,3c00

/sbus@3,0

/fhc@2,f8800000

/disk-board@6,0

/SUNW,UltraSPARC-II@5,0

/SUNW,UltraSPARC-ii@4,0

/fhc@4,f8800000

/SUNW,UltraSPARC-II@1,0

/SUNW,UltraSPARC-11@0,0

/fhc@0,f8800000

/central@1f,0

/virtual-memory

/memory@0,0

/aliases

/options

/openprom

/chosen

/packages

/pci@f,4000/SUNW,isptwo@3

/pci@f,4000/SUNW,isptwo@3/st

/pci@f,4000/SUNW,isptwo@3/sd

/fhc@e,f8800000/sbus-speed@0,500000

/fhc@e,f8800000/eeprom@0,300000

/fhc@e,f8800000/flashprom@0,0

/fhc@e,f8800000/environment@0,400000

/fhc@e,f8800000/ac@0,1000000

/pci@e,2000/pci@2

/pci@e,2000/pci@2/SUNW,qlc@1

/pci@e,2000/pci@2/SUNW,qlc@1,1

/pci@e,2000/pci@2/SUNW,qlc@1/fp@0,0

/pci@e,2000/pci@2/SUNW,qlc@1/fp@0,0/disk

/pci@e,2000/pci@2/SUNW,qlc@1,1/fp@0,0

/pci@e,2000/pci@2/SUNW,qlc@1,1/fp@0,0/disk

CODE EXAMPLE 1-2 System Recognition of the Host Adapter, Method A, Part 2
ok apply show-children /pci@e,2000/pci@2/SUNW,qlc@5 LiD HA --- Port WWN --- ----- ---- Disk description ---- _3d 3d 5080020000025a5a SUN ----- SENA ---------- 1.09PZX _30 30 21000020370e6891 SEAGATE - ST19171FCSUN9.0G177E9823U86993 _33 33 21000020370e964f SEAGATE - ST19171FCSUN9.0G177E9823V06714 _36 36 21000020370e92c9 SEAGATE - ST19171FCSUN9.0G177E9823V11851 _2d 2d 5080020000025a59 SUN ----- SENA ---------- 1.09PZX _23 23 21000020370e930d SEAGATE - ST19171FCSUN9.0G177E9823V12050 _26 26 21000020370e9b08 SEAGATE - ST19171FCSUN9.0G177E9823V15713

CODE EXAMPLE 1-2 System Recognition of the Host Adapter, Method A, Part 2

ok apply show-children /pci@e,2000/pci@2/SUNW,qlc@5

LiD HA --- Port WWN --- ----- ---- Disk description ----

_3d 3d 5080020000025a5a SUN ----- SENA ---------- 1.09PZX

_30 30 21000020370e6891 SEAGATE - ST19171FCSUN9.0G177E9823U86993

_33 33 21000020370e964f SEAGATE - ST19171FCSUN9.0G177E9823V06714

_36 36 21000020370e92c9 SEAGATE - ST19171FCSUN9.0G177E9823V11851

_2d 2d 5080020000025a59 SUN ----- SENA ---------- 1.09PZX

_23 23 21000020370e930d SEAGATE - ST19171FCSUN9.0G177E9823V12050

_26 26 21000020370e9b08 SEAGATE - ST19171FCSUN9.0G177E9823V15713

In "Invalid Cross-Reference Format", /pci@e,0/pci@1/pc1@1/SUNW,qlc@5 is one port on the Sun StorEdge 2G FC PCI Dual Channel Network Adapter and the disks are in a Sun StorEdge A5000 array (SENA).

Note - The probe-scsi-all command does not function identically on all platforms, and does not in all cases probe for fiber channel devices. The
probe-fcal-all command exists only on Sun Enterprise trademark systems.

9. Reboot your system using the boot -r command.

Testing the Installation

SunVTS

Refer to the SunVTS documents in TABLE 1-4.

TABLE 1-1 Sun VTS Documents
Application	Title	Part Number
Diagnostic Testing	SunVTS 4.5 User's Guide ^[1]	816-1575
	SunVTS 4.5 Test Reference	816-1576
	SunVTS 4.3 User's Guide ^[2]	806-7705
	SunVTS 4.3 Test Reference	806-7704

SunVTS is a diagnostic program that exercises your system to verify the functionality, reliability, and configuration of your host adapter. You will need to install both the 32- and 64-bit versions of SunVTS.

Testing Procedure

1. To invoke SunVTS locally on a system running CDE, type the following as root:

# cd /opt/SUNWvts/bin

# ./sunvts

2. From the SunVTS menus select the following:

a. Select devices None and select intervention.

b. Select mode Functional test.

c. Select HostAdapters qlcx where x is the qlc number of the qlc port you want to run this test against.

d. If you want to run the external loopback test, place a loopback plug into the qlc port that you want to test.

If you do not have an external loopback plug, you can make one by taking apart a fiber cable and plug the same cable into the transmitter and receiver of the qlc port.

e. Right click on the qlc test and select Test Parameter Options.

f. Enable the External Loopback Test.

Note - If you do not use a loopback plug, you can connect the qlc port to storage devices. In such a case, you will be testing both the qlc and the entire fiber loop.

g. Select Start to start the test.

Note - If you select only the external loopback test, the different version diagnostic tests will not be run and the delay time between tests will be set to zero. This is a good way to test your fiber loop if you leave the qlc port attached to storage devices.

^{1 (TableFootnote) Use SunVTS 4.5 with Solaris 8 update 6 operating environment.}

^{2 (TableFootnote) Use SunVTS 4.3 with Solaris 8 update 4 operating environment.}