OpenSolaris

NPIV January Beta Release

Introduction

These packages provide a Solaris implementation of N Port ID Virtualization (NPIV).
These changes only cover the driver portion of NPIV, they do not cover the xVM portions, which will be delivered in the future.

Background on NPIV

More information about NPIV can be found on the
NPIV project page

Hardware requirements

NPIV support must be present in the adapter, and only new 4Gb
Qlogic and Emulex HBAs have resources to support NPIV.   

Emulex HBAs should use the latest firmware available, which can be downloaded from the Emulex web site.
Qlogic HBAs embed firmware in the driver, so do not require firmware upgrades.

Older HBAs continue to be supported without NPIV.

Downloading the packages

Download consists of three sets of packages.

First, select appropriate generic FibreChannel package, for
X86
or
SPARC.

Then, choose appropriate packages for the HBAs you have installed in your system.

Emulex (x86
SPARC)

Qlogic
(x86
SPARC)

Installing the packages

• First, untar new packages, for example tar -xvf solaris-11-sparc.tar.
  The solaris-11-*.tar file contains the following set of packages

     SUNWcfcl
     SUNWfchba
     SUNWfcip
     SUNWfcmdb
     SUNWfcp
     SUNWfcprt
     SUNWfcsm
     SUNWfctl

• For each new package to be installed, the old package should be removed first. For example pkgrm SUNfctl

• The, install new packages using pkgadd command.

Note for users of emlxs NPIV implementation

Currently, the emlxs driver implements NPIV and reads the configuration from the emlxs.conf file.
When Solaris NPIV is finally released, we will transparently upgrade from the emlxs.conf file.
However, in this release, any configuration migration must be done manually.

Reverting to old packages

To change back to the original packages, the new packages should be first removed, then the original packages restored.

You can use pkgrm to remove the new packages.

You can then reinstall the original install packages.
For example if you use a DVD to install Solaris,
they are in the Solaris_11/Product

fcadm command

The new fcadm command supports adding and deleting NPIV ports.
The fcinfo command output has been extended to include NPIV capability.

*To create a port

    fcadm npiv-create-port <physical-port-wwn> <virtual-node-wwn> <virtual-port-wwn>

*to delete a virtual port
fcadm npiv-delete-port <physical-port-wwn> <virtual-port-wwn>

Selecting World Wide Name (WWN)

In this release, automatic WWN assignment for NPIV ports is not supported.
Users must ensure that their WWN is unique and follows naming rules.  
The relevant specification is at:
FC-FS-2, section 15.    

A WWN is a 64 bit value, and should be world wide unique.
There are different formats for world wide names determined by the first nibble (upper 4 bits).
One safe format to use is locally assigned, meaning the administrator assigned the name.
For locally assigned, first 4 bits are 0x3, the remaining bits are locally assigned.
For example, the value 0x3000000000000000 is acceptable, and then
the next NPIV port could be 0x3000000000000001.    

The port name and node name may be identical.

Sample fcadm session

Example, create a virtual port.
*First, identify NPIV capable port, and note the physical port wwn (Called HBA Port WWN).

    # fcinfo hba-port
       HBA Port WWN: 210000e08b84e3ea
       OS Device Name: /dev/cfg/c4
       Manufacturer: QLogic Corp.
       Model: 375-3294-01
       Firmware Version: 4.3.0
       FCode/BIOS Version:  BIOS: 1.4; fcode: 1.11; EFI: 1.0;
       Type: N-port
       State: online
       Supported Speeds: 1Gb 2Gb 4Gb
       Current Speed: 4Gb
       Node WWN: 200000e08b84e3ea
       Max NPIV Ports: 63
       NPIV port list:

*Then create port

    # fcadm npiv-create-port 210000e08b84e3ea 1000000000000300 1000000000000301

*Verify port

    # fcinfo hba-port
       HBA Port WWN: 210000e08b84e3ea
       OS Device Name: /dev/cfg/c4
       Manufacturer: QLogic Corp.
       Model: 375-3294-01
       Firmware Version: 4.3.0
       FCode/BIOS Version:  BIOS: 1.4; fcode: 1.11; EFI: 1.0;
       Type: N-port
       State: online
       Supported Speeds: 1Gb 2Gb 4Gb
       Current Speed: 4Gb
       Node WWN: 200000e08b84e3ea
       Max NPIV Ports: 63
       NPIV port list:
         Vritual Port1:
               Node WWN: 1000000000000300
               Port WWN:   1000000000000301

*Then delete a virtual port
# fcadm npiv-delete-port 210000e08b84e3ea 1000000000000301

Building the Source

Download source here.
Source consists of an entire NWS source tree.  Existing NWS build procedures can be used.    

Note: source for Emulex driver is not provided.

Questions:

Please direct questions to npiv-iteam at sun.com