C H A P T E R  1

Installation

This chapter describes how to install the Sun StorEdgetrademark PCI Dual Fibre Channel Host Adapter in a system.


Software Requirements

Please consult the most resent version of the Release Notes for the lastest updates on the Operating Systems, platforms, software and storage devices supported.

Device Drivers

The minimum Solaristrademark operating environment releases to support the device drivers for the Sun StorEdge PCI Dual Fibre Channel Host Adapter are:

All of the above drivers are bundled with Solaris 8. See TABLE 1-2 for driver availability with Solaris 7.


TABLE 1-2 Solaris 7 Availability

Package

Solaris 7 Release

Availability

SUNWfctl

Solaris 7 11/99

Bundled

SUNWfcp

Solaris 7 11/99

Bundled

SUNWqlc

Solaris 7

Unbundled

SUNWfcip

Solaris 7

Unbundled


SunVTS qlctest


Tools and Equipment Needed

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

You will also need:


Preparing for Installation



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:

Sun Enterprise Systems

The Sun StorEdge PCI Dual Fibre Channel Host Adapter does not support JTAG. When you install the PCI host adapter in a Sun Enterprisetrademark 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
S-Bus-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 Solaristrademark operating environment you are using.

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

3. Get the required software:

a. Go to the http://docs.sun.com Web site.

b. Click Storage and read the Sun StorEdge A5000 Installation Supplement and the Sun StorEdge PCI Dual Fibre Channel Host Adapter Product Notes.

The Product Notes will give you the software patch IDs.

c. Download the software patches from:

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.

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 icon

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 icon

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 1x9 optical transceiver (OT) connectors (FIGURE 1-3).


FIGURE 1-3 Sun StorEdge PCI Dual Fibre Channel Host 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 icon

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 a disk array or hub.



caution icon

Caution - In multiple-initiator configurations:
bulletWhen a Sun StorEdge PCI Dual Fibre Channel Host 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.
bulletWhen a Fibre Channel Arbitrated Loop (FCAL) hub is placed between a Sun StorEdge PCI Dual Fibre Channel Host Adapter and a Sun StorEdge A5x00, more than one host adapter on the same loop may be used.



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

7. Power on your peripherals and then your system.



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.

Use either Method A or Method B.

a. For Method A, see FIGURE 1-5 on "Invalid Cross-Reference Format" and FIGURE 1-6 on "Invalid Cross-Reference Format".

FIGURE 1-6 is a continuation of FIGURE 1-5.

b. For Method B, see FIGURE 1-7 on "Invalid Cross-Reference Format".


FIGURE 1-5 System Recognition of the Host Adapter, Method A, Part 1



FIGURE 1-6 System Recognition of the Host Adapter, Method A, Part 2


In FIGURE 1-6, /pci@1f,0/pci@1/pc1@1/SUNW,qlc@4 is one port on the Sun StorEdge PCI Dual Fibre Channel Host Adapter and the disks are in a Sun StorEdge A5000 array (SENA).


FIGURE 1-7 System Recognition of the Host Adapter, Method B




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 Enterprisetrademark 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-4 Sun VTS Documents

Application

Title

Part Number

Diagnostic Testing

SunVTS 3.4 User's Guide

806-2884

 

SunVTS 3.4 Test Reference

806-2885

 

Sun VTS 4.0 User's Guide

806-2057

 

Sun VTS 4.0 Test Reference Manual

806-2058


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. In addition, you will need the SunVTS qlc test package--SUNWvtsqc--installed.

Once you have the SUNWvtsqc package installed, you may run the qlctest under 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 # 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.