Wiki code for NPIV January Beta Release Notes

Hide Line numbers
1: ==NPIV January Beta Release
2: 
3: ===Introduction
4: 
5: These packages provide a Solaris implementation of N Port ID Virtualization (NPIV).
6: These changes only cover the driver portion of NPIV, they do not cover the xVM portions, which will be delivered in the future.
7: 
8: 
9: ====Background on NPIV
10: 
11: More information about NPIV can be found on the 
12: [[NPIV project page>>Project npiv.WebHome]]
13: 
14: ===Hardware requirements
15: 
16: NPIV support must be present in the adapter, and only new 4Gb
17: Qlogic and Emulex HBAs have resources to support NPIV.   
18: 
19: Emulex HBAs should use the latest firmware available, which can be downloaded from the Emulex web site.
20: Qlogic HBAs embed firmware in the driver, so do not require firmware upgrades.
21: 
22: Older HBAs continue to be supported without NPIV.
23: 
24: ===Downloading the packages
25: 
26: Download consists of three sets of packages.
27: 
28: First, select appropriate generic FibreChannel package, for 
29: [[X86>>attach:Project npiv.NPIV_Beta1_release_notes@solaris-11-i386.tar]]
30: or 
31: [[SPARC>>attach:Project npiv.NPIV_Beta1_release_notes@solaris-11-sparc.tar]].
32: 
33: Then, choose appropriate packages for the HBAs you have installed in your system.
34: 
35: Emulex ([[x86>>attach:Project npiv.NPIV_Beta1_release_notes@emlxs-11-i386.tar]]
36: [[SPARC>>attach:Project npiv.NPIV_Beta1_release_notes@emlxs-11-sparc.tar]])
37: 
38: Qlogic
39: ([[x86>>attach:Project npiv.NPIV_Beta1_release_notes@qlc-11-i386.tar]]
40: [[SPARC>>attach:Project npiv.NPIV_Beta1_release_notes@qlc-11-sparc.tar]])
41: 
42: ===Installing the packages
43: 
44: * First, untar new packages, for example tar -xvf solaris-11-sparc.tar.
45: The solaris-11-*.tar file contains the following set of packages
46: 
47:      SUNWcfcl
48:      SUNWfchba
49:      SUNWfcip
50:      SUNWfcmdb
51:      SUNWfcp
52:      SUNWfcprt
53:      SUNWfcsm
54:      SUNWfctl
55: 
56: * For each new package to be installed, the old package should be removed first. For example pkgrm SUNfctl
57: 
58: * The, install new packages using pkgadd command.
59: 
60: 
61: 
62: ====Note for users of emlxs NPIV implementation
63: 
64: Currently, the emlxs driver implements NPIV and reads the configuration from the emlxs.conf file.
65: When Solaris NPIV is finally released, we will transparently upgrade from the emlxs.conf file.
66: However, in this release, any configuration migration must be done manually.
67: 
68: 
69: ===Reverting to old packages
70: 
71: To change back to the original packages, the new packages should be first removed, then the original packages restored.
72: 
73: You can use pkgrm to remove the new packages.
74: 
75: You can then reinstall the original install packages.
76: For example if you use a DVD to install Solaris,
77: they are in the Solaris_11/Product
78: 
79: ===fcadm command
80: 
81: The new fcadm command supports adding and deleting NPIV ports.
82: The fcinfo command output has been extended to include NPIV capability.
83: 
84: *To create a port
85: 
86: {{{
87:     fcadm npiv-create-port <physical-port-wwn> <virtual-node-wwn> <virtual-port-wwn>
88: }}}
89: 
90: *to delete a virtual port
91: {{{
92:     fcadm npiv-delete-port <physical-port-wwn> <virtual-port-wwn> 
93: }}}
94: 
95: ===Selecting World Wide Name (WWN)
96: 
97: In this release, automatic WWN assignment for NPIV ports is not supported.
98: Users must ensure that their WWN is unique and follows naming rules.  
99: The relevant specification is at:
100: [[FC-FS-2>>http://www.t11.org/t11/stat.nsf/upnum/1619-d]], section 15.    
101: 
102: A WWN is a 64 bit value, and should be world wide unique.
103: There are different formats for world wide names determined by the first nibble (upper 4 bits).
104: One safe format to use is locally assigned, meaning the administrator assigned the name.
105: For locally assigned, first 4 bits are 0x3, the remaining bits are locally assigned. 
106: For example, the value 0x3000000000000000 is acceptable, and then
107: the next NPIV port could be 0x3000000000000001.    
108: 
109: The port name and node name may be identical.
110: 
111: 
112: ===Sample fcadm session
113: 
114: Example, create a virtual port.
115: *First, identify NPIV capable port, and note the physical port wwn (Called HBA Port WWN).
116: 
117: {{{
118:     # fcinfo hba-port
119:        HBA Port WWN: 210000e08b84e3ea
120:        OS Device Name: /dev/cfg/c4
121:        Manufacturer: QLogic Corp.
122:        Model: 375-3294-01
123:        Firmware Version: 4.3.0
124:        FCode/BIOS Version:  BIOS: 1.4; fcode: 1.11; EFI: 1.0;
125:        Type: N-port
126:        State: online
127:        Supported Speeds: 1Gb 2Gb 4Gb
128:        Current Speed: 4Gb
129:        Node WWN: 200000e08b84e3ea
130:        Max NPIV Ports: 63
131:        NPIV port list:
132: }}}
133: 
134: *Then create port
135: 
136: {{{
137:     # fcadm npiv-create-port 210000e08b84e3ea 1000000000000300 1000000000000301
138: }}}
139: 
140: *Verify port
141: 
142: {{{
143:     # fcinfo hba-port
144:        HBA Port WWN: 210000e08b84e3ea
145:        OS Device Name: /dev/cfg/c4
146:        Manufacturer: QLogic Corp.
147:        Model: 375-3294-01
148:        Firmware Version: 4.3.0
149:        FCode/BIOS Version:  BIOS: 1.4; fcode: 1.11; EFI: 1.0;
150:        Type: N-port
151:        State: online
152:        Supported Speeds: 1Gb 2Gb 4Gb
153:        Current Speed: 4Gb
154:        Node WWN: 200000e08b84e3ea
155:        Max NPIV Ports: 63
156:        NPIV port list:
157:          Vritual Port1:
158:                Node WWN: 1000000000000300
159:                Port WWN:   1000000000000301
160: }}}
161: 
162: *Then delete a virtual port
163: {{{
164:     # fcadm npiv-delete-port 210000e08b84e3ea 1000000000000301
165: }}}
166: 
167: ===Building the Source
168: 
169: Download source [[here>>attach:Project npiv.NPIV_Beta1_release_notes@solaris-11-npiv-source.tar.bz2]].
170: Source consists of an entire NWS source tree.  Existing [[NWS build procedures>>Project nws.WebHome]] can be used.    
171: 
172: Note: source for Emulex driver is not provided.
173: 
174: ===Questions:
175: 
176: Please direct questions to npiv-iteam at sun.com
OpenSolaris

Top Menu

Wiki code for NPIV January Beta Release Notes

Search

Collectives

Community Group

Project

User Group

Subsites

Project npiv Pages
