InfoDoc ID   Synopsis   Date
28200   How to identify fibre channel device drivers and related packages   28 Jan 2002

Status Issued

Description

There are times when you will encounter systems that are lacking the packages needed to configure and recognize fibre channel storage.

This document attempts to resolve the "missing packages" dilemma, which can take some time to sort out as you try to find all the packages, or figure out which ones you even need.

You will know you are missing packages if you can see the devices at the ok prompt using the following commands, but Solaris won't build the device tree for them:

ok show-devs
ok apply show-children <device> (doesn't work on the 450)
    or
ok select <device>
ok show-children

-NOTE-

The Host Adapter Installation Guide for the HBA's (Host Bus Adapters) in question are recommended reading. They have an excellent explanation on verifying the hardware from the OBP.

If Solaris builds the device paths for the HBA, but won't make the disk devices, you are probably missing the ssd driver (or at least it is an easy thing to check before suspecting hardware).

Sun currently has 3 Fibre Channel drivers; ifp, qlc, socal. They are used by the following HBA's:

Xoption#    FRU Part#   Product Name     Bus    Driver      ASIC
------------------------------------------------------------------
X6729A      375-0040    FC100/P          PCI    ifp         2100
X6748A	    375-0118	Diamond (cPCI)	 PCI	qlc	    2200
X6799A      375-3019    Amber            PCI    qlc         220x
X6727A      375-3030    Crystal+         PCI    qlc         220x
X6757A	    375-3048	Ivory		 sbus	qlc	    2200**
X6730A      501-5266*   FC100/S          sbus   socal       soc+
X2612A      501-4883    Type 4 IO        sbus   socal       soc+
X2622A      501-4884    Graphics IO      sbus   socal       soc+

*   There are 2 other previous FRUs: 501-3060, 501-5202
**  (There will be a new ISP2200 available for sbus in FY03)
       

Examples from path_to_inst:

FC100/P

"/pci@1f,4000/SUNW,ifp@5/ssd@w50020f2300002768,1" 3 "ssd"

FC100/S

"/sbus@1f,0/SUNW,socal@0,0/sf@0,0/ssd@w50020f2300005511,3" 3 "ssd"

Amber

"/pci@1f,2000/SUNW,qlc@1/fp@0,0/ssd@w2100002037224828,0" 14 "ssd"

Type 4 IO

"/sbus@a,0/SUNW,socal@d,10000/sf@1,0/ssd@w210000203770bf12,0" 411 "ssd"

*** Packages for 2.7/2.8 ***

NOTE - everything with an "x" at the end is the 64bit version

There is a basic set of packages you will need no matter what the HBA:

You need these for the ssd driver.
SUNWssad SPARCstorage Array Drivers SUNWssadx SPARCstorage Array Drivers SUNWssaop SPARCstorage Array Utility
You need these for the luxadm commands, i.e. A5000 (STORtools needs the lux packages).
SUNWluxop Sun Enterprise Network Array firmware and utilities SUNWluxox Sun Enterprise Network Array libraries
You will need these for your photons - but you seem to need them regardless.
SUNWses SCSI Enclosure Services Device Driver SUNWsesx SCSI Enclosure Services Device Driver (64-bit)

Specific to each HBA you will need the following:

FC100/S - SOC+

SUNWluxd.d Sun Enterprise Network Array sf Device Driver (sun4d) SUNWluxd.u Sun Enterprise Network Array sf Device Driver (sun4u) SUNWluxd.us Sun Enterprise Network Array sf Device Driver (sun4us) SUNWluxdx.u Sun Enterprise Network Array sf Device Driver (sun4u) SUNWluxdx.us Sun Enterprise Network Array sf Device Driver (sun4us) SUNWluxl Sun Enterprise Network Array socal Device Driver SUNWluxlx Sun Enterprise Network Array socal Device Driver
FC100/P (I believe you may need the sf driver for the ifp)
SUNWifp Sun Fibre Channel Arbitrated Loop Device Driver SUNWifph Sun Fibre Channel Arbitrated Loop Driver Header Files SUNWifpx Sun Fibre Channel Arbitrated Loop Device Driver
Amber/Crystal (leadville)
SUNWqlc Qlogic ISP 2200/2202 Fibre Channel Device Driver SUNWqlcx Qlogic ISP 2200/2202 Fibre Channel Device Driver SUNWfcip Sun FCIP IP/ARP over FibreChannel Device Driver SUNWfcipx Sun FCIP IP/ARP over FibreChannel Device Driver SUNWfcp Sun FCP SCSI Device Driver SUNWfcpx Sun FCP SCSI Device Driver SUNWfctl Sun Fibre Channel Transport Layer SUNWfctlx Sun Fibre Channel Transport Layer
VTS Test Packages
SUNWvtsqc3.4 VTS qlctest package for the qlc card - Solaris 7 SUNWvtsqc4.0 VTS qlctest package for the qlc card - Solaris 8
MPXIO (only works with qlc drivers & Solaris 8)
Install the SUNWsan package to enable Traffic Manager and Fabric Utilities (see link below)

*** Packages for 2.6 ***

The naming conventions for 2.6 are slightly different and the ifp packages are unbundled.

ssd:
SUNWssadv SPARCstorage Array Drivers SUNWssaop SPARCstorage Array Utility
luxadm:
SUNWluxop Sun Enterprise Network Array firmware and utilities
ses:
SUNWses SCSI Enclosure Services Device Driver
socal:
SUNWluxal Sun Enterprise Network Array socal Device Driver SUNWluxdv.d Sun Enterprise Network Array sf Device Driver (sun4d) SUNWluxdv.u Sun Enterprise Network Array sf Device Driver (sun4u) SUNWluxdv.u1 Sun Enterprise Network Array sf Device Driver (sun4u1)
ifp (unbundled packages):
SUNWifp Sun Fibre Channel Arbitrated Loop Device Driver SUNWifph Sun Fibre Channel Arbirated Loop Driver Header Files SUNWvtsfp VTS ifp test package

(no support for qlc or MPXIO)

Finding All of These Packages:

Now that you know what packages you need, you are probably wondering where to find them all. Check the CD that ships with the new card, or check the following CD locations:

Solaris 8:
They are all on disk 1 of 1 under "Product".

Solaris 7:
Everything except the qlc drivers are in the regular place, on the install CD under "Product". The qlc packages can be downloaded here:

http://sunsolve5.sun.com/qlc/#storedge

Solaris 2.6
The ifp packages are unbundled and there are no qlc packages. They should be on CD 704-6180-10

SUNWsan:

http://www.sun.com/storage/san (requires login)

VTS:
You can find the test packages at:

External
http://sunsolve5.sun.com/qlc/#qlc

Internal
http://webhome.central/diagnostics/docs/qlogic2202.html

Additional Links:

HBA FCODE

Fcode for all fibre HBAs we currently ship can be found at:

http://hba1-62.ebay/

HBA Support Matrix

http://webhome.ebay/HBAs/matrix.html

Driver Support Matrix

http://webhome.ebay/sanprjmgmt/drivers/support.html

INTERNAL SUMMARY:

Submitted by Karl.Vietmeier@Sun.COM

SUBMITTER: George Bolduc APPLIES TO: Hardware/Disk Storage Subsystem/StorEdge Disk Array/StorEdge A5000 ATTACHMENTS:


Copyright (c) 1997-2003 Sun Microsystems, Inc.