Broadcom OneCommand Manager for VMware vCenter User Guide

Broadcom OneCommand Manager for VMware vCenter User Guide
™
OneCommand Manager for
VMware vCenter
Version 10.2
User Manual
P010089-01A Rev. A
Emulex Connects™ Servers, Storage and People
2
Copyright © 2011-2014 Emulex. All rights reserved worldwide. No part of this document may be reproduced by any
means or translated to any electronic medium without the prior written consent of Emulex.
Information furnished by Emulex is believed to be accurate and reliable. However, no responsibility is assumed by
Emulex for its use; or for any infringements of patents or other rights of third parties which may result from its use. No
license is granted by implication or otherwise under any patent, copyright or related rights of Emulex.
Emulex, the Emulex logo, AutoPilot Installer, AutoPilot Manager, BlockGuard, Connectivity Continuum,
Convergenomics, Emulex Connect, Emulex Secure, EZPilot, FibreSpy, HBAnyware, InSpeed, LightPulse, MultiPulse,
OneCommand, OneConnect, One Network. One Company., SBOD, SLI, and VEngine are trademarks of Emulex. All
other brand or product names referenced herein are trademarks or registered trademarks of their respective
companies or organizations.
Emulex provides this manual "as is" without any warranty of any kind, either expressed or implied, including but not
limited to the implied warranties of merchantability or fitness for a particular purpose. Emulex may make
improvements and changes to the product described in this manual at any time and without any notice. Emulex
assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties that may
result. Periodic changes are made to information contained herein; although these changes will be incorporated into
new editions of this manual, Emulex disclaims any undertaking to give notice of such changes.
Emulex, 3333 Susan Street
Costa Mesa, CA 92626
Note: References to OCe11100 series products also apply to OCe11100R series products.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
Table of Contents
Table of Contents
List of Figures .................................................................................... 12
List of Tables ..................................................................................... 16
1. Introduction ................................................................................... 17
Abbreviations ........................................................................................ 21
2. Installing and Uninstalling OneCommand Manager for VMware vCenter
Components ...................................................................................... 25
Best Installation Practices ......................................................................... 25
Requirements ........................................................................................ 25
Hardware..........................................................................................25
Software...........................................................................................25
Installing OneCommand Manager for VMware vCenter ...................................... 26
Verifying the OneCommand Manager for VMware vCenter Installation .................29
Enabling and Disabling OneCommand Manager for VMware vCenter ..................... 30
Registering and Unregistering OneCommand Manager for VMware vCenter ............ 31
Uninstalling OneCommand Manager for VMware vCenter................................... 33
Reinstalling OneCommand Manager for VMware vCenter ................................... 33
3. Using OneCommand Manager for VMware vCenter.................................... 35
Behavior of OneCommand Manager for VMware vCenter Settings in the
ESXi Server ........................................................................................... 35
Active Directory..................................................................................35
Privileges for OneCommand Manager for VMware vCenter................................35
Lockdown Mode Feature ........................................................................35
Accessing the vSphere Console ................................................................36
vSphere Console Views............................................................................. 36
Accessing OneCommand Manager for VMware vCenter from the VMware
Web Client ............................................................................................ 38
Enabling the OneCommand Manager for VMware vCenter in the Web
Client ..............................................................................................38
Enabling OneCommand Manager for VMware for vCenter Server Appliance
(vCSA)..............................................................................................39
Using OneCommand Manager for VMware vCenter Web Client ...........................39
Launching OneCommand Manager for VMware vCenter Web Client .....................40
4. Managing Clusters ............................................................................ 42
Viewing Information in a Cluster................................................................. 42
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
3
Table of Contents
Viewing Host Information in a Cluster ........................................................42
Hosts Information Field Definitions ............................................................... 43
Viewing Adapter Information ..................................................................43
Adapters Information Field Definitions ........................................................... 44
Viewing Port Information in a Cluster (Host centric mode) ...............................44
Host centric Information Field Definitions ....................................................... 45
Viewing Virtual Port Information in a Cluster (Host centric mode) ......................45
Virtual Port Information Field Definitions ....................................................... 46
Viewing Port Information in a Cluster (Fabric centric mode) .............................46
Fabric centric Information Field Definitions..................................................... 48
5. Managing Hosts ............................................................................... 49
Viewing Information and Driver Parameters in a Host....................................... 49
Viewing Information for a Single Host .......................................................49
Host Information Field Definitions ................................................................ 49
Viewing Driver Parameters of All Adapters in a Host ......................................50
Host Driver Parameters Tab Field Definitions ................................................... 51
Viewing Firmware Information for All Adapters in a Host ................................52
Host Maintenance Tab Field Definitions.......................................................... 52
Setting Driver Parameters for All Adapters in a Host ....................................... 52
6. Managing Adapters and Ports .............................................................. 54
FC and FCoE Ports................................................................................... 54
Viewing FC Adapter Information ..............................................................54
FC Adapter Information Field Definitions ........................................................ 54
Viewing FC Port Details and Changing Link State ...........................................55
FC Port Details Tab Field Definitions ............................................................. 56
Viewing FCoE Port Details ......................................................................57
FCoE Port Details Field Definitions................................................................ 57
Viewing FC/FCoE Port Driver Parameters ....................................................58
FC/FCoE Driver Parameters Tab Field Definitions .............................................. 59
Viewing FC/FCoE Port Statistics ..............................................................60
FC/FCoE Port Statistics Tab Field Definitions ................................................... 60
Viewing FC Port Transceiver Information ....................................................61
Transceiver Information Field Definitions ....................................................... 62
Viewing FC/FCoE Port Vital Product Data (VPD) ............................................63
VPD Table Definitions ............................................................................... 63
Viewing Maintenance Information and Firmware Versions for an FC/FCoE
Port ................................................................................................64
Maintenance Tab Field Definitions ................................................................ 65
Viewing and Managing FC/FCoE LUNs ........................................................... 66
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
4
Table of Contents
Viewing FC/FCoE LUN Information ............................................................66
FC/FCoE LUN Information Field Definitions ..................................................... 66
Enabling an Optimized Access Storage (ExpressLane) LUN ................................67
Disabling ExpressLane LUNs ....................................................................69
Viewing PCI Registers for an FC Port .........................................................69
Viewing Flash Contents for an FC Port .......................................................70
Viewing PCI Registers for an FCoE Port.......................................................70
Configuring FCoE Initialization Protocol (FIP) ...............................................71
FIP Tab Field Descriptions .......................................................................... 72
Configuring DCB Parameters for FCoE Adapter Ports ......................................73
DCB Tab Field Definitions........................................................................... 73
Configure DCB Parameters for FCoE Adapter Ports............................................. 74
Changing WWN Configuration for an FC Port ................................................75
Resetting an FC/FCoE Port .....................................................................78
Enabling and Disabling FC Ports ...............................................................79
Setting Driver Parameters for an FC/FCoE Port.............................................79
Saving Driver Parameters of an FC/FCoE Port to a File....................................79
Enabling/Disabling PFC Throttle on an FCoE Port ..........................................80
Configuring FIP Parameters for an FCoE Adapter ...........................................80
iSCSI Port ............................................................................................. 80
Viewing iSCSI Port Information ................................................................80
iSCSI Port Info Tab Field Definitions .............................................................. 81
Enabling iSCSI Boot ..............................................................................82
Viewing PCI Registers for an iSCSI Port.......................................................82
Viewing iSCSI iSNS Server Information........................................................83
iSNS Tab Field Definitions .......................................................................... 84
Disabling the iSNS Server .......................................................................84
Changing the iSNS Server .......................................................................84
Viewing iSCSI Initiator Statistics...............................................................84
iSCSI Statistics Tab Field Definitions.............................................................. 85
Viewing iSCSI Initiator Login Options .........................................................86
iSCSI Initiator Login Options Tab Field Definitions.............................................. 88
Initiator Default Login Options Window Field Definitions ..................................... 89
Viewing iSCSI Target Discovery Information .................................................90
iSCSI Target Discovery Tab Field Definitions .................................................... 90
Viewing iSCSI Target Information .............................................................91
iSCSI Target Information Tab Field Definitions.................................................. 91
Viewing Target Session Information ..........................................................91
Target Sessions Window Field Definitions........................................................ 92
Configuring iSNS for iSCSI Target Discovery .................................................94
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
5
Table of Contents
Viewing iSCSI LUN Information.................................................................94
iSCSI LUN Info Tab Field Definitions .............................................................. 95
Viewing iSCSI Port Vital Product Data (VPD).................................................95
VPD Table Definitions ............................................................................... 96
Configuring DCB Parameters for iSCSI Adapter Ports.......................................96
DCB Tab Field Definitions........................................................................... 97
Configure DCB Dialog Box Field Definitions ...................................................... 99
NIC Port ..............................................................................................102
Viewing NIC Port Information ................................................................ 102
NIC Port Information Tab Field Definitions .................................................... 102
Enabling and Disabling VEPA ..................................................................... 104
Viewing PCI Registers for a NIC Port ........................................................ 105
Viewing NIC Port Vital Product Data (VPD) ................................................ 106
VPD Table Definitions ............................................................................. 107
Using SR-IOV on NIC Ports .................................................................... 107
Enabling or Disabling SR-IOV ..................................................................... 107
Displaying Virtual Functions on a Host Operating System ................................... 108
Port Information Field Definitions for the Virtual Function ................................. 108
OCe10100–Series and OCe11100–Series Adapters ...........................................109
Viewing OCe10100–Series and OCe11100–Series Adapter Information ................. 109
Adapter Information Tab Field Definitions..................................................... 109
Channel Management Area (OCe11100–Series Adapters Only) .............................. 110
Viewing and Installing Licenses for OneConnect OCe10100–Series and
OCe11100–Series Adapters.................................................................... 111
Viewing Licenses ................................................................................... 112
Installing Licenses ................................................................................. 112
Changing Personalities on OCe10100–Series and OCe11100– Series Adapters ........ 113
Managing Port Channels Using Channel Management .................................... 114
Enabling and Disabling Channel Management ................................................. 114
Configuring Channel Management for OCe11100–Series Adapters...................... 115
Channel Mgmt Field Definitions ................................................................. 115
Disabling a Specific Channel ..................................................................... 116
LPVID Assignment for a Specific Channel ...................................................... 116
Bandwidth Assignments for a Specific Channel ............................................... 116
Viewing the Channel Management Tab for vNIC1 ......................................... 117
Channel Mgmt Field Definitions for vNIC1 ..................................................... 117
Viewing the Channel Management Tab for UFP ........................................... 118
Channel Mgmt Field Definitions for UFP........................................................ 118
Viewing OCe10100–Series and OCe11100–Series Adapter Firmware Information .... 119
Maintenance Tab Field Definitions .............................................................. 119
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
6
Table of Contents
Viewing and Configuring Physical Ports for OCe10100–Series and
OCe11100–Series Adapters.................................................................... 120
Viewing Physical Ports ............................................................................ 120
Physical Port Info Tab Field Definitions ........................................................ 120
Configuring a Physical Port for OCe10100–Series and OCe11100– Series
Adapters............................................................................................. 121
Change Port Speed Field Definitions ............................................................ 122
Viewing Physical Data for OneConnect 10GBASE–T–Series Adapters ....................... 122
PHY Data Tab Field Definitions .................................................................. 123
Viewing Port Transceiver Information for OCe10100–Series and OCe11100–Series
Adapters............................................................................................. 124
Transceiver Information Field Definitions ..................................................... 124
Viewing and Configuring OCe10100–Series and OCe11100– Series Physical
Port DCB Parameters .......................................................................... 125
Viewing Physical Port DCB Parameters ......................................................... 125
DCB Tab Field Definitions......................................................................... 126
Configuring Physical Port DCB Parameters..................................................... 127
Configure DCB Dialog Box Field Definitions .................................................... 128
OCe14100–Series Adapters .......................................................................130
Viewing OCe14100–Series Adapter Configuration Information .......................... 130
Configuring OCe14000–Series Adapters ..................................................... 131
OCe14100–Series Adapter Configuration Tab Field Definitions ............................. 131
Custom Configurations ............................................................................ 133
Mixed Mode Configuration ........................................................................ 134
Concurrent Mode................................................................................... 135
UMC Configuration View ...................................................................... 136
Default UMC Settings .............................................................................. 137
IBM MultiChannel Configuration View ...................................................... 138
Multichannel vNIC Configuration ................................................................ 138
MultiChannel SIMode Configuration ............................................................. 139
Multichannel UFP Configuration ................................................................. 140
Dell NPar Configuration Views ............................................................... 141
NPar Bandwidth Settings.......................................................................... 141
Two Port Adapters ................................................................................. 141
Four Port Adapters................................................................................. 143
Dell NPar Enabled.................................................................................. 144
Viewing and Configuring OCe14100–Series Physical Port DCB Parameters ............ 145
Viewing Physical Port DCB Parameters ......................................................... 145
DCB Tab Field Definitions......................................................................... 146
Configuring DCB Parameters for FCoE/iSCSI Adapter Ports ................................. 147
Configure DCB Dialog Box Field Definitions .................................................... 148
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
7
Table of Contents
7. Updating Firmware ........................................................................ 151
Performing a Batch Firmware Update in Cluster View ....................................151
Updating Firmware on Multiple Adapters in Cluster View ............................... 151
Batch Firmware Update Jobs Window Field Definitions ..................................... 154
Updating Firmware on Adapters in a Host ....................................................155
Jobs Window Field Definitions ................................................................... 158
Updating Firmware for an Adapter.......................................................... 159
Jobs Window for an FC Port ...................................................................... 161
Updating Firmware for OCe10100–Series,
OCe11100–Series, and OCe14100–Series Adapters ..........................................162
8. Exporting SAN Information in Cluster View ........................................... 164
Export SAN Info Window Field Definitions ................................................. 165
Active Jobs Column Definitions ................................................................ 165
Completed Jobs Column Definitions .......................................................... 166
Jobs Window Buttons ............................................................................ 166
Capturing SAN Information in XML or CSV Format ........................................ 166
Considerations When Exporting SAN Information in a Cluster View.................... 166
9. Diagnostics................................................................................... 167
LightPulse FC HBA Diagnostic Tests ............................................................167
Running Loopback Tests ...................................................................... 167
Running End to End (ECHO) Tests ........................................................... 168
Running D_Port Tests (LPe16000–Series FC Adapters).................................... 168
Running a Power On Self Test (POST) ...................................................... 172
Using Beaconing................................................................................ 172
Setting Up Diagnostic Test Options ......................................................... 172
Setting Up a Test Failure Error Action.......................................................... 172
Setting Up Test Cycles ............................................................................ 172
Setting Up a Test Pattern......................................................................... 173
Test Status .......................................................................................... 173
Saving the Log File............................................................................. 173
Creating FC Port Diagnostic Dumps ......................................................... 174
Diagnostic Dump Tab Field Definitions ......................................................... 174
Viewing Diagnostic Dumps Files ............................................................. 175
OneConnect Diagnostic Tests ....................................................................177
Running Loopback Tests ...................................................................... 177
Using Beaconing................................................................................ 178
Running a TDR Test (10GBASE–T–Series Adapters Only).................................. 178
Setting Up Diagnostic Test Options ......................................................... 179
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
8
Table of Contents
Setting Up a Test Failure Error Action.......................................................... 179
Setting Up Test Cycles ............................................................................ 179
Setting Up a Test Pattern......................................................................... 179
Test Status .......................................................................................... 179
Saving the Log File............................................................................. 179
Creating OneConnect Adapter Port Diagnostic Dumps ................................... 180
Diagnostic Dump Tab Field Definitions ......................................................... 181
Viewing Diagnostic Dumps Files ............................................................. 182
10. Troubleshooting .......................................................................... 183
Security ..............................................................................................183
Accepting the Blocked Content.............................................................. 183
Internet Explorer................................................................................... 183
Chrome and Firefox ............................................................................... 183
Installing a Security Certificate ............................................................. 184
11. Using OneCommand Manager for VMware vCenter Command Line
Interface......................................................................................... 188
Using the CLI Client ................................................................................189
Syntax Rules .................................................................................... 189
The Command Reference.........................................................................189
help (single command)........................................................................ 189
Syntax................................................................................................ 189
Description.......................................................................................... 189
Parameters.......................................................................................... 189
help (group) .................................................................................... 189
changepersonality ............................................................................. 192
changewwn ..................................................................................... 193
clearisnsserver ................................................................................. 194
cmgetparams ................................................................................... 194
cmmode ......................................................................................... 196
cmsetbw......................................................................................... 197
deletedumpfiles................................................................................ 198
driverconfig ..................................................................................... 199
D_Port ........................................................................................... 199
dump............................................................................................. 201
echotest ......................................................................................... 202
enablebootcode ................................................................................ 203
exportsaninfo................................................................................... 203
firmwareupdate ................................................................................ 204
getadapterportconfig (OCe14000–Series Only) ............................................ 205
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
9
Table of Contents
getbeacon ....................................................................................... 208
getdcbparams .................................................................................. 208
getdriverparams................................................................................ 208
getdriverparamsglobal ........................................................................ 209
getdumpdirectory.............................................................................. 209
getdumpfilenames ............................................................................. 210
getfcfinfo ....................................................................................... 210
getfipparams ................................................................................... 211
getinitiatorproperties ......................................................................... 211
getiscsiluns...................................................................................... 211
getiscsiportstats................................................................................ 212
getlunlist ........................................................................................ 212
getexpresslanelunlist (LPe16000–Series and OCe15100– Series Only).................. 213
getpcidata ...................................................................................... 214
getpginfo ........................................................................................ 214
getportstatistics................................................................................ 214
getretentioncount ............................................................................. 215
getsessioninfo .................................................................................. 215
getvpd ........................................................................................... 216
getwwncap...................................................................................... 216
getxcvrdata ..................................................................................... 217
hbaattributes ................................................................................... 217
installadapterlicense .......................................................................... 218
listvfuncs ........................................................................................ 218
listhbas .......................................................................................... 219
listprofiles....................................................................................... 219
listsessions ...................................................................................... 220
listvms ........................................................................................... 221
listvports ........................................................................................ 221
loadlist........................................................................................... 222
loopbacktest .................................................................................... 222
pcidata .......................................................................................... 223
portattributes .................................................................................. 224
posttest.......................................................................................... 224
readwwn ........................................................................................ 225
reset ............................................................................................. 225
restorewwn ..................................................................................... 226
saveconfig....................................................................................... 226
serverattributes ................................................................................ 227
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
10
Table of Contents
setadapterportconfig (OCe14000–Series Only) ............................................ 227
setbeacon ....................................................................................... 231
setcablenvp ..................................................................................... 231
setcnapgbw ..................................................................................... 232
setdcbparam.................................................................................... 233
setdcbpriority .................................................................................. 234
setdriverparam ................................................................................. 236
setdriverparamdefaults ....................................................................... 236
setdumpdirectory .............................................................................. 237
setfipparams.................................................................................... 237
setexpresslanelunstate (LPe16000–Series and OCe15100– Series Only) ............... 238
setpfcthrottle .................................................................................. 239
setphyportspeed ............................................................................... 240
setportenabled ................................................................................. 240
setretentioncount.............................................................................. 241
setvccred........................................................................................ 242
showisnsserver ................................................................................. 243
showlicenseadapterfeatures ................................................................. 243
showlicenseadapterid ......................................................................... 243
showpersonalities .............................................................................. 244
showtarget ...................................................................................... 245
sriovenable...................................................................................... 245
targetmapping.................................................................................. 245
tdrtest ........................................................................................... 246
umcsetlpvid..................................................................................... 246
updateisnsserver ............................................................................... 247
VEPAenable ..................................................................................... 248
version........................................................................................... 249
Viewing Audit Logs Using the CLI Command ..................................................249
12. Troubleshooting .......................................................................... 251
Security ..............................................................................................251
Accepting the Blocked Content.............................................................. 251
Internet Explorer................................................................................... 251
Chrome and Firefox ............................................................................... 251
Installing a Security Certificate ............................................................. 252
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
11
List of Figures
List of Figures
Figure 2-1
Figure 2-2
Figure 2-3
Figure 2-4
Figure 2-5
Figure 2-6
Figure 2-7
Figure 2-8
Figure 2-9
Figure 3-1
Figure 3-2
Figure 3-3
Figure 4-1
Figure 4-2
Figure 4-3
Figure 4-4
Figure 4-5
Figure 4-6
Figure 4-7
Figure 5-1
Figure 5-2
Figure 5-3
Figure 6-1
Figure 6-2
Figure 6-3
Figure 6-4
Figure 6-5
Figure 6-6
Figure 6-7
Figure 6-8
Figure 6-9
Figure 6-10
Figure 6-11
Figure 6-12
Figure 6-13
Figure 6-14
Figure 6-15
Figure 6-16
Installation Options Window.............................................................26
OCM for VMware vCenter Configuration Window.....................................27
OCM for VMware vCenter Configuration Window with Port in Use
Warning .....................................................................................27
Register/Unregister Dialog Box .........................................................28
vSphere Console ...........................................................................29
Plug-in Manager Window .................................................................30
Plug-in Manager with Selected Row ....................................................31
Register/Unregister Dialog Box .........................................................32
Reinstallation Configuration Dialog Box ...............................................34
Host-Centric Cluster View ...............................................................37
Host View...................................................................................38
vSphere Web Client Plug-In Management Page.......................................40
Hosts Information Pane ..................................................................42
Adapters Information .....................................................................43
Host-Centric Cluster View ...............................................................44
Close-Up of Host-Centric Cluster View ................................................45
Virtual Port Cluster View ................................................................46
Fabric-Centric Cluster View .............................................................47
Close-up of Fabric-Centric Cluster View...............................................47
Host Information Pane....................................................................49
Host Driver Parameters Pane............................................................51
Host Maintenance Tab....................................................................52
FC Adapter Information Tab.............................................................54
FC Port Details Tab .......................................................................55
FCoE Port Details Tab ....................................................................57
FC/FCoE Port Driver Parameters Tab ..................................................59
FC/FCoE Port Statistics Tab .............................................................60
FC Port Transceiver Tab .................................................................62
Port VPD Tab...............................................................................63
FC Port Maintenance Tab ................................................................64
FCoE Port Maintenance Tab .............................................................64
FC/FCoE LUN Information Tab ..........................................................66
Enable ExpressLane LUN Pull Down Menu .............................................68
FC/FCoE LUN with ExpressLane Enabled ..............................................68
FC Port PCI Registers Tab ................................................................69
FC Port Flash Contents ...................................................................70
FCoE Port PCI Registers Tab .............................................................71
FCoE Port FIP Tab .........................................................................72
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
12
List of Figures
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
6-17
6-18
6-19
6-20
6-21
6-22
6-23
6-24
6-25
6-26
6-27
6-28
6-29
6-30
6-31
6-32
6-33
6-34
6-35
6-36
6-37
6-38
6-39
6-40
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
6-41
6-42
6-43
6-44
6-45
6-46
6-47
6-48
6-49
6-50
6-51
6-52
6-53
6-54
Figure 6-55
Figure 6-56
DCB Tab (FCoE Adapter Port Selected) ................................................73
Configure DCB Dialog Box for FCoE Adapter Ports (DCBX Enabled) ...............75
Change WWN Configuration Dialog Box ................................................77
Warning About Changing WWN ..........................................................77
Reset Port Warning .......................................................................78
iSCSI Port Info Tab ........................................................................81
iSCSI Port, PCI Registers Tab ............................................................83
iSCSI Port, iSNS Tab.......................................................................83
iSCSI Port, Update iSNS Server Dialog Box ............................................84
iSCSI Initiator, iSCSI Statistics Tab .....................................................85
iSCSI Initiator Logon Options Tab .......................................................87
iSCSI Initiator Default Login Options Window.........................................87
iSCSI Target Discovery Tab ..............................................................90
iSCSI Target Information Tab............................................................91
iSCSI Target Sessions Window ...........................................................92
iSCSI LUN Info Tab ........................................................................95
iSCSI Port VPD Tab ........................................................................96
DCB Tab (iSCSI Adapter Port Selected) ................................................97
Configure DCB Dialog Box for iSCSI Adapter Ports (DCBX Enabled)................99
NIC Port Information Tab .............................................................. 102
NIC Port Information Tab, VEPA Enabled............................................ 105
NIC Port PCI Registers Tab ............................................................. 106
NIC Port VPD Tab........................................................................ 106
Virtual Functions Discovered on the Physical Function on the Host
Operating System ....................................................................... 108
Port Information tab for NIC Virtual Function ...................................... 108
OneConnect Adapter Information Tab .............................................. 109
OneConnect OCe11102 Adapter Information Tab .................................. 112
Install Feature Licenses Dialog Box................................................... 113
Channel Mgmt tab for the OCe11102 adapter ...................................... 115
Channel Management Tab in vNIC1 Mode ........................................... 117
Channel Management Tab in UFP Mode.............................................. 118
OCe11100-Series Adapter Maintenance Tab........................................ 119
OCe11100–Series Adapter Physical Port Info Tab .................................. 120
Change Port Speed Dialog Box ........................................................ 121
OneConnect Adapter PHY Data Tab .................................................. 123
OCe10100–Series Port Transceiver Tab .............................................. 124
FCoE Adapter Port, DCB Tab .......................................................... 125
DCB Configuration Dialog Box for FCoE and ISCSI Adapter Ports
(DCBX Enabled) .......................................................................... 128
OCe14100-series Adapter Configuration Tab (FCoE selected).................... 131
Current Configuration Details example .............................................. 132
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
13
List of Figures
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
6-57
6-58
6-59
6-60
6-61
6-62
6-63
6-64
6-65
6-66
6-67
6-68
6-69
6-70
6-71
6-72
Figure 7-1
Figure 7-2
Figure 7-3
Figure 7-4
Figure 7-5
Figure 7-6
Figure 7-7
Figure 7-8
Figure 7-9
Figure 7-10
Figure 7-11
Figure 8-1
Figure 8-2
Figure 8-3
Figure 9-1
Figure 9-2
Figure 9-3
Figure 9-4
Figure 9-5
Figure 9-6
Figure 9-7
Figure 9-8
Figure 9-9
Figure 9-10
Figure 9-11
OCe14100-series Adapter Configuration Tab, Custom Configuration ........... 133
Mixed Mode Protocol pull down menu ............................................... 134
Concurrent Storage Configuration View ............................................. 135
Concurrent Storage Configuration Choices for the Third Function .............. 136
UMC View (four ports) .................................................................. 136
MultiChannel View (showing multichannel type drop-down) .................... 138
MultiChannel vNIC View (Mixed Mode Storage)..................................... 139
MultiChannel SIMode View ............................................................. 140
MultiChannel UFP View (concurrent mode storage) ............................... 140
Dell Two Port NPar Configuration, NParEP Mode Disabled ....................... 142
Dell Two Port NPar Configuration, NParEP Mode Enabled ........................ 142
Dell Four Port NPar Configuration, NParEP Mode Disabled ....................... 143
Dell Four Port NPar Configuration, NParEP Mode Enabled........................ 144
Adapter Configuration Tab with NPar Enabled .................................... 144
OCe14100-Series Adapter, DCB Tab (FCoE/iSCSI Adapter Port Selected) ...... 146
DCB Configuration Dialog Box for FCoE and ISCSI Adapter Ports
(DCBX Enabled) .......................................................................... 148
Batch Firmware Update Information Pane .......................................... 151
Batch Firmware Download Dialog Box, Host-Centric View........................ 152
Batch Firmware Download Dialog Box, Fabric-Centric View ..................... 153
Batch Firmware Update Jobs Window ............................................... 154
Empty Batch Firmware Download Dialog Box ....................................... 156
Populated Batch Firmware Download Dialog Box .................................. 156
Jobs Window ............................................................................. 157
Firmware Download dialog box ...................................................... 159
Jobs Window ............................................................................. 161
Firmware Download Dialog Box ....................................................... 162
Jobs Window ............................................................................. 163
Export SAN Info .......................................................................... 164
Export SAN Info Dialog Box ............................................................ 165
Export SAN Info Jobs Window, Active Jobs List .................................... 165
FC Adapter Diagnostics Tab ........................................................... 167
Diagnostic Tests Warning .............................................................. 168
FC Adapter Diagnostics Tab with D_Port Tests Option ............................ 169
D_Port Tests Dialog Box ................................................................ 170
D_Port Tests Dialog Box - Passed Results............................................ 171
D_Port Tests Dialog Box - Failed Results ............................................ 171
Diagnostic Test Log Entries ............................................................ 173
FC Port Diagnostic Dump Tab ......................................................... 174
Diagnostic Dump Files window ........................................................ 175
Datastores View of vSphere Client ................................................... 176
vSphere Datastore Browser ............................................................ 176
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
14
List of Figures
Figure 9-12
Figure 9-13
Figure 9-14
Figure 9-15
Figure 9-16
Figure 10-1
Figure 10-2
Figure 10-3
Figure 10-4
Figure 10-5
Figure 12-1
Figure 12-2
Figure 12-3
Figure 12-4
Figure 12-5
OneConnect Adapter Diagnostics Tab................................................ 177
Diagnostic Tests Warning .............................................................. 178
Diagnostic Test Log Entries ............................................................ 180
Port Diagnostic Dump Tab ............................................................. 181
Diagnostic Dump Files window ........................................................ 182
Blocked Content in Internet Explorer ................................................ 183
Blocked Content in the Firefox or Chrome Browser ............................... 184
Untrusted Certificate................................................................... 184
Certificate Dialog Box .................................................................. 185
Certificate Import Wizard ............................................................. 185
Blocked Content in Internet Explorer ................................................ 251
Blocked Content in the Firefox or Chrome Browser ............................... 252
Untrusted Certificate................................................................... 252
Certificate Dialog Box .................................................................. 253
Certificate Import Wizard ............................................................. 253
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
15
List of Tables
List of Tables
Table 1-1
Table 10-1
Table 11-1
Table 12-1
Support Provided by Emulex CIM Provider Versions .................................18
Troubleshooting Issues and Resolutions ............................................. 186
Group and Supported Commands ..................................................... 190
Troubleshooting Issues and Resolutions ............................................. 254
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
16
1. Introduction
1. Introduction
Emulex® OneCommand Manager™ for VMware vCenter integrates the in-depth
management of Emulex host bus adapters (HBAs), universal converged network
adapters (UCNAs), and converged fabric adapters (CFAs) into the VMware vCenter
management console.
This comprehensive solution builds upon standard Emulex Common Interface Model
(CIM) management providers and advanced functionality delivered with the Emulex
OneCommand Manager application to present native configuration management,
status monitoring, and online maintenance of Emulex adapters in VMware ESXi
environments, using a graphical (GUI) or command line (CLI) user interface.
OneCommand Manager for VMware vCenter supports the following VMware
platforms:



VMware ESXi 5.5
VMware ESXi 5.1
VMware ESXi 5.0
OneCommand Manager for VMware vCenter can be hosted/registered on the
following servers:



vCenter Server 5.5
vCenter Server 5.1
vCenter Server 5.0
OneCommand Manager for VMware vCenter is supported for the following operating
systems:






Windows Server 2008 SP2 (or later) – Standard, Enterprise and Datacenter
editions (32 bit, x86) and (64 bit, x86_64)
Windows Server 2008 R2 – Standard, Enterprise and Datacenter editions (32 bit,
x86) and (64 bit, x86_64)
Windows 7 -x64
Windows 8 -x64
Windows 8.1 -x64
Windows Server 2012
Refer to Table 1-1, Support Provided by Emulex CIM Provider Versions, on page 18 to
determine the support provided by your Emulex CIM Provider.
Note: Screen shots in this manual are for illustrative purposes only. Your system
information can vary.
OneCommand Manager for VMware vCenter supports Emulex LPe16202 CFAs. If the
CFA is in Fibre Channel (FC) mode, it functions as an FC adapter. If it is in Fibre
Channel over Ethernet (FCoE) + network interface card (NIC) mode, it functions as a
UCNA.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
17
1. Introduction
OneCommand Manager for VMware vCenter supports Emulex OCe14101 and
OCe14102 UCNAs. The features available in OneCommand Manager for VMware
vCenter are determined by the version of Emulex CIM provider installed.
The following table lists the Emulex OneCommand Manager application support
provided by each Emulex CIM provider package and the individual FC and UCNA
providers in each package. The Emulex CIM Provider packages can be downloaded
from the Emulex website.
Note: In Table 1-1, the following conventions apply:




the feature is supported on the particular Emulex CIM Provider version and
OneCommand Manager for VMWare vCenter.
N/A the feature is not applicable.
* the feature is supported for LPe16000-series FC adapters only.
** the feature is supported for LPe16000-series FC and CNA adapters.

Table 1-1 Support Provided by Emulex CIM Provider Versions
Emulex OneCommand
Manager Application
Features
ELX CIM
Provider
Package
v10.0
UCNA
FC


View virtual port information
in a cluster (host-centric
mode)
N/A
N/A
Discover hosts, adapters (FC,
FCoE, NIC and iSCSI), targets,
and LUNs for selected ESXi
hosts

Discover hosts and adapters
(FC and FCoE) for selected
ESXi fabrics
Discover virtual ports
connected to an FC or FCoE
port
ELX CIM
Provider
Package
v10.2
UCNA

FC
OneCommand OneCommand
Manager for
Manager for
VMware
VMware
vCenter
vCenter
v10.0
v 10.2



N/A
N/A













Display firmware revision






Display boot code version






Update firmware and FC boot
code on a single adapter






Update firmware and FC boot
code on a per-fabric basis
N/A
N/A
N/A
N/A


Change WWPN or WWN for FC
adapters






Locate adapters with
beaconing






OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
18
1. Introduction
Table 1-1 Support Provided by Emulex CIM Provider Versions (Continued)
ELX CIM
Provider
Package
v10.0
ELX CIM
Provider
Package
v10.2
OneCommand OneCommand
Manager for
Manager for
VMware
VMware
vCenter
vCenter
v10.0
v 10.2
Emulex OneCommand
Manager Application
Features
UCNA
FC
UCNA
FC
Display PCI-Express registers






N/A
N/A

*
N/A
*
Physical Loopback test

N/A




MAC loopback test

N/A

N/A


D_Port (also referred to as
ClearLink) test
UCNA only
PCI loopback test
N/A

N/A



FC only
Internal and External
loopback test
Echo test
N/A

N/A



FC only


N/A



FC only
POST test
N/A


N/A
TDR tests

N/A

N/A
N/A
N/A
N/A
Enable/disable ports


Get driver parameters
(Global and Port)

Set global driver parameters
to adapters

LP only

LP only
N/A

















Set port driver parameters to
adapters






Target and LUN information






N/A
N/A
**
**
N/A
**
Reset Port (FC and FCoE only)






Toggle PFC throttle (FCoE
only)

N/A

N/A


View VPD






View data






Batch update firmware and
FC boot code to multiple
adapters
ExpressLane priority
queueing
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
19
1. Introduction
Table 1-1 Support Provided by Emulex CIM Provider Versions (Continued)
Emulex OneCommand
Manager Application
Features
ELX CIM
Provider
Package
v10.0
ELX CIM
Provider
Package
v10.2
OneCommand OneCommand
Manager for
Manager for
VMware
VMware
vCenter
vCenter
v10.0
v 10.2
UCNA
FC
UCNA
FC
View physical data for
10GBASE-T adapters

N/A

N/A

UCNA 10GBASE-T only

UCNA 10GBASE-T only
iSCSI management

N/A

N/A


Enable/disable FIP data

N/A

N/A


UCNA only
DCB configuration

N/A

N/A

UCNA only
N/A

UCNA only
Display flash contents
(wakeup parameters/flash
load list)

Export SAN configuration
information at cluster level
and at host level
N/A
N/A
N/A
Perform diagnostic dump at
the adapter and port level


Personality (protocol) change
and licensing

N/A
iSCSI boot firmware table
(iBFT) support

Channel Management

N/A

N/A


Single root I/O virtualization
(SR-IOV) (SR-IOV is not
supported with UMC channel
management.)

N/A
N/A
N/A


Virtual Ethernet Port
Aggregator (VEPA)
(SR-IOV must be enabled)

N/A

N/A






FC only
LP only
FC only
LP only
N/A







N/A


UCNA only
N/A

N/A


UCNA only
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
20
1. Introduction
Abbreviations
Abbreviations
BIOS
basic input-output system
BOFM
IBM BladeCenter Open Fabric Manager
CDB
command descriptor block
CFA
converged fabric adapter
CHAP
Challenge Handshake Authentication Protocol
CIM
Common Interface Model
CIN
Cisco, Intel, Nuova (data center bridging exchange)
CLI
command line interface
CLP
command line protocol
CM
channel management
CNA
Converged network adapter
CRC
cyclic redundancy check
CSV
comma-separated values
D_Port
Diagnostic port. Also referred to as ClearLink.
DAC
direct-attach copper
DCB
data center bridging
DCBX
data center bridging exchange
DHCP
Dynamic Host Configuration Protocol
DMA
direct memory access
EC
engineering change level
ETO
extended time out
FC
Fibre Channel
FCoE
Fibre Channel over Ethernet
FIP
FCoE Initialization Protocol
FPMA
fabric-provided MAC address
FW
firmware
GUI
graphical user interface
HW
hardware
HBA
host bus adapter
iBFT
iSCSI boot firmware table
IEEE
Institution of Electrical and Electronics Engineers
I/O
input/output
IP
internet protocol
IPL
initial program load
IPv4
Internet Protocol version 4
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
21
1. Introduction
Abbreviations
IPv6
Internet Protocol version 6
iSCSI
internet Small Computer System Interface
ISID
initiator session identifier
iSNS
internet Storage Name Server
KB
kilobyte
LDPC
low-density parity check
LDTO
link down time out
LED
light emitting diode
LIP
Loop Initialization Primitive
LLDP
Link Layer Discovery Protocol
LPVID
logical port VLAN ID
LUN
logical unit number
MAC
media access control
MDI
medium dependent interface
MN
manufacturer ID
MSE
mean squared error
MTU
maximum transmission unit
NCSI
Network Controller Sideband Interface
NED
NIC – ETS disabled.
NIC
network interface card (or controller)
NOS
not operational sequence
NPar
NIC Partitioning
NVP
nominal velocity of propagation
NVRAM
non-volatile random-access memory
OS
operating system
OUI
organizationally unique identifier
PF
physical function
PDU
protocol data unit
PFC
priority-based flow control
PGID
priority group ID
PHY
physical layer
PLL
phase lock loop
POST
power-on self-test
PXE
Pre-boot Execution Environment
QoS
quality of service
R2T
request to transmit
Recv
received
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
22
1. Introduction
Abbreviations
RHEL
Red Hat Enterprise Linux
RPI
remote port indicator
Rx
receive
SAN
storage area network
SCSI
Small Computer System Interface
SF
standard function
SFCB
Small Footprint CIM Broker
SFP
small form factor pluggable
SIMode
IBM term for UMC (switch independent mode). Previously known as
vNIC2.
SLES
SUSE Linux Enterprise Server
SLI
scalable link interface
SNMP
Simple Network Management Protocol
SNR
signal to noise ratio
SR-IOV
single root I/O virtualization
SNR
Signal-to-Noise
TCP
Transmission Control Protocol
TDR
time-domain reflectometer
Tx
transmit
UCNA
Universal Converged Network Adapter
UFP
IBM’s Universal Fabric Port.
ULP
Upper Layer Protocol
UMC
Universal Multichannel
UTF-8
U (Universal Character Set) Transformation Format –8 bit
vCSA
VMware for vCenter Server Appliance
VEPA
Virtual Ethernet Port Aggregator
VF
virtual function
VPD
vital product data
VLAN
virtual local area network
VLANID
virtual local area network id
VM
virtual machine
vNIC
virtual NIC (also known as virtual fabric mode)
vNIC2
previous name for SIMode
VPort
virtual port
WWN
world wide name
WWNN
world wide node name
WWPN
world wide port name
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
23
1. Introduction
Abbreviations
VM
virtual machine
Xmt
transmitted
XRI
exchange resource indicator
XML
extensible markup language
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
24
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Best Installation Practices
2. Installing and Uninstalling OneCommand
Manager for VMware vCenter Components
Best Installation Practices
OneCommand Manager for VMware vCenter provides real-time management as a
plug-in through the VMware vSphere console and VMware Web Client. The web client
allows you to run OneCommand Manager for VMware vCenter from the vSphere Web
client. System performance is directly influenced by the speed and efficiency of the
underlying network infrastructure. The following bullets outline recommendations to
achieve the best application response times.


To avoid network latencies, ensure that all the managed ESXi hosts, the vCenter
Server and the VI infrastructure client are in the same network.
To avoid configuration conflicts, install the vCenter Server and the VI
infrastructure client on different hosts within the same network.
Requirements
Hardware

Physical or virtual (x86/x86_64) servers with a minimum RAM of 2 Gb/s and
250 Mb/s of disk space
Software






VMware ESXi 5.0, 5.1, and 5.5 environments
Operating system – Windows Server 2008 (32 and 64 bit), Windows 7 (64 bit),
Windows 8 (64 bit), or Windows 2012 (64 bit)
Adobe Flash Player 11.2 or later
vCenter Server 5.0, 5.1, and 5.5
vSphere Client 5.0, 5.1, and 5.5
vSphere Web Client to manage vcenter server using web client instead of
vSphere client
Note: On the system where OneCommand Manager for VMware vCenter is installed,
make sure the port numbers configured during the installation are open and
dedicated to the OneCommand Manager for VMware vCenter server only. No
other service should be listening on this port.


Emulex CIM Provider Package 10.2
Driver and Firmware Requirements
Note: See the Emulex website for the latest compatible driver and firmware versions.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
25
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Installing OneCommand Manager for VMware vCenter
Installing OneCommand Manager for VMware
vCenter
Note: The Emulex CIM Provider must be installed on your ESXi host before installing
OneCommand Manager for VMware vCenter. For more information on
installing the CIM Provider, see the CIM Provider Package Installation Guide
available on the Emulex website.
Note: As part of the OneCommand Manager for VMware vCenter installation, the
OneCommand Manager for VMware vCenter Web Client components are
installed and registered.
To install OneCommand Manager for VMware vCenter in Windows:
1. From the Emulex website, download the
ELXOCM-VMware-vCenter-<version>-Setup.exe installation file to your system.
2. Navigate to the system directory to which you downloaded the file.
3. Double-click ELXOCM-VMware-vCenter-<version>-Setup.exe. The
OneCommand Manager for VMware vCenter window appears.
4. Click Next. The License agreement window appears.
5. Read the agreement and select the I agree to these terms and conditions checkbox
and click Next. The Installation Options window with the default Installation folder
appears.
Figure 2-1 Installation Options Window
6. Ensure that the OCM for VMware vCenter checkbox is selected.
7. Program files install by default to c:\Program Files\Emulex. To change this
location, click Browse and navigate to where you want the program files to reside.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
26
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Installing OneCommand Manager for VMware vCenter
8. Click Install. The Operation in progress screen appears. When the process is
complete, the OCM for VMware vCenter configuration window appears.
Figure 2-2 OCM for VMware vCenter Configuration Window
Default port numbers for OneCommand Manager for VMware vCenter server are
displayed.
Note: The Windows firewall setting must allow incoming connections on the
HTTP and HTTPS ports that you configure here.
If the port numbers are already in use, a warning appears next to the port number.
Figure 2-3 OCM for VMware vCenter Configuration Window with Port in Use Warning
9. Click Next. The Operation in progress screen appears. When the installation
process is complete a message prompts you to launch the registration utility.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
27
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Installing OneCommand Manager for VMware vCenter
10. Click Yes. The Register/Unregister dialog box appears in a new browser window.
Figure 2-4 Register/Unregister Dialog Box
11. Enter the following details of the vCenter Server:

vCenter Server Name – The IP address of the vCenter Server.

vCenter Server HTTPS Port – The HTTPS port number of the vCenter Server.
Note: The vCenter Server HTTPS port is by default 443. You can change this
value if you have configured a different HTTPS port while installing the
vCenter.
Username – The user with required privileges.

Password – The user password.
12. Click Register to register OneCommand Manager for VMware vCenter with a new
vCenter Server.

Notes:
You can unregister an existing OneCommand Manager for VMware
vCenter by clicking Unregister.

If you change the host name of the machine hosting the plug–in server, you
should re-install the plug–in server and re-register.
13. When the operation is successful, a message is displayed. Click OK.
14. Close the browser window. The Installation completed window appears. Click
Finish. An OneCommand Manager for VMware vCenter Registration icon is
created on the desktop. You do not need to reboot the system.

OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
28
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Installing OneCommand Manager for VMware vCenter
Verifying the OneCommand Manager for VMware vCenter
Installation
To verify OneCommand Manager for VMware vCenter installation:
1. Log in to the vCenter Server through the VMware vSphere console.
2. Enter the IP address and credentials of the vCenter Server where OneCommand
Manager for VMware vCenter is registered. The vSphere console appears.
Figure 2-5 vSphere Console
3. In the vSphere console select Plug-ins from the menu bar and select Manage
Plug-ins. The Plug-in Manager window appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
29
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Enabling and Disabling OneCommand Manager for VMware vCenter
Figure 2-6 Plug-in Manager Window
4. In the Plug-in Manager window, check the status of OneCommand Manager for
VMware vCenter (Emulex OneCommand). If the OneCommand Manager for
VMware vCenter installation is complete, the status of OneCommand Manager for
VMware vCenter is enabled by default.
Enabling and Disabling OneCommand Manager for
VMware vCenter
If you disable OneCommand Manager for VMware vCenter, the Emulex
OneCommand tab immediately disappears from the vSphere console. If you enable
OneCommand Manager for VMware vCenter, the Emulex OneCommand tab
immediately appears on the vSphere console.
To change the status of OneCommand Manager for VMware vCenter (Emulex
OneCommand in Figure 2-7):
1. Log in to the vCenter Server through the VMware vSphere console.
2. Enter the IP address and credentials of the vCenter Server where OneCommand
Manager for VMware vCenter is registered. The vSphere console appears.
3. In the vSphere console select Plug-ins from the menu bar and select Manage
Plug-ins. The Plug-in Manager window appears.
4. Click the Emulex OneCommand row. A context menu appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
30
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Registering and Unregistering OneCommand Manager for VMware vCenter
Figure 2-7 Plug-in Manager with Selected Row
5. Select Enable or Disable.
Registering and Unregistering OneCommand
Manager for VMware vCenter
Note: If you are using the vSphere Web Client, you must verify that the vSphere Web
Client and the vCenter server are registered to the same vCenter Single Sign On
server to ensure that the vSphere Web Client can access the vCenter server
inventory.
To register or unregister OneCommand Manager for VMware vCenter with a new
vCenter Server:
1. Double-click the OCM for VMware vCenter Registration icon on the desktop. This
icon is created when OneCommand Manager for VMware vCenter is successfully
installed. The register/unregister dialog box is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
31
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Registering and Unregistering OneCommand Manager for VMware vCenter
Figure 2-8 Register/Unregister Dialog Box
2. Enter the following details of the vCenter Server:

vCenter Server Name – The IP address of the vCenter Server.

vCenter Server HTTPS Port – The HTTPS port number of the vCenter Server.

The vCenter Server HTTPS port is by default 443. You can change this value if
you have configured a different HTTPS port while installing the vCenter.

Username – The user with required privileges.

Password – The user password.
3. Do one of the following:

Click Register to register OneCommand Manager for VMware vCenter with a
new vCenter Server.
-or
Click Unregister to unregister an existing OneCommand Manager for VMware
vCenter with a vCenter Server.
Notes:
If you change the host name of the machine hosting the plug-in server, you
should re-install the plug-in server and re-register.

If the vCenter server is already registered with another instance of
OneCommand Manager for VMware server, it is replaced with this server
instance.
4. When the operation is successful, a message is displayed. Click OK.
5. Close the browser window.

Note: OneCommand Manager for VMware vCenter can be registered with more than
one vCenter Server.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
32
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Uninstalling OneCommand Manager for VMware vCenter
Uninstalling OneCommand Manager for VMware
vCenter
Caution:
When you uninstall OneCommand Manager for VMware vCenter, ensure
that you do not delete the default configuration and log files that are stored
in the%TEMP%\Emulex\OCM for VMware directory. If these files are
deleted, all historical information of active management performed from the
host is permanently lost.
Before you uninstall OneCommand Manager for VMware vCenter, you must
unregister it from the vCenter Server. For more information, refer to “Using
OneCommand Manager for VMware vCenter” on page 35.
To uninstall OneCommand Manager for VMware vCenter in a Windows system:
1. Double-click ELXOCM-VMware-vCenter-<version>-Setup.exe. The
OneCommand Manager for VMware vCenter window prompts you to
reinstall/uninstall the application. Select Uninstall the application completely and
click Next. A progress window is displayed.
The screen indicating the detection of OneCommand Manager for VMware vCenter
appears.
2. Click OK. When uninstallation is complete, the Uninstallation Completed window
is displayed.
3. Click Finish. You do not need to reboot the system.
Reinstalling OneCommand Manager for VMware
vCenter
To reinstall OneCommand Manager for VMware vCenter in a Windows system:
1. Double-click ELXOCM-VMware-vCenter-<version>-Setup.exe. The
OneCommand Manager for VMware vCenter window prompts you to
reinstall/uninstall the application.
2. Select Re-install the application and click Next. A progress window is displayed.
The OCM for VMware vCenter window appears.
3. Click Next. The License agreement screen appears.
4. Read the agreement and select the I agree to these terms and conditions checkbox
and click Next. The Installation Options window with the previous installation
folder appears (Figure 2-1).
5. Click Install. OneCommand Manager for VMware vCenter is uninstalled. The
operation in progress window appears. When the process is complete, the
OneCommand Manager for VMware vCenter configuration window appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
33
2. Installing and Uninstalling OneCommand Manager for VMware vCenter Components
Reinstalling OneCommand Manager for VMware vCenter
Figure 2-9 Reinstallation Configuration Dialog Box
If OneCommand Manager for VMware vCenter was installed earlier with port
numbers other than the defaults provided, those configured ports are shown. If the
port numbers are already in use, a warning appears next to the port number.
Note: The Windows firewall setting must allow incoming connections on the
HTTP and HTTPS ports that you configure here.
6. Follow the on-screen instructions and complete the installation with steps 9 to 14 of
“Installing OneCommand Manager for VMware vCenter” on page 26.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
34
3. Using OneCommand Manager for VMware vCenter
Behavior of OneCommand Manager for VMware vCenter Settings in the ESXi Server
3. Using OneCommand Manager for VMware
vCenter
Behavior of OneCommand Manager for VMware
vCenter Settings in the ESXi Server
Active Directory
Refer to the vSphere manual on the VMware website for information on creating a user
with required privileges and changing access permissions for a user in the Active
Directory.
Privileges for OneCommand Manager for VMware vCenter
Only a user with these specific privileges can read and perform active management in
OneCommand Manager for VMware vCenter:



“Host.CIM.CIM Interaction” to read and manage data through the
OneCommand Manager for VMware vCenter
“Extension.Register extension” to register OneCommand Manager for VMware
vCenter using the registration utility
“Extension.Unregister extension” to unregister OneCommand Manager for
VMware vCenter using the registration utility
All other users including the root user of the ESXi host cannot perform any actions
including reading data. If a user without the required privileges attempts to perform
any action in OneCommand Manager for VMware vCenter, an error message is
displayed.
Note: To configure user roles and assign privileges, refer to the VMware vCenter Server
Manual.
Lockdown Mode Feature
Refer to the vSphere manual on the VMware website for information on enabling and
disabling lockdown mode.
If lockdown mode is enabled for an ESXi host, then only a user with the required
privileges can access the ESXi host and manage adapters using OneCommand Manager
for VMware vCenter. All other users including the root user will not have access to the
ESXi host.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
35
3. Using OneCommand Manager for VMware vCenter
vSphere Console Views
Accessing the vSphere Console
To access the vSphere console:
1. Log in to the VMware vSphere Client.
a. Double-click the VMware vSphere Client icon.
b. Enter the credentials and click Login.
2. Select a cluster or host in the vSphere console tree-view and click the Emulex
OneCommand tab to perform active management on a cluster or a host.
3. A Security Alert is displayed, click Yes. The vSphere console is displayed.
vSphere Console Views
The vSphere console supports two views:


Cluster view
Host view
To access the cluster view:
Select a cluster in the vSphere console tree-view and select the Emulex
OneCommand tab. The cluster view appears.
To access the host view:
Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab. The host view appears.
In cluster and host views, the OneCommand Manager for VMware vCenter window
consists of three major parts:




The Emulex Device Management area.
The Information pane corresponding to the option or element selected in the
Emulex Device Management area.
The About area shows version information about the Emulex OneCommand
Manager for VMware vCenter.
Console buttons

Help – Click to load the complete indexed online help for OneCommand
Manager for VMware vCenter. You can search for information for all
OneCommand Manager for VMware tabs and functions.

Refresh – Click to refresh the information. If a host is added to the currently
selected cluster, the host information is refreshed.

Preferences – Click to access the User Preferences window. Available in host
view only. In the User Preferences window, select the Event Logging
checkbox to show up/down events for FC, FCoE and iSCSI ports logged
into the vSphere console. NIC port events are not logged, as VMware
already does this. FC, FCoE and iSCSI port events are limited to the active
vCenter client. If the same user login is used from another vCenter client,
the User Preference window does not show these events.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
36
3. Using OneCommand Manager for VMware vCenter
vSphere Console Views
Note: The User Preferences window logs only up and down events for the
port. Other events, such as temperature, are not posted.
The difference between the two views is the Emulex Device Management area which
may contain options or a tree-view. In a cluster view you can view fabric-centric or
host-centric information about all the hosts in a cluster. Figure 3-1 shows the Emulex
Device Management options available in a host-centric cluster view. You can perform
active management simultaneously on a fabric or group of hosts belonging to a cluster.
In a host view you can only view information about a single host. Figure 3-2 shows the
Emulex Device Management tree-view elements for a selected host. In the host view, in
addition to selecting an element in the tree-view, you must also select a tab in the
information pane to view the information for the element selected in the tree-view.
Notes:


A host can be managed by only one vCenter Server at a time.
The OneCommand Manager for VMware vCenter user interface is auto
refreshed every five minutes.
Figure 3-1 Host-Centric Cluster View
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
37
3. Using OneCommand Manager for VMware vCenter
Accessing OneCommand Manager for VMware vCenter from the VMware Web Client
Figure 3-2 Host View
Accessing OneCommand Manager for VMware
vCenter from the VMware Web Client
You can run OneCommand Manager for VMware vCenter from within the vSphere
Web Client.
Note: The web client for OneCommand Manager for VMware vCenter was registered
as part of the installation.
Enabling the OneCommand Manager for VMware vCenter in
the Web Client
To activate OneCommand Manager for VMware vCenter, which allows it to be
accessed from the Classic Solutions tab, you must modify the webclient.properties file
on the server where the vSphere web client is installed.
1. Stop the vSphere web client service.
2. Locate the webclient.properties file in the vSphere Web Client install directory,
typically %ProgramData%\VMware\vSphere Web Client, and add the following
line:
scriptPlugin.enabled = true
3. Save and close the file.
4. Restart the vSphere web client service.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
38
3. Using OneCommand Manager for VMware vCenter
Accessing OneCommand Manager for VMware vCenter from the VMware Web Client
Enabling OneCommand Manager for VMware for vCenter
Server Appliance (vCSA)
vCSA is a preconfigured Linux-based virtual machine that runs the vCenter Server and
associated services. vCSA is an alternative for centralized management of VMware
vSphere instead of Windows vCenter Server.
To enable OneCommand Manager for VMware vCenter on vCSA:
1. Edit webclient.properties file at:
/var/lib/vmware/vsphere-client/webclient.properties
and add the statement:
scriptPlugin.enabled = true
2. Save the file.
3. Restart the vSphere Web Client service on the web console.
4. Log in to vCSA again.
The Classic Solutions tab for the OneCommand Manager for VMware vCenter is
now displayed.
Using OneCommand Manager for VMware vCenter Web
Client
OneCommand Manager for VMware vCenter can be enabled or disabled from the
Plug-In Management section in the vSphere Web Client.
Note: You must have sufficient privileges to access the Plug-In Management section.
Refer to the VMware documentation for information on configuring users and
privileges.
To enable OneCommand Manager for VMware vCenter in the vSphere Web Client:
1. From the navigation panel on the left-side of the vSphere Web Client Home page,
click Administration > Solutions> Plug-in Management. The Plug-in
Management page is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
39
3. Using OneCommand Manager for VMware vCenter
Accessing OneCommand Manager for VMware vCenter from the VMware Web Client
.
Figure 3-3 vSphere Web Client Plug-In Management Page
2. In the Plug-In Management page, select Emulex OneCommand Web and
right-click under the State column. A context menu opens.
3. Select Enable to enable OneCommand Manager for VMware vCenter or select
Disable to disable OneCommand Manager for VMware vCenter.
Launching OneCommand Manager for VMware vCenter Web
Client
Note: To increase the size of the OneCommand Manager for VMware screen, the
Recent Tasks panel on the right can be unpinned and collapsed.
OneCommand Manager for VMware vCenter is available at the host level and the
cluster level in the vSphere inventory list.
Once you are logged into the vSphere client, the OneCommand Manager for VMware
vCenter is under the Classic Solutions tab for a particular host or cluster that you select
in the vSphere client. When the Classic Solutions tab is loaded, the functionality and
features available are the same as those for the OneCommand Manager for VMware
vCenter available for vSphere console.
To launch the OneCommand Manager for VMware vCenter Web Client:
1. Log in to the vSphere Web Client. The vSphere Web Client home page is displayed.
2. Navigate to an ESXi host or cluster in the Navigation pane.
3. From the Host level view, select the host you want to display.
-orFrom the Cluster level view, select the cluster you want to display.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
40
3. Using OneCommand Manager for VMware vCenter
Accessing OneCommand Manager for VMware vCenter from the VMware Web Client
4. Go to the Classic solutions tab to access the OneCommand Manager for VMware
vCenter.
Note: If OneCommand Manager for VMware vCenter is the only plug-in
registered on the vCenter server, the tab title “Emulex OneCommand” does
not appear under the Classic Solutions tab. OneCommand Manager for
VMware vCenter directly loads under the Classic Solutions tab with no title.
The “Emulex OneCommand” plug-in is shown as a sub tab only if two or
more plug-ins are registered.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
41
4. Managing Clusters
Viewing Information in a Cluster
4. Managing Clusters
Note: Hosts in a cluster with different provider versions support features as listed in
Table 1-1, Support Provided by Emulex CIM Provider Versions, on page 18.
Viewing Information in a Cluster
From within a cluster, you can view information about:





Hosts in a cluster
Adapters on hosts in a cluster
Host-centric mode ports
Host-centric mode virtual ports
Fabric-centric mode ports
Viewing Host Information in a Cluster
You can view information about the various hosts in a cluster.
To view host information in a cluster:
1. Select a cluster in the vSphere console tree-view. The Getting Started tab is selected
by default.
2. Select the Emulex OneCommand tab, the Hosts information pane is displayed.
Figure 4-1 Hosts Information Pane
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
42
4. Managing Clusters
Viewing Information in a Cluster
Hosts Information Field Definitions








IP Address – The IP address of the host in the cluster.
Operating System – The operating system and version installed on the host.
Drivers – The drivers and their versions installed on the host.
CIM Provider Version – The version of the Emulex CIM Provider that is
running on the ESXi host.
Adapters – The number of adapters installed in the host.
Fabrics – The number of fabrics to which the host is connected.
Ports – The number of discovered physical ports that can be managed by the
host.
Lock Down Mode – Specifies if lock down mode is enabled or disabled.
To navigate Hosts Information fields:
1. Use the Filter list to filter the host information. You can choose any of the available
host information fields from the list, enter a wildcard for the field and click Search.
2. Click Clear to clear the search criteria.
3. Click Refresh to refresh the information. If a host is added to the currently selected
cluster, the host information is refreshed.
Viewing Adapter Information
You can view information about all adapters belonging to the various hosts in a cluster.
To view adapter information:
1. Select a cluster in the vSphere console tree-view and select the Emulex
OneCommand tab.
2. From the Emulex Device Management options, select Adapters. Adapters
information is displayed.
Figure 4-2 Adapters Information
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
43
4. Managing Clusters
Viewing Information in a Cluster
Adapters Information Field Definitions




Adapter Model – The model of the adapter.
Serial Number – The serial number of the adapter.
Hardware Version – For FC adapters this field shows the JEDEC ID. For
UCNAs this field shows the board type and revision code.
Description – The type of adapter.
To navigate the Adapter Information page:
1. Use the Filter list to filter the adapter information. Choose any of the available
adapter information fields from the list and enter a wildcard for the field and click
Search.
2. Click Clear to clear the search criteria and the corresponding adapter information.
3. Click Refresh to refresh the information. If an adapter is added to any of the hosts,
the adapter information is refreshed.
Viewing Port Information in a Cluster (Host centric mode)
To view port information in a cluster in host-centric mode:
1. Select a cluster in the vSphere console tree-view.
2. Select the Emulex OneCommand tab. Hosts information is displayed.
3. From the Emulex Device Management options, select Ports. The host-centric
information pane is displayed.
4. Make sure the Group by Fabric checkbox is cleared.
Figure 4-3 Host-Centric Cluster View
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
44
4. Managing Clusters
Viewing Information in a Cluster
Figure 4-4 Close-Up of Host-Centric Cluster View
Host centric Information Field Definitions







Port WWN – The Port World Wide Name.
Link Status – The status of the link on the selected port.
Fabric – This is a 64-bit worldwide unique identifier assigned to the fabric.
Driver Name – The executable file image name for the driver as it appears in the
Emulex driver download package.
Driver Version – The version of the installed driver.
Active FW Version – The active firmware version.
Flash FW Version – The firmware version that will become active once the
system is rebooted.
Viewing Virtual Port Information in a Cluster (Host centric
mode)
To view virtual port information in a cluster in host-centric mode:
1. Select a cluster in the vSphere console tree-view.
2. Select the Emulex OneCommand tab, port host information is displayed.
3. From the Emulex Device Management options, select vPorts. The Virtual Port
information is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
45
4. Managing Clusters
Viewing Information in a Cluster
Figure 4-5 Virtual Port Cluster View
Virtual Port Information Field Definitions






vPort WWN – The virtual port World Wide Name.
vPort Node WWN – The virtual port node World Wide Name.
vPort FCID – The virtual port FC ID.
vPort Name – The virtual port name.
Target Ports – The number of target ports.
Virtual Machine – Virtual machine information.
Filtering Host Information
To filter the host information:
1. Use the Filter list to filter the host information.
2. Choose any of the available host information fields from the list and enter a
wildcard for the field and click Search.
3. Click Clear to clear the search criteria.
Viewing Port Information in a Cluster (Fabric centric mode)
To view port information in a cluster in fabric-centric mode:
1. Select a cluster in the vSphere console tree-view.
2. Select the Emulex OneCommand tab, host information is displayed.
3. From the Emulex Device Management options, select Ports. The host-centric
information pane is displayed.
4. Select the Group by Fabric checkbox. Fabric information is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
46
4. Managing Clusters
Viewing Information in a Cluster
Figure 4-6 Fabric-Centric Cluster View
Note: iSCSI and NIC ports are not attached to any fabric, so they are listed under “No
Fabric Attachment”
Figure 4-7 Close-up of Fabric-Centric Cluster View
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
47
4. Managing Clusters
Viewing Information in a Cluster
Fabric centric Information Field Definitions








Port WWN – The port World Wide Name.
Host – The host IP address.
Adapter – The adapter model.
Link Status – The status of the link on the selected port.
Driver Name – The executable file image name for the driver as it appears in the
Emulex driver download package.
Driver Version – The version of the installed driver.
Active FW Version – The active firmware version.
Flash FW Version – The firmware version that will become active once the
system is rebooted.
Filtering Host Information
To filter the host information:
1. Use the Filter list to filter the fabric information.
2. Choose any of the available fabric information fields from the list and enter a
wildcard for the field and click Search.
3. Click Clear to clear the search criteria.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
48
5. Managing Hosts
Viewing Information and Driver Parameters in a Host
5. Managing Hosts
Viewing Information and Driver Parameters in a Host
Viewing Information for a Single Host
To view host information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab. The Host Information tab is selected by default and the information of the
selected host appears.
Figure 5-1 Host Information Pane
Host Information Field Definitions









Host Name – The host identifier.
Number of Adapters – The number of adapters installed in the host.
Number of Fabrics – The number of fabrics to which the host is connected.
Operating System – The operating system and version installed on the selected
host.
Lock Down Mode – Indicates whether lockdown mode is enabled or disabled.
IP Address – The IP address of the host.
Number of Ports – The number of discovered physical ports that can be
managed by this host.
Number of Target Ports – The number of targets discovered across the ports.
CIM Provider Versions – The version of the Emulex CIM Providers that are
running on the ESXi host.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
49
5. Managing Hosts
Viewing Information and Driver Parameters in a Host
Function Summary Area

NIC Functions – The number of NIC functions running on the discovered
adapters on this host.
FC/FCoE



FC Functions – The number of FC functions running on the discovered adapters
on this host.
FCoE Functions – The number of FCoE functions running on the discovered
adapters on this host.
FC Targets – The number of FC targets discovered on the FC/FCoE functions on
this host.
iSCSI


iSCSI Functions – The number of iSCSI functions running on the discovered
adapters on this host.
iSCSI Targets –The number of iSCSI targets discovered on the iSCSI functions
on this host.
Viewing Driver Parameters of All Adapters in a Host
The host Driver Parameters tab enables you to view and edit the adapter driver
parameter settings for a specific host. The host driver parameters are global values and
apply to all adapters in that host unless they are overridden by parameters assigned to
a specific adapter using the port Driver Parameters tab. For each parameter, the
information pane shows the current value, the range of acceptable values, the default
value, and whether the parameter is dynamic. A dynamic parameter allows the change
to take effect without resetting the adapter or rebooting the system. For information on
changing parameters for the host, refer to “Viewing Firmware Information for All
Adapters in a Host” on page 52.
Note: If there are no discovered FC or FCoE adapters, the driver parameters table is
empty. This occurs because there are no adapters to which the host driver
parameters apply.
To view driver parameters for all adapters in a host:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. Select the Driver Parameters tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
50
5. Managing Hosts
Viewing Information and Driver Parameters in a Host
Figure 5-2 Host Driver Parameters Pane
Host Driver Parameters Tab Field Definitions


Installed Driver Type – The current driver installed on this host.
Driver Parameter table – A list of adapter driver parameters and their current
values.
Driver parameter specific information is displayed in this area. This includes
value, range, default, activation requirements and description.







Parameter – The name of the driver parameter.
Value – The value of the driver parameter.
Temporary – Indicates if the value can be set temporarily at port level.
Range – The range of acceptable values for the driver parameter.
Default – The default value of the parameter.
Activation Requirements – The steps required to activate the changed
value of the driver parameter.
Description – The description of the driver parameter.
Host Driver Parameter Tab Buttons



Restore – Click if you changed parameters, but did not click Apply and you
want to restore the parameters to their last saved values.
Defaults – Click to reset all parameter values to their default (factory) values.
Apply – Click to apply the global values.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
51
5. Managing Hosts
Setting Driver Parameters for All Adapters in a Host
Viewing Firmware Information for All Adapters in a Host
For updating firmware, see “Updating Firmware on Adapters in a Host” on page 155.
The host Maintenance tab enables you to view and update firmware on multiple
adapters in a specific host.
To view firmware for all adapters in a host:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. Select the Maintenance tab.
Figure 5-3 Host Maintenance Tab
Host Maintenance Tab Field Definitions




Adapter – The model of the adapter.
Port – The port WWN.
Active FW Version – The current firmware on the adapter.
Flash FW Version – The flashed firmware on the adapter. Shows n/a for FC
ports.
Host Maintenance Tab Buttons

Update Firmware – Click to update firmware on the selected adapter.
Setting Driver Parameters for All Adapters in a Host
To change the driver parameters for all adapters in a host:
1. From the vSphere console tree-view, select the host whose adapter driver
parameters you want to change and select the Emulex OneCommand tab.
2. Select the host Driver Parameters tab. If there are adapters with different driver
types installed, the Installed Driver Types menu shows a list of all driver types and
driver versions that are installed. Select the driver whose parameters you want to
change. This menu does not appear if all the adapters are using the same driver.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
52
5. Managing Hosts
Setting Driver Parameters for All Adapters in a Host
3. In the driver parameter table, click the Value field of a parameter that you want to
change. The range for the value is displayed. Enter a value in decimal or
hexadecimal format, depending on how the current value is presented. If the value
is in hexadecimal format, it is prefixed by “0x” (for example -”0x2d”).
4. Parameters that can be changed temporarily can only be changed from the
corresponding port. Such parameters are represented with a check-box next to it.
5. Click Apply.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
53
6. Managing Adapters and Ports
FC and FCoE Ports
6. Managing Adapters and Ports
The adapter information that is displayed depends upon the type of adapter you select;
LightPulse (FC) or OneConnect.
FC and FCoE Ports
Viewing FC Adapter Information
When you select an FC adapter from the Emulex Device Management tree-view, the
Adapter Information pane contains general attributes associated with the selected FC
adapter.
To view information for an FC adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select an FC adapter. The adapter
Information tab is displayed.
Figure 6-1 FC Adapter Information Tab
FC Adapter Information Field Definitions






Model – The complete model name of the adapter.
Manufacturer – The manufacturer of the adapter.
Serial Number – The manufacturer's serial number for the selected adapter.
Device ID – The default device ID for the selected adapter.
HW Version – For LightPulse adapters, this field shows the JEDEC ID.
Adapter Temperature – If the adapter's temperature is not available, “Not
Supported” is displayed. If supported by the adapter, this field shows the
adapter's temperature and one of the following temperature-related status
messages:

Normal – The adapter’s temperature is within normal operational range.

Exceeded operational range – Critical: The adapter’s temperature is beyond
normal operational range. If the temperature continues to increase, the
adapter shuts down. You must determine the cause of the temperature
problem and fix it immediately. Check for system cooling issues. Common
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
54
6. Managing Adapters and Ports
FC and FCoE Ports

causes of system cooling issues include clogged air filters, inoperable fans
and air conditioning problems that cause high ambient air temperatures.
Exceeded operational range – Adapter stopped: The temperature has
reached critical limit, forcing the adapter to shut down. You must determine
the cause of the temperature problem and fix it before resuming operation.
Check for system cooling issues. Common causes of system cooling issues
include clogged air filters, inoperable fans and air conditioning problems
that cause high ambient air temperatures.
After the system overheating issue is resolved and the adapter has cooled
down, reboot the system or, if the system supports hot swapping, cycle the
power of the adapter slot.
Viewing FC Port Details and Changing Link State
When you select an FC port from the Emulex Device Management tree-view, the Port
Details tab contains general attributes associated with the selected FC adapter. A
button in the Port Status area enables you to disable or enable the port. This button
toggles between Disable and Enable, depending upon the current status of the physical
port.
To view details for an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port for which you want
to view information.
3. The Port Details tab is displayed.
Figure 6-2 FC Port Details Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
55
6. Managing Adapters and Ports
FC and FCoE Ports
FC Port Details Tab Field Definitions
Port Attributes Area
















Port WWN – The port World Wide Name of the selected adapter.
Node WWN – The node World Wide Name of the selected adapter.
Fabric Name – The Fabric Name is a 64-bit worldwide unique identifier
assigned to the fabric.
Boot Version – The version of boot code installed on the selected adapter port. If
the boot code is disabled, the field shows “Disabled”.
Port FCID – The FC ID of the selected adapter port.
PCI Function – The PCI function number of the selected port.
PCI Bus Number – The PCI bus number.
Driver Version – The version of the driver installed for the adapter.
Driver Name – The executable file image name for the driver as it appears in the
Emulex driver download package.
Firmware Version – The version of Emulex firmware currently active on the
adapter port.
Discovered Ports – The number of mapped and unmapped ports found during
discovery by the Emulex adapter driver. The mapped ports are targets and the
unmapped ports are non-targets such as switches or adapters.
Port Type – The current operational mode of the selected adapter’s port.
OS Device Name – The platform-specific name by which the selected adapter is
known to the operating system.
Symbolic Node Name – The FC name used to register the driver with the name
server.
Supported Class of Service – A frame delivery scheme exhibiting a set of
delivery characteristics and attributes. There are three classes of service.

Class 1 provides a dedicated connection between a pair of ports with
confirmed delivery or notification of non-delivery.

Class 2 provides a frame switched service with confirmed delivery or
notification of non-delivery.

Class 3 provides a frame switched service similar to Class 2 but without
notification of frame delivery or non-delivery.
Supported FC4 Types – A 256-bit (8-word) map of the FC-4 protocol types
supported by the port containing the selected adapter.
Port Status Area
The Link Status field indicates the status of the link on the selected adapter port.
FC Port Details Tab Buttons
The Enable Port/Disable Port button toggles between Disable Port and Enable Port,
depending upon the current status of the physical port.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
56
6. Managing Adapters and Ports
FC and FCoE Ports
Port Speed Area
The Port Speed field indicates the current port speed of the selected adapter port.
Viewing FCoE Port Details
Use the Port Details tab to view general attributes associated with the selected FCoE
port.
To view port details for an FCoE port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE port whose details
you want to view.
3. Select the Port Details tab.
Figure 6-3 FCoE Port Details Tab
FCoE Port Details Field Definitions
Port Attributes Area





Port WWN – The port World Wide Name of the adapter.
Node WWN – The node World Wide Name of the selected adapter.
Fabric Name – The Fabric Name field is displayed in Host view. This is a 64-bit
worldwide unique identifier assigned to the fabric. The host name is the name
of the host containing the adapter.
Boot Version – The version of boot code installed on the selected adapter port. If
the boot code is disabled, the field shows “Disabled”.
Port FCID – The FCoE ID for the selected adapter port.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
57
6. Managing Adapters and Ports
FC and FCoE Ports











PCI Function – The PCI function number assigned by the system.
PCI Bus Number – The PCI bus number.
Driver Version – The version of the driver installed for the adapter.
Driver Name – The executable file image name for the driver as it appears in the
Emulex driver download package.
Firmware Version – The version of Emulex firmware currently active on the
adapter port.
Discovered Ports – The number of mapped and unmapped ports found during
discovery by the Emulex adapter driver. The mapped ports are targets and the
unmapped ports are non-targets such as switches or adapters.
Port Type – The current operational mode of the selected adapter’s port.
OS Device Name – The platform-specific name by which the selected adapter is
known to the operating system.
Symbolic Node Name – The FC name used to register the driver with the name
server.
Supported Class of Service – A frame delivery scheme exhibiting a set of
delivery characteristics and attributes. There are three classes of service.

Class 1 provides a dedicated connection between a pair of ports with
confirmed delivery or notification of non-delivery.

Class 2 provides a frame switched service with confirmed delivery or
notification of non-delivery.

Class 3 provides a frame switched service similar to Class 2 but without
notification of frame delivery or non-delivery.
Supported FC4 Types – A 256-bit (8-word) map of the FC-4 protocol types
supported by the port containing the selected adapter.
Port Status Area




Link Status – The status of the link on the selected adapter port.
LinkDown Reason - The reason for the Link Status on the selected port.
Port Speed – The current port speed of the selected adapter port.
Bandwidth Limit – The QoS bandwidth restriction on the port.
Viewing FC/FCoE Port Driver Parameters
The Driver Parameter’s tab shows driver parameters for a port.
To view driver parameters for a port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the port for which you want to
view driver parameters.
3. Select the Driver Parameters tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
58
6. Managing Adapters and Ports
FC and FCoE Ports
Figure 6-4 FC/FCoE Port Driver Parameters Tab
FC/FCoE Driver Parameters Tab Field Definitions


Installed Driver Type – The current driver installed on this host.
Port Parameter table – A list of port driver parameters and their current values.

Parameter – The driver parameter’s name.

Value – The driver parameter’s value.

Temporary – Indicates if the value is temporary.

Range – The range of acceptable values for the driver parameter.

Default – The driver parameter’s default value.

Activation Requirements – The steps required to activate the changed value
of the driver parameter.

Description – The driver parameter’s description.
FC/FCoE Driver Parameters Tab Buttons





Globals – Click to set a port parameter value to the corresponding host
parameter value. All parameter values will be the same as the global, or host,
values.
Restore – Click if you changed parameters, but did not click Apply and you
want to restore the parameters to their last saved values.
Defaults – Click to reset all parameter values to their default (factory) values.
Apply – Click to apply the global values.
Export – Click to save a desired port parameter configuration.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
59
6. Managing Adapters and Ports
FC and FCoE Ports
Viewing FC/FCoE Port Statistics
When you select an FC/FCoE port from the discovery-tree, the Port Statistics tab
provides cumulative totals for various error events and statistics on the port. Some
statistics are cleared when the adapter is reset.
To view statistics for a port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the port for which you want to
view statistics information.
3. Select the Statistics tab.
Figure 6-5 FC/FCoE Port Statistics Tab
FC/FCoE Port Statistics Tab Field Definitions





Tx Frames – The FC frames transmitted by this adapter port.
Tx Words – The FC words transmitted by this adapter port.
Tx KB Count – The FC kilobytes transmitted by this adapter port.
Tx Sequences – The FC sequences transmitted by this adapter port.
LIP count – The number of loop initialization primitive (LIP) events that have
occurred for the port. This field is supported only if the topology is arbitrated
loop. Loop initialization consists of the following:

Temporarily suspending loop operations.

Determining whether loop capable ports are connected to the loop.

Assigning AL_PA IDs.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
60
6. Managing Adapters and Ports
FC and FCoE Ports
Providing notification of configuration changes and loop failures.

Placing loop ports in the monitoring state.
Error Frames – The number of frames received with cyclic redundancy check
(CRC) errors.
Link Failures – The number of times the link has failed. A link failure can cause
a timeout.
Loss of Signal – The number of times the signal was lost.
Invalid Tx Words – The total number of invalid words transmitted by this
adapter port.
Ex Count Orig – The number of FC exchanges originating on this port.
Active XRIs – The number of active exchange resource indicators.
Received P_BSY – The number of FC port-busy link response frames received.
Link Transitions – The number of times the SLI port sent a link attention
condition.
Elastic Buf Overruns – The number of times the link interface has had its elastic
buffer overrun.
Rx Frames – The number of FC frames received by this adapter port.
Rx Words – The number of FC words received by this adapter port.
Rx KB Count – The received kilobyte count by this adapter port.
Rx Sequences – The number of FC sequences received by this adapter port.
NOS count – The number of NOS events that have occurred on the switched
fabric (not supported for an arbitrated loop).
Dumped Frames – The number of frames that were lost due to a lack of host
buffers available.
Loss of Sync – The number of times loss of synchronization has occurred.
Prim Seq Prot Errs – The primitive sequence protocol error count. This counter
is incremented whenever there is any type of protocol error.
Invalid CRCs – The number of frames received that contain CRC failures.
Ex Count Resp – The number of FC exchange responses made by this port.
Active RPIs – The number of remote port indicators.
Receive F_BSY – The number of FC port-busy link response frames received.
Primitive Seq Timeouts – The number of times a primitive sequence event timed
out.
Arbitration Timeouts – The number of times the arbitration loop has timed out.
Large counts could indicate a malfunction somewhere in the loop or heavy
usage of the loop.
























Viewing FC Port Transceiver Information
The Transceiver Data tab enables you to view transceiver information such as vendor
name, serial number, part number and so on. If the adapter/transceiver does not
support some or all of the transceiver data, the fields display N/A.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
61
6. Managing Adapters and Ports
FC and FCoE Ports
To view transceiver information for an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port whose transceiver
information you want to view.
3. Select the Transceiver Data tab.
Figure 6-6 FC Port Transceiver Tab
Transceiver Information Field Definitions
Module Attributes Area










Vendor – The name of the vendor.
Identifier/Type – The identifier value that specifies the physical device
described by the serial information.
Ext. Identifier – Additional information about the transceiver.
Connector – The external optical or electrical cable connector provided as the
media interface.
Wavelength – The nominal transmitter output wavelength at room
temperature.
OUI – The vendor’s Organizationally Unique Identifier. It is also known as the
IEEE Company Identifier for the vendor.
Date – The vendor’s date code in the MM/DD/YY format.
Serial Number – The serial number provided by the vendor.
Part Number – The part number provided by the SFP vendor.
Revision – The vendor revision level.
Diagnostic Data Area

Temperature – The internally measured module temperature.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
62
6. Managing Adapters and Ports
FC and FCoE Ports




Supply Voltage – The internally measured supply voltage in the transceiver.
TX Bias Current – The internally measured TX bias current.
TX Output Power – The measured TX output power.
RX Input Power – The measured RX input power.
Viewing FC/FCoE Port Vital Product Data (VPD)
The VPD tab shows vital product data (if available) for the selected FC/FCoE port such
as the product name, part number, serial number, and so on.
To view VPD information for a port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the port for which you want to
view VPD information.
3. Select the VPD tab.
Figure 6-7 Port VPD Tab
VPD Table Definitions




Part Number – The adapter's part number.
Product Name – The product information about the selected adapter port.
Serial Number – The adapter's serial number.
VO – Vendor unique data. “V” indicates a vendor-specific field. An adapter
may have none, one or more of these fields defined. Valid values for this field
are “VO” (the letter “O”, not the number zero) and “Vx” (where “x” is a
number).
Note: Some adapters may show additional VPD information such as
engineering change (EC) level and MN (manufacturer ID).
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
63
6. Managing Adapters and Ports
FC and FCoE Ports
Viewing Maintenance Information and Firmware Versions
for an FC/FCoE Port
The Maintenance tab shows firmware information for an FC/FCoE port.
To view firmware information for a port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC/FCoE port whose
firmware information you want to view.
3. Select the Maintenance tab.
Figure 6-8 FC Port Maintenance Tab
Figure 6-9 FCoE Port Maintenance Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
64
6. Managing Adapters and Ports
FC and FCoE Ports
Maintenance Tab Field Definitions
FC Port Firmware Area







Current Version – The Emulex firmware version number for this model of
adapter.
Initial Load – The firmware version stub responsible for installing SLI code into
its proper slot.
SLI-2 Name – The name of the SLI-2 firmware overlay.
Kernel Version – The version of the firmware responsible for starting the driver.
Operational Name –The name of the operational firmware for the selected
adapter.
SLI-1 Name – The name of the SLI-1 firmware overlay.
SLI-3 Name – The name of the SLI-3 firmware overlay.
FCoE Port Firmware Area




Firmware Version on Flash – The firmware version stored on the adapter’s
non-volatile storage. When the system restarts, this version becomes the active
firmware version.
Service Processor FW Version – The firmware version that is operational on the
adapter.
Active Firmware Version – The firmware version running on the selected
adapter.
ULP FW Name – The firmware version running on the ULP processors within
the ASIC.
WWN Management Area (FC and FCoE)
Current


WWPN – The WWPN for the selected adapter port.
WWNN – The WWNN for the selected adapter port.
Pending Changes


WWPN – If the WWPN has been changed, the new WWPN is displayed in this
list until the system is rebooted. Once rebooted, the new WWPN is displayed in
the Current list.
WWNN – If the WWNN has been changed, the new WWNN is displayed in this
list until the system is rebooted. Once rebooted, the new WWNN is displayed in
the Current list.
Maintenance Tab Buttons (FC and FCoE)

Change WWN – Click to change the selected adapter port's WWPN or WWNN.
Refer to “Changing WWN Configuration for an FC Port” on page 75 for more
information.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
65
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs

Reset – Click to reset the adapter port. Refer to “Viewing FC/FCoE Port Driver
Parameters” on page 58 for more information.
Maintenance Tab Buttons (FC only)

Update Firmware – Click to update firmware on the selected port.
Viewing and Managing FC/FCoE LUNs
Viewing FC/FCoE LUN Information
When you select a LUN associated with an FC/FCoE adapter from the Emulex Device
Management tree-view, the LUN Info pane shows information associated with that
LUN.
To view LUN information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC/FCoE LUN whose
information you want to view. The corresponding LUN Info pane appears.
Figure 6-10 FC/FCoE LUN Information Tab
FC/FCoE LUN Information Field Definitions
Vendor Product Information Area



Vendor Name – The name of the vendor of the LUN.
Product ID – The vendor-specific ID for the LUN.
Revision – The vendor-specific revision number for the LUN.
Mapping Information Area

FCP LUN – The FC identifier used by the adapter to map to the operating
system LUN.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
66
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs


SCSI OS LUN – The SCSI identifier used by the operating system to map to the
specific LUN.
OS Device Name – The name assigned by the operating system to the LUN.
LUN Capacity Area
LUN capacity information is only provided when the LUN is a mass-storage (disk)
device. Other devices such as tapes and scanners do not display capacity.


Capacity – The capacity of the LUN, in megabytes.
Block Size – The length of a logical unit block in bytes.
Enabling an Optimized Access Storage (ExpressLane) LUN
Notes




Enabling an ExpressLane LUN is supported only for the LPe16000 and
OCe15100 families of adapters.
Express Lane is supported only on ESXi5.5 versions.
An ExpressLane LUN must be enabled in the driver before it can be used by the
OneCommand Manager for VMware vCenter. Additionally, the priority value
to mark each of the ExpressLane frames needs to be specified to the FC/FCoE
driver through new driver parameters.
ExpressLane is not supported for LUNs attached to virtual ports.
If your system contains flash and rotational storage I/O on the same initiator port, the
improved performance of the flash storage can be hindered by the slower rotational
storage I/O performance. Because both are sharing the same queue, rotational storage
I/O requests queued up in front of flash storage I/O requests can prevent the
performance gains of flash storage I/O (i.e. head of line blocking). To prevent this, you
can create a separate priority queue in the driver to process the requests ahead of the
normal queue. Additionally, the I/O frames placed on this queue can be marked with a
priority so that the switch and target also prioritizes the flash I/O requests. By
indicating to the FC/FCOE driver, which LUNs should receive this special priority
queuing (i.e. ExpressLane LUNs), performance on these LUNs can be greatly
improved. Even if only FC flash storage is available on your system, there may be
LUNs that you want to run I/O with a higher priority than other LUNs.
To enable an ExpressLane LUN:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, expand the FC/FCoE adapter port.
3. Expand the FC/FCoE target.
4. Right-click the LUN on which you want to enable ExpressLane.
5. Select Enable ExpressLane LUN from the pull down menu.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
67
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Figure 6-11 Enable ExpressLane LUN Pull Down Menu
The LUN icon changes to
.
Note: The ExpressLane state of a LUN is enabled at the driver (active) level and
the configured level (persists across reboots).
Figure 6-12 FC/FCoE LUN with ExpressLane Enabled
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
68
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Disabling ExpressLane LUNs
You can disable a specific ExpressLane LUN or disable all ExpressLane LUNS for a
port.
To disable a specific ExpressLane LUN:
1.
2.
3.
4.
In the Emulex Device Management tree-view, expand the FC/FCoE adapter port.
Expand the FC/FCoE target.
Right-click the LUN for which you want to disable ExpressLane.
Select Disable ExpressLane LUN from the pull down menu.
To disable all ExpressLane LUNs for a port:
1.
2.
3.
4.
In the Emulex Device Management tree-view, expand the FC/FCoE adapter port.
Expand the FC/FCoE target.
Right-click any LUN with ExpressLane enabled.
Select Disable All ExpressLane LUNs on this target from the pull down menu.
Viewing PCI Registers for an FC Port
The PCI Registers tab shows PCI information, including PCI Express details, about the
selected FC port.
Note: The PCI fields may vary with the type of adapter installed.
To view PCI registers for an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port for which you want
to view PCI information.
3. Select the PCI Registers tab.
Figure 6-13 FC Port PCI Registers Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
69
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Viewing Flash Contents for an FC Port
To view the flash contents for an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port whose Flash
contents you want to view.
3. Select the Flash Contents tab. The Flash Contents information pane appears.
Figure 6-14 FC Port Flash Contents
4. Select the Show Wakeup Images Only checkbox if you want to see only the flash
contents with the wake-up images.
Viewing PCI Registers for an FCoE Port
The PCI Registers tab shows PCI information about the selected FCoE port.
To view PCI registers for an FCoE port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE port for which you
want to view PCI information.
3. Select the PCI Registers tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
70
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Figure 6-15 FCoE Port PCI Registers Tab
Configuring FCoE Initialization Protocol (FIP)
The FIP tab allows you to view configure FIP for an FCoE adapter port.
To configure FIP:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE adapter port whose
FIP properties you want to configure.
3. Select the FIP tab.
4. Set the parameters you want and click Apply Changes.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
71
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Figure 6-16 FCoE Port FIP Tab
FIP Tab Field Descriptions
DCB Settings Area
DCB settings are only applicable when the DCBX Mode in the DCB tab is set to DCB.
Note: In Figure 6-16, the “DCB (FIP) Settings” area has “Active” in its title. This
indicates that DCB (FIP) is the current DCBX mode (DCBX mode is set from the
DCB tab). If CIN (Non-FIP) was the current DCBX mode, “Active” would be in
the “CIN (Non-FIP) Settings” area.




Primary Fabric Name – Indicates the FC fabric's WWN to which to connect. If
the Primary Fabric Name is wild (all 0xFFs), then connection to any fabric name
is allowed.
Primary Switch Name – Indicates the FC switch's WWN to which to connect. If
the Primary Switch Name is wild (all 0xFFs) then connection to any switch
name is allowed.
VLAN ID – Determines the VLAN where the adapter FCoE services are
available. It can have a value from 0 to 4095 and supports wild card values if the
Any VLAN ID is valid checkbox is selected.
Any VLAN ID is valid checkbox – When checked, the VLAN ID field of the
FCoE forwarder can be any valid value.
CIN Settings Area


FC Map – Enter the bit value that completes the fabric-provided MAC address
(FPMA).
VLAN ID – Determines the VLAN where the adapter FCoE services are
available. It can have a value from 0 to 4095.
FIP Tab Buttons

Apply Changes – Click to set new FIP parameters.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
72
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Configuring DCB Parameters for FCoE Adapter Ports
To view the DCB parameters for FCoE adapter ports:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE adapter port whose
FIP properties you want to configure.
3. Select the DCB tab.
Figure 6-17 DCB Tab (FCoE Adapter Port Selected)
DCB Tab Field Definitions



DCBX State – The current DCBX state (enabled or disabled).
LLDP Transmit State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx
must be enabled. If either Rx or Tx is disabled, DCBX is disabled.
LLDP Receive State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx
must be enabled. If either Rx or Tx is disabled, DCBX is disabled.
PFC Properties Area



State – Enabled means that flow control in both directions (Tx and Rx) is
enabled.
Active Priorities – Lists the priorities with PFC set to Enabled.
Sync'd – If yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
73
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs

Error – The error state. This capability indicates whether an error has occurred
during the configuration exchange with the peer. Error is also set to YES when
the Compatible method for the capability fails.
Protocol Properties Area




State – The FCoE state. It can be Enabled or Disabled.
Sync'd – If yes, the FCoE priority has been set by the peer. This parameter
cannot be set.
Error – The FCoE error state. This capability indicates whether an error has
occurred during the configuration exchange with the peer. Error is also set to
YES when the Compatible method for the capability fails.
iSCSI Priority and FCoE Priority – Protocol properties, as applicable.
ETS Priority Group Properties Area
Note: Not shown when UMC is enabled on the adapter.



State – The FCoE or NIC-only state. It can be Enabled or Disabled.
Sync'd – If yes, the Priority Groups have been set by the peer. This parameter
cannot be set.
Error – The error state. This capability indicates whether an error has occurred
during the configuration exchange with the peer. Error is also set to YES when
the Compatible method for the capability fails.
Active Groups



Group ID–The Priority Group number. It can be 0 to 7.
Priority Membership – The priorities that are assigned to each Priority Group. It
is represented in comma separated format.
Bandwidth% – The percentage of available link bandwidth allocated to a
particular Priority Group.
DCB Tab Buttons

Configure DCB – Click to configure DCB parameters. See the instructions that
follow.
Configure DCB Parameters for FCoE Adapter Ports
To configure DCB for FCoE adapter ports:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE adapter port whose
properties you want to configure.
3. Select the DCB tab.
4. Click Configure DCB. The Configure DCB dialog box appears.
5. Configure the settings you want and click OK.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
74
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Figure 6-18 Configure DCB Dialog Box for FCoE Adapter Ports (DCBX Enabled)
Note: An error message is displayed if you try to configure more priority groups
than the adapter supports. The “Max Configurable PGs” field in the ETS
Priority Groups area shows the number of priority groups supported by the
adapter.
Changing WWN Configuration for an FC Port
The Maintenance tab enables you to change the WWPN and the WWNN of a selected
adapter port. For example, you might want to use an installed adapter as a standby if
another installed adapter fails. By changing the standby adapter's WWPN or WWNN,
it can assume the identity and configuration (such as driver parameters and persistent
binding settings) of the failed adapter.
There are three options for referencing WWNs:



Factory default WWN – The WWN as shipped from the factory.
Non-volatile WWN – The values that are saved in the non-volatile adapter’s
flash memory that survive a reboot and/or power outage.
Volatile WWN – A temporary value that is saved in the volatile memory on the
flash. If volatile WWNs are set, they are used instead of the non-volatile WWNs.
Volatile WWN changes require a warm system reboot to take effect. Volatile
WWN changes are lost on systems that power cycle the adapters during the
reboot.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
75
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Caution:
Changing volatile WWNs result in taking the selected adapter
offline. Ensure that this adapter is not controlling a boot device and
all I/O activity on this adapter has stopped before proceeding.
Emulex assumes no responsibility for the consequences of making
volatile WWN changes on a boot adapter.
Considerations When Changing WWN Configuration for an FC Port



To avoid address conflicts, do not assign a WWNN or WWPN with
OneCommand Manager for VMware vCenter if you also use another address
management tool.
The WWPN and WWNN in the Pending Changes list can show “n/a” instead of
“none”. This happens when the remote host is busy processing some critical
task and WWN Management cannot obtain the current state of WWN
management.
In an environment where preboot management exists, a WWPN or WWNN
modified by OneCommand Manager for VMware vCenter can be overridden
by preboot management such as IBM BladeCenter Open Fabric Manager
(BOFM) and industry standard Command Line Protocol (CLP).
For example:
In an environment with CLP/BOFM: OneCommand Manager for VMware
vCenter modifies the WWNN or WWPN. OneCommand Manager for
VMware vCenter requires a reboot to complete the change. After a reboot,
the CLP string is sent during system boot and rewrites the WWNN or
WWPN, or EFIBoot finds the BOFM protocol and uses the default WWNN
or WWPN per BOFM's command.

In environment without CLP/BOFM: OneCommand Manager for VMware
vCenter modifies the WWNN or WWPN. OneCommand Manager for
VMware vCenter requires a reboot to complete the change. The system
comes up and OneCommand Manager for VMware vCenter modified
WWNN or WWPN is used.
On the system where OneCommand Manager for VMware vCenter is installed,
make sure the port numbers configured during the installation are open and
dedicated to the OneCommand Manager for VMware vCenter server only. No
other service should be listening on this port.


To change a port's WWPN or WWNN:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port for which you want
to change the WWN information.
3. Select the Maintenance tab (Figure 6-9).
4. Click Change WWN. The Change WWN Configuration dialog box appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
76
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Figure 6-19 Change WWN Configuration Dialog Box
5. Do one of the following:

Enter a new WWPN or WWNN.

Click Get Factory Default WWNs to load the settings that were assigned when
the adapter was manufactured. These values can then be modified and saved as
volatile or non-volatile WWNs.

Click Get Non-Volatile WWNs to load the current non-volatile WWN. These
values can be modified and saved to volatile or non-volatile memory. You can
edit the data returned from the button.
6. Check Write changes to volatile memory for temporary use to save the New
WWPN and New WWNN settings as volatile WWNs. If cleared, the New WWPN
and New WWNN settings are saved as non-volatile WWNs.
Note: If the adapter or firmware does not support volatile WWNs, the “Write
changes to volatile memory for temporary use” checkbox is disabled. This
type of change is supported locally and via TCP/IP connections. This
checkbox is disabled for remote in-band adapters regardless of adapter
models and firmware version.
7. Click OK. The following warning appears.
Figure 6-20 Warning About Changing WWN
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
77
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
8. Click Yes. The New WWPN and new WWNN values are saved. The new WWPN
and WWNN appear in the Pending Changes list in the WWN Management area of
the Maintenance tab.
9. Reboot the system for the changes to take effect. The new WWPN and WWNN
appear in the Pending Changes list of the Maintenance tab until the system is
rebooted. After rebooting, the changes are applied and appear in the Current
section of the Maintenance tab.
Note: After changing the WWN of an adapter, you must reboot the system before
trying to access the adapter on that system.
Resetting an FC/FCoE Port
Caution:
Do not reset your adapter port while copying or writing files. This could
result in data loss or corruption.
Note: While resetting a port on OneCommand Manager for VMware vCenter, do not
perform any active management operations on the ESXi host.
Note: For FCoE ports, a reset is only necessary to activate changed driver parameters
or FIP settings. It does not actually perform an adapter level reset of the port.
When changing WWN configuration on OneCommand Manager for VMware
vCenter, do not perform any active management operations on the ESXi host.
To reset an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port you want to reset.
3. Select the Maintenance tab (Figure 6-9).
4. Click Reset.
5. The following warning appears:
Figure 6-21 Reset Port Warning
Click Yes. The adapter port resets. The reset can require several seconds to
complete. While the adapter port is resetting, the message “Operation is in
progress” is displayed. When the reset is finished, the message “Reset Port
Completed” is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
78
6. Managing Adapters and Ports
Viewing and Managing FC/FCoE LUNs
Enabling and Disabling FC Ports
Using the Port Information tab you can enable or disable FC ports. When you disable
an FC port, you disable all functions for the port. Disabled ports appear in the
discovery-tree as a black port icon.
Note: Ensure there is no I/O traffic on the port before disabling it and never disable a
boot port.
To enable or disable an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port for which you want
to view information.
3. Select the Port Details tab.
4. Click Enable Port or Disable Port.
Setting Driver Parameters for an FC/FCoE Port
To change the driver parameters for a port using the Value field:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the port for which you want to
change the driver parameters.
3. Select the Driver Parameters tab.
4. In the driver parameter table, click the Value field of a parameter that you want to
change. The range for the value is displayed. Enter a value in decimal or
hexadecimal format, depending on how the current value is presented. If the value
is in hexadecimal format, it is prefaced by “0x” (for example -”0x2d”). You can enter
a hexadecimal value without the “0x”. For example, if you enter ff10, this value is
interpreted and displayed as “0xff10”.
5. If you want the change to be temporary (causing the parameter to revert to its last
permanent setting when the system is rebooted), check the Temporary box. This
option is available only for dynamic parameters.
6. If you are making changes to multiple parameters, and you want all the changes to
be temporary, check the Make all changes temporary box. This setting overrides
the setting of the Make change temporary box. Only dynamic parameters can be
made temporary.
7. Click Apply.
Saving Driver Parameters of an FC/FCoE Port to a File
To change the driver parameters for a port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
79
6. Managing Adapters and Ports
iSCSI Port
2. In the Emulex Device Management tree-view, select the FC port for which you want
to change the driver parameters.
3. Select the Driver Parameters tab.
4. Click Export to create and save a desired port parameter configuration. Each
definition is saved in a comma-delimited file with the following format:
<parameter-name>=<parameter-value>
5.
Click Apply to apply your configuration changes.
Enabling/Disabling PFC Throttle on an FCoE Port
To enable or disable PFC throttle:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE port whose PFC
throttle status you want to change.
3. Select the Port Details tab (Figure 6-2 on page 55).
4. In the PFC Throttle area, select Enable or Disable. PFC throttle is immediately
enabled or disabled, depending upon your selection.
Note: The Enable/Disable button is disabled for OCe11100–series adapters and the
LPe16202 CFA.
Configuring FIP Parameters for an FCoE Adapter
The FIP tab enables you to configure FIP for FCoE adapters.
To configure FIP parameters for an FCoE port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE port for which you
want to configure FIP information.
3. Select the FIP tab (Figure 6-16 on page 72).
4. Set the parameters you want and click Apply Changes.
iSCSI Port
Viewing iSCSI Port Information
When you select an iSCSI port from the Emulex Device Management tree-view, the
iSCSI Port Information tab shows general attributes associated with the selected iSCSI
port.
To view general iSCSI port information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
80
6. Managing Adapters and Ports
iSCSI Port
2. In the Emulex Device Management tree-view, select the iSCSI port for which you
want to view information.
3. Select the Port Information tab.
Figure 6-22 iSCSI Port Info Tab
iSCSI Port Info Tab Field Definitions













Driver Name – The iSCSI driver file name.
Driver Version – The iSCSI driver version.
MAC Address – The iSCSI MAC address currently assigned to the port.
Perm MAC Address – The original factory assigned iSCSI MAC address.
Device ID – The PCI device ID assigned to the iSCSI function.
Vendor ID – The PCI vendor ID assigned to the iSCSI function.
PCI Function – The PCI function number assigned to the iSCSI function.
LDTO – (Link Down Time Out) The amount of time in seconds that the iSCSI
driver delays reporting a link down error to the operating system.
Max MTU – The maximum transmission unit for Ethernet traffic.
Default ETO – The default extended timeout.
Max CDB Length – The maximum SCSI command descriptor block size.
Subsystem Device ID – The PCI subsystem ID assigned to the iSCSI function.
Subsys Vendor ID – The PCI subsystem vendor ID assigned to the iSCSI
function.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
81
6. Managing Adapters and Ports
iSCSI Port

PCI Bus Number – The PCI bus number to which the port is mapped.
TCP/IP Info Area







DHCP Enabled – The DHCP authentication status of the selected port.
IP Address – The IP address for the NIC port.
Subnet Mask – The subnet mask for the NIC port.
Gateway Address – The gateway address for the NIC port.
VLAN Enabled – The VLAN enabled state for the iSCSI interface.
VLAN ID – The VLAN identifier to use, from 0 to 4094 (only valid when VLAN
is enabled). A value of 0 indicates the VLAN is disabled.
VLAN Priority – The VLAN priority for the iSCSI interface.
Network Info Area





Link Status – The status of the link on the selected port.
LinkDown Reason - The reason for the status of LinkDown on the selected port.
Port Speed – The current port speed of the iSCSI port.
Min Bandwidth – The minimum SoftCap bandwidth assigned.
Max Bandwidth – The maximum SoftCap bandwidth assigned.
Enabling iSCSI Boot
To enable iSCSI boot:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI port for which you
want to view information.
3. To enable iSCSI boot, check Enable iSCSI Boot. To disable iSCSI boot, clear Enable
iSCSI Boot.
Viewing PCI Registers for an iSCSI Port
The PCI Registers tab contains PCI information about the selected iSCSI port.
To view PCI registers for an iSCSI port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI port for which you
want to view PCI information.
3. Select the PCI Registers tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
82
6. Managing Adapters and Ports
iSCSI Port
Figure 6-23 iSCSI Port, PCI Registers Tab
Viewing iSCSI iSNS Server Information
If the server has been set up as an Internet Storage Name Server (iSNS), the iSNS tab
shows the IP address and TCP Port for the selected iSCSI port.
To view iSNS server information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI port for which you
want to view iSNS information.
3. Select the iSNS tab.
Figure 6-24 iSCSI Port, iSNS Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
83
6. Managing Adapters and Ports
iSCSI Port
iSNS Tab Field Definitions
iSNS Server


IP Address - The IP address of the iSNS server.
TCP Port - The TCP port number for the connection to the iSNS server.
Disabling the iSNS Server
To disable the iSNS server, click Clear iSNS on the iSNS tab.
Changing the iSNS Server
To change the iSNS server:
1. On the iSNS tab, click Add/Update iSNS. The Update iSNS Server dialog box is
displayed.
Figure 6-25 iSCSI Port, Update iSNS Server Dialog Box
2. Enter the new server address and Port ID.
3. Click OK to commit the new iSNS server. The new iSNS information is displayed
on the iSNS tab. The new or updated iSNS server is also queried for iSCSI targets.
Any discovered targets are added to the iSCSI Target Discovery tab.
Viewing iSCSI Initiator Statistics
The iSCSI Statistics tab shows information for the selected iSCSI port.
To view iSCSI initiator statistics:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI initiator for which
you want to view Statistic information.
3. Click the iSCSI Statistics tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
84
6. Managing Adapters and Ports
iSCSI Port
Figure 6-26 iSCSI Initiator, iSCSI Statistics Tab
iSCSI Statistics Tab Field Definitions












Node Roles – The node role for this iSCSI initiator.
Portal Count – The number of rows in the iscsiPortaltypeTable that are
currently associated with this iSCSI instance.
Node Count – The number of rows in the iscsiNodetypeTable that are currently
associated with this iSCSI instance.
Session Count – The number of rows in the iscsiSessiontypeTable that are
currently associated with this iSCSI instance.
Session Failure Count – The number of times a session belonging to this port
has failed.
Last Session Failure Type – The type of failure encountered in the last session
failure.
Last Session Remote Node – The iSCSI name of the remote node from the failed
session.
Session Digest Errors – The count of PDUs that were received on the session and
contained header or data digest errors.
Session Connection Timeout – The count of connections within this session that
have been terminated due to a timeout.
Session Format Errors – The count of sessions that failed due to receipt of an
iSCSI protocol data unit (PDU) that contained a format error.
Login Failures – The number of times a login from this initiator failed.
Last Failure Time – The timestamp of the most recent failure of a login attempt
from this initiator. A value of 0 indicates that no failures have occurred.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
85
6. Managing Adapters and Ports
iSCSI Port













Last Failure Type – A description of the last failure.
Last Target Failure Name – The UTF-8 string name of the target that most
recently failed a login request from this initiator.
Last Target Failure Address – The Internet Network Address of the target that
most recently failed.
Login Accept Responses – The count of Login Response PDUs received by this
initiator that were accepted.
Login Other Fail Responses – The count of Login Response PDUs received by
this initiator with any status code not counted by the other objects.
Login Redirect Responses – The count of Login Response PDUs received by the
initiator with status class of Redirection.
Login Authentication Fail Responses – The count of Login Response PDUs with
status class 0x201 Authentication Failed received by this initiator.
Login Authentication Failures – The number of times the initiator has aborted a
login because the target could not be authenticated.
Login Negotiation Failures – The number of times the initiator has aborted a
login because parameter negotiation with the target failed.
Logout Normals – The count of Logout Command PDUs generated by this
initiator with a normal reason code.
Logout Others – The count of Logout Command PDUs generated by this
initiator with any status code other than normal.
Port Row Status – This field allows entries to be dynamically added and
removed from this table via Simple Network Management Protocol (SNMP).
Portal Role – The role of a portal. A portal can operate as a target portal and/or
an initiator portal.
Viewing iSCSI Initiator Login Options
The iSCSI Initiator Login Options tab shows the set of login options used by the
initiator when logging into a target.
To view iSCSI initiator login information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI initiator for which
you want to view initiator login information.
3. Click the iSCSI Initiator Login Options tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
86
6. Managing Adapters and Ports
iSCSI Port
Figure 6-27 iSCSI Initiator Logon Options Tab
To view iSCSI initiator default login options:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI initiator for which
you want to view Initiator Login information.
3. Click the iSCSI Initiator LoginOptions tab.
4. Click View Default Login. The Initiator Default Login Options window appears.
Figure 6-28 iSCSI Initiator Default Login Options Window
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
87
6. Managing Adapters and Ports
iSCSI Port
iSCSI Initiator Login Options Tab Field Definitions
iSCSI Names Area


Initiator iSCSI Name – The iSCSI qualifier name of the initiator.
Initiator Alias – An optional non-unique string used to identify the initiator.
Initiator Login Options Area



Immediate Data – If set to Yes, the initiator can append unsolicited data to an
iSCSI command.
Header Digest – If set to CRC32C, the integrity of an iSCSI PDU's header
segments are protected by a CRC32C checksum. If set to None, the PDU’s
header segments are not protected.
Data Digest – If set to CRC32C, the integrity of an iSCSI PDU's data segment is
protected by a CRC32C checksum. If set to None, the PDU’s data segments are
not protected.
Authentication Area





Authentication Method

One-Way CHAP requires only that the authenticator (iSCSI target)
authenticate the iSCSI initiator.

Mutual CHAP requires that both the iSCSI target and iSCSI initiator
authenticate each other.

None indicates that no authentication is performed.
Target CHAP Name – The iSCSI login name sent by the initiator to the target for
authentication. This name is required for both One-Way CHAP and Mutual
CHAP authentication. The target CHAP name is also known as the username.
Target Secret – The iSCSI login secret sent by the initiator to the target for
authentication. A target secret is required for both One-Way CHAP and Mutual
CHAP authentication.
Initiator CHAP Name – The iSCSI login name sent by the target to the initiator
for authentication. The initiator CHAP name is only required for Mutual CHAP
authentication. The initiator CHAP name is also known as the username.
Initiator Secret – The iSCSI login secret sent by the target to the initiator for
authentication. The initiator secret is only required for Mutual CHAP
authentication.
iSCSI Initiator Login Options Tab Buttons

View Default Login Options – Click to show the Initiator Default Login Options
window.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
88
6. Managing Adapters and Ports
iSCSI Port
Initiator Default Login Options Window Field Definitions














InitialR2T – The initial request to transmit. When set to Yes, the initiator has to
wait for the target to solicit SCSI data before sending it. When set to No, it
allows the initiator to send a burst of unsolicited FirstBurstLength bytes.
ImmediateData – If set to Yes, allows the initiator to append unsolicited data to
a command.
MaxOutstandingR2T – The maximum number of outstanding request to
transmit's (R2T's) per task within a session, each up to MaxBurstLength bytes.
FirstBurstLength – The maximum amount of unsolicited data (in bytes) the
initiator can send to the target during the execution of a single iSCSI command.
MaxBurstLength – The maximum amount of either unsolicited or solicited data
the initiator may send in a single burst. Any amount of data exceeding this
value must be explicitly solicited by the target.
DefaultTimeToWait – The minimum time to wait, in seconds, before the
initiator attempts to reconnect or reassign a connection (or task) that has been
dropped after an unexpected connection termination or reset. The initiator and
target negotiate to determine this value.
DefaultTimeTo Retain – The maximum time, in seconds, to reassign a
connection after the initial wait that is indicated in DefaultTime2Wait has
elapsed. The initiator and target negotiate to determine this value.
HeaderDigest – The valid values for this property are CRC32C or None. If set to
CRC32C and the initiator is configured accordingly, the integrity of an iSCSI
PDU's header segments is protected by a CRC32C checksum.
DataDigest – The valid values for this property are CRC32C or None. If set to
CRC32C and the initiator is configured accordingly, the integrity of an iSCSI
PDU's data segment is protected by a CRC32C checksum.
MaxConnections – The maximum number of connections to targets that are
allowed within a single session.
DataPPDUInOrder – The order of data PDUs within a sequence.
DataSequenceInOrder – The order between sequences.
MaxRecDataSegmentLength – The maximum data segment length in bytes an
initiator or target can receive in an iSCSI PDU.
ErrorRecoveryLevel – The operational ErrorRecoveryLevel for the session. 0
indicates recovery only by session restart. 1 indicates recovery by reissuing
commands, data, or status. 2 indicates connection failure recovery.
Initiator Default Login Options Window Buttons

Close – Click to close the window.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
89
6. Managing Adapters and Ports
iSCSI Port
Viewing iSCSI Target Discovery Information
The iSCSI Target Discovery tab shows all currently discovered targets. Targets on this
tab come from one of three sources:



The target was added manually.
The target was discovered via a target portal.
The target was found through an iSNS server query.
To view iSCSI target discovery information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI initiator for which
you want to view target discovery information.
3. Click the iSCSI Target Discovery tab.
Figure 6-29 iSCSI Target Discovery Tab
iSCSI Target Discovery Tab Field Definitions



iSCSI Name – The iSCSI name assigned to the target.
Alias – The iSCSI alias assigned to the target. This is assigned at the target
portal, not by OneCommand Manager for VMware vCenter.
Status – The status field indicates if the target is connected or disconnected.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
90
6. Managing Adapters and Ports
iSCSI Port
Viewing iSCSI Target Information
The iSCSI Target Information tab shows information about the target. You can also
view information about a target session.
To view iSCSI target discovery information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI target for which you
want to view target discovery information.
The iSCSI Target Information tab is displayed.
Figure 6-30 iSCSI Target Information Tab
iSCSI Target Information Tab Field Definitions



Target iSCSI Name – The iSCSI name assigned to the target.
Target Alias – The iSCSI alias assigned to the target. This is assigned at the
target portal, not by OneCommand Manager for VMware vCenter.
ETO – The ETO for the target. The driver ensures that I/Os are not “timed out”
until this time has expired (from the time the target stopped responding).
iSCSI Target Information Tab Buttons
The Sessions button opens the Target Sessions window.
Viewing Target Session Information
There may be multiple active sessions for a connected target.
To view iSCSI target session information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI target for which you
want to view target discovery information. The iSCSI Target Information tab is
displayed.
3. Click Sessions. You can toggle between sessions by using the drop-down list in the
upper left corner of the window.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
91
6. Managing Adapters and Ports
iSCSI Port
Figure 6-31 iSCSI Target Sessions Window
Target Sessions Window Field Definitions






Initiator Name – The initiator named used to log into the session.
ISID – The initiator session identifier (unique for each session).
iSCSI Boot – “Yes” indicates a boot session. Logout is not possible from a boot
session.
Status – The session status (logged in, login in progress, login failed, recovery,
unknown).
ISID Qualifier – The first two bytes of the ISID (unique for each session).
TSIH – The target session identifier handle. A tag generated by an iSCSI target
to identify an iSCSI session with a specific iSCSI initiator.
Session Negotiated Login Options Area


InitialR2T – The initial request to transmit. When set to Yes, the initiator has to
wait for the target to solicit SCSI data before sending it. When set to No, it
allows the initiator to send a burst of unsolicited FirstBurstLength bytes.
Immediate Data – When set to Yes, it allows the initiator to append unsolicited
data to a command.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
92
6. Managing Adapters and Ports
iSCSI Port









MaxConnections – The maximum number of connections to targets that are
allowed within a single session.
MaxOutstandingR2T – The maximum number of outstanding request to
transmits (R2Ts) per task within a session, each up to MaxBurstLength bytes.
FirstBurstLength – The maximum amount of unsolicited data (in bytes) the
initiator can send to the target during the execution of a single iSCSI command.
MaxBurstLength – The maximum amount of either unsolicited or solicited data
the initiator may send in a single burst. Any amount of data exceeding this
value must be explicitly solicited by the target.
DefaultTimeToWait – The minimum time to wait, in seconds, before the
initiator attempts to reconnect or reassign a connection (or task) that has been
dropped after an unexpected connection termination or reset. The initiator and
target negotiate to determine this value.
DefaultTimeToRetain – The maximum time, in seconds, to reassign a
connection after the initial wait that is indicated in DefaultTimeToWait has
elapsed. The initiator and target negotiate to determine this value.
ErrorRecoveryLevel – The operational ErrorRecoveryLevel for the session. 0
indicates recovery only by session restart. 1 indicates recovery by reissuing
commands, data, or status. 2 indicates connection failure recovery.
DataPDUInOrder – The order of PDUs within a sequence.
DataSequenceInOrder – The order between sequences.
Session Statistics Area








Session Direction – The direction of iSCSI session. Valid values are
InboundSession and OutboundSession.
Cmd PDUs – The count of Command PDUs transferred on this session.
Response PDUs – The count of Response PDUs transferred on this session.
Xmt Data Octets – The count of data octets that were transmitted by the local
iSCSI node on this session.
Recv Data Octets – The count of data octets that were received by the local iSCSI
node on this session.
Digest Errors – The count of PDUs which were received on the session and
contained header or data digest errors.
Connection Timeouts – The count of connections within this session which have
been terminated due to a timeout.
Session Target Alias – The target alias for the session.
Connection Information Area





iSCSI Connection ID – The iSCSI Connection ID assigned to the connection.
Status – The status of the connection. Valid values are connected and unknown.
Source IP Address – The source IP address for the connection.
Source Port – The source TCP port number for the connection.
Destination IP Address – The destination IP address for the connection.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
93
6. Managing Adapters and Ports
iSCSI Port



Destination Port – The destination TCP port number for the connection.
Redirected Destination – The redirected IP address for the target.
Redirected Destination Port – The redirected port number for the target.
Connection Negotiated Login Properties Area





Authentication Method – The authentication method used for connection. Valid
values are None, Mutual CHAP and One-Way CHAP.
MaxRecdDataSegmentLength – The maximum data segment length in bytes an
initiator or target can receive in an iSCSI PDU.
Header Digest – When set to CRC32C, the integrity of an iSCSI PDU's header
segments is protected by a CRC32C checksum.
Data Digest – When set to CRC32C, the integrity of an iSCSI PDU's data
segments is protected by a CRC32C checksum.
TCPMSS – The maximum segment size for this connection. The driver uses this
to determine the size of the data PDU whenever it is required to transmit the
entire PDU with a single iSCSI header.
Configuring iSNS for iSCSI Target Discovery
An Internet Storage Name Server (iSNS) maintains a database of storage network
elements that can be queried by other hosts within the SAN. iSCSI storage devices in
particular can register targets with the iSNS for efficient discovery by iSCSI clients. Use
the iSCSI SNS tab to configure the iSNS server or to discover the server. For more
information about the iSCSI SNS tab, refer to “Viewing iSCSI iSNS Server Information”
on page 83.
Viewing iSCSI LUN Information
The iSCSI LUN Info tab shows basic vendor, product and LUN masking information.
To view iSCSI LUN information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the LUN for which you want to
view information. The LUN Info tab is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
94
6. Managing Adapters and Ports
iSCSI Port
Figure 6-32 iSCSI LUN Info Tab
iSCSI LUN Info Tab Field Definitions
Vendor/Product Information Area




Vendor Name – The name of the vendor of the LUN.
Model Number – The vendor’s model number for the LUN.
LUN Name – The name of the LUN.
Serial Number – The vendor’s serial number for the LUN.
LUN Capacity Area


Capacity – The capacity of the LUN, in megabytes.
Block Size – The length of a logical unit block in bytes.
LUN Masking Information Area
The Current Mask Status field indicates possible LUN mask states as masked or
unmasked.
Viewing iSCSI Port Vital Product Data (VPD)
The VPD tab shows vital product data (if available) for the selected iSCSI port such as
the product name, part number, serial number and so on.
To view VPD information of an iSCSI port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI port for which you
want to view VPD information.
3. Select the VPD tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
95
6. Managing Adapters and Ports
iSCSI Port
Figure 6-33 iSCSI Port VPD Tab
VPD Table Definitions




Product Name – The product information about a selected adapter port.
Part Number – The adapter's part number.
Serial Number – The adapter's serial number.
VO – Vendor unique data. “V” indicates a vendor-specific field. An adapter
may have none, one or more of these fields defined. Valid values for this field
are “VO” (the letter “O”, not the number zero) and “Vx” (where “x” is a
number).
Note: Some adapters may show additional VPD information such as engineering
change (EC) level and MN (manufacturer ID).
Configuring DCB Parameters for iSCSI Adapter Ports
The DCB tab displays parameters for iSCSI adapter ports.
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the iSCSI adapter port whose
FIP properties you want to configure.
3. Select the DCB tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
96
6. Managing Adapters and Ports
iSCSI Port
Figure 6-34 DCB Tab (iSCSI Adapter Port Selected)
DCB Tab Field Definitions



DCBX State – The current DCBX state (enabled or disabled).
LLDP Transmit State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx
must be enabled. If either Rx or Tx is disabled, DCBX is disabled.
LLDP Receive State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx
must be enabled. If either Rx or Tx is disabled, DCBX is disabled.
PFC Properties Area
Note: PFC is not supported on all the iSCSI adapter ports.




State – Enabled means that flow control in both directions (Tx and Rx) is
enabled.
Active Priorities – Lists the priorities with PFC set to Enabled.
Sync'd – If yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
Error – The error state. This capability indicates whether an error has occurred
during the configuration exchange with the peer. Error is also set to YES when
the Compatible method for the capability fails.
iSCSI Properties Area


State – The iSCSI state. It can be Enabled or Disabled.
Active Priority – The current active priority assigned for FCoE.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
97
6. Managing Adapters and Ports
iSCSI Port


Sync'd – If yes, the FCoE priority has been set by the peer. This parameter
cannot be set.
Error – The iSCSI error state. This capability indicates whether an error has
occurred during the configuration exchange with the peer.
ETS Priority Group Properties Area
Note: Not shown when UMC is enabled on the adapter.



State – The current Priority Group state. It can be Enabled or Disabled.
Sync'd – If yes, the Priority Groups have been set by the peer. This parameter
cannot be set.
Error – The error state. This capability indicates whether an error has occurred
during the configuration exchange with the peer.
Active Groups



PG –The Priority Group number. It can be 0 to 7.
Priorities – The priorities that are assigned to each Priority Group. It is
represented in comma separated format.
Bandwidth % – The percentage of available link bandwidth allocated to a
particular Priority Group.
DCB Tab Buttons

Configure DCB –Click to configure DCB parameters. See the instructions that
follow.
To configure DCB for iSCSI adapter ports:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FCoE adapter port whose
FIP properties you want to configure.
3. Select the DCB tab.
4. Click Configure DCB. The Configure DCB dialog box appears.
5. Configure the settings you want and click OK.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
98
6. Managing Adapters and Ports
iSCSI Port
Figure 6-35 Configure DCB Dialog Box for iSCSI Adapter Ports (DCBX Enabled)
Note: An error message is displayed if you try to configure more priority groups
than the adapter supports. The “Max Configurable PGs” field shows the
number of priority groups supported by the adapter.
Configure DCB Dialog Box Field Definitions
DCBX Settings Area



Enabled – DCBX can be enabled or disabled. With DCBX enabled, the
configured values are used only if the switch does not provide them. With
DCBX disabled, the configured values are used.
Operating Version – The operating version of the DCBX protocol. The system
adjusts as needed to operate at the highest version supported by both link
partners. This setting cannot be changed.
Maximum Version – The highest DCBX protocol version supported by the
system. Version numbers start at zero. The DCBX protocol must be backward
compatible with all previous versions. This setting cannot be changed.
LLDP Settings Area

Transmit Enabled – LLDP Transmit can be enabled or disabled.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
99
6. Managing Adapters and Ports
iSCSI Port





Transmit Port Description Enabled – Provides a description of the port in an
alpha-numeric format. The value equals the ifDescr object, if the LAN device
supports RFC 2863.
Transmit System Name Enabled – Provides the system's assigned name in an
alpha-numeric format. The value equals the sysName object, if the LAN device
supports RFC 3418.
Receive Enabled – LLDP Receive can be enabled or disabled.
Transmit System Description Enabled – Provides a description of the network
entity in an alpha-numeric format. This includes system's name and versions of
hardware, operating system and networking software supported by the device.
The value equals the sysDescr object, if the LAN device supports RFC 3418.
Transmit System Capabilities Enabled – Indicates the primary function(s) of the
device and whether these functions are enabled on the device. The capabilities
are indicated by two octets. Bits 0 through 7 indicate Other, Repeater, Bridge,
WLAN AP, Router, Telephone, DOCSIS cable device and Station respectively.
Bits 8 through 15 are reserved.
PFC Priorities Area
Note: There is no PFC support for an OCe10100–series adapter’s NIC or iSCSI port.



Active Priorities – The priorities that are marked active for PFC.
Enable – When checked, PFC is enabled.
Configured Priorities –The priorities that are configured, but might not yet be
active. A maximum of two PFC priority checkboxes can be selected, out of
which one of these selections must match the iSCSI priority. The additional PFC
priority is for Ethernet traffic. The PFC priority for Ethernet traffic must be
assigned to a Priority Group which has no other priorities.
iSCSI Priority Area


Active Priority – The active iSCSI priority.
Configured Priority – The configured iSCSI priority.
ETS Priority Groups Area
Note: Not available when UMC is enabled on the adapter.


Active Groups

Group ID – The Priority Group ID.

Priority Membership – The different priorities assigned to the various
Priority Groups. This is the current active configuration.

Bandwidth – The bandwidths that are assigned to different Priority Groups.
This is the current active configuration.
Configured Groups

Group ID – The Priority Group ID.

Priority Membership – The configured priority membership grouping.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
100
6. Managing Adapters and Ports
iSCSI Port

Bandwidth% – The configured bandwidth value for the different Priority
Groups.
Configure DCB Dialog Box Buttons



Defaults – Click to return parameters to default DCB settings.
Configuration Rules – Click to view a window that lists the rules for configuring
priorities. You must observe these rules when configuring Priority Groups for
adapter ports.
Configuration Rules – Click to display the iSCSI Priority window that lists the
rules for configuring iSCSI priorities.
You must observe the following rules when configuring priority groups for
iSCSI adapter ports:
1. Only one priority can be configured as the iSCSI priority.
2. A maximum of two PFC priorities can be selected and one of them must
match the iSCSI priority.
Note: Not all adapters support two PFC priorities. Adapters that do not
support two PFC priorities display an error message if you try to
configure more than one PFC priority.


3. The priority group to which the iSCSI priority is assigned must contain no
other priorities.
4. The additional PFC priority must be assigned to a priority group which has
no other priorities.
5. Bandwidths of all the priority groups must add up to 100%.
OK – Click to apply and save your changes.
Cancel – Click to discard any changes you made.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
101
6. Managing Adapters and Ports
NIC Port
NIC Port
Viewing NIC Port Information
When you select a NIC port from the Emulex Device Management tree-view, the NIC
Port Information tab shows general attributes associated with the selected NIC port. If
the adapter supports vNIC, vNIC data is also displayed.
Notes:


NIC ports not only exist on NIC-only adapters, but also exist on FCoE and
iSCSI adapters.
vNIC is supported only on IBM virtual fabric adapters. For specific
information as to whether it is supported on a specific adapter, refer to the
release notes that are available on the IBM adapter pages on the Emulex
website.
To view general NIC port information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the NIC port for which you
want to view information.
Note: In Virtual Ports view, NIC ports appear only on FCoE adapters. They do not
appear on NIC-only adapters.
3. Select the Port Information tab.
Figure 6-36 NIC Port Information Tab
NIC Port Information Tab Field Definitions

Driver Name – The NIC driver file name.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
102
6. Managing Adapters and Ports
NIC Port






















Driver Version – The NIC driver version.
MAC Address – The NIC MAC address currently assigned to the port.
Perm MAC Address – The original factory assigned NIC MAC address.
IP Address – The IP address for the NIC port.
Subnet Mask – The subnet mask for the NIC port.
Gateway Address – The gateway address for the NIC port.
IP Address Origin – The origin of the IP address (DHCP or static).
Link Status – The link status is always displayed as “n/a” (not available).
LinkDown Reason – The reason for the status of LinkDown on the selected port.
Interface Name – The interface assigned to this port by the host operating
system.
Port Speed – The current port speed of the NIC port.
Device ID – The PCI device ID assigned to the NIC function.
Subsys Device ID – The PCI subsystem ID assigned to the NIC function.
Vendor ID – The PCI vendor ID assigned to the NIC function.
Subsys Vendor ID – The PCI subsystem vendor ID assigned to the NIC function.
IPv6 Address – The Internet Protocol Version 6 address, if applicable.
PCI Function – The PCI function number assigned to the NIC function.
PCI Bus Number – The PCI bus number to which the port is mapped.
Current MTU – The current transmission unit for Ethernet traffic.
Max MTU – The maximum transmission unit for Ethernet traffic.
Min Bandwidth – The minimum SoftCap bandwidth assigned.
Max Bandwidth – The maximum SoftCap bandwidth assigned.
Network Boot
To boot from the iSCSI SAN, the host must have an iSCSI boot capable network adapter
that supports the iSCSI Boot Firmware Table (iBFT) format. The iBFT is a method of
communicating parameters about the iSCSI boot device to an operating system. To boot
the host from the Network interface, use preboot execution environment (PXE).
NIC functions include iBFT boot configuration and PXE boot configuration which are
displayed under the Network Boot section of the NIC Port Information tab. If the
currently selected NIC port does not support network boot, the Network Boot section is
not displayed.
Notes



The iBFT boot option is only available for the UCNA 16 Gb family of adapters
that support the NIC or iSCSI protocol. PXE boot is supported on LPe16202,
OCe10000, and OCe11000–series adapters.
Network boot options are only available on ports with a PCI function of 0 or 1.
Network boot is supported by CIM Provider 3.6.12 and above.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
103
6. Managing Adapters and Ports
NIC Port
To select a network boot configuration on the selected port, click the desired option
from the Network Boot section:



iBFT – to boot from an iSCSI SAN using the iSCSI Boot Firmware Table (iBFT)
format.
PXE – to boot from a network interface using a preboot execution environment
(PXE).
None – to disable the network boot functions.
Enabling SR-IOV
To enable SR-IOV, check Enable SR–IOV. To disable SR-IOV, clear the Enable SR-OV
checkbox.
If the Enable SR-IOV checkbox is disabled, the operating system or port does not
support SR–IOV.
Notes



A system reboot is required to change the SR-IOV state.
SR-IOV must be enabled at the system BIOS level.
SR-IOV is not supported with UMC channel management. If you are using
SR-IOV, then you must disable channel management. See “Managing Port
Channels Using Channel Management” on page 114 for more information.
Enabling and Disabling VEPA
VEPA allows the network traffic at the VFs to bypass the hypervisor's virtual switch,
and allow the PFs to transmit the traffic to the external switch. This relieves the CPU of
the switching burden, and puts the traffic on the physical network, where you can
monitor it using familiar techniques.
To enable VEPA, check Enable VEPA. To disable VEPA, clear the Enable VEPA
checkbox.
Notes


SR-IOV must be enabled to enable VEPA.
VEPA is only available on the OCe14100–series adapters.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
104
6. Managing Adapters and Ports
NIC Port

VEPA is only available for NIC ports.
Figure 6-37 NIC Port Information Tab, VEPA Enabled
Viewing PCI Registers for a NIC Port
The PCI Registers tab contains PCI information about the selected NIC function.
To view a NIC port’s PCI registers:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the NIC port for which you
want to view PCI information.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
105
6. Managing Adapters and Ports
NIC Port
3. Select the PCI Registers tab.
Figure 6-38 NIC Port PCI Registers Tab
Viewing NIC Port Vital Product Data (VPD)
The VPD tab shows vital product data (if available) for the selected NIC port such as
the product name, part number, and serial number for example.
To view VPD information of an NIC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the NIC port for which you
want to view VPD information.
3. Select the VPD tab.
Figure 6-39 NIC Port VPD Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
106
6. Managing Adapters and Ports
NIC Port
VPD Table Definitions




Product Name – The product information about a selected adapter port.
Part Number – The adapter's part number.
Serial Number – The adapter's serial number.
VO – Vendor unique data. “V” indicates a vendor-specific field. An adapter
may have none, one or more of these fields defined. Valid values for this field
are “VO” (the letter “O”, not the number zero) and “Vx” (where “x” is a
number).
Note: Some adapters may show additional VPD information such as engineering
change (EC) level and MN (manufacturer ID).
Using SR-IOV on NIC Ports
When SR-IOV is available, the NIC Port Information tab (Figure 6-36) allows you to
enable SR-IOV on NIC adapter ports. When SR–IOV is enabled, multiple VFs can be
created on a NIC PF for an adapter port. These VF's are assigned by the ESXi host to the
VMs. Each VM can be assigned one or more VFs by the guest operating system running
on the VM. To the guest operating system, the VF is an independent NIC function with
its own MAC address and is available for network I/O.
The discovery-tree displays the VFs running on the discovered PFs. It also shows the
selected VFs MAC Address, VLAN ID, Link Status, and Transmit Rate.
Enabling or Disabling SR-IOV
To enable or disable SR-IOV:
1.
2.
3.
4.
Select Host view.
Select a NIC port function on an adapter in the discovery-tree.
Select the Port Information tab.
Click Enable SR-IOV or clear the Enable SR-IOV checkbox. See Figure 6-36 on
page 102.
Notes:




SR-IOV is not supported with UMC channel management; they are mutually
exclusive. If you set channel management, then you must disable SR-IOV. If you
set SR-IOV, then you must disable channel management.
To use SR-IOV, you must enable SR-IOV in OneCommand Manager for
VMware vCenter and the system BIOS. See the Emulex Drivers for VMware ESXi
User Manual for information on enabling SR-IOV in the system BIOS.
If you disable SR-IOV from the Port Information tab by clearing the Enable
SR-IOV checkbox, the operating system or port stops supporting SR-IOV after
reboot.
A system reboot is required to change the SR-IOV state.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
107
6. Managing Adapters and Ports
NIC Port
Displaying Virtual Functions on a Host Operating System
OneCommand Manager for VMware vCenter can discover the VFs running on the
discovered physical functions and display them in the discovery-tree as shown in
Figure 7-41.
Figure 6-40 Virtual Functions Discovered on the Physical Function on the Host Operating System
Select the VF under the host operating system in the discovery-tree to display the Port
Information tab.
Figure 6-41 Port Information tab for NIC Virtual Function
Port Information Field Definitions for the Virtual Function




MAC Address – The NIC MAC address currently assigned to the port.
VLAN-ID – The VLAN identifier used by the NIC port.
Link Status – The status of the link on the selected port.
Transmit Rate – The rate at which data is transmitted over the port in Mbs.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
108
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
OCe10100–Series and OCe11100–Series Adapters
Viewing OCe10100–Series and OCe11100–Series Adapter
Information
The Adapter Information tab contains general attributes associated for the selected
UCNA. You can also use this tab to view and enable licenses. See “Viewing FC Port
Details and Changing Link State” on page 55 for more information.
To view information for a UCNA:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select a UCNA. The Adapter
Information tab is displayed.
Figure 6-42 OneConnect Adapter Information Tab
Adapter Information Tab Field Definitions




Model – The model of the selected adapter.
Manufacturer – The manufacturer of the adapter.
Serial Number – The serial number of the selected adapter.
Active Firmware Version – The firmware version running on the selected
adapter.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
109
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters









Firmware State – The condition of the firmware.
BIOS Version – The version of the BIOS in use.
Boot Code Version – The version of the boot code in use.
HW Version – The hardware version of the selected adapter.
NCSI Version – The NCSI version.
IPL File Name – The name of the IPL file currently loaded.
PCI Express Link Speed – The speed of the PCI bus in which the adapter
running.
PCI Express Bus Width – The number of lanes for the slot in which the adapter
is running.
Adapter Temperature – If the adapter's temperature is not available, “Not
Supported” is displayed. If supported by the adapter, this field displays the
adapter's temperature and one of the following temperature-related status
messages:

Normal: The adapter’s temperature is within normal operational range.

Warning: The adapter’s temperature is beyond normal operational range. If
the temperature continues to increase, the adapter shuts down. You must
determine the cause of the temperature problem and fix it immediately.
Check for system cooling issues. Common causes of system cooling issues
include clogged air filters, inoperable fans and air conditioning problems
that cause high ambient air temperatures.

Exceeds operational range – Adapter stopped: The temperature has reached
critical limit, forcing the adapter to shut down. You must determine the
cause of the temperature problem and fix it before resuming operation.
Check for system cooling issues. Common causes of system cooling issues
include clogged air filters, inoperable fans and air conditioning problems
that cause high ambient air temperatures.
After a system overheating issue is resolved and the adapter is cooled down,
reboot the system or, if the system supports hot swapping, cycle the power of
the adapter slot.
Personality Area
The Current field indicates the current personality in use by the adapter.
After Reboot Area
You can change the current personality of the adapter by clicking one of the following:



FCoE – Click to choose the FCoE personality.
iSCSI – Click to choose the iSCSI personality.
NIC Only – Click to choose the NIC only personality.
Channel Management Area (OCe11100–Series Adapters Only)
You can enable or disable channel management for an entire adapter and select the
channel management mode from the Channel Management area.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
110
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters


Current Management Type – Displays the currently active channel
management mode.
Management Type After Reboot – Changes the channel management mode
when you select a channel management mode from the list.

Select None from the list to disable channel management and click Apply.
License Features Area


Shows the available personalities.
Shows the status of the available personalities.
Adapter Information Tab Buttons


Apply – Click to apply save any changes that you have made.

After Reboot – Click to apply the selected personality.

Management Type After Reboot – Click to apply the selected Management
Type After Reboot.
Install Feature Licenses – Click to install licenses.
Viewing and Installing Licenses for OneConnect
OCe10100–Series and OCe11100–Series Adapters
OneCommand Manager for VMware vCenter allows you to view available licenses and
install licenses to enable capabilities such as FCoE or iSCSI personalities on
OCe10100-series and OCe11100-series adapters.
Note: When licenses or licensable features are not available for the adapter, license
information is not displayed.
Note: Licensing is not available for the LPe16202 CFA.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
111
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Figure 6-43 OneConnect OCe11102 Adapter Information Tab
Viewing Licenses
To view available licenses for an OCe10100-series or an OCe11100-series adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select an adapter whose licenses you
want to view.
3. Select the Adapter Information tab.
License information is displayed in the License Features area. The table shows the
available licenses and whether they are licensed or not.
Note: An empty feature list means the adapter has no licensable capabilities.
Installing Licenses
Note: Contact Emulex for the required license files.
To install licenses for an OCe10100-series or a OCe11100-series adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the adapter for which you
want to install licenses.
3. Select the Adapter Information tab (Figure 6-42, OneConnect Adapter Information
Tab, on page 109).
4. Click Install Feature Licenses. The Install Feature Licenses dialog box shows the
Adapter ID.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
112
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Figure 6-44 Install Feature Licenses Dialog Box
5. Following the instructions you received with the Entitlement Code, go to the
License website and enter the Adapter ID and Entitlement Code.
6. When the Adapter ID and Entitlement Code are successfully validated, download a
License Key File containing one or more activation keys.
7. In the Install Feature Licenses dialog box, click Browse. The file selection dialog box
appears. Select the file you want to use and click OK.
8. A dialog box appears confirming that you want to install the licenses. Click Yes.
9. A dialog box appears notifying you that the installation was successful or why it
failed. Click OK.
Changing Personalities on OCe10100–Series and OCe11100–
Series Adapters
OneCommand Manager for VMware vCenter allows you to change the personality
running on an OCe10100-series or an OCe11100-series adapter. There are three
personalities: NIC-Only, FCoE, and iSCSI.
Note: OneCommand Manager for VMware vCenter does not support personality
change for the LPe16202 CFA.
In some cases the adapters come pre-configured to support multiple personalities. In
other cases an enablement license must be installed before the adapter can support
multiple personalities. Refer to “Installing Licenses” on page 112 for more information.
To change the personality of an adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select an adapter whose personality
you want to change.
3. Select the Adapter Information tab (Figure 6-42). From the Personality area of the
Adapter Information tab, select the personality type you want and click Apply.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
113
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Note: If the adapter does not support personalities, personality controls are not
displayed. If the adapter does not support a particular personality type that
control is disabled.
4. Reboot the host for the personality change to take effect.
Managing Port Channels Using Channel Management
Note: Channel management is not available for the LPe16202 CFA and
OCe10100-series adapters.
Channel management allows each supported OCe11100-series adapter’s physical port
to be partitioned into a maximum of four isolated channels providing a converged
conduit for network and storage traffic. Each channel has its own unique MAC address
and provides traffic management capabilities such as enabling or disabling send and
receive traffic, minimum and maximum transmit rates, and VLAN IDs for untagged
packets.
Ports are managed using the Channel Management tab. The Channel Management tab
is displayed when an adapter port is selected in the discovery-tree and Channel
Management is enabled on the Adapter Information tab. See “Enabling and Disabling
Channel Management” on page 114.
The Channel Management tab for UMC or vNIC2 shows the function number, type of
protocol, MAC address, and more for each channel. You can also configure and enable
or disable channels, and assign LPVIDs.
Refer to the Emulex Universal Multichannel Reference Guide for more information about
channel management.
Notes:



Channel management and SR-IOV cannot be used together. If you set channel
management, then you must disable SR-IOV. If you set SR-IOV, then you must
disable UMC.
Properties for all channels on a port can be viewed and modified at the time
channel management is enabled on the Adapter Information tab; before the
required reboot to activate channel management on the adapter.
vNIC2 mode or UMC mode is required to dynamically control UCNA ports
using channel management.
Enabling and Disabling Channel Management
To enable channel management, select a management type from the Management Type
After Reboot list in the Channel Management area when in the Adapter Information
view. See Figure 6-42, OneConnect Adapter Information Tab, on page 109.
To disable channel management, select None from the Management Type After Reboot
list.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
114
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Notes


You must reboot the host for channel management to activate.
When the channel management mode in the Adapter Information tab is set to
None, the Channel Mgmt tab is not displayed.
Configuring Channel Management for OCe11100–Series
Adapters
When you select an OCe11102 adapter port with channel management enabled, the
Channel Mgmt tab is available.
Note: The Channel Mgmt tab shows the settings for the configured channel
management mode after reboot. This may not match the mode that is currently
running on the adapter if you have changed the mode in the Adapter
Information tab, but have not rebooted.
To manage the ports for an OCe11102 adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the adapter port for which you
want to manage channels.
3. Select the Channel Mgmt tab. The Channel Mgmt tab is displayed.
Figure 6-45 Channel Mgmt tab for the OCe11102 adapter
4. Make appropriate changes to the LPVID, Min BW%, and Max BW% values in
accordance with the guidelines that follow.
5. Click Apply. A reboot is not required.
Channel Mgmt Field Definitions


Channel Management Type – Channel management protocol type in use.
Funct# – Function number used to identify a specific channel.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
115
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters





Type – Protocol personality of a specific channel.
MAC Address – MAC address assigned to a specific channel.
LPVID – Logical port VLAN ID.
Minimum and maximum bandwidths (in percent) – Percentage of available
link bandwidth allocated to a particular function.
Minimum bandwidth total – Sum of the minimum bandwidths which must
total 100% in order to apply any changes made in the Channel Mgmt tab.
Note: If you change any properties, you must click Apply Changes to save them.
A reboot is not required for changes to take effect.
Disabling a Specific Channel
To disable a channel, click the Minimum Bandwidth field for the specific channel and
enter a ‘0’ value.
To enable a channel, click the Minimum Bandwidth field for the specific channel and
enter a non-zero value.
For more information on setting bandwidths, see “Bandwidth Assignments for a
Specific Channel” on page 116.
LPVID Assignment for a Specific Channel
LPVID values range between 2 and 4094. Any “enabled” channel must be assigned an
LPVID. LPVIDs must be unique across all channels on a port.
Note: LPVID does not apply to iSCSI and FCoE channel types. LPVID is set to zero for
these protocols.
To assign an LPVID value:
1. Click the LPVID field for the channel you want to change.
2. Enter a valid LPVID value.
3. Click Apply Changes
Note: If you click Apply Changes and the LPVID values are not between 2 and 4094 or
if they are not unique, an error message is displayed indicating the problem and
that the changes were not saved.
Bandwidth Assignments for a Specific Channel
Minimum bandwidth values of the “enabled” channels can be set between 1% and
100%, but must all add up to exactly 100%. The total of these bandwidths is displayed
and updated each time the minimum bandwidth field is changed. If the total is 100%,
the background in the “Minimum bandwidth total:” is green. If not, the background is
red to indicate changes must be made.
The maximum bandwidth of a channel must be greater than or equal to the minimum
bandwidth for that channel.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
116
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
To assign a bandwidth value:
1. Click the appropriate Bandwidth field for the channel you want to change.
2. Enter a valid bandwidth value.
3. Click Apply Changes
Note: If you click Apply Changes and the total minimum bandwidths do not add up
to 100% or one of the maximum bandwidths is not valid, an error message is
displayed indicating the problem and that the changes were not saved.
Viewing the Channel Management Tab for vNIC1
For adapters that support vNIC1, the vNIC properties are displayed in the Channel
Management tab when vNIC is enabled. The Port Channel Management Tab for vNIC
is read-only with the vNIC specific attributes listed in the table as shown in Figure 6-46.
Note: vNIC is only supported on certain virtual fabric adapters. For specific
information as to whether it is supported on a specific adapter, see the release
notes that are available on the Emulex website.
To view vNIC channel management:
1. From the discovery-tree, select the vNIC adapter port whose channel information
you want to view.
2. Select the Channel Management tab.
Figure 6-46 Channel Management Tab in vNIC1 Mode
Channel Mgmt Field Definitions for vNIC1







Channel Management Type – Channel management protocol type in use.
Function # – Function number used to identify a specific channel.
Type – Protocol personality of a specific channel.
MAC address – MAC address assigned to a specific channel.
Name – Name assigned to the vNIC by an administrator during switch
configuration.
Outer VLAN ID – VLAN identifier used between the NIC port and the switch.
The switch maps this value into the VLAN ID used on the network.
Min. BW – Minimum bandwidth at which the port is guaranteed to run.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
117
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters

Max. BW – Maximum bandwidth at which the port is guaranteed to run.
Viewing the Channel Management Tab for UFP
For adapters that support UFP, the UFP properties are displayed in the Channel
Management tab when UFP is enabled. The Port Channel Management tab for UFP is
read-only with specific attributes listed in the table as shown in Figure 6-47.
Note: UFP is supported only on IBM virtual fabric adapters. For specific information
as to whether it is supported on a specific adapter, see the release notes that are
available on the IBM adapter pages on the Emulex website.
To view UFP channel management:
1. From the discovery-tree, select the UFP adapter port whose channel information
you want to view.
2. Select the Channel Management tab.
Figure 6-47 Channel Management Tab in UFP Mode
Channel Mgmt Field Definitions for UFP








Channel Management Type – The channel management protocol type in use.
Function Number – The function number assigned by the system to the channel.
Type – The protocol type in use.
MAC address – The MAC address assigned to the channel.
Name – The name assigned to the UFP by an administrator during switch
configuration.
Outer VLAN ID – The VLAN identifier used between the NIC port and the
switch. The switch maps this value into the VLAN ID used on the network.
Min. Bandwidth – The minimum bandwidth at which the port is guaranteed to
run.
Max. Bandwidth – The maximum bandwidth at which the port is guaranteed to
run.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
118
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Viewing OCe10100–Series and OCe11100–Series Adapter
Firmware Information
Unlike LightPulse adapters, OCe10100-series and OCe11100-series adapter firmware is
maintained on an adapter-specific basis instead of port-specific basis.
To view firmware information for an adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the adapter for which you
want to view firmware information.
3. Select the Maintenance tab. The Maintenance tab enables you to view and update
firmware on an adapter in a specific host.
Figure 6-48 OCe11100-Series Adapter Maintenance Tab
Maintenance Tab Field Definitions




Active Firmware Version – The firmware version currently being used by the
adapter.
Flash Firmware Version – The flash firmware version flashed on the adapter.
BIOS Version – The version of the BIOS currently being used by the adapter.
Boot Code Versions – The adapter's boot code versions currently being used by
the adapter.
Note: The Start-up Boot Code is the boot code that boots the adapter. It has no
relation to the FC, or PXE boot code versions.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
119
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Maintenance Tab Button
The Update Firmware button updates firmware on the selected adapter. Refer to
“Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series
Adapters” on page 162 for more information.
Viewing and Configuring Physical Ports for OCe10100–Series
and OCe11100–Series Adapters
Viewing Physical Ports
The Physical Port Info tab shows general information about the PCI functions under the
selected physical port and the current physical port status.
To view physical port information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the OCe11100-series adapter
physical port for which you want to view information.
3. Select the Physical Port Info tab.
Figure 6-49 OCe11100–Series Adapter Physical Port Info Tab
Physical Port Info Tab Field Definitions
PCI Function Summary Area



NIC – The number of NIC functions running on the adapter.
iSCSI – The number of iSCSI functions running on the adapter.
FCoE – The number of FCoE functions running on the adapter.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
120
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Physical Port Status Area

Status:

Down – Not operational

Up – Operational

n/a – Not available
Port Speed Area



Interface Type – The module type and speed.
Configured Speed – The configured port mode (default, force or auto-negotiate)
and speed.
DAC Cable Length – The digital audio cable length in meters.
Configuring a Physical Port for OCe10100–Series and OCe11100–
Series Adapters
Enabling or Disabling a Physical Port
To change the physical port status, click Enable/Disable. This button toggles between
Disable and Enable, depending upon the current status of the physical port.
Changing a Physical Port’s Speed
The Change Port Speed dialog box allows you to configure port mode, speed and DAC
cable length.
To configure port speed for a physical port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port whose port
speed you want to configure.
3. Select the Physical Port Info tab.
4. Click Set Speed. The Change Port Speed dialog box appears.
5. As applicable, make mode, speed and DAC cable length changes.
6. Click OK.
Figure 6-50 Change Port Speed Dialog Box
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
121
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Change Port Speed Field Definitions



Mode

Default – Speed and DAC Cable Length fields are not active.

Force

Auto-Negotiate
Speed – This field is active if the mode is set to Force or Auto-Negotiate.

If the mode is set to Force and depending upon the interface type, you can
set the speed to one of the following:

10 Mb

100 Mb

1 Gb/s

10 Gb/s

If the mode set to Auto-Negotiate, and depending upon the interface type,
you can set the speed setting to a single or multiple speed value.

Single speed values

10 Mb

100 Mb

1 Gb/s

10 Gb/s

Multiple speed values combinations

10 Gb/s and 1 Gb/s

1 Gb/s and 100 Mb

1 Gb/s, 100 Mb and 10 Mb

100 Mb and 10 Mb
DAC Cable Length – This field is only required if the Force mode is selected and
the speed is set to 10 Gb/s. Select from 1 to 10 meters. This field is not active in
all other cases.
Viewing Physical Data for OneConnect 10GBASE–T–Series
Adapters
The PHY Data tab shows physical data information for OneConnect 10GBASE-T–series
adapters.
To view physical data information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port for which you
want to view physical data information.
3. Select the PHY Data tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
122
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Figure 6-51 OneConnect Adapter PHY Data Tab
PHY Data Tab Field Definitions
Operational Attributes Area




Temperature – The internally measured adapter temperature.
Firmware – The version of Emulex firmware currently active on the adapter
port.
Config ID – The CRC configuration details.
Link Uptime – The time in seconds that the link has been up. Pair A/B/C/D
SNR Margin – The port’s average SNR margin for twisted pairs A, B, C & D.
Error Rates Area



LDPC Frame Errors – The number of LDPC frame errors.
PHY CRC8 Errors – The number of physical CRC errors.
Pair A/B/C/D MSE – The port’s average MSE relative to the transmitted code
words for twisted pairs A, B, C & D.
Counters Area



MDI PLL Events – The number of MDI PLL events.
10G EMI Events – The 10G EMI Event counter tracks the number of single-tone
interference detected by the CNA's MDI signals. This counter holds its value at
MDI link down and self-clears at the next link up.
PHY Frames – Counts the number of physical frames transmitted and received
since the MDI link has been established. This counter holds its value at MDI link
down and self-clears at the next link up.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
123
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Viewing Port Transceiver Information for OCe10100–Series and
OCe11100–Series Adapters
The Transceiver Data tab enables you to view transceiver information such as vendor
name, serial number, part number, and diagnostic data. If the adapter/transceiver does
not support some or all of the transceiver data, the fields show N/A.
To view transceiver information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port whose
transceiver information you want to view.
3. Select the Transceiver Data tab.
Figure 6-52 OCe10100–Series Port Transceiver Tab
Transceiver Information Field Definitions
Module Attributes Area








Vendor – The name of the vendor.
Identifier/Type – The identifier value that specifies the physical device
described by the serial information.
Ext. Identifier – Additional information about the transceiver.
Connector – The external optical or electrical cable connector provided as the
media interface.
Wavelength – The nominal transmitter output wavelength at room
temperature.
OUI – The vendor’s OUI. It is also referred to as the IEEE Company Identifier
for the vendor.
Date – The vendor’s date code in the MM/DD/YY format.
Serial Number – The serial number provided by the vendor.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
124
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters


Part Number – The part number provided by the SFP vendor.
Revision – The vendor revision level.
Diagnostic Data Area





Temperature – The internally measured module temperature.
Supply Voltage – The internally measured supply voltage in the transceiver.
TX Bias Current – The internally measured TX bias current.
TX Output Power – The measured TX output power.
RX Input Power – The measured RX input power.
Viewing and Configuring OCe10100–Series and OCe11100–
Series Physical Port DCB Parameters
Viewing Physical Port DCB Parameters
The DCB tab shows the DCB parameters for a physical port.
Note: DCB tab does not appear for OCe10100–series adapters with a NIC only
personality.
To view the DCB parameters for a physical port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port for which you
want to view DCB parameters.
3. Select the DCB tab.
Figure 6-53 FCoE Adapter Port, DCB Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
125
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
DCB Tab Field Definitions



DCBX State – The current DCBX (Data Center discovery and Capability
exchange protocol) state (enabled or disabled).
LLDP Transmit State – DCBX uses Link Layer Discovery Protocol (LLDP) to
exchange parameters between two link peers. For the DCBX protocol to operate
correctly, both LLDP receive and transmit states must be enabled. If either the
receive or transmit state is disabled, DCBX is disabled.
LLDP Receive State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP receive and
transmit states must be enabled. If either the receive or transmit states is
disabled, DCBX is disabled.
PFC Properties Area




State – Enabled indicates that there is flow control in both directions (receive
and transmit).
Active Priorities – Lists the number of priorities with PFC set to enabled.
Sync’d – If Yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
Error – The FCoE error status. The error status indicates whether an error
occurred during the configuration exchange with the peer. Error is also set to
Yes when the Compatible method fails.
Protocol Properties Area





State – Enabled indicates that there is flow control in both directions (receive
and transmit).
Sync’d – If Yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
Error – The FCoE error status. The error status indicates whether an error
occurred during the configuration exchange with the peer. Error is also set to
Yes when the Compatible method fails.
iSCSI Priority (if applicable) –The configured iSCSI priority.
FCoE Priority (if applicable) –The configured FCoE priority.
ETS Properties Area




State – The protocol state. It can be enabled or disabled.
Sync’d – If Yes, the protocol priority has been set by the peer. This parameter
cannot be set.
Error – The error status. The error status indicates whether an error occurred
during the configuration exchange with the peer. Error is also set to Yes when
the Compatible method fails.
Active Groups Table

Group ID – The Priority Group number. It can be 0 to 7.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
126
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters


Priority Membership – The priorities that are assigned to each Priority
Group. It is represented in comma separated format.
Bandwidth% – The percentage of available link bandwidth allocated to a
particular Priority Group.
DCB Tab Button
The Configure DCB button allows you to configure the DCB parameters.
Configuring Physical Port DCB Parameters
The DCB Configuration dialog box allows you to configure physical port DCB
parameters. While there are eight ETS Priority Groups in which the priorities can be
assigned, only two of those groups can be assigned priorities and bandwidths. The
FCoE priority is assigned to one Priority Group and the other seven (NIC) priorities
must be assigned to one and only one other Priority Group. If you are configuring
Priority Groups on a DCBX enabled switch, in order to work properly with the adapter
port, you should only configure two Priority Groups in the same way.
To configure DCB parameters for a physical port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port whose DCB
properties you want to configure.
3. Select the DCB tab.
4. Click Configure DCB. The DCB Configuration dialog box appears.
5. Configure the settings you want and click OK.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
127
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters
Figure 6-54 DCB Configuration Dialog Box for FCoE and ISCSI Adapter Ports (DCBX Enabled)
Configure DCB Dialog Box Field Definitions
DCBX Settings Area




Enabled – DCBX can be enabled or disabled. With DCBX enabled, the
configured values are used only if the switch does not provide them. With
DCBX disabled, the configured values are used.
DCBX Mode – The DCBX mode can be set to DCB or Cisco-Intel-Nuova (CIN).
Changes to the DCBX mode require a reboot of the host.
Operating Version – The operating version of the DCBX protocol. The system
adjusts as needed to operate at the highest version supported by both link
partners. This setting cannot be changed.
Maximum Version – The highest DCBX protocol version supported by the
system. Version numbers start at zero. The DCBX protocol must be backward
compatible with all previous versions. This setting cannot be changed.
LLDP Settings Area



Transmit Enabled – LLDP Transmit can be enabled or disabled.
Transmit Port Description Enabled – Provides a description of the port in an
alpha-numeric format. The value equals the ifDescr object, if the LAN device
supports RFC 2863.
Transmit System Name Enabled – Provides the system's assigned name in an
alpha-numeric format. The value equals the sysName object, if the LAN device
supports RFC 3418.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
128
6. Managing Adapters and Ports
OCe10100–Series and OCe11100–Series Adapters



Transmit System Description Enabled – Provides a description of the network
entity in an alpha-numeric format. This includes system's name and versions of
hardware, operating system and networking software supported by the device.
The value equals the sysDescr object, if the LAN device supports RFC 3418.
Transmit System Capabilities Enabled – Indicates the primary function(s) of the
device and whether these functions are enabled on the device. The capabilities
are indicated by two octets. Bits 0 through 7 indicate Other, Repeater, Bridge,
WLAN AP, Router, Telephone, DOCSIS cable device and Station respectively.
Bits 8 through 15 are reserved.
Receive Enabled – LLDP Receive can be enabled or disabled.
PFC Priorities Area
You can configure PFC priorities on LPe16202 NIC ports and OCe11100–series NIC
and iSCSI ports.
Note: There is no PFC support for an OCe10100–series adapter’s NIC or iSCSI
port.



Active Priorities – The priorities that are marked active for PFC.
Enable – This checkbox enables PFC priorities.

If you are configuring a NIC port, clear this checkbox.

If you are configuring an iSCSI or FCoE port, select this checkbox.
Configured Priorities – If the Enable checkbox is selected, these are the priorities
that are configured, but might not yet be active. You can select two PFC priority
checkboxes. One of these selections must match the iSCSI priority. The other
PFC priority is for Ethernet traffic. The PFC priority for Ethernet traffic must be
assigned to a Priority Group which has no other priorities.
FCoE Priority Area (FCoE adapter ports only)


Active Priority – The active FCoE priority.
Configured Priority – The configured FCoE priority.
iSCSI Priority Area (FCoE adapter ports only)


Active Priority – The active iSCSI priority.
Configured Priority – The configured iSCSI priority.
ETS Priority Groups Area
Active Groups




Max Configurable PGs – The maximum number of Priority Groups that can
be configured.
Group ID – The Priority Group ID.
Priority Membership – The different priorities assigned to the various
Priority Groups. This is the current active configuration.
Bandwidth – The bandwidths that are assigned to different Priority Groups.
This is the current active configuration.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
129
6. Managing Adapters and Ports
OCe14100–Series Adapters
Configured Groups



Group ID – The Priority Group ID.
Priority Membership – The configured priority membership grouping.
Bandwidth% – The configured bandwidth value for the different Priority
Groups.
Configure DCB Dialog Box Buttons




Defaults – Click to return parameters to default DCB settings.
Configuration Rules – Click to view a window that lists the rules for
configuring priorities. You must observe these rules when configuring
Priority Groups for adapter ports. Configuration rules are displayed based
on the type of adapter ports you are configuring.
OK – Click to apply and save your changes.
Cancel – Click to discard any changes you made.
FCoE and iSCSI Configuration Rules





One and only one priority is configured for the priority.
You can select a maximum of two PFC priorities and one of them must
match the priority.
The PFC Priority Group to which the priority is assigned must contain no
other priorities.
The additional PFC priority must be assigned to a Priority Group which has
no other priority.
Bandwidths of all the Priority Groups must total 100%.
NIC Configuration Rules



One and only one priority is configured for the priority.
The PFC priority must be assigned to a Priority Group which has no other
priorities.
Bandwidths of all the Priority Groups must total 100%.
OCe14100–Series Adapters
Viewing OCe14100–Series Adapter Configuration
Information
The Adapter Configuration tab contains current configuration information associated
for the selected adapter.
To view configuration information:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
130
6. Managing Adapters and Ports
OCe14100–Series Adapters
2. In the Emulex Device Management tree-view, select an adapter. The Adapter
Configuration tab is displayed.
Configuring OCe14000–Series Adapters
When you select an OCe14000-series adapter from the discovery-tree, the Adapter
Configuration tab is displayed. The type of information that appears depends on the
what protocols and capabilities are available on the adapter. (The IPL defines the
protocols and capabilities.)
For all adapters except NPar, there are three configuration modes available:

Single personality – Select a single protocol (along with NIC, or NIC-only) to
run on all ports on the adapter.

Custom – Choose the protocols to run on each port independently. Custom
configuration is available if the adapter is capable of mixed or concurrent mode
storage.

Multichannel – View the channel properties and change the configurable
properties (based on the multichannel type).
For NPar, the adapter is either running with NPar disabled (the adapter is running
as a single NIC function on each port), or with NPar enabled, which can be similar
to a multichannel configuration or a storage channel configuration.
Figure 6-55 OCe14100-series Adapter Configuration Tab (FCoE selected)
OCe14100–Series Adapter Configuration Tab Field Definitions


Current Configuration – The protocol running on the adapter.
Next Boot Configuration – Displays different checkboxes or radios buttons
subject to the protocol running on the adapter. Select a checkbox or radio button
to change the tab's view and next boot configuration method.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
131
6. Managing Adapters and Ports
OCe14100–Series Adapters

The display in the lower area of the tab depends upon selected view of the next
boot configuration. For non-NPar configurations, depending upon
configuration options available on the adapter, you can configure the adapter
for a single personality (e.g. FCoE), multichannel or a custom configuration (for
mix and concurrent modes).
OCe14100–Series Adapter Configuration Tab Buttons




Apply - Saves the changes to the next boot configuration to the adapter.
Restore - Resets any changes to the next boot configuration back to the currently
saved settings on the adapter.
Factory Defaults – Returns the adapter to the factory default profile and settings
for that adapter. A reboot is required.
Details – Displays a pop up a window with more information about the current
configuration running on the adapter.
Figure 6-56 Current Configuration Details example
Configuring a Single Personality
The Single personality view allows you to select the same protocol to run on all ports of
the adapter. When you configure a single personality for an adapter, all ports run the
same number of functions and protocols on those functions.
To configure a single personality:
1. From the discovery-tree, select the OCe14100-series adapter whose personality you
want to configure.
2. From the Adapter Configuration tab, check the Single personality (all ports) radio
button.
3. Select the personality you want to apply from the Personality pull down menu (see
Figure 6-55 on page 131).
Note: If you choose a NIC-Only configuration, there may be multiple NIC-Only
configurations available (for example; NIC-Only or NIC-Only, No ETS). If the
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
132
6. Managing Adapters and Ports
OCe14100–Series Adapters
adapter supports multiple NIC configurations (profiles), you must select a
NIC-Only configuration from the NIC-Only configuration list.
Note: If you choose the NIC-Only No ETS configuration, SR-IOV is automatically
enabled on each NIC function and allows up to 63 virtual functions. If you
choose the NIC-Only configuration, SR-IOV is not supported.
4. Click Apply. A message appears notifying you of the profiles activation
requirements. Not all selections require a reboot.
Custom Configurations
The Custom configuration view allows you to customize the protocols running on
each port of an adapter. The Port Configuration table only displays the available
ports. When the Custom radio button is selected, the Adapter Configuration tab
looks like the following:
Figure 6-57 OCe14100-series Adapter Configuration Tab, Custom Configuration
Note: Custom configurations are only available if the adapter supports mixed or
concurrent mode storage.
Note:
If you configure all ports the same, you essentially configure a single
personality and the Adapter Configuration tab shows the Single Personality
radio button automatically selected.
To set up a custom configuration:
1. From the discovery-tree, select the OCe14100-series adapter whose personality you
want to configure.
2. From the Adapter Configuration tab, check the Custom radio button.
3. Select the personality you want to apply from the Protocol pull down menu for
each port.
4. Click Apply. A message appears notifying you of the profiles activation
requirements. Not all selections require a reboot.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
133
6. Managing Adapters and Ports
OCe14100–Series Adapters
Mixed Mode Configuration
When mixed mode is available, up to two functions per port can be configured. The
first function will be NIC. The second function can be a storage protocol or “None”.
When you click on the second function's pull down menu, the available storage
protocols for the function are displayed.
Figure 6-58 Mixed Mode Protocol pull down menu
You can select any of the available storage protocols or “None” to indicate that the
second function will not be available on that port. After selecting the protocols to run
on each port, click Apply to save the configuration.
Note:
If you select the same protocol or “None” on all ports, you essentially
configured a single personality. In this case, after clicking Apply, the tab
switches to the single personality view showing the selected personality in the
personality pull down menu.
Note: If NIC protocol is selected for all functions, a pull down appears with available
NIC-Only profiles. One of them must be selected.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
134
6. Managing Adapters and Ports
OCe14100–Series Adapters
Concurrent Mode
When concurrent mode is available, up to three functions per port are configurable.
Figure 6-59 Concurrent Storage Configuration View
The pull down menu for selecting a storage protocol to run on the second and third
functions is the same as the pull down menu for mixed mode storage.
Concurrent Storage Configuration is subject to the following rules:



The first function must be NIC.
If two storage functions are configured on a port, they must be different storage
protocols (i.e. concurrent mode).
When you select the storage protocol for the second function, the choices in the
pull down menu for the third function are limited to the other storage protocol
or “None”.
Note: If you select the same protocol or “None” for all second functions on all ports
and “None” for all third functions, you essentially configured a single
personality. In this case, after clicking the Apply button, the tab switches to the
single personality view and the selected personality is shown in the personality
pull down menu.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
135
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-60 Concurrent Storage Configuration Choices for the Third Function
UMC Configuration View
When UMC is available and the UMC radio button is selected, the Adapter
Configuration tab looks like the following:
Figure 6-61 UMC View (four ports)
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
136
6. Managing Adapters and Ports
OCe14100–Series Adapters
UMC channel protocol assignments are subject to the following rules:







The first channel can only be assigned NIC protocols. The first channel cannot
be assigned None.
The second and third channels can be assigned the following:

NIC

None (channel disabled)

Storage protocol (third channel only when concurrent mode storage is
available)

If storage protocols are assigned to the second and third channels, they must
be different storage protocols.
The fourth and higher channels (if available) can only be assigned NIC or None
(channel is disabled).
A channel's logical link is set to down by setting both the minimum and
maximum bandwidths to 0.
The total minimum bandwidth for all enabled channels on a port must add up
to 100, except in the case where all the maximum bandwidths are 0 (for
example, setting a logical link down on all channels).
The maximum bandwidth for each channel must be greater than or equal to the
minimum bandwidth for that channel.
LPVIDs (range 2-4094) must be assigned to all NIC channels and must be
unique across all NIC channels on a port. However, any or all of the LPVIDs on
one port can be repeated on another port.
Default UMC Settings
Most hosts today do not support ARI, therefore the default UMC settings are designed
to prevent enabling functions that require ARI (when possible). This prevents the
possibility of enabling channels that are not seen on the PCI bus when the system boots.
There is one case where functions requiring ARI are enabled when UMC is enabled. On
a four port adapter, when UMC is disabled, if the third function on each port is already
enabled when UMC is enabled, that function continues to be enabled. In this case, it is
assumed that you previously enabled the third function because ARI was available.
When UMC is enabled, the channels are assigned default values based upon the
following rules:
For each port:





All enabled functions (i.e. functions not set to None) continue to be enabled,
running the same protocol before UMC was enabled even if its function number
is greater than seven (only possible on 4 four-port adapters).
Any channel with a function number less than eight is enabled with NIC.
Any channel with a function number greater than seven is set to None (channel
is disabled).
The minimum bandwidths are assigned by dividing up 100% as evenly as
possible between the enabled channels.
The maximum bandwidths for the enabled channels are set to 100.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
137
6. Managing Adapters and Ports
OCe14100–Series Adapters


Both the minimum and maximum bandwidth for the channels assigned None
are set to 0.
The LPVIDs are set to 0. You must assign any NIC channel a valid LPVID.
Note: These rules create the default settings for the channels. You can update these
rules before saving them.
IBM MultiChannel Configuration View
Note: IBM multichannel currently only allows four channels per port even in one and
two port configurations
For IBM multichannel configuration, there are three different multichannel types
available: vNIC, SIMode, and UFP. When you check the MultiChannel radio button,
the Adapter Configuration tab looks like the following:
Figure 6-62 MultiChannel View (showing multichannel type drop-down)
A MultiChannel Type pull down menu is available to select the type of multichannel
configuration on the adapter. The contents of the Channel Configuration table depend
upon the selected multichannel type.
Multichannel vNIC Configuration
When vNIC is selected on the adapter, the Adapter Configuration tab looks like the
following:
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
138
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-63 MultiChannel vNIC View (Mixed Mode Storage)
The Channel Configuration table shows the channel properties for vNIC.
There are drop-downs for each port's channels second and third channels. vNIC
protocol assignments are subject to the following rules:




The first channel can only be assigned a NIC protocol. The first channel cannot
be assigned None.
The second and third channels can be assigned the following:

NIC

None (channel disabled)

Storage protocol (On the third channel only when concurrent mode storage
is available)
The fourth and higher channels (if available) can only be assigned NIC or None
(channel is disabled).
LPVIDs (range 2-4094) must be assigned to all NIC channels and must be
unique across all NIC channels on a port. However, any or all of the LPVIDs on
one port can be repeated on another port.
MultiChannel SIMode Configuration
When MultiChannel SIMode is selected, the Adapter Configuration tab looks like the
following:
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
139
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-64 MultiChannel SIMode View
Other than the names, SIMode and UMC configuration is exactly the same. See “UMC
Configuration View” on page 136.
Multichannel UFP Configuration
When UFP is selected, the Adapter Configuration tab looks like the following:
Figure 6-65 MultiChannel UFP View (concurrent mode storage)
The Channel Configuration table shows the channel properties for multichannel UFP.
There are drop-downs for each port's channels second and third channels.
Multichannel UFP channel protocol assignments are subject to the following rules:

The first channel can only be assigned NIC protocols. The first channel cannot
be assigned None.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
140
6. Managing Adapters and Ports
OCe14100–Series Adapters


The second and third channels can be assigned the following:

NIC

None (channel disabled)

Storage protocol (third channel only when concurrent mode storage is
available)

Storage protocols can only be assigned to the second channel when
mix-mode storage is available.

The third channel can be assigned a storage protocol when concurrent mode
storage is available under the following restrictions.

Can only be assigned a storage protocol if the second channel is assigned
a storage protocol.

The storage protocol must be different than the second channel's storage
protocol.
The fourth and higher channels (if available) can be assigned the NIC protocol
or None (channel is disabled).
Dell NPar Configuration Views
NPar Bandwidth Settings
Similar to UMC, a minimum and maximum bandwidth is assigned to each enabled (i.e.
not None) partition. The sum of the minimum bandwidths must add up to 100. The
maximum bandwidth for each partition must be equal to or greater than the minimum
bandwidth on that partition and no larger than 100. Unlike UMC, if the minimum and
maximum bandwidths are set to 0, the logical link on the adapter is not brought down.
A small of amount of data will trickle through the port for that partition when
bandwidth is available. Bandwidth changes take effect immediately (no reboot
required).
Two Port Adapters
Dell two port adapters allow up to four or eight partitions per port, depending upon
whether the NParEP Mode check box is checked or cleared.
NParEP Mode Disabled
For Dell NPar adapters, the Adapter Configuration tab is different than for the other
adapters. There are two choices in the Next Boot Configuration: NPar Enabled and
Enable NParEP Mode. When NPar is enabled and NParEP Mode is disabled, the
adapter is basically a NIC-only adapter. The Adapter Configuration tab looks similar to
the following:
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
141
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-66 Dell Two Port NPar Configuration, NParEP Mode Disabled
If the NParEP Mode check box is cleared (disabled), only four partitions per port can be
configured. FCoE, iSCSI or None can be configured on the second through fourth
partitions, but only one FCoE and one iSCSI can be configured. None cannot be
configured on the first partition.
NParEP Mode Enabled
Figure 6-67 Dell Two Port NPar Configuration, NParEP Mode Enabled
If the NParEP Mode check box is selected (enabled), up to eight partitions per port can
be configured. FCoE or iSCSI can be configured on the second through fourth
partitions, but only one FCoE and one iSCSI can be configured. Partitions higher than
the fourth partition can only configured for NIC or None. None cannot be configured
on the first partition.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
142
6. Managing Adapters and Ports
OCe14100–Series Adapters
Four Port Adapters
Dell four port adapters allow up to two or four partitions per port, depending upon
whether the NParEP Mode check box is checked or cleared.
NParEP Mode Disabled
When NPar is enabled and NParEP Mode is disabled, the Adapter Configuration tab
looks similar to the following:
Figure 6-68 Dell Four Port NPar Configuration, NParEP Mode Disabled
If the NParEP Mode check box is cleared (disabled), only two partitions per port can be
configured. FCoE, iSCSI or None can be configured on the second function, None
cannot be configured on the first function.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
143
6. Managing Adapters and Ports
OCe14100–Series Adapters
NParEP Mode Enabled
Figure 6-69 Dell Four Port NPar Configuration, NParEP Mode Enabled
If the NParEP Mode check box is selected (enabled), up to four partitions per port can
be configured. FCoE or iSCSI can be configured on the second through fourth
partitions, but only one FCoE and one iSCSI can be configured. None cannot be
configured on the first partition.
Dell NPar Enabled
When NPar is enabled, the Adapter Configuration tab looks like the following:
Figure 6-70 Adapter Configuration Tab with NPar Enabled
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
144
6. Managing Adapters and Ports
OCe14100–Series Adapters
You can switch between showing eight functions and showing sixteen functions for a
given adapter, if NPar is enabled. If you know whether you are in an NParEP Mode
configuration, you can display the appropriate number of functions for an adapter.
NPar protocol assignments are subject to the following rules:








The first channel can only be assigned NIC protocols. The first channel cannot
be assigned None.
The second and third channels can be assigned the following:

NIC

None (channel disabled)

Storage protocol (note: on 3rd channel only when concurrent mode storage
is available)
The fourth and higher channels (if available) can only be assigned NIC or None
(channel is disabled).
The total of the minimum bandwidths of the enabled functions for each port
must add up to 100 percent. The maximum bandwidth for each function must
be greater than, or equal to, the minimum bandwidth for that channel.
After changing the NPar configuration and applying the changes, except for
bandwidth changes, a reboot is required to activate the new configuration.
SR-IOV must be disabled on the adapter BIOS when NPar is used. See “Using
SR-IOV on NIC Ports” on page 107 for information on disabling SR-IOV on the
adapter BIOS.
SR-IOV must be enabled on the system BIOS when NParEP is used. See the
documentation that accompanied your Dell server for more information.
NParEP support is available only on Dell 13G or newer systems.
Viewing and Configuring OCe14100–Series Physical Port
DCB Parameters
Viewing Physical Port DCB Parameters
To view the DCB parameters for a physical port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port for which you
want to view DCB parameters.
3. Select the DCB tab.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
145
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-71 OCe14100-Series Adapter, DCB Tab (FCoE/iSCSI Adapter Port Selected)
DCB Tab Field Definitions



DCBX State – The current DCBX (Data Center discovery and Capability
exchange protocol) state (enabled or disabled).
LLDP Transmit State – DCBX uses Link Layer Discovery Protocol (LLDP) to
exchange parameters between two link peers. For the DCBX protocol to operate
correctly, both LLDP receive and transmit states must be enabled. If either the
receive or transmit state is disabled, DCBX is disabled.
LLDP Receive State – DCBX uses LLDP to exchange parameters between two
link peers. For the DCBX protocol to operate correctly, both LLDP receive and
transmit states must be enabled. If either the receive or transmit states is
disabled, DCBX is disabled.
PFC Properties Area



State – Enabled indicates that there is flow control in both directions (receive
and transmit).
Active Priorities – Lists the number of priorities with PFC set to Enabled.
Sync’d – If Yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
146
6. Managing Adapters and Ports
OCe14100–Series Adapters

Error – The FCoE Error status. The error status indicates whether an error
occurred during the configuration exchange with the peer. Error is also set to
Yes when the Compatible method fails.
FCoE and iSCSI Protocol Properties Area





State – Enabled indicates that there is flow control in both directions (receive
and transmit).
Sync’d – If Yes, the PFC priorities have been set by the peer. This parameter
cannot be set.
Error – The FCoE Error status. The error status indicates whether an error
occurred during the configuration exchange with the peer. Error is also set to
Yes when the Compatible method fails.
iSCSI Priority (if applicable) – The configured iSCSI priority.
FCoE Priority (if applicable) – The configured FCoE priority.
ETS Properties Area




State – The protocol state. It can be Enabled or Disabled.
Sync’d – If Yes, the protocol priority has been set by the peer. This parameter
cannot be set.
Error – The error status. The error status indicates whether an error occurred
during the configuration exchange with the peer. Error is also set to Yes when
the Compatible method fails.
Active Groups Table

Group ID – The Priority Group number. It can be 0 to 7.

Priority Membership – The priorities that are assigned to each Priority
Group. It is represented in comma separated format.

Bandwidth% – The percentage of available link bandwidth allocated to a
particular Priority Group.
DCB Tab Button
The Configure DCB button allows you to configure the DCB parameters.
Configuring DCB Parameters for FCoE/iSCSI Adapter Ports
To configure DCB parameters for a physical port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the physical port whose DCB
properties you want to configure.
3. Select the DCB tab.
4. Click Configure DCB. The DCB Configuration dialog box appears.
5. Configure the settings you want and click OK.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
147
6. Managing Adapters and Ports
OCe14100–Series Adapters
Figure 6-72 DCB Configuration Dialog Box for FCoE and ISCSI Adapter Ports (DCBX Enabled)
Configure DCB Dialog Box Field Definitions
DCBX Settings Area



Enabled – DCBX can be enabled or disabled. With DCBX enabled, the
configured values are used only if the switch does not provide them. With
DCBX disabled, the configured values are used.
Operating Version – The operating version of the DCBX protocol. The system
adjusts as needed to operate at the highest version supported by both link
partners. This setting cannot be changed.
Maximum Version – The highest DCBX protocol version supported by the
system. Version numbers start at zero. The DCBX protocol must be backward
compatible with all previous versions. This setting cannot be changed.
LLDP Settings Area


Transmit Enabled – LLDP Transmit can be enabled or disabled.
Transmit Port Description Enabled – Provides a description of the port in an
alpha-numeric format. The value equals the ifDescr object, if the LAN device
supports RFC 2863.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
148
6. Managing Adapters and Ports
OCe14100–Series Adapters




Transmit System Name Enabled – Provides the system's assigned name in an
alpha-numeric format. The value equals the sysName object, if the LAN device
supports RFC 3418.
Transmit System Description Enabled – Provides a description of the network
entity in an alpha-numeric format. This includes system's name and versions of
hardware, operating system and networking software supported by the device.
The value equals the sysDescr object, if the LAN device supports RFC 3418.
Transmit System Capabilities Enabled – Indicates the primary function(s) of the
device and whether these functions are enabled on the device. The capabilities
are indicated by two octets. Bits 0 through 7 indicate Other, Repeater, Bridge,
WLAN AP, Router, Telephone, DOCSIS cable device and Station respectively.
Bits 8 through 15 are reserved.
Receive Enabled – LLDP Receive can be enabled or disabled.
PFC Priorities Area
You can configure PFC priorities on LPe16202 CFA NIC ports and OCe11100–series
NIC and iSCSI ports.
Note: There is no PFC support for an OCe10100–series adapter’s NIC or iSCSI
port.



Active Priorities – The priorities that are marked active for PFC.
Enable – This checkbox enables PFC priorities.

If you are configuring a NIC port, clear this checkbox.

If you are configuring an iSCSI or FCoE port, select this checkbox.
Configured Priorities – If the Enable checkbox is selected, these are the priorities
that are configured, but might not yet be active. You can select two PFC priority
checkboxes. One of these selections must match the iSCSI priority. The other
PFC priority is for Ethernet traffic. The PFC priority for Ethernet traffic must be
assigned to a Priority Group which has no other priorities.
FCoE Priority Area (FCoE adapter ports only)


Active Priority – The active FCoE priority.
Configured Priority – The configured FCoE priority.
iSCSI Priority Area (FCoE adapter ports only)


Active Priority – The active iSCSI priority.
Configured Priority – The configured iSCSI priority.
ETS Priority Groups Area
Active Groups


Max Configurable PGs – The maximum number of Priority Groups that can be
configured.
Group ID – The Priority Group ID.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
149
6. Managing Adapters and Ports
OCe14100–Series Adapters


Priority Membership – The different priorities assigned to the various Priority
Groups. This is the current active configuration.
Bandwidth – The bandwidths that are assigned to different Priority Groups.
This is the current active configuration.
Configured Groups



Group ID – The Priority Group ID.
Priority Membership – The configured priority membership grouping.
Bandwidth% – The configured bandwidth value for the different Priority
Groups.
Configure DCB Dialog Box Buttons




Defaults – Click to return parameters to default DCB settings.
Configuration Rules – Click to view a window that lists the rules for configuring
priorities. You must observe these rules when configuring Priority Groups for
adapter ports. Configuration rules are displayed based on the type of adapter
ports you are configuring.
OK – Click to apply and save your changes.
Cancel – Click to discard any changes you made.
FCoE and iSCSI Configuration Rules





One and only one priority is configured for the priority.
You can select a maximum of two PFC priorities and one of them must match
the priority.
The PFC Priority Group to which the priority is assigned must contain no other
priorities.
The additional PFC priority must be assigned to a Priority Group which has no
other priority.
Bandwidths of all the Priority Groups must total 100%.
NIC Configuration Rules



One and only one priority is configured for the priority.
The PFC priority must be assigned to a Priority Group which has no other
priorities.
Bandwidths of all the Priority Groups must total 100%.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
150
7. Updating Firmware
Performing a Batch Firmware Update in Cluster View
7. Updating Firmware
Performing a Batch Firmware Update in Cluster View
Before you can perform a batch update, you must download the firmware file from the
Emulex website and extract it into a directory on your local drive.
Note: On the system where OneCommand Manager for VMware vCenter is installed,
make sure the port numbers configured during the installation are open and
dedicated to the OneCommand Manager for VMware vCenter server only. No
other service should be listening on this port.
To perform a batch firmware update:
1. Select a cluster in the vSphere console tree-view and select the Emulex
OneCommand tab.
2. From the Emulex Device Management options, select Batch Firmware Update.
Figure 7-1 Batch Firmware Update Information Pane
3. Click Update Firmware to install firmware on multiple adapters in a single step.
Batch firmware loading is restricted to a single firmware file and to all accessible
adapters for which that file is compatible.
Updating Firmware on Multiple Adapters in Cluster View
To update firmware for multiple adapters:
1. Click Update Firmware. A Batch Firmware Download dialog box appears with
blank fields.
Note: You do not need to select a particular tree element for this operation.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
151
7. Updating Firmware
Performing a Batch Firmware Update in Cluster View
2. Click Browse and a search dialog box appears. On the search dialog box, select the
file you want to use and click OK. A status message appears indicating that
OneCommand Manager for VMware vCenter is searching for compatible adapters.
Once compatible adapters are found, the following is displayed in the Batch
Firmware Download dialog box:

The Firmware File field shows the selected image file name.

The Supported Models field shows a list of all adapter models that are
compatible with the selected image file.

The set of compatible adapters appears in the dialog box’s tree-view.
3. To view the compatible adapters in host-centric mode, make sure the Group by
Fabric checkbox is cleared. Figure 7-2 shows the Batch Firmware Download dialog
box in host-centric view.
Figure 7-2 Batch Firmware Download Dialog Box, Host-Centric View
4. To view the compatible adapters in a fabric-centric mode, select the Group by
Fabric checkbox. Figure 7-3 shows the Batch Firmware Download dialog box in
fabric-centric view
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
152
7. Updating Firmware
Performing a Batch Firmware Update in Cluster View
Figure 7-3 Batch Firmware Download Dialog Box, Fabric-Centric View
The tree-view shows all adapters and their corresponding hosts or fabrics for which
the selected firmware file is compatible. Use the checkboxes next to the entries to
select or deselect a host, fabric, adapter or port (if the adapters where the individual
port can have new firmware downloaded).
Note: iSCSI and NIC ports are not attached to any fabric, they are not listed in the
Batch Firmware Download dialog box.
5. Make your selections and click Start Download. A message prompting you to
confirm the firmware update appears, click Yes.
When the download begins the Jobs window is displayed (Figure 7-4). A status
message in the Active Job list shows the progress of the firmware download. The ports
on which the firmware is being downloaded have the status “Job is in progress”, the
other ports have “Waiting in queue to start”. When download is completed, the entry
moves to the Completed Jobs window. The status message field in the Completed Jobs
window shows the status of the completed job.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
153
7. Updating Firmware
Performing a Batch Firmware Update in Cluster View
Figure 7-4 Batch Firmware Update Jobs Window
Batch Firmware Update Jobs Window Field Definitions
Active Jobs Column Definitions






User – The user who triggered the firmware update.
Host – The IP address of the host to which the adapter/port belongs.
Adapter – The model of the adapter.
Port – The Port WWN for an FC adapter. This field is blank for a UCNA.
Start Time – The time the job is submitted.
Status Message – The status of the job.
Completed Jobs Column Definitions







User – The user who triggered the firmware update.
Host – The IP address of the host to which the adapter/port belongs.
Adapter – The model of the adapter.
Port – The port WWN for an FC adapter. This field is blank for a UCNA.
Start Time – The time the job is submitted.
End Time – The time the job is completed.
Status Message – The status of the job.
Jobs Window Buttons


Update Firmware – Click to update firmware on a different adapter in the same
cluster.
Cancel Updates – Click to cancel the jobs with “Waiting in queue to start”
status.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
154
7. Updating Firmware
Updating Firmware on Adapters in a Host
Considerations for Firmware Updates





If you start a firmware update and log out from the vSphere console before the
firmware update is completed, all pending jobs fail.
The firmware update progresses in the background until all the jobs are
completed. During this period you can still browse through the other tabs.
The submitted firmware update job can also be tracked in the VMware tasks
window.
Multiple firmware update jobs can be submitted for different adapters and
ports on the same or different ESXi hosts simultaneously to OneCommand
Manager for VMware. However, only a single job is processed on a given ESXi
host. The remaining jobs on that host will be queued and processed
sequentially.
The firmware update job submitted can also be tracked in the VMware tasks
window.
Updating Firmware on Adapters in a Host
On the system where OneCommand Manager for VMware vCenter is installed, make
sure the port numbers configured during the installation are open and dedicated to the
OneCommand Manager for VMware vCenter server only. No other service should be
listening on this port.
Before you can perform a batch update, the firmware file must be downloaded from the
Emulex website and extracted to a directory on your local drive.
To update firmware for compatible adapters:
1. Click Update Firmware.
Note: You do not need to select a particular tree element for this operation.
The Batch Firmware Download dialog box appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
155
7. Updating Firmware
Updating Firmware on Adapters in a Host
Figure 7-5 Empty Batch Firmware Download Dialog Box
2. Click Browse. The Firmware File Selection dialog box appears. Select the file you
want to use and click OK. A status message appears indicating that OneCommand
Manager for VMware vCenter is searching for compatible adapters.
Once compatible adapters are found, the Firmware File field of the Batch Firmware
Download dialog box shows the selected image file name. The Supported Models
field shows a list of all adapter models that are compatible with the selected image
file. The set of compatible adapters shows in the dialog box’s tree-view
Figure 7-6 Populated Batch Firmware Download Dialog Box
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
156
7. Updating Firmware
Updating Firmware on Adapters in a Host
The tree-view shows all adapters and their corresponding hosts for which the
selected firmware file is compatible. Use the checkboxes next to the host and
adapter entries to select or deselect an entry. Checking an adapter selects or
removes that adapter; checking a host removes or selects all eligible adapters for
that host.
To view the compatible adapters in a fabric-centric mode, select the Group by
Fabric checkbox.
For adapters where each individual port can have new firmware installed, you can
select the ports on the adapter to which you want to download firmware.
3. Make your selections and click Start Download. A message prompting you to
confirm the firmware update appears, click Yes.
When the update begins, a status message in the Active Job window shows the
progress as either “Job is in progress” or “Waiting in queue to start”. The ports on
which the firmware is being downloaded have the status “Job is in progress” the
others have “Waiting in queue to start”. You can select the checkbox to cancel the
jobs with status “Waiting in queue to start”. When download is completed, the
entry moves to the Completed Jobs window. The status message field in the
Completed Jobs window shows the status of the completed job.
Notes:


If you start firmware update and log out from the vSphere console before
the firmware update is completed, all pending jobs fail.
The firmware update progresses in the background until all the jobs are
completed. During this period you can still browse through the other tabs.
Figure 7-7 Jobs Window
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
157
7. Updating Firmware
Updating Firmware on Adapters in a Host
Jobs Window Field Definitions
Active Jobs Area






User – The user who triggered the firmware update.
Host – The IP address of the host to which the adapter/port belongs.
Adapter – The model of the adapter.
Port – The port WWN for an FC adapter. This field is blank for a UCNA.
Start Time – The time that the job is submitted.
Status Message – The status of the job.
Completed Jobs Area







User – The user who triggered the firmware update.
Host – The IP address of the host to which the adapter/port belongs.
Adapter – The model of the adapter.
Port – The port WWN for an FC adapter. This field is blank for a UCNA.
Start Time – The time that the job is submitted.
End Time – The time that the job is completed.
Status Message – The status of the job.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
158
7. Updating Firmware
Updating Firmware on Adapters in a Host
Updating Firmware for an Adapter
To update firmware for an FC port:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the adapter for which you
want to update firmware.
3. Select the Maintenance tab and click Update Firmware. If a warning screen
appears, click Yes. The Firmware Download dialog box appears.
Figure 7-8 Firmware Download dialog box
4. Click Browse and navigate to the unzipped, extracted image file you want to
download.
5. On the browse window, select the file and click OK. The Firmware Download
dialog box appears.
6. Click Start Update. A message prompting you to confirm the firmware update
appears.
7. Click Yes. When the update begins, the Jobs window is displayed (Figure 7-9). A
status message in the Active Job list shows the progress of the download. The ports
on which the firmware is being downloaded have the status “Job is in progress”,
the others have “Waiting in queue to start”. When download is completed, the
entry moves to the Completed Jobs window. The status message field in the
Completed Jobs window shows the status of the completed job.
Notes:

If you start a firmware update and log out from the vSphere console before
the firmware update is completed, all pending jobs fail.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
159
7. Updating Firmware
Updating Firmware on Adapters in a Host

The firmware update progresses in the background until all the jobs are
completed. During this period you can still browse through the other tabs.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
160
7. Updating Firmware
Updating Firmware on Adapters in a Host
Jobs Window for an FC Port
The Jobs window provides information and active and completed jobs.
Figure 7-9 Jobs Window
Jobs Window Field Definitions
Active Jobs Column Definitions







User – The user who triggered the firmware update.
Host – The IP address of the ESXi host to which the adapter or port belongs.
Adapter – The model of the adapter selected for the firmware update request.
Port – The Port WWN selected for the firmware update. This field is applicable
for FC ports only.
Start Time – The time the firmware update is submitted.
End Time – The time of completion of the firmware update.
Status Message – The status of the firmware update action. This field also
indicates if a reboot is required to activate the firmware.
Completed Jobs Column Definitions







User – The user who triggered the firmware update.
Host – The IP address of the host to which the adapter/port belongs.
Adapter – The model of the adapter.
Port – The port WWN for an FC adapter. This field is blank for a UCNA.
Start Time – The time the job is submitted.
End Time – The time the job is completed.
Status Message – The status of the job.
Jobs Window Buttons
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
161
7. Updating Firmware
Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series Adapters


Update Firmware – Click to update firmware on a different adapter in the same
cluster.
Cancel Updates – Click to cancel the jobs with “Waiting in queue to start”
status.
Updating Firmware for OCe10100–Series,
OCe11100–Series, and OCe14100–Series Adapters
For OCe10100-series, OCe11100-series, and OCe14100-series adapters, you update the
firmware for the entire adapter and not for individual ports.
To update firmware for an adapter:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the adapter for which you
want to update firmware information.
3. Select the Maintenance tab (Figure 6-48) and click Update Firmware. If a warning
message appears, click Yes. The Firmware Download dialog box appears.
Figure 7-10 Firmware Download Dialog Box
4. Click Browse and navigate to the unzipped, extracted image file you want to
download.
5. On the browse window, select the file and click OK.
6. Click Start Update.
When the update begins, the Jobs window is displayed (Figure 7-7). A status
message in the Active Job list shows the progress of the download. The ports on
which the firmware is being downloaded have the status “Job is in progress”, the
other ports display the “Waiting in queue to start” status.
When the download has completed, the entry moves to the Completed Jobs
window. The status message field in the Completed Jobs window shows the status
of the completed job.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
162
7. Updating Firmware
Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series Adapters
You can monitor jobs submitted through the OneCommand Manager for VMware
vCenter Command Line Interface. If you start a firmware update and log out from
the vSphere console before the firmware update is completed, all pending jobs fail.
The firmware update progresses in the background until all the jobs are completed.
During this period, you can still browse through the other tabs. The firmware
update job submitted can also be tracked in the VMware tasks window.
Figure 7-11 Jobs Window
7. Open Firmware Summary and the updated firmware information for the selected
adapter is displayed.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
163
8. Exporting SAN Information in Cluster View
Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series Adapters
8. Exporting SAN Information in Cluster View
Exporting SAN information (creating a SAN report) progresses in the background until
all the jobs are completed. During this period you can still browse through the other
tabs.
Note: Creating a SAN report can take several minutes for a large SAN.
To export SAN information:
1. Select a cluster in the vSphere console tree-view and select the Emulex
OneCommand tab.
2. From the Emulex Device Management tree, select Export San Info. The export SAN
Info pane is displayed (Figure 8-1, Export SAN Info, on page 164).
3. Click Export San Info. The Export SAN Info dialog box is displayed (Figure 8-2 on
page 165).
4. Select host or hosts to export. Optionally, select the Select/Deselect All checkbox to
select all hosts. Clear the Select/Deselect All checkbox to clear all host checkboxes.
5. Click Export.
The Export SAN Info Jobs window is displayed. The status is displayed in the
Active Jobs list (Figure 8-3 on page 165).
When the export job is completed, the entry is displayed in the Completed Jobs list
with a “Successfully completed” status.
Figure 8-1 Export SAN Info
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
164
8. Exporting SAN Information in Cluster View
Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series Adapters
Figure 8-2 Export SAN Info Dialog Box
Figure 8-3 Export SAN Info Jobs Window, Active Jobs List
Export SAN Info Window Field Definitions
Active Jobs Column Definitions



User – The user who triggered the firmware update.
Start Time – The time the job is submitted.
Status Message – The status of the job.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
165
8. Exporting SAN Information in Cluster View
Updating Firmware for OCe10100–Series, OCe11100–Series, and OCe14100–Series Adapters
Completed Jobs Column Definitions





User – The user who triggered the firmware update.
Start Time – The time the job is submitted.
End Time – The time the job is completed.
Status Message – The status of the job.
Download – Click XML or CSV to download the file with SAN information in
the specified format.
Jobs Window Buttons

Export SAN Info – Click to update firmware on a different adapter in the same
cluster.
Capturing SAN Information in XML or CSV Format
1. Click the row that represents the information you want to capture.
2. Scroll to the right until the Download column appears.
3. In the Download column, click XML or CSV to capture the information.
Considerations When Exporting SAN Information in a
Cluster View


At any time only ten completed jobs are available to be exported. If more than
ten jobs are completed, the first completed jobs are not available for download.
If you click Export SAN Info and log out from the vSphere console before the
export is completed, all pending jobs fail.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
166
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
When running port diagnostic tests using OneCommand Manager for VMware
vCenter, do not perform any active management operations on the ESXi host.
Running Loopback Tests
There are three loopback tests that you can run for the FC adapter port:



PCI Loopback – A firmware controlled diagnostic test in which a random data
pattern is routed through the PCI Bus without being sent to an adapter link
port. The returned data is subsequently validated for integrity.
Internal Loopback – A diagnostic test in which a random data pattern is sent
down to an adapter link port, then is immediately returned without actually
going out on the port. The returned data is subsequently validated for integrity.
External Loopback – A diagnostic test in which a random data pattern is sent
down to an adapter link port. The data goes out of the port and immediately
returns via a loopback connector. The returned data is subsequently validated
for integrity.
To run loopback tests:
1. From the Emulex Device Management tree-view, select the FC adapter physical
port on which you want to run the loopback test.
2. Select the Diagnostics tab. In the Loopback Test area of the dialog box, choose the
type of loopback test you want to run and define the loopback test parameters.
Figure 9-1 FC Adapter Diagnostics Tab
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
167
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Note: You must insert a loopback plug in the selected adapter before running an
External Loopback test. Also, you must ensure that the NIC function of the
port goes to a link up state.
3. Click Start Test. The following warning appears:
Figure 9-2 Diagnostic Tests Warning
4. Click Yes. A progress bar shows that the test is running.
5. Periodic test feedback, consisting of the current loopback test/cycle plus the
completion status of each type of test, is displayed in the Test Status section of the
dialog box. Click Show Test Logs to view and save the log file (Figure 9-14).
Running End to End (ECHO) Tests
Run echo tests using the End-to-End (ECHO) Test section of the Diagnostics tab. The
end-to-end test enables you send an ECHO command/response sequence between an
adapter port and a target port.
To run end-to-end echo tests:
1. From the Emulex Device Management tree-view, select the FC adapter physical
port on which you want to initiate the End-to-End (ECHO) test.
2. Select the Diagnostics tab. In the End-to-End (Echo) Test area, select Echo Test.
3. Enter the WWPN for the target. The Diagnostic Test warning appears (Figure 9-13).
4. Click Yes. A result screen appears and the test results appear in the Test Log.
5. Click Clear to erase the contents of the log display or click Save to File to save the
log file.
Note: The ECHO test button is enabled only if its port has targets connected.
Running D_Port Tests (LPe16000–Series FC Adapters)
D_Port is a diagnostic mode supported by Brocade switches only for the LPe16000
family of FC adapters with D_Port support.
Note: D_Port is also referred to as ClearLink.
D_Port tests detect physical cabling issues that can result in increased error rates and
intermittent behavior. When activated, D_Port tests include:


Local electrical loopback
Loopback to the remote optics
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
168
9. Diagnostics
LightPulse FC HBA Diagnostic Tests



Loopback from the remote port to the local optics
A full device loopback test with data integrity checks
An estimate of cable length (to validate that a proper buffering scheme is in
place)
These tests allow a level of fault isolation to distinguish faults due to marginal cable,
optics modules, and connector or optics seating.
To run D_Port tests:
1. From the Emulex Device Management tree-view, select the FC adapter physical
port for which you want to run the D_Port tests.
2. Select the Diagnostics tab and in the Standard Tests area, click Launch.
Figure 9-3 FC Adapter Diagnostics Tab with D_Port Tests Option
3. From the D_Port Tests dialog box, click Start Test.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
169
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Figure 9-4 D_Port Tests Dialog Box
The D_Port tests are launched. If all tests pass, a dialog box similar to Figure 9-5 is
displayed. If all tests do not pass, the Failed result in shown in the Test Phase
Results. See Figure 9-6 for an example.
Click Save Results to File to save the test results to a text file. You can view this text
file in any text editor.
Notes





To stop tests, click Stop Test.
The D_Port tests can take an extended period of time to complete.
If the Overall Test Result is "FAILED", you need to either re-run the tests
successfully or reset the HBA port to bring the link back up.
If an older version of an SFP is used in an adapter's port, which does not fully
support all D_Port tests, some of the test phase results report skipped. If an
older SFP version is detected by the OneCommand Manager for VMware
vCenter, a message is displayed under the results box indicating that the SFP
version does not fully support all D_Port tests.
If a test phase fails, the D_Port diagnostics are automatically stopped. In this
case, some of the phases may not be reported in the results. However, the failed
phase will be reported.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
170
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Figure 9-5 D_Port Tests Dialog Box - Passed Results
Figure 9-6 D_Port Tests Dialog Box - Failed Results
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
171
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Running a Power On Self Test (POST)
The POST is a firmware test normally performed on an adapter after a reset or restart.
The POST does not require any configuration to run.
To run the POST:
1. From the Emulex Device Management tree-view, select the FC adapter physical
port on which you want to run the POST.
2. Select the Diagnostics tab and in the Standard Tests area, click Start Test. A
progress window appears, showing the progress of the POST test.
3. Once the test is completed, the Test Completion Status window appears. Click OK.
A POST window appears with the POST information.
Using Beaconing
Beaconing enables you to force a specific adapter’s LEDs to blink in a particular
sequence. The blinking pattern acts as a beacon, making it easier to locate a specific
adapter among racks of other adapters.
When you enable beaconing for UCNAs, the two LEDs blink rapidly in unison until
you disable beaconing.
Note: Beaconing is disabled if the selected adapter does not support beaconing.
To enable or disable beaconing:
1. From the Emulex Device Management tree-view, select the adapter port whose
LEDs you want to set.
2. Select the Diagnostics tab and click Beacon On or Beacon Off.
Setting Up Diagnostic Test Options
Setting Up a Test Failure Error Action
There are two error action options in the event of a test failure:


Stop Test – Does not log the error and aborts the test. No further tests are run.
Ignore – Logs the error and proceeds with the next test cycle.
Setting Up Test Cycles
Specify one of the following test cycles:



Select an established cycle count by clicking on the corresponding radio button.
Enter a custom cycle count in the blank field in the Test Cycles area.
Set the test to run until you manually click Stop Test, by selecting the Infinite
radio button.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
172
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Setting Up a Test Pattern
Enter a custom test pattern to be used in tests that transfer data. The test pattern can be
up to eight hexadecimal bytes.
Test Status
The Test Status area shows how many completed cycles of each test ran, as well as the
number of errors.
Saving the Log File
You can save the test log to a log file for later viewing or printing. When data is written
to a saved file, the data is appended at the end of the file. Each entry has a two-line
header with the adapter identifier and the date and time of the test. The data
accumulates to form a chronological history of the diagnostics performed on the
adapter.


The default location is the OneCommand Manager for VMware vCenter install
directory on your local drive.
In the VMware Server: There is no default directory for ESXi.
After writing an entry into the log, you are prompted to clear the display. Figure 9-7
shows the Diagnostic Test log entries that will be saved to the log file.
Figure 9-7 Diagnostic Test Log Entries
To save the log file:
1. After running a test from the Diagnostic tab, click Show Test Logs. The Diagnostic
Test Logs dialog box appears. The default name of a saved file is DiagTest.log.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
173
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
2. Browse to the desired directory, change the log file name if you want and click Save
to File.
Creating FC Port Diagnostic Dumps
Diagnostic dump enables you to create and manage a diagnostic dump for a selected
FC port. Dump files contain information, such as firmware version and driver version
for example, that is particularly useful when troubleshooting an adapter.
To start a diagnostic dump:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the FC port.
3. Select the Diagnostic Dump tab. The Diagnostic Dump information pane appears.
Figure 9-8 FC Port Diagnostic Dump Tab
4. Enter a name in the Dump File Directory field in the Dump Details area to set the
dump file directory. A prefix of /vmfs/volumes is added to the location, if it is not
specified.
5. To specify up to 20 files to retain using the Dump Files Retention counter, enter the
number of files and click Update.
6. Click Start Dump to initiate a diagnostic dump on the selected FC port. Click
Delete Existing Dump Files to remove existing dump files for the selected FC port.
Caution:
Disruption of service may occur if a diagnostic dump is run during I/O
activity.
Diagnostic Dump Tab Field Definitions



Serial Number – The port WWN.
Dump File Directory – The location where the dump files are created.
Dump File Retention – The number of dump files per FC port to retain on the
host.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
174
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
Diagnostic Dump Tab Buttons





Modify Dump Directory – Click to modify the dump file directory.
Update – Click to change the dump file retention count.
Delete Existing Files – Click to remove existing dump files from the selected FC
port.
Start Dump – Click to initiate a diagnostic dump on the selected FC port.
Show Dump Files – Click to view the diagnostic dump files generated through
the diagnostic dump feature.
Viewing Diagnostic Dumps Files
Diagnostic dump file names can be viewed using the OneCommand Manager for
VMware vCenter. The dump files are stored on the host’s data store and the vSphere
client can be used to download dump files by browsing the host data store.
To view the FC port diagnostic dump:
1. On the Diagnostic Dump tab, click Show Dump Files. The Diagnostic Dump Files
window opens showing the diagnostic dump files currently on your system. These
files are available in the dump directory configured from the Diagnostic Dumps
tab. You can extract these files using the vSphere client.
Figure 9-9 Diagnostic Dump Files window
2. Extract the dump files by using the vSphere client to download the dump files by
browsing the data store.
a. Click the Configuration tab in the vSphere client. The Datastores view is
displayed (Figure 9-10 on page 176).
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
175
9. Diagnostics
LightPulse FC HBA Diagnostic Tests
b. Right-click the datastore where the dump file is located, and select Browse
Datastore... from the context menu. A Datastore Browser window opens
(Figure 9-11).
c. In the Datastore Browser, right-click the dump file that you want to review and
select Download... from the context menu. A Browse for Folder window opens.
d. Select the desired location for the dump files in the Browse for Folder window
and press OK. The file is down loaded to the location you select.
You can view the dump file in any text editor.
Figure 9-10 Datastores View of vSphere Client
Figure 9-11 vSphere Datastore Browser
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
176
9. Diagnostics
OneConnect Diagnostic Tests
OneConnect Diagnostic Tests
Running Loopback Tests
Note: When running port diagnostic tests using OneCommand Manager for VMware
vCenter, do not perform any active management operations on the ESXi host.
Run the following loopback tests:


PHY Loopback – The PHY loopback test connects the transmit output of the
physical layer to the receive input of the physical layer. The data is transmitted,
received, and checked for data miscompute errors.
MAC Loopback – The MAC loopback test connects the transmit output of the
MAC controller to the receive input of the MAC controller (bypassing the PHY).
To run loopback tests:
1. From the Emulex Device Management tree-view, select the physical port on which
you want to run the loopback test.
2. Select the Diagnostics tab. In the Loopback Test area of the dialog box, choose the
type of loopback test you want to run and define the loopback test parameters.
Figure 9-12 OneConnect Adapter Diagnostics Tab
You must insert a loopback plug in the selected adapter before running an External
Loopback test. Also, you must ensure that the NIC function of the port goes to a
link up state.
3. Click Start Test. The following warning appears:
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
177
9. Diagnostics
OneConnect Diagnostic Tests
Figure 9-13 Diagnostic Tests Warning
4. Click Yes. A progress bar shows that the test is running.
Periodic test feedback, consisting of the current loopback test/cycle plus the
completion status of each type of test, is displayed in the Test Status section of the
dialog box. Click Show Test Logs to view and save the log file (Figure 9-14).
Using Beaconing
Beaconing can force an adapter’s LEDs to blink in a particular sequence. The blinking
pattern acts as a beacon, making it easier to locate a specific adapter among racks of
other adapters.
When you enable beaconing for OneConnect adapters, the two LEDs blink rapidly in
unison until you disable beaconing.
Note: Beaconing is disabled if the selected adapter does not support beaconing.
To enable or disable beaconing:
1. From the Emulex Device Management tree-view, select the adapter port whose
LEDs you want to set.
2. Select the Diagnostics tab and click Beacon On or Beacon Off.
Running a TDR Test (10GBASE–T–Series Adapters Only)
To run a TDR test:
1. From the Emulex Device Management tree-view, select the adapter port on which
you want to run a TDR test.
2. Select the Diagnostics tab.
3. In the TDR area, enter an NVP value. This value compares the cable speed of
reflection versus the speed of light.
4. Click Start TDR Test.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
178
9. Diagnostics
OneConnect Diagnostic Tests
Setting Up Diagnostic Test Options
Setting Up a Test Failure Error Action
There are two error action options in the event of a test failure:


Stop Test – Does not log the error and aborts the test. No further tests are run.
Ignore – Logs the error and proceeds with the next test cycle.
Setting Up Test Cycles
Specify one of the following test cycles:



Select an established cycle count by clicking on the corresponding radio button.
Enter a custom cycle count in the blank field in the Test Cycles area.
Set the test to run until you manually click Stop Test, by selecting the Infinite
radio button.
Setting Up a Test Pattern
Enter a custom test pattern to be used in tests that transfer data. The test pattern can be
up to eight hexadecimal bytes.
Test Status
The Test Status area shows how many completed cycles of each test ran, as well as the
number of errors. Periodic test feedback, consisting of the current loopback test/cycle
plus the completion status of each type of test, is displayed in the Test Status area. Click
Show Test Logs to view and save the log file (Figure 9-14).
Saving the Log File
You can save the test log to a log file for later viewing or printing. When data is written
to a saved file, the data is appended at the end of the file. Each entry has a two-line
header that contains the identifier of the adapter being tested and the date and time of
the test. Over time, the data accumulates to form a chronological history of the
diagnostics performed on the adapter.


The default location is the OneCommand Manager for VMware vCenter install
directory on your local drive.
In the VMware Server: There is no default directory for ESXi.
After writing an entry into the log, you are prompted to clear the display.
Figure 9-14 shows the Diagnostic Test log entries that will be saved to the log file.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
179
9. Diagnostics
OneConnect Diagnostic Tests
Figure 9-14 Diagnostic Test Log Entries
To save the log file:
1. After running a test from the Diagnostic tab, click Show Test Logs. The Diagnostic
Test Logs dialog box appears. The default name of a saved file is DiagTest.log.
2. Browse to the desired directory, change the log file name if you want and click Save
to File.
Creating OneConnect Adapter Port Diagnostic Dumps
Diagnostic dump enables you to create and manage a diagnostic dump for a selected
OneConnect adapter port. Dump files contain information, such as firmware version
and driver version for example, that is particularly useful when troubleshooting an
adapter.
To start a diagnostic dump:
1. Select a host in the vSphere console tree-view and select the Emulex OneCommand
tab.
2. In the Emulex Device Management tree-view, select the port.
3. Select the Diagnostic Dump tab. The Diagnostic Dump information pane appears.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
180
9. Diagnostics
OneConnect Diagnostic Tests
Figure 9-15 Port Diagnostic Dump Tab
4. Enter a name in the Dump File Directory field in the Dump Details area to set the
dump file directory. A prefix of /vmfs/volumes is added to the location, if it is not
specified.
5. To specify up to 20 files to retain using the Dump Files Retention counter, enter the
number of files and click Update.
6. Click Start Dump to initiate a diagnostic dump on the selected FC port. Click
Delete Existing Dump Files to remove existing dump files for the selected
OneConnect port.
Caution:
Disruption of service may occur if a diagnostic dump is run during I/O
activity.
Diagnostic Dump Tab Field Definitions



Serial Number – The port WWN.
Dump File Directory – The location where the dump files are created.
Dump File Retention – The number of dump files per port to retain on the host.
Diagnostic Dump Tab Buttons





Modify Dump Directory – Click to modify the dump file directory.
Update – Click to change the dump file retention count.
Delete Existing Files – Click to remove existing dump files from the selected
OneConnect port.
Start Dump – Click to initiate a diagnostic dump on the selected port.
Show Dump Files – Click to view the diagnostic dump files generated through
the diagnostic dump feature.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
181
9. Diagnostics
OneConnect Diagnostic Tests
Viewing Diagnostic Dumps Files
Diagnostic dump file names can be viewed using the OneCommand Manager for
VMware vCenter. The dump files are stored on the host’s data store and the vSphere
client can be used to download dump files by browsing the host data store.
To view the FC port diagnostic dump in the OneCommand Manager for VMware
vCenter:
1. On the Diagnostic Dump Tab, click Show Dump Files. The Diagnostic Dump Files
window opens showing the diagnostic dump files currently on your system. These
files are available in the dump directory configured from the Diagnostic Dumps
tab. You can extract these files using the vSphere client.
Figure 9-16 Diagnostic Dump Files window
2. Extract the dump files by using the vSphere client to download the dump files by
browsing the data store.
a. Click the Configuration tab in the vSphere client. The Datastores view is
displayed (Figure 9-10 on page 176).
b. Right-click the datastore where your dump file is located, and select Browse
Datastore... from the context menu. A Datastore Browser window opens
(Figure 9-11 on page 176).
c. In the Datastore Browser, right-click the dump file that you want to review and
select Download from the context menu. A Browse for Folder window opens.
d. Select the desired location for the dump files in the Browse for Folder window
and press OK. The file is down loaded to the location you select.
You can view the dump file in any text editor.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
182
10. Troubleshooting
Security
10. Troubleshooting
There are several circumstances in which your system may operate in an unexpected
manner. The Troubleshooting section explains some of these circumstances and offers
one or more solutions for each issue.
Security
The vSphere Web Client server and the OneCommand Manager for VMware vCenter
can be installed on different machines. As a result, certificate or insecure-content
warnings could occur. There are two ways to remedy the problem:


Accept the blocked content – temporary solution
Install a security certificate– permanent solution
Accepting the Blocked Content
The procedure for accepting blocked content depends on the type of browser you are
using. This is not a permanent solution and you will need to repeat this procedure
every time you load the web client. If you want a permanent solution, you must install
the correct security certificate. See “Installing a Security Certificate” on page 184.
Internet Explorer
Accept the blocked content.
Figure 10-1 Blocked Content in Internet Explorer
Chrome and Firefox
1. Load the plug-in URL in a separate tab or window.
The plug-in URL format is:
https://<plugin-server>:<https-port>/elxvcplugin
For example:
https://pluginserverhostFQDN:443/elxvcplugin
Note: You can extract the plug-in server, IP address, host name, and port number
from the browser warning message.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
183
10. Troubleshooting
Security
2. Confirm or accept the certificate warning.
3. Refresh the vSphere web client tab or window.
Figure 10-2 Blocked Content in the Firefox or Chrome Browser
Installing a Security Certificate
A permanent solution to the security warnings is to install the correct security
certificate.
To install a security certificate:
1. Open Internet Explorer in Administrative Mode.
2. Load the plug-in url and accept the certificate warning.
The plug-in url must have the following format:
https://<plugin-server>:<https-port>/elxvcplugin
The page loads with a certificate error.
3. Click on the Certificate Error. A list appears showing the untrusted certificate.
Figure 10-3 Untrusted Certificate
4. Click View certificates in the Certificate Error list. The Certificate dialog box opens.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
184
10. Troubleshooting
Security
Figure 10-4 Certificate Dialog Box
5. Click Install Certificate.... The Certificate Import Wizard opens.
Figure 10-5 Certificate Import Wizard
6. Follow the wizard instructions and install the certificate to the Trusted Root
Certification Authorities location.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
185
10. Troubleshooting
Security
Table 10-1 Troubleshooting Issues and Resolutions
Issue
Resolution
The Emulex OneCommand tab is not visible in
the vSphere console.
In the vSphere console select the Plug-in menu and choose
Manage Plug-ins. In the Plug-in Manager window, check the status
of the Emulex OneCommand Manager for VMware vCenter
(Emulex OneCommand). The status must be “Enabled”. If it is
not, enable it.
On the machine where OneCommand Manager for VMware
vCenter is installed, make sure the port numbers configured
during the installation are open and dedicated to the plug-in
server only. No other service should be listening on this port.
When you select the Emulex OneCommand tab Ensure the version of Adobe Flash player installed is 11.2 or later.
in the vSphere console, a message appears
If you have not installed the Adobe Flash player, you can
indicating that the Adobe Flash player is
download it from the Adobe website.
required.
When you select the Emulex OneCommand tab Ensure that you have the required privileges to view information
in the vSphere console, the Emulex Device
in the vSphere console.
Management tree-view does not display any
elements.
There is slow response from OneCommand
Manager for VMware vCenter.
Ensure that the following are on the same network:
• ESXi servers managed by the OneCommand Manager VMware
for vCenter server
• Systems hosting the OneCommand Manager for VMware
vCenter server
• OneCommand Manager for VMware vCenter
Firmware update fails on a LightPulse or a
On the ESXi host, check the firewall settings and ensure that the
OneConnect adapter, or installing licenses fails HTTP/HTTPS ports are open. Use the following command to
on a OneConnect adapter.
disable the firewall:
esxcli network firewall unload
Firmware update fails with the error message
“Error reading resource”.
Check the following:
• Make sure that you can ping the hostname, on which the
OneCommand Manager for VMware vCenter is installed, from
the ESXi host. If you cannot ping the hostname, either reinstall
providing the reachable IP/hostname (with domain) or add the
host name to the DNS.
• Check the memory space in the ESXi host and clean up the old
logs.
When you make any changes to the ESXi host, Click Refresh in the GUI. If the change is not reflected, restart
such as plugging cables, unplugging cables, or ‘sfcb’ on the ESXi host using the command:
storage references, OneCommand Manager for
/etc/init.d/sfcbd-watchdog restart
VMware vCenter does not reflect the change
Click Refresh again in the GUI.
immediately.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
186
10. Troubleshooting
Security
Table 10-1 Troubleshooting Issues and Resolutions (Continued)
Issue
Resolution
On a Windows 7 x64 operating system,
executing the CLI commands using the
executables results in unnecessary error
traces.
The C disk is highly protected; even the administrator account has
limited privileges. For example, the contents in the directory
“C:\Program Files\” have no write and full control privileges.
To remedy the problem:
• Assign your account write and full control privileges to
“C:\Program Files \”.
-or• Install OneCommand Manager for VMware vCenter on another
disk, for example, D.
When OneCommand Manager for VMware
vCenter loads within the vSphere console, it
shows a Security warning.
See “Security” on page 183.
When the VMware Web Client is launched, it
requires OneCommand Manager for VMware
vCenter to load in another browser tab and
accept the Emulex Certificate.
See “Security” on page 183.
OneCommand Manager for VMware vCenter Version 10.2 User Manual
P010089-01A Rev. A
187
11. Using OneCommand Manager for VMware vCenter Command Line Interface
11. Using OneCommand Manager for VMware
vCenter Command Line Interface
The Command Line Interface (CLI) client component of OneCommand Manager for
VMware vCenter is installed as part of OneCommand Manager for VMware vCenter
installation.
OneCommand Manager for VMware vCenter CLI can manage Emulex adapters in
systems with VMware ESXi 5.0, 5.1, and 5.5 environments.
In order to run any of the CLI commands you must run the elxvcpcmd.exe file, which is
available in the OneCommand Manager for VMware vCenter installation directory
(which is by default C:\Program Files\Emulex). This component is intended for use in
scripted operations within batch files. Each time you run this script from the command
line, a single operation is performed.
Most operations retrieve information about an entity on the storage area network
(SAN) and show that information on the console.
OneCommand Manager for VMware vCenter CLI runs only in TCP/IP mode.
Most of the CLI client commands require one or more additional parameters that
specify the nature of the command. For FC and FCoE ports, the world wide port name
(WWPN) of the adapter must be specified.
To run a command at the cluster level, use:
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> c=<clustername>
<ocm_cmd> [<ocm_cmd_arg>...]
For example, run the following command to export SAN information for a cluster:
elxvcpcmd.exe v=10.192.203.162 u=Administrator
exportsaninfo [csv]
p=password
c=ih123vid34
To run a command at the host level, use:
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> h=<esx_host>
<ocm_cmd> [<ocm_cmd_arg>...]
For example, run the following command to display the port attributes for the adapter
with the specified WWPN:
elxvcpcmd.exe v=10.120.121.122 u=Administrator p=password
h=10.120.121.123 portattributes 10:00:00:00:C9:39:6C:9D
For NIC ports, the MAC address must be specified.
For example, run the following command to display the port attributes for the UCNA
port with the specified MAC address:
elxvcpcmd.exe v=10.120.121.122 u=Administrator p=password
h=10.120.121.123 portattributes 00-11-22-33-44-55
For help purposes only, all commands are grouped together.
For more information about the group help command, see page 189. For more
information about commands in each group, see Table 11-1 on page 190.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
188
11. Using OneCommand Manager for VMware vCenter Command Line Interface
Using the CLI Client
Using the CLI Client
Syntax Rules
The syntax rules for CLI commands are as follows:






All commands must start with elxvcpcmd.exe.
The requested operation must contain at least three characters, or as many as
needed to distinguish it from any other operation.
Whenever a WWPN is specified, individual fields are separated by colons (:).
When a MAC address is specified, the fields are separated by a dash (-).
The parameters must be specified in the order indicated in the syntax.
Parameters that are not required and may be omitted are in square brackets [ ].
The Command Reference
CLI Client commands are supported for Windows only.
help (single command)
Syntax
elxvcpcmd.exe [CmdName] help
Description
This command shows the help for the specific command.
Parameters
CmdName
Any CLI command.
help (group)
Syntax
elxvcpcmd.exe help
Description
This command shows the help for a group. These help groups are categorized based on
the functionality of the commands. Supported groups are: Cluster, Attributes,
AdapterLicense, Personality, Firmware, DriverParameters, WWNManagement, and
TargetAndLuns.
You can specify the group name in the help command to find the commands supported
for a group.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
189
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Table 11-1 Group and Supported Commands
Group
Definition
General
General commands that can be run “setvccred”
on the OneCommand Manager
“version”
application for VMware servers.
AdapterLicense
A set of commands used to read
and manage personality licenses
for an Emulex adapter.
“installadapterlicense”
“showlicenseadapterfeatures”
“showlicenseadapterid”
Adapter Management
(OCe14000 Adapters
only)
Commands to retrieve and set
adapter port configuration.
“getadapterportconfig
(OCe14000–Series Only)”
“setadapterportconfig
(OCe14000–Series Only)”
Attributes
A set of commands used to read
and manage information about an
adapter.
“Example”
“getportstatistics”
“getvpd”
“hbaattributes”
“listhbas”
“portattributes”
“serverattributes”
“setphyportspeed”
“setportenabled”
Boot Group
A set of commands enabling an ESXi “enablebootcode”
host to manage the boot
environment.
Channel Management
A set of commands enabling an
ESXi host to handle Channel
Management.
Cluster
A set of commands that can be run “exportsaninfo”
on a cluster.
“firmwareupdate”
“listhbas”
DCB Group
A set of commands enabling an ESXi “getdcbparams”
host to read and manage DCB
“getpginfo”
parameters for an Emulex adapter. “setcnapgbw”
“setdcbparam”
“setdcbpriority”
OCM for VMware vCenter Version 10.2 User Manual
Supported Commands
“cmgetparams”
“cmmode”
“cmsetbw”
P009805-01A Rev. A
190
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Table 11-1 Group and Supported Commands (Continued)
Group
Definition
Supported Commands
Diagnostic
A set of commands used to run
different diagnostic tests for an
Emulex adapter or port.
“D_Port” (Also known as
ClearLink. Only for LPe16000–
series FC adapters)
“echotest”
“getxcvrdata”
“loadlist”
“loopbacktest”
“posttest”
“setbeacon”
“setcablenvp”
“tdrtest”
DriverParameters
A set of commands enabling an ESXi “driverconfig”
host to read and manage driver
“getdriverparams”
parameters for the host and an
“getdriverparamsglobal”
Emulex adapter.
“saveconfig”
“setdriverparam”
“setdriverparamdefaults”
Dump
A set of commands enabling you to “deletedumpfiles”
create a “dump” file for a selected “dump”
adapter. A dump files is useful
“getdumpdirectory”
when troubleshooting.
“getdumpfilenames”
“getretentioncount”
“setdumpdirectory”
“setretentioncount”
FCoE
A set of commands enabling an ESXi “getfcfinfo”
host to read and manage FCoE
“getfipparams”
functions for an Emulex adapter.
“setfipparams”
Firmware
A set of commands enabling an ESXi “firmwareupdate”
host to update the firmware for an
Emulex adapter or port.
iSCSI Group
A set of commands enabling an ESXi “clearisnsserver”
host to read and manage iSCSI
“getinitiatorproperties”
functions for an Emulex adapter.
“getiscsiportstats”
“getsessioninfo”
“listprofiles”
“showisnsserver”
“updateisnsserver”
Personality
A set of commands enabling an ESXi “changepersonality”
host to read and manage
“showpersonalities”
personalities for an Emulex
adapter.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
191
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Table 11-1 Group and Supported Commands (Continued)
Group
Definition
Supported Commands
SR-IOV
A set of commands that allows
“listvfuncs”
multiple VFs to be created on a NIC “sriovenable”
PF for an adapter port..
Note: SR-IOV is not supported with
UMC channel management.
TargetAndLuns
A set of commands enabling an ESXi “getiscsiluns”
host to read targets and LUNS
“getlunlist”
attached to the port on an Emulex “showtarget”
adapter.
“targetmapping”
VEPA
A set of commands that show the
VEPA state and enable/disable the
VEPA state.
“VEPAenable”
Note: VEPA commands are only
supported on the
OCe14000–series adapters.
Note: VEPA commands require that
SR-IOV is enabled.
Virtual Machines
A set of commands enabling an ESXi “listvms”
host to find Virtual Machines and
“listvports”
their attached ports.
WWWNManagement
A set of commands enabling an ESXi “changewwn”
host to read and manage the WWN “getwwncap”
details for the port on an Emulex
“readwwn”
adapter.
“restorewwn”
Example
elxvcpcmd.exe
attributes help
Information returned
Commands for Attributes
listhbas, hbaattributes, portattributes, pcidata, getvpd
Parameters
None.
changepersonality
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
changepersonality <WWPN | MAC> <type> [FCoE\iSCSI\NIC]
OCM for VMware vCenter Version 10.2 User Manual
<h=ESXhostIP>
P009805-01A Rev. A
192
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command changes the valid personality of the adapter to which the specified port
belongs.
Note: This command is not supported for the OCe14000–series adapters. Use the
"setadapterportconfig" command for these adapters.
Parameters=
h
The IP address of the ESXi host with Emulex adapter.
WWPN
The port’s WWPN of any FCoE function on the adapter.
MAC
The MAC address of the NIC or iSCSI port.
[FCoE\iSCSI\NIC]
The changed personality that is activated upon a system reboot.
pid
A profile ID to use for NIC.
Example
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.203.195
changepersonality 00-00-c9-12-34-56 nic 21
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.203.195
showpersonalities 00-00-c9-12-34-56
Active Profile ID:
23
Configured Profile ID: 21
Adapter Personalities:
NIC
iSCSI
FCoE (active)
changewwn
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
changewwn <WWPN> <New WWPN> <New WWNN> <ReadType>
<h=ESXhostIP>
Description
This command changes the WWN of the specified port.
Parameters
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The port’s WWPN.
ReadType
0 = Volatile, 1 = Non-volatile.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
193
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
clearisnsserver
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> clearisnsserver <MAC>
Description
This command clears the configured iSNS server and disables iSNS target discovery for
a given port. If there is no iSNS server currently configured, this command does
nothing.
Parameters
v
The IP address of the vCenter server managing the ESXi host.
u
The user name of the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
cmgetparams
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> cmgetparams <WWPN | MAC>
Description
This command shows the active (booted) mode (NPar or disabled) for the adapter. This
command also shows the channel management state of the adapter, the configured
state of the adapter, the configured channel management mode, which is N/A if
disabled, and available channel management modes. This is followed by a table
showing the port's channels and their channel properties. The Type column in the table
shows which protocol is running on each channel. Because the displayed channels are
based on all physical ports, some adapters show only two or three channels instead of
four because that is all the physical port allows.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
WWPN of an FCoE function on the physical port.
MAC
MAC address of any NIC function on the physical adapter port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
194
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Example (all NIC)
elxvcpcmd.exe v=10.20.30.40 u=username p=password h=10.11.12.13 CMGetParams
00-00-c9-12-34-56
Active state:
Disabled
Configured mode: None
Available modes: vNIC1, SIMode, UFP
elxvcpcmd.exe v=10.20.30.40 u=username p=password h=10.11.12.13 CMGetParams
00-00-c9-12-34-56
Active state:
Disabled
Configured mode: SIMode
Available modes: vNIC1, SIMode, UFP
UMC Enabled : Yes
Chan#
----0
1
2
3
Type
---NIC
NIC
NIC
NIC
MAC Address
----------------00-00-c9-bb-cc-aa
00-00-c9-bb-cc-ab
00-00-c9-bb-cc-ac
00-00-c9-bb-cc-ad
Logical
Link State
---------Enabled
Disabled
Enabled
Enabled
LPVID
----2
3
4
5
Min BW
-----25
0
25
50
Max BW
-----50
50
50
75
Example (Multichannel enabled, UMC, Mixed Mode)
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 cmgetparams
00-00-c9-12-34-56
Active Mode:
UMC
Configured mode: UMC
Available modes: UMC
Func#
----0
1
2
3
Type
----NIC
FCoE
NIC
NIC
MAC Address
LPVID Min BW Max BW
----------------- ----- ------ -----00-00-c9-12-34-56 2
25
50
n/a
n/a
40
100
00-00-c9-12-34-58 4
25
50
00-00-c9-12-34-59 5
10
20
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 CMGetParams
00-00-c9-12-34-57
Active Mode:
UMC
Configured mode: UMC
Available modes: UMC
Func#
----0
1
2
3
Type
----NIC
iSCSI
NIC
NIC
MAC Address
LPVID Min BW Max BW
----------------- ----- ------ -----00-00-c9-12-34-56 2
25
50
00-00-c9-12-34-57 n/a
30
100
00-00-c9-12-34-58 4
25
50
00-00-c9-12-34-59 5
20
50
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
195
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 cmgetparams
00-00-c9-12-34-58
Active Mode:
UMC
Configured mode: UMC
Available modes: UMC
Func#
----0
1
2
3
Type
----NIC
FCoE
NIC
NIC
MAC Address
LPVID Min BW Max BW
----------------- ----- ------ -----00-00-c9-12-34-56 2
25
50
n/a
n/a
40
100
00-00-c9-12-34-58 4
25
50
00-00-c9-12-34-59 5
10
20
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 CMGetParams
00-00-c9-12-34-59
Active Mode:
UMC
Configured mode: UMC
Available modes: UMC
Func#
----0
1
2
3
Type
----NIC
iSCSI
NIC
NIC
MAC Address
LPVID Min BW Max BW
----------------- ----- ------ -----00-00-c9-12-34-56 2
25
50
00-00-c9-12-34-57 n/a
30
100
00-00-c9-12-34-58 4
25
50
00-00-c9-12-34-59 5
20
50
Example (NPar enabled - 4 functions/port)
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 cmgetparams
00-00-c9-12-34-56
Active Mode:
NPar
Configured mode: NPar
Available modes: NPar
Func#
----0
1
2
3
Type
----NIC
iSCSI
FCoE
NONE
MAC Address
Min BW Max BW
----------------- ------ -----00-00-c9-12-34-56
40
75
00-00-c9-12-34-57
20
100
00-00-c9-12-34-58
40
100
00-00-c9-12-34-59
0
0
cmmode
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> cmmode <WWPN | MAC Address> <None | Type>
Description
This command enables or disables channel management on an adapter.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
196
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Note: A system reboot is required for the change to take effect.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
WWPN of an FCoE function on the physical port.
MAC
MAC address of any NIC function on the physical adapter port.
None|Type
Specify None to disable channel management or specify a channel
management type to enable channel management.
Example:
This example shows that the channel management on an adapter containing a NIC
function with a MAC address of [00-00-c9-ad-ad-aa] is disabled.
elxvcpcmd.exe v=10.20.30.40 u=username p=password h=10.11.12.13 CMMode
00-00-c9-bb-cc-aa None
cmsetbw
Note: This command is not available for 1 Gb ports.
Syntax
>elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> cmsetbw <WWPN | MAC> <Min0,Max0> <Min1,Max1>...[MinN,MaxN]
Description
This command sets the minimum and maximum bandwidth for up to N channels each
on the physical port (where N is number of channels enabled on the adapter). The total
of the minimum bandwidths must add up to 100%. The total of the maximum
bandwidths must be greater than or equal to the minimum bandwidths and have a
maximum of 100%. When only three channels are available, specifying Min3,Max3
causes an error. When only two channels are available, specifying Min2,MaxB2 and
Min3,Max3 causes an error.
When in channel management mode, you can disable a channel’s logical link by setting
the minimum bandwidth and the maximum bandwidth to 0. If a channel’s protocol is
set to None, the minimum and maximum bandwidth must be 0. Setting the minimum
bandwidth to a value greater than 0 enables the channel if it was previously disabled.
Notes:

For OCe14000–series adapters (with NPar disabled), the total minimum
bandwidth must add up to 0 or 100%. If the adapter is enabled for NPar, the
total minimum bandwidth must add up to 100%.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
197
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference



The maximum bandwidth of a channel must be greater than or equal to the
minimum bandwidth for that channel up to a maximum of 100.
This command fails if the current channel management mode is vNIC1 or UFP,
or None.
When channel management is enabled, a system reboot is not required for the
change take effect.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
WWPN of an FCoE function on the physical port.
MAC
MAC address of any NIC function on the physical adapter port.
Bandwidth Value
Note: The number of channels and the max value of N are adapter model
specific.
Min0,Max0
Minimum and maximum bandwidths for channel 0
Min1,Max1
Minimum and maximum bandwidths for channel 1
MinN,MaxN
Minimum and maximum bandwidths for channel 2
Example
elxvcpcmd.exe v=10.20.30.40 u=username p=password h=10.11.12.13CMSetBW
00-00-c9-bb-cc-aa 25,50 50,75 0,0 25,100
> elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
cmgetparams 00-00-c9-12-34-56
Active mode:
UMC
Configured mode: UMC
Available modes: UMC
Func#
----0
1
2
3
Type
----NIC
iSCSI
NIC
NIC
MAC Address
LPVID Min BW Max BW
----------------- ----- ------ -----00-00-c9-12-34-56 2
25
50
00-00-c9-12-34-57 n/a
50
100
00-00-c9-12-34-58 3
0
0
00-00-c9-12-34-59 4
25
50
deletedumpfiles
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> deletedumpfiles <WWN | MAC>
Description
This command deletes all diagnostic dump files for a given port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
198
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
driverconfig
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> driverconfig <WWPN> <FileName> <Flag>
Description
This command sets all driver parameters to the values in the .dpv file on a particular
ESXi host. The .dpv file’s driver type must match the driver type of the host platform
FC/FCoE adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
FileName
The name of the .dpv file (stored in the Emulex Repository directory)
Flag
G = Makes change global (all adapters on this host)
N = Makes change non-global (adapter-specific)
D_Port
elxvcpcmd.exe v=10.192.000.000 u=root p=password d_Port WWPN
Description
The D_Port diagnostic is also known as ClearLink. The D_Port diagnostic is run from
the OneCommand Manager for VMware vCenter CLI by specifying the d_Port
command.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
199
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
p
The user password for the vCenter server.
WWPN
The WWPN of the FC function of the adapter on which to run tests.
Considerations for running DPort





It is not possible to detect if the switch can run D_Port tests before running the
tests. Therefore, a test failure occurs if the D_Port command is run with a switch
that does not support D_Port.
To terminate tests while they are running, type <CTL> + <C>. In this case no
results are given.
If the overall test result is FAILED, you must re-run the tests successfully or
reset the HBA port to bring the link back up. A message is displayed instructing
you to perform one of these actions if the overall test result is FAILED.
If a test phase fails, the D_Port tests are automatically stopped. In this case,
some of the phases may not be reported in the results. However, the failed
phase will be reported.
More than one error can be reported. In this case, multiple lines are displayed
for the test phase showing each error.
Examples
Successful Test Example
elxvcpcmd.exe v=10.192.203.184 u=root p=password d_port 10:00:00:c9:11:2b:38:b4
Running tests, please wait…
Start time:
Wed Oct 2 01:41:35 2013
[After a period of time, the output similar to the following is displayed]
End time:
Status:
Frame Size:
Frame Count:
Roundtrip Link Latency:
Estimated CableLength: 20
Wed Oct 2 01:45:23 2013
PASSED
2000
5000
1108 nano-seconds
meters
==============================================================
Test Phase
Result
Latency
Local Error
Remote Error
==============================================================
Electrical Loopback
Optical Loopback
Reverse Optical Loopback
Link Traffic
Reverse Link Traffic
PASSED
PASSED
PASSED
PASSED
PASSED
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
n/a
==============================================================
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
200
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Status:
PASSED
Frame Size:
2000
Frame Count:
5000
Roundtrip Link Latency:
1108 nano-seconds
Estimated CableLength: 20 meters
=============================================================================
Test Phase
Result Latency Local Error
Remote Error
==============================================================================
Electrical Loopback
PASSED n/a
n/a
n/a
Optical Loopback
PASSED n/a
n/a
n/a
Reverse Optical Loopback PASSED n/a
n/a
n/a
Link Traffic
PASSED n/a
n/a
n/a
Reverse Link Traffic
PASSED n/a
n/a
n/a
=============================================================================
Failed Test Example
elxvcpcmd.exe v=10.192.203.184 u=root p=password d_port 10:00:00:c9:11:2b:38:b5
Running tests, please wait…
Start time:
Wed Oct 2 01:49:25 2013
End time:
Wed Oct 2 01:52:41 2013
Status:
FAILED
Frame Size:
2000
Frame Count:
5000
Roundtrip Link Latency:
1108 nano-seconds
Estimated Cable Length: 20 meters
==============================================================================
Test Phase
Result Latency Local Error
Remote Error
==============================================================================
Electrical Loopback
PASSED n/a
n/a
n/a
Optical Loopback
PASSED n/a
n/a
n/a
Reverse Optical Loopback PASSED n/a
n/a
n/a
Link Traffic
PASSED n/a
n/a
n/a
Reverse Link Traffic
FAILED n/a
Link resets received Link Failures
==============================================================================
dump
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> dump <WWPN | MAC> core [Options]
Description
This command performs a core dump on a local port (OCe11102 or OCe10102). The
dump file is placed in the dump directory with the following filename format:
<Hostname>_<Adapter serial number>_<datetimestamp>.core
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
201
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
If the command is successful, the following message is displayed:
Dump Successful.
Note: Since this command is dumping memory, it can take time while generating
large files.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the UCNA port.
Options
Additional options are available under the direction of Emulex Technical
Support.
echotest
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> echo <WWN | MAC> <Destination WWPN> <Count> <StopOnError>
[Pattern]
Description
This command runs a loopback test on a given FC, FCoE, NIC or iSCSI port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
Destination WWPN
WWPN of the destination (echoing) adapter.
Count
The number of times to run the test (0 = run test infinitely,
Range = 1...99,999).
StopOnError
Checks if the test must be halted on error.
0 = No halt
1 = Halt
Pattern
(optional)
One to eight hexadecimal bytes to use for loopback data (for
example: 1a2b3c4d).
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
202
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Example
elxvcpcmd.exe v=10.20.30.40 u=user p=password h=1.2.3.4 echo
10:00:00:c9:12:34:56 10:00:00:c9:ab:cd:ee 100 1 1a2b3c4d5e
enablebootcode
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> enablebootcode <WWPN | MAC> [Flag][NetworkBootMethod]
Description
This command enables or disables the bootBIOS state on a given port by enabling or
disabling the boot code on the FC adapter, the PXE BIOS or the iBFT for 16GB ports of
the NIC on the UCNA.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex
adapters.
MAC
The MAC address of the UCNA port.
Flag
0 – disable BootBIOS state.
1 – enable BootBIOS state.
NetworkBootMethod
Network boot method to be used by the NIC.


iBFT
PXE
exportsaninfo
Note: Emulex recommends that you redirect this output to a file with a proper
extension, .xml for XML-formatted files and .csv for CSV-formatted files. Due to
the amount of information that must be obtained and reported, this command
can take a long time on large SAN configurations.
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> <c=clustername>
exportsaninfo [format]
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
203
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Note: [format] is optional. If the format parameter is specified as csv, the
adapter information is shown in csv format. If the format parameter is
specified as xml, the adapter information is shown in xml format.
Leaving the format parameter blank shows the data in xml format.
Description
This command exports all SAN information related to Emulex adapters in all the hosts
in a cluster. This command is supported only at the cluster level.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
c
The cluster name.
Format
csv – The output information in CSV format.
xml – The output information in XML format (default).
firmwareupdate
Syntax
For a cluster:
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> c=<clustername>
firmwareupdate [all|WWNs|MACs] <filelocation>
For a host:
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> h=<ESXhostIP>
firmwareupdate [all|WWNs|MACs] <filelocation>
Description
This command updates the firmware on the Emulex adapters found in the specified
VMware cluster or the ESXi host.
Procedure
1. Run the firmwareupdate command. A list of adapter serial numbers (for UCNAs)
or port WWNs (for FC adapters) are displayed, applicable to the firmware file
specified.
2. Select the adapter or port option to use for the update. List, Range, All or Choice
options are displayed.
The firmware update process begins and returns the result for each adapter or port.
3. If you press <Ctrl> + <C> and the firmware update process has started on any
adapter or port, the update continues. But if the firmware update process is queued,
the update is cancelled.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
204
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Note: The optional argument [all|WWNs|MACs] updates the firmware without
any user prompt. Either all or a combination of WWNs and MACs can be
given as an option.
You can view the status of submitted firmware jobs on the Maintenance tab of the
cluster or host.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
c
The cluster name in the vSphere console.
h
The IP address of the ESXi host with Emulex adapters.
all|WWNs|MACs
(optional)
The all optional argument updates all compatible adapters or ports
without any user prompt. The WWNs or MACs optional argument
updates the port WWNs or MACs belonging to a specified cluster or
host without any user prompt.
file_location
The firmware file path on the local disk.
getadapterportconfig (OCe14000–Series Only)
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc username> p=<vc password> h=<esx host>
GetAdapterPortConfig <MAC|WWPN>
Description
The command shows the active and configured (after reboot) adapter port
configurations including the total number of ports, the maximum number of FCoE and
iSCSI functions that can be defined, and if the adapter allows mixed mode storage and
concurrent mode storage. The number of functions per port depends upon the current
setup of the adapter (i.e. mixed or concurrent storage mode, multichannel, NPar).
Depending upon the presence of NParEP on a host, this command may show more
functions per port than are actually running on the host.
Note: For multichannel and NPar configurations, this command only shows the port
protocol assignments. For the entire multichannel configuration use the
cmgetparams command.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
205
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
WWPN
The WWPN of the FCoE port.
MAC
The MAC address of the NIC or iSCSI port.
Examples
Mixed Mode
hbacmd getadapterportconfig 00-00-c9-12-34-56
Number of Ports
: 4
Maximum FCoE Functions : 4
Maximum iSCSI Functions : 4
Mixed Mode I/O Allowed : Yes
Concurrent Mode I/O Allowed : No
RebootRequired
: No
Active Configuration
Profile ID : 37
MCType:None
Port Assignments:
Port 0: NIC,iSCSI
Port 1: NIC,iSCSI
Port 2: NIC,FCoE
Port 3: NIC,FCoE
Reboot Configuration
Profile ID : 37
MCType:None
Port Assignments:
Port 0 (p0): NIC,iSCSI
Port 1 (p1): NIC,iSCSI
Port 2 (p2): NIC,FCoE
Port 3 (p3): NIC,FCoE
Note:(pN) labels are the port parameter names to use in the
SetAdapterPortConfig command (e.g. p0=NIC,FCoE p1=NIC,iSCSI).
Concurrent Mode – Two–Port Adapter (port number starting at one)
hbacmd getadapterportconfig 00-00-c9-12-34-56
Number of Ports
: 2
Maximum FCoE Functions : 4
Maximum iSCSI Functions : 4
Mixed Mode I/O Allowed : Yes
Concurrent Mode I/O Allowed : Yes
RebootRequired
: Yes
Active Configuration
Profile ID : 37
MCType
: None
Port Assignments:
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
206
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Port 1: NIC,iSCSI,FCoE
Port 2: NIC,iSCSI,FCoE
Reboot Configuration (reboot required!)
Profile ID : 23
MCType
: None
Port Assignments:
Port 1 (p0): NIC,FCoE,None
Port 2 (p1): NIC,FCoE,None
Note:(pN) labels are the port parameter names to use in the
SetAdapterPortConfig command (e.g. p0=NIC,FCoE p1=NIC,iSCSI).
UMC- Concurrent Mode
hbacmd getadapterportconfig 00-00-c9-12-34-56
Number of Ports
: 4
Maximum FCoE Functions : 4
Maximum iSCSI Functions : 4
Mixed Mode I/O Allowed : Yes
Concurrent Mode I/O Allowed : Yes
RebootRequired
: No
Active Configuration
Profile ID : 37
MC Type
: UMC
Port Assignments:
Port 0: NIC,iSCSI,FCoE,NIC
Port 1: NIC,iSCSI,FCoE,NIC
Port 2: NIC,FCoE,NIC,NIC
Port 3: NIC,iSCSI,NIC,NIC
Reboot Configuration
Profile ID : 37
MC Type
: UMC
Port Assignments:
Port 0 (p0): NIC,iSCSI,FCoE,NIC
Port 1 (p1): NIC,iSCSI,FCoE,NIC
Port 2 (p2): NIC,FCoE,NIC,NIC
Port 3 (p3): NIC,iSCSI,NIC,NIC
Note:(pN) labels are the port parameter names to use in the
SetAdapterPortConfig command (e.g. p0=NIC,FCoE p1=NIC,iSCSI).
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
207
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
getbeacon
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getbeacon <WWPN | MAC>
Description
This command shows the current beacon state, ON or OFF.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FC or FCoE port.
MAC
The MAC address of the NIC or iSCSI port.
getdcbparams
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getdcbparams <WWPN | MAC>
Description
This command extracts the DCB parameters associated with a given FCoE, NIC or
iSCSI port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FC or FCoE port.
MAC
The MAC address of the NIC or iSCSI port.
getdriverparams
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getdriverparams <WWPN | MAC>
OCM for VMware vCenter Version 10.2 User Manual
<h=ESXhostIP>
P009805-01A Rev. A
208
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command shows the driver parameters of the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FC/FCoE port.
MAC
The MAC address of the NIC or iSCSI port.
getdriverparamsglobal
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getdriverparamsglobal <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows the global driver parameters of the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FC/FCoE port.
MAC
The MAC address of the NIC or iSCSI port.
getdumpdirectory
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getdumpdirectory <WWN | MAC>
Description
This command shows the dump file directory for the FCoE, NIC or iSCSI port in the
host.
Note: The dump directory applies to all adapters in the server. There is not a separate
dump directory for each adapter.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
209
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
getdumpfilenames
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getdumpfilenames <WWPN | MAC>
Description
This command shows a list of all the dump filenames for a given port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
getfcfinfo
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getfcfinfo <WWPN>
Description
This command shows the FCF information of an adapter in FCoE mode.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
210
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
getfipparams
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getfipparams <WWPN>
Description
This command shows the FCoE Initialization Protocol (FIP) parameters of the UCNA in
FCoE mode.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
getinitiatorproperties
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getinitiatorproperties <MAC>
Description
This command shows all the initiator login options for the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
getiscsiluns
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getiscsiluns <MAC> <Target>
<h=ESXhostIP>
Description
This command shows the LUNs attached to the iSCSI target of the specified iSCSI port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
211
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
Target
The name of the iSCSI target.
getiscsiportstats
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getiscsiportstats <MAC>
Description
This command shows all the port statistics for a specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
getlunlist
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getlunlist <WWPN> <TargetWWN>
<h=ESXhostIP>
Description
This command shows the LUNs attached to the FC and FCoE target of the specified
FC/FCoE port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
212
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Target WWPN
The WWPN of the iSCSI target.
getexpresslanelunlist (LPe16000–Series and OCe15100–
Series Only)
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> <h=ESXhostIP>
getexpresslanelunlist <WWPN> <Target WWPN> <Option>
Description
This command shows the LUNs that support ExpressLane and their respective
ExpressLane status.
Note: Only LUNs that support ExpressLane are shown by this command. LUNS
without ExpressLane support are not shown.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FC/FCoE function connected to the target.
Target WWPN
The WWPN of the FC/FCoE target.
Option
Valid options:
0: Get information from the driver
1: Get information from configuration
Example
elxvcpcmd.exe v=10.192.000.000 u=user p=password h=10.192.87.198
getexpresslanelunlist 10:00:00:00:00:87:01:98 20:22:d4:ae:52:6e:6f:08 0
HBACMD_GetLunList: Success
Number of LUNs: 4
FCP_LUN
------------------0000 0000 0000 0000
0001 0000 0000 0000
0002 0000 0000 0000
0003 0000 0000 0000
OS_LUN
--------------------0000 0000 0000 0000
0001 0000 0000 0000
0002 0000 0000 0000
0003 0000 0000 0000
OCM for VMware vCenter Version 10.2 User Manual
ExpressLane LUN
---------------No
Yes
No
Yes
P009805-01A Rev. A
213
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
getpcidata
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getpcidata <WWPN | MAC>
Description
This command shows PCI register details for FC, FCoE, NIC and iSCSI ports.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
getpginfo
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getpginfo <WWPN>
Description
This command shows the priorities and bandwidth percentages for all the priority
groups for the port. Additionally, this command displays the number of priority
groups supported by an adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
getportstatistics
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getportstatistics <WWPN>
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
214
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command extracts the statistics for a designated FC or FCoE port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
getretentioncount
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getretentioncount <WWN | MAC>
Description
This command shows the diagnostic dump file retention count set on a port.
Note: The retention count applies to all adapters in the server.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
getsessioninfo
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getsessioninfo <MAC> <Target> <TSIH | <ISID_Qual Target_IP>>
Description
This command lists all session information for a specified session. You must specify the
iSCSI target name <Target> and either the TSIH <TSIH> of the session or the session's
ISID Qualifier <ISID_Qual> and the target's IP address <Target_IP>. These parameters
tell the command to gather the information from the specified target and session. You
can find the TSIH and ISID qualifier by running the ListSessions command.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
215
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
Target
The target’s iSCSI name enclosed in quotes (string length:11-255).
TSIH
The TSIH value of the session (value: 1-65535).
ISID_Qual
The ISID qualifier of the session (value: 0-65535).
Target_IP
The Target's IP address.
Note: You must specify either the TSIH value or the ISID qualifier. If ISID qualifier is
specified you must also specify the Target’s ID address.
getvpd
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getvpd <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows the VPD details for the specified port on the adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
getwwncap
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
getwwncap <WWPN>
<h=ESXhostIP>
Description
This command shows the WWN capabilities of the specified port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
216
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
getxcvrdata
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> getxcvrdata <WWN | MAC>
Description
This command shows transceiver data such as vendor name and serial number.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
hbaattributes
Syntax
elxvcpcmd.exe
hbaattributes
v=<vcenter server> u=<vc_username> p=<vc_pwd> <h=ESXhostIP>
<WWPN | MAC>
Description
This command shows a list of all adapter attributes for the specified port on the
adapter. This command is supported only at the host level.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
217
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
installadapterlicense
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> installadapterlicense <WWPN | MAC> [Licence File Path]
Description
This command shows a list of the manageable Emulex adapters found by remote
out-of-band (TCP/IP) discovery. For NIC ports, instead of the port WWPN, the MAC
address is displayed. The node WWPN and fabric WWPN are not displayed.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
Licence File Path
The local file path of the license file to be installed.
Note: The InstallAdapterLicense command applies to UCNAs only.
listvfuncs
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> listvfuncs <MAC>
Description
This command shows a list of all the virtual functions discovered.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
MAC address of any NIC function on the physical adapter port
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
218
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
listhbas
Syntax
For a cluster:
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> <c=clustername>
listhbas
For a host:
elxvcpcmd.exe
listhbas
v=<vcenter server> u=<vc_username> p=<vc_pwd> <h=ESXhostIP>
Description
This command shows a list of the manageable Emulex adapters found by remote
out-of-band (TCP/IP) discovery. For NIC ports, instead of the port WWN, the MAC
address is displayed. The node WWN and fabric WWN are not displayed.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
c
The cluster name in the vSphere console.
h
The IP address of the ESXi host with Emulex adapters.
listprofiles
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd> <h=ESXhost>
ListProfiles <WWPN | MAC address>
Description
This command shows a list of the available profile IDs and their descriptions for an
adapter. This command also shows currently active and configured profiled IDs. The
information shown with the command is useful when you are determining the
appropriate profile ID to specify for a ChangePersonality command.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
219
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of an FCoE function on the physical port.
MAC address
The MAC address of any NIC function on the physical adapter port.
Example
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 listprofiles
00-00-c9-12-34-56
Active Profile ID:
23
Configured Profile ID: 23
Available Profiles
ID
-16
17
19
23
24
36
37
38
Description
----------------------------------NIC
ISCSI initiator, no DIF
FCOE initiator + Target, with DIF
FCOE initiator + Target, no DIF
NIC - ETS Disabled
Mixed Storage, 25% ISCSI initiator only, 75% FCOE, no DIF
Mixed Storage, 50% ISCSI initiator only, 50% FCOE, no DIF
Mixed Storage, 75% ISCSI initiator only, 25% FCOE, no DIF
listsessions
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> listsessions <MAC> <Target>
Description
This command lists all the sessions on a specified target. The iSCSI target name
<Target> instructs the command to gather the information from the listed iSCSI target
name.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
220
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
Target
The iSCSI target name.
listvms
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> listvms <WWPN>
Description
This command lists all virtual machines and their information for all manageable ports.
If you specify the host with the “h=<host>” option or just give the physical WWPN,
only the virtual machines for that host return. If you specify the physical port and the
virtual port, only the virtual machine for the specified virtual port returns.
The virtual machine name is only displayed if the virtual port is associated with a
virtual machine on VMware ESXi 5.0 and 5.1. If you are running this command on any
other server that has virtual ports, you will not see the virtual machine name.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
listvports
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> listvports <WWNP>
Description
This command lists virtual ports on the specified physical port. Leaving the physical
WWPN parameter blank lists all virtual ports on all manageable hosts that support
virtual ports.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
221
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
loadlist
Note: Loadlist is not supported for UCNAs.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> loadlist <WWPN>
Description
This command shows the flash parameters for a given FC port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
loopbacktest
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> loopbacktest <WWPN | MAC> <Type> <Count> <StopOnError> [Pattern]
Description
This command is used to run a loopback test on a given FC, FCoE, NIC or iSCSI port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
222
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Type
Type of loopback test to run:
0 = PCI LoopBack Test
1 = Internal LoopBack Test
2 = External LoopBack Test (requires loopback plug)
3 = DMA Loopback Test
4 = PHY Loopback Test
5 = MAC Loopback Test
Note: Loopback tests 0 and 1 are not supported for UCNAs.
Loopback tests 3, 4 and 5 are only supported for UCNAs.
Count
The number of times to run the test (0 = run test infinitely, Range =
1...99,999)
StopOnError
Checks if the test must be halted on error.
0 = No halt
1 = Halt
Pattern
(optional)
1 to 8 hexadecimal bytes to use for loopback data (for example:
1a2b3c4d)
Example:
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> loopbacktest 00-00-c9-93-2f-9f 4 120 0
pcidata
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
pcidata <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows the PCI attributes for the port specified on the adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
223
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
portattributes
Supported by
Windows
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
PortAttributes <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows a list of all port attributes for the port specified on the adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port. If the port supports VEPA, the
output contains the line “VEPA State: <enabled | disabled>.
posttest
Note: The posttest command does not apply to the LPe16000–series of adapters.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> posttest <WWPN | MAC>
Description
This command runs the POST on a specified FC port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
224
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
readwwn
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
showpersonalities <WWPN | MAC> [ReadType]
<h=ESXhostIP>
Description
This command shows the WWN details of the specified port and category.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
ReadType
Valid types are:
0 = Volatile
1 = Non-volatile
2 = Factory default
3 = Current
4 = Configured
reset
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> reset <WWPN>
Description
This command resets the adapter. An adapter reset can require several seconds to
complete, especially for remote devices. When the reset is completed, the system
command prompt is displayed.
Notes:


Supported only for FC and FCoE ports. Not supported for NIC and iSCSI
ports.
For FCoE ports, this command only resets the driver to update changed
driver parameters that require a driver reset. It does not cause a hardware
reset of the adapter port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
225
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
restorewwn
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
restorewwn <WWPN> <RestoreType>
<h=ESXhostIP>
Description
This command restores the WWN value of the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
RestoreType
Valid types are:
0 = Restore Default WWNs
1 = Restore NVRAM WWNs
saveconfig
Note: Driver parameters that are set temporarily and globally (using the G and T
flags) must be read using the getdriverparamsel xvcpcmd command to view the
current value of the parameter. The getdriverparamsglobal elxvcpcmd
command returns only permanently set driver parameter values. Additionally,
if temporary, global values have been set for one or more driver parameters, the
saveconfig elxvcpcmd command must be run with the N flag (using the N flag
is analogous to the elxvcpcmd command getdriverparams) to force the driver
parameter values for the specified adapter to be saved. Inaccurate values may
be saved if the G flag is used for this command.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> saveconfig <WWN> <FileName> <Flag>
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
226
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command saves the specified FC/FCoE adapter’s driver parameters to a file on an
ESXi host. The resulting file contains a list of driver parameter definitions in ASCII file
format with definitions delimited by a comma. Each definition is of the form:
<parameter-name>=<parameter-value>.
The command saves either the values of the global set, or those specific to the adapter
in the Emulex Repository directory.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
FileName
The name of the local .dpv file.
Flag
Valid types are:
G = Make change global (all adapters on this host)
N = Make change non-global (adapter-specific)
serverattributes
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> serverattributes
Description
This command is used to retrieve basic information about the host such as the OS
version and CIM provider version.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
setadapterportconfig (OCe14000–Series Only)
Syntax
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.203.195
SetAdapterPortConfig <MAC|WWPN> defaults
or
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
227
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
hbacmd SetAdapterPortConfig <MAC|WWPN> p0=P0Config [p1=P1Config]
[p2=P2Config][p3=P3Config] [pid=ProfileID] [mctype=Type] [NParEpMode=state]
Description
The SetAdapterPortConfig command configures the function protocol assignments for
all ports on an adapter. Additionally use this command to restore the adapter to its
factory default profile and settings. The number of ports and function protocol
assignments specified in this command depends upon the available ports, storage
mode (mixed or concurrent) and multichannel/NPar state. Depending upon the
presence of NParEP on a host, this command may allow the configuration of more
functions per port than is available on the PCI bus. This means a lesser number of
functions per port than are configured by this command may be noticed after rebooting
the host.
Enabling/Disabling Multichannel
Use the Type parameter to enable and disable multichannel. When enabling
multichannel, the additional function protocols must be specified for the extra channels
that are not available when multichannel is disabled.
Examples for Enabling and Disabling Multichannel
To enable multichannel:
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
setadapterportconfig 00-00-c9-12-34-56 p0=nic,iscsi,nic,nic
p1=nic,fcoe,nic,nic p2=nic,fcoe,nic,nic p3=nic,iscsi,nic,nic mctype=umc
To disable multichannel:
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
setadapterportconfig 00-00-c9-12-34-56 p0=nic,iscsi p1= nic,fcoe p2=nic,fcoe
p3=nic,iscsi mctype=none
Syntax Rules








No spaces are allowed between around the = or commas in when specifying a
port (e.g. p0 = nic, iscsi would cause an error).
The only choice for the f0 parameter is NIC. Choices for the f1–fm parameters
are None, iSCSI or FCoE (or NIC for multichannel configurations).
This command fails if you specify two storage protocols on a port and the
concurrent storage mode is not available.
This command fails if you specify three storage functions on a port.
This command failsif you specify two of the same storage functions on a port.
The number of functions (f) you can specify depend upon the adapter model
and the configuration type (for example, non-multi–channel, multichannel,
NPar, etc.). If you specify an incorrect number of functions, the command fails.
You can only specify NIC as the f0 parameter if no other f parameters are
specified. Also you cannot specify NIC with multichannel configurations.
The pid=profile_id option is required for NIC only configurations. It you
specify an incorrect number of functions, the command fails.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
228
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference




If the mctype parameter is specified, it must be an available multichannel type
(see CMGetParams command for available types) or set to None to disable
multichannel. If the mctype parameter is not specified, the currently configured
multichannel type (including None) remains unchanged.
If one or more functions are set to None and they are the last functions on a port,
they do not need to be specified (for example, p0=nic,iscsinone can be shortened
to p0=nic,iscsi).
You can only specify NParEPMode with the mctype-NPar parameter or when
the current configured MC type is NPar.
When you disable NPar (for example mctype=none), the NParEP Mode is
automatically disabled.You must reboot to activate a new port configuration.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
MAC address of any iSCSI or NIC function on the adapter.
WWPN
World Wide Port Name of any FCoE function on the adapter.
p0=fcnCfg
1st port's function(s)
p1=fcnCfg
2nd port's function(s) (required for 2 and 4 port adapters)
p2=fcnCfg
3rd port's function(s) (required for 4 port adapters)
p3=fcnCfg
4th port's function(s) (required for 4 port adapters)
fcnCf
f0[,f1[,...fM]] where
f0: 1st function protocol on port (must be NIC)
f1: 2nd function protocol on port (optional)
fM: Mth function protocol on port (optional)
The number of functions (i.e. value of M) per port are model and
multichannel type specific.
pid
Optionally specifies the profile ID to use for the personality. This
parameter is required for NIC only.
Type
Optional multichannel type specification (specify none to disable
multichannel). This parameter is required to specify multichannel. If
not specified, no change to the configured multichannel type is made.
State
NParEP Mode state. This parameter can only be specified when
mctype=NPar.
Valid states are:
0 = Disabled
1 = Enabled
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
229
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Examples
Mixed Mode
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
setadapterportconfig 00-00-c9-12-34-56 p0=nic,iscsi p1=nic,fcoe p2=nic,fcoe
p3=nic
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
getadapterportconfig 00-00-c9-12-34-56
Number of Ports
: 4
Maximum FCoE Functions : 4
Maximum iSCSI Functions : 4
Mixed Mode I/O Allowed : Yes
Concurrent Mode I/O Allowed : No
RebootRequired
: Yes
Active Configuration
Profile ID : 37
MCType
: None
Port Assignments:
Port 0: NIC,iSCSI
Port 1: NIC,FCoE
Port 2: NIC,iSCSI
Port 3: NIC,FCOE
Reboot Configuration
Profile ID : 37
MCType
: None
Port Assignments:
Port 0 (p0): NIC,iSCSI
Port 1 (p1): NIC,FCoE
Port 2 (p2): NIC,FCoE
Port 3 (p3): NIC,None
Note: (pN) labels are the port parameter names to use in the
SetAdapterPortConfig command (e.g. p0=NIC,FCoE p1=NIC,iSCSI)
Concurrent Mode with Two Ports
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
setadapterportconfig 00-00-c9-12-34-56 p0=nic,iscsi,fcoe p1=nic,fcoe
C:\Program Files\Emulex\Util\OCManager>hbacmd getadapterportconfig
00-00-c9-12-34-56
Number of Ports
: 2
Maximum FCoE Functions : 4
Maximum iSCSI Functions : 4
Mixed Mode I/O Allowed : Yes
Concurrent Mode I/O Allowed : Yes
RebootRequired
: Yes
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
230
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Active Configuration
Profile ID : 33
MCType
: None
Port Assignments:
Port 01: NIC,iSCSI,FCoE
Port 12: NIC,iSCSI,FCoE
Reboot Configuration
Profile ID : 33
MCType
: None
Port Assignments:
Port 1 (p0): NIC,iSCSI,FCoE
Port 2 (p1): NIC,FCoE,None
Note:
(pN) labels are the port parameter names to use in the
SetAdapterPortConfig command (e.g. p0=NIC,FCoE p1=NIC,iSCSI).
setbeacon
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setbeacon <WWN | MAC> <BeaconState>
Description
This command turns the beacon on or off.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
MAC address of the NIC or iSCSI port.
BeaconState
New state of the beacon:
0 = Off
1 = On
setcablenvp
Note: This command supports only OCe11100 T 10GBASE-T–series adapters.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
231
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
h=<esx_host> setcablenvp <WWN | MAC> <NPV>
Description
This command sets the nominal velocity of propagation (N-V-P), required for the TDR
test, for the cable that connects to the physical port associated with the WWPN or
MAC.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
NVP
A percentage value between 1 and 100 (Consult your cable
documentation to obtain the proper NVP value).
setcnapgbw
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setcnapgbw <WWPN | MAC> <BW0>...<BW7>
Description
This command sets the bandwidth percentage of a priority group on a given FCoE, NIC
or iSCSI port according to the following rules:


Bandwidths BW0 to BW7 must add up to 100%.
Bandwidth can be assigned to a priority group that has priorities.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
BW0 to BW7
The bandwidth for priority group 0 to 7.
Example:
This command sets the bandwidth of PGID0 to 50 PGID1 to 50 and the rest to 0%.
elxvcpcmd.exe setcnapgbw 10:00:00:00:c9:3c:f7:88 50 50 0 0 0 0 0 0
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
232
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
setdcbparam
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setdcbparam <WWPN | MAC> <Param> <Value>
Description
This command configures the DCB and LLDP settings on a UCNA.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
Param
See below.
Value
See below.
UCNA Parameters and Values (1= enabled 0 = disabled)
DCBXState – The current DCBX (Data Center discovery and Capability
exchange protocol) state.PFCEnable – Enabled means that flow control in both
directions (Tx and Rx) is enabled.
FCoEPriority – You must specify a single priority (0-7). [only for FCoE adapters]
iSCSIPriority – You must specify a single priority (0-7). [only for iSCSI adapters]
PFCPriorities – Specify PFCPriorities as a single priority or as a list of comma
separated values. Comma separated list of up to 7 values ranging from 0-7.
Default – Setting the SetDCBParam arguments to default sets all UCNA DCB
parameters (including priority groups) to their default values.
Example:
elxvcpcmd setdcbparam <WWPN|MAC> defaults
Link Layer Discovery Protocol (LLDP) Parameters and Values
(1= enabled 0 = disabled)
TxState (Transmit State) – DCBX uses Link Layer Discovery Protocol (LLDP) to
exchange parameters between two link peers. For the DCBX protocol to operate
correctly, both LLDP Rx and Tx must be enabled. If either Rx or Tx is disabled,
DCBX is disabled.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
233
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
RxState (Receive State) – DCBX uses LLDP to exchange parameters between
two link peers. For the DCBX protocol to operate correctly, both LLDP Rx and
Tx must be enabled. If either Rx or Tx is disabled, DCBX is disabled.
TxPortDesc (Transmit Port Description) – Provides a description of the port in
an alpha-numeric format. The value equals the ifDescr object, if the LAN device
supports RFC 2863.
TxSysDesc (Transmit System Description) – Provides a description of the
network entity in an alpha-numeric format. This includes the system's name
and versions of hardware, operating system and networking software
supported by the device. The value equals the sysDescr object, if the LAN
device supports RFC 3418.
TxSysName (Transmit System Name) – Provides the system's assigned name in
an alpha-numeric format. The value equals the sysName object, if the LAN
device supports RFC 3418.
TxSysCap (Transmit System Capabilities) – Indicates the primary function(s) of
the device and whether or not these functions are enabled on the device. The
capabilities are indicated by two octets. Bits 0 through 7 indicate Other,
Repeater, Bridge, WLAN AP, Router, Telephone, DOCSIS cable device and
Station respectively. Bits 8 through 15 are reserved.
Where multiple values are possible, specify them with a comma-separated list.
Example:
elxvcpcmd v=12.345.678.901 u=username p=password h=12.345.678.123
setdcbparam 00-00-c9-3c-f7-88 fcoepriority 3
setdcbpriority
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setdcbpriority <WWN | MAC> <PFC Priorities> <Priorities of
PGID0> < Priorities of PGID1>...<Priorities of PGID7>
Description
This command sets the priorities for a priority group. The values must be set according
to the following rules:








The priorities range from 0 to 7.
The priority group IDs (PGID) range from 0 to 7.
A priority can exist in only one priority group.
All priorities must appear once in any of the eight (PG0-PG7) priority groups.
Each set of priorities for a group must be separated by a space.
Specify multiple priorities for the same group by a comma-separated list.
To specify none, use - for the argument.
The same priority values cannot be specified to different groups.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
234
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference



All priorities (0 to 7) must be assigned to some PGID.
Not all PGIDs must be assigned a priority.
Not all adapters support two PFC priorities and eight priority groups. For
adapters, if you exceed the PFC priorities or priority groups an error message
appears.
FCoE Adapter Specific Rules:




Minimum of one and a maximum of two PFC priorities can be configured.
One of the PFC priorities must match FCoE priority.
The additional PFC priority must be assigned to a priority group which has no
other priorities.
The FCoE priority must be assigned to a priority group which has no other
priorities.
iSCSI Adapter Specific Rules:




Minimum of one and a maximum of two PFC priorities can be configured.
One of the PFC priorities must match iSCSI priority.
The additional PFC priority must be assigned to a priority group which has no
other priorities.
The iSCSI priority must be assigned to a priority group which has no other
priorities.
NIC Adapter Specific Rules:


Only one PFC priority can be configured.
The PFC priority must be assigned to a priority group which has no other
priorities.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
PFCPriorities
PFC priority that is a comma separated list of up to 7 values ranging
from 0-7.
Priorities of
PGID
Priority group membership that is a comma separated list of priorities
ranging in value for 0-7.
Example:
elxvcpcmd v=12.345.678.901 u=username p=password h=12.345.678.123
setdcbpriority 10:00:00:00:c9:3c:f7:88 3 0,1,2,4,5,6,7 3 0 0 0 0 0 0
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
235
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
setdriverparam
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
setdriverparam <WWPN | MAC> <Flag1> <Flag2> <Param> <Value>
<h=ESXhostIP>
Description
This command sets the driver parameter at the port or global level, either permanently
or temporarily for the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
Flag1
L = Local (all adapters on this host)
G = Global (all adapters on this host)
Flag2
P = Permanent (persists across re-boot)
T = Temporary.
Param
The name of the driver parameter.
Value
The value of the driver parameter.
setdriverparamdefaults
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
setdriverparamdefaults <WWPN | MAC> <Flag1> <Flag2>
<h=ESXhostIP>
Description
This command restores the driver parameter to the default value at the port or global
level, either permanently or temporarily for the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
236
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Flag1
L = Local (all adapters on this host)
G = Global (all adapters on this host)
Flag2
P = Permanent (persists across re-boot)
T = Temporary.
setdumpdirectory
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
setdumpdirectory <WWN | MAC> <DumpDirectory>
h=<esx_host>
Description
Use the setdumpdirectory command to set the dump directory for a given FC/FCoE,
NIC or iSCSI port. To use the SetDumpDirectory command, you must have a directory
mapped under /vmfs/volumes/ where the files will be placed.
Note: The dump directory applies to all adapters in the server. There is no separate
dump directory for each adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
DumpDirectory
The directory under /vmfs/volumes that you created to store the
dump files.
Example:
elxvcpcmd v=12.345.678.901 u=username p=password h=12.345.678.123
setdumpdirectory 10:00:00:00:c9:61:f2:64 vcenter-datastore
This example shows the dump directory set to /vmfs/volumes/vcenter-datastore.
setfipparams
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setfipparams <WWPN> <Param> <Value>
Description
This command sets the FIP parameters of the adapter in FCoE mode.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
237
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
Param
FIP parameter name (pfabric, pswitch, vlanid, fcmap and cinvlanid).
Value
FIP parameter value and the valid range for the FIP parameter.
pfabric – 8 byte fabric name (format XX:XX:XX:XX:XX:XX:XX:XX)
pswitch – 8 byte switch name (format
XX:XX:XX:XX:XX:XX:XX:XX)
vlanid – 2 byte VLAN ID [0-4095] OR 'any' for any valid VLANID
fcmap – 3-byte FC_map, 0x0EFCxx
cinvlanid – 2-byte VLAN_ID [0-4095]
Example:
elxvcpcmd v=12.345.678.901 u=username p=password h=12.345.678.123
setfipparams 10:00:00:00:c9:5b:3a:6d fcmap 0x0efc99
setexpresslanelunstate (LPe16000–Series and OCe15100–
Series Only)
Syntax
setexpresslanelunstate <WWPN> <Target WWPN> <Lun> <State> <Option>
Description
This command enables and disables ExpressLane on a particular LUN.
Note: A masked LUN cannot be enabled for ExpressLane.
Parameters
wwpn
The WWPN of the FC/FCoE function connected to the target.
Targetwwpn
The WWPN of the target.
LUN
LUN number to enable/disable ExpressLane
State
0 = Disable ExpressLane
1 = Enable ExpressLane
Option
Valid ExpressLane options:
0 = Set ExpressLane LUN state in driver (active)
1 = Set ExpressLaneLUN state in configuration (persist across
reboots)
2 = Set ExpressLane LUN state in both (driver and configuration)
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
238
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Examples
The following example enables ExpressLane for LUN 2 on specified target, in the driver
and configuration.
elxvcpcmd.exe v=10.192.000.000 u=user p=password h=10.192.87.198
setexpresslanelunstate 10:00:00:00:00:87:01:98 20:22:d4:ae:52:6e:6f:08 2 1 2
The following example enables ExpressLane for LUN 2 on a specified target, in the
driver only. After a reboot, a LUN is not an ExpressLane LUN.
elxvcpcmd.exe v=10.192.000.000 u=user p=password h=10.192.87.198
setoaslunstate 10:00:00:00:00:87:01:98 20:22:d4:ae:52:6e:6f:08 2 1 0
The following example disables ExpressLane for LUN 2 on a specified target, in the
driver and configuration.
elxvcpcmd.exe v=10.192.000.000 u=user p=password h=10.192.87.198
setoaslunstate 10:00:00:00:00:87:01:98 20:22:d4:ae:52:6e:6f:08 2 0 2
The following example disables ExpressLane for LUN 2 on a specified target, in the
driver only. Assuming this is configured to be an ExpressLane LUN, after a reboot
LUN 2 is an ExpressLane LUN again.
elxvcpcmd.exe v=10.192.000.000 u=user p=password h=10.192.87.198
setoaslunstate 10:00:00:00:00:87:01:98 20:22:d4:ae:52:6e:6f:08 2 0 0
setpfcthrottle
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setpfcthrottle <WWPN> <Flag>
Description
This command returns the PfcThrottle state as enabled or disabled for OCe10102
adapters only.
Note: The PFC Throttle state is returned by the PortAttributes command for UCNAs.
However for UCNAs with older firmware that does not support PfcThrottle
and for FC adapters, the PFC Throttle state is not returned by the PortAttributes
command.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
Flag
0 = Disabled
1 = Enabled
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
239
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
setphyportspeed
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> SetPhyPortSpeed <WWPN | MAC> <Mode> [Speed [Length]]
Description
This command sets the port speed on OCe11102 adapters.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of the FCoE port.
MAC
The MAC address of the UCNA port.
Mode
Mode number:
0 = Default
1 = Auto-Negotiate
2 = Force
Speed
Speed string that is required for Mode = 1 or 2 (s=10Gb/1Gb/100Mb).
Length
DAC cable length in meters (0-10, required for 10Gb SFP Plus
interface type).
Note: When Mode = 0, the Speed and Length arguments are ignored. When Mode = 1,
the Length arguments is ignored.
Example:
The following example configures the port to a forced speed of 1 Gb/sec with a cable
length of 4 meters.
elxvcpcmd.exe v=11.190.705.200 u=username p=password h=11.190.206.300
setphyportspeed 2 1Gb 4
setportenabled
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setportenabled <WWPN | MAC> <Flag>
Description
This command is used to toggle the enable or disable status for an FC, FCoE, NIC or
iSCSI port on a host.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
240
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Notes:


Ensure that all I/O traffic on the port is stopped before disabling the port.
When the setportenabled command disables an FC port, the adapter must
be reset to activate the new setting. Only UCNAs do not require a reset
when the adapter port is enabled or disabled.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
Flag
0 = Disabled
1 = Enabled
setretentioncount
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> setretentioncount <WWN | MAC> < RetentionCount >
Description
This command specifies the maximum number of diagnostic dump files for the
adapter. When the count reaches the limit, the next dump operation deletes the oldest
file.
Note: The retention count applies to all adapters in the server.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
241
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC or iSCSI port.
RetentionCount
The number of dump files to retain.
setvccred
Syntax
elxvcpcmd.exe setvccred v=<vCenter IP/Name> u=<username> p=<password>
Description
While executing a set of CLI commands, you need to enter vCenter credentials
repeatedly. By executing the “setvccred” command first, you can save these credentials
including vCenter server name/IP, username and password to a file in an encrypted
format and execute subsequent commands without use of vCenter credentials.
Using this command is optional. You can continue to execute the commands providing
all credentials.
Note: This command does not apply to ports or adapters.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
Example
Execute setvccred first:
elxvcpcmd.exe setvccred v=12.345.678.901 u=username p=password
Subsequent commands can be:
New format:
elxvcpcmd.exe h=12.345.678.123 listhbas
-orOld Format:
elxvcpcmd.exe v=12.345.678.901 u=username p=password h=12.345.678.123
listhbas
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
242
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
showisnsserver
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> showisnsserver < MAC>
Description
This command shows the currently configured Internet Storage Name Server. This
command also indicates whether or not iSNS discovery is enabled.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
showlicenseadapterfeatures
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
showlicenseadapterfeatures <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows the licenses available for the adapter to which the specified port
belongs.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
showlicenseadapterid
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
showlicenseadapterid <WWPN | MAC>
OCM for VMware vCenter Version 10.2 User Manual
<h=ESXhostIP>
P009805-01A Rev. A
243
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command shows the license ID of the adapter to which the specified port belongs.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
showpersonalities
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
showpersonalities <WWPN | MAC>
<h=ESXhostIP>
Description
This command shows the personalities of the adapter to which the specified port
belongs.
Note: If the active and/or configured configurations are not single personality, the
active and/or configured personality indicators are not shown.
Note: The personalities shown depend upon the availability of the personality, which
is controlled by the profiles that are exposed by an adapter's IPL.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
Example
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000
showpersonalities 00-00-c9-12-34-56
Adapter Personalities:
NIC
iSCSI
FCoE (active) (configured
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
244
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
showtarget
Syntax
elxvcpcmd.exe v=<vcenter server> u=<vc_username> p=<vc_pwd>
showtarget <MAC>
<h=ESXhostIP>
Description
This command shows the iSCSI target details of the adapter to which the specified
iSCSI port belongs.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
sriovenable
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> sriovenable <MAC> <0 | 1>
Description
This command enables or disables SR-IOV support for an adapter's physical port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC Address of any NIC function on the physical
adapter port.
SR-IOV Enable state
0 = disable SR-IOV
1 = enable SR-IOV
Note: SR-IOV is not supported with UMC channel management.
targetmapping
Syntax
elxvcpcmd.exe
v=<vcenter server> u=<vc_username> p=<vc_pwd>
OCM for VMware vCenter Version 10.2 User Manual
<h=ESXhostIP>
P009805-01A Rev. A
245
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
targetmapping <WWPN>
Description
This command shows the targets attached to the FC and FCoE of the specified port.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
tdrtest
Note: This command supports only OneConnect OCe11102 10GBASE-T series
adapters.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> tdrtest <WWPN | MAC>
Description
This command runs a TDR test on a given 10GBASE-T adapter.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
WWPN
The WWPN of a port on the ESXi host with Emulex adapters.
MAC
The MAC address of the NIC port.
umcsetlpvid
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host>umcsetLPVID <WWPN | MAC> <LPVID0> <LPVID1> [LPVIDN]
Description
This command sets the Logical Port VLAN IDs (LPVID) for each channel on a physical
port. LPVID values are in the range of 2-4094. When only three channels are available,
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
246
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
specifying LPVID3 causes an error. When only two channels are available, specifying
LPVID2 and LPVID3 causes an error.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
MAC address of any NIC function on the physical adapter port.
LPVID State
LPVID0
LPVID for channel 0
LPVID1
LPVID for channel 1
LPVIDN
LPVID for channel N
Note: The number of channels and the maximum value of N are adapter
model specific.
Notes:









LPVID values are in the range of 2-4094.
This is the only command available to set LPVID values.
Every NIC channel on a physical port must have a unique LPVID.
This command is not available FCoE and iSCSI channels because they are
storage channels. LPVIDs for FCoE and iSCSI channels must be set to ‘0’.
This command is not available for 1 Gb ports.
If UMC is disabled when this command is executed, a warning message is
displayed stating that UMC is disabled and must be enabled for any changes to
take effect.
A system reboot is not required for the change take effect.
LPVID properties are only associated with UMC. The umcsetlpvid command
fails if the current channel management mode is not UMC.
SR-IOV is not supported with UMC channel management.
Example
elxvcpcmd.exe v=10.192.000.000 u=root p=vmware h=10.192.000.000 umcsetlpvid
00-00-c9-12-34-56 1001 1002 1003 1004
updateisnsserver
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_password>
h=<esx_host> updateisnsserver <MAC> <Server IP> <Port>
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
247
11. Using OneCommand Manager for VMware vCenter Command Line Interface
The Command Reference
Description
This command updates the configured iSNS server. This command requires the server
IP <Server_IP> and port number <Port> of the iSNS server be available to respond to
the iSNS requests.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
Server_IP
IP address of the iSNS server to configure.
Port
Port number of the iSNS server to configure (value: 1024-65535).
VEPAenable
Note: VEPA is only supported on OCe14000-series NIC ports. For all other adapter
types and port types this feature is undefined, and this command returns the
following error message: Hardware Does Not Support.
Syntax
elxvcpcmd.exe v=<vcenter_server> u=<vc_username> p=<vc_pwd> h=<esx_host>
VEPAenable <MAC Address> <0|1>
Description
The command takes two parameters:


The MAC address is the MAC address of any NIC on the relevant physical port.
The final parameter specifies whether to enable or disable VEPA: 0 is disabled
and 1 is enabled.
Parameters
v
The vCenter server IP address.
u
The user name for the vCenter server.
p
The user password for the vCenter server.
h
The IP address of the ESXi host with Emulex adapters.
MAC
The MAC address of the iSCSI port.
Port (0/1)
Port number of the iSNS server to configure (value: 1024-65535).
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
248
11. Using OneCommand Manager for VMware vCenter Command Line Interface
Viewing Audit Logs Using the CLI Command
version
Syntax
elxvcpcmd.exe version
Description
This command shows the version of the CLI installed.
Parameters
None.
Viewing Audit Logs Using the CLI Command
Note: All active management actions performed are saved to a log file specific to the
action. The maximum size of a log file is 2 MB. If the size of the log file exceeds
this limit, old log entries are deleted for the particular event.
Syntax
elxvcpaudit.exe <event name>
Note: If the event name is not specified, all events are displayed.
Description
You can use the elxvcpaudit.exe script to log all the historical active management
performed through the vSphere console on the Emulex adapters. To see the usage
information, run the script with no parameters specified. All supported events are
displayed.
Parameter
event name
The command name describing the appropriate active management
action performed.
List of Supported Event Names
installadapterlicense
Shows if any licenses are installed on the UCNA.
changepersonality
Shows if any personality changes are performed on the
UCNA.
loopbacktest
Shows diagnostic tests run on the UCNA.
setdriverparam
Shows the driver parameters changed on a LightPulse or
OneConnect adapter at both port and global levels.
setdcbparam
Shows the changes to the DCB parameters on the UCNA.
setbeacon
Shows the beacon settings on the UCNA.
setfipparam
Shows the changes to the FIP parameters on the UCNA.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
249
11. Using OneCommand Manager for VMware vCenter Command Line Interface
Viewing Audit Logs Using the CLI Command
download
Shows the firmware download activities performed.
reset
Shows the port reset activities performed.
changewwn
Shows the WWN change activities performed.
Example
Audit log for
: changewwn
-------------------User Name
Date and Time
Operation
Host Name
Adapter Id
Port Id
Message
:
:
:
:
:
:
:
Administrator
2011-06-16T19:25:12Z
ChangeWWNJobInfo
10.192.203.179
BT11161224
10:00:00:00:C9:BB:1E:77
Successfully changed WWN.
New State
New WWPN = 10:00:00:00:C9:BB:1E:78
New WWNN = 20:00:00:00:C9:BB:1E:78
Volatile = false
Old State
Old WWPN = 10:00:00:00:C9:BB:1E:77
Old WWNN = 20:00:00:00:C9:BB:1E:77
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
250
12. Troubleshooting
Security
12. Troubleshooting
There are several circumstances in which your system may operate in an unexpected
manner. The Troubleshooting section explains some of these circumstances and offers
one or more solutions for each issue.
Security
The vSphere Web Client server and the OneCommand Manager for VMware vCenter
can be installed on different machines. As a result, certificate or insecure-content
warnings could occur. There are two ways to remedy the problem:


Accept the blocked content – temporary solution
Install a security certificate– permanent solution
Accepting the Blocked Content
The procedure for accepting blocked content depends on the type of browser you are
using. This is not a permanent solution and you will need to repeat this procedure
every time you load the web client. If you want a permanent solution, you must install
the correct security certificate. See “Installing a Security Certificate” on page 252.
Internet Explorer
Accept the blocked content.
Figure 12-1 Blocked Content in Internet Explorer
Chrome and Firefox
1. Load the plug-in URL in a separate tab or window.
The plug-in URL format is:
https://<plugin-server>:<https-port>/elxvcplugin
For example:
https://pluginserverhostFQDN:443/elxvcplugin
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
251
12. Troubleshooting
Security
Note: You can extract the plug-in server, IP address, host name, and port number
from the browser warning message.
2. Confirm or accept the certificate warning.
3. Refresh the vSphere web client tab or window.
Figure 12-2 Blocked Content in the Firefox or Chrome Browser
Installing a Security Certificate
A permanent solution to the security warnings is to install the correct security
certificate.
To install a security certificate:
1. Open Internet Explorer in Administrative Mode.
2. Load the plug-in url and accept the certificate warning.
The plug-in url must have the following format:
https://<plugin-server>:<https-port>/elxvcplugin
The page loads with a certificate error.
3. Click on the Certificate Error. A list appears showing the untrusted certificate.
Figure 12-3 Untrusted Certificate
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
252
12. Troubleshooting
Security
4. Click View certificates in the Certificate Error list. The Certificate dialog box opens.
Figure 12-4 Certificate Dialog Box
5. Click Install Certificate.... The Certificate Import Wizard opens.
Figure 12-5 Certificate Import Wizard
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
253
12. Troubleshooting
Security
6. Follow the wizard instructions and install the certificate to the Trusted Root
Certification Authorities location.
Table 12-1 Troubleshooting Issues and Resolutions
Issue
Resolution
The Emulex OneCommand tab is not visible in
the vSphere console.
In the vSphere console select the Plug-in menu and choose
Manage Plug-ins. In the Plug-in Manager window, check the status
of the Emulex OneCommand Manager for VMware vCenter
(Emulex OneCommand). The status must be “Enabled”. If it is
not, enable it.
On the machine where OneCommand Manager for VMware
vCenter is installed, make sure the port numbers configured
during the installation are open and dedicated to the plug-in
server only. No other service should be listening on this port.
When you select the Emulex OneCommand tab Ensure the version of Adobe Flash player installed is 11.2 or later.
in the vSphere console, a message appears
If you have not installed the Adobe Flash player, you can
indicating that the Adobe Flash player is
download it from the Adobe website.
required.
When you select the Emulex OneCommand tab Ensure that you have the required privileges to view information
in the vSphere console, the Emulex Device
in the vSphere console.
Management tree-view does not display any
elements.
There is slow response from OneCommand
Manager for VMware vCenter.
Ensure that the following are on the same network:
• ESXi servers managed by the OneCommand Manager for
VMware vCenter server
• Systems hosting the OneCommand Manager for VMware
vCenter server
• OneCommand Manager for VMware vCenter
Firmware update fails on a LightPulse or a
On the ESXi host, check the firewall settings and ensure that the
OneConnect adapter, or installing licenses fails HTTP/HTTPS ports are open. Use the following command to
on a OneConnect adapter.
disable the firewall:
esxcli network firewall unload
Firmware update fails with the error message
“Error reading resource”.
Check the following:
• Make sure that you can ping the hostname, on which the
OneCommand Manager for VMware application is installed,
from the ESXi host. If you cannot ping the hostname, either
reinstall providing the reachable IP/hostname (with domain)
or add the host name to the dns.
• Check the memory space in the ESXi host and clean up the old
logs.
When you make any changes to the ESXi host, Click Refresh in the GUI. If the change is not reflected, restart
such as plugging cables, unplugging cables, or ‘sfcb’ on the ESXi host using the command:
storage references, OneCommand Manager for
/etc/init.d/sfcbd-watchdog restart
VMware vCenter does not reflect the change
Click Refresh again in the GUI.
immediately.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
254
12. Troubleshooting
Security
Table 12-1 Troubleshooting Issues and Resolutions (Continued)
Issue
Resolution
On a Windows 7 x64 operating system,
executing the CLI commands using the
executables results in unnecessary error
traces.
The C disk is highly protected; even the administrator account has
limited privileges. For example, the contents in the directory
“C:\Program Files\” have no write and full control privileges.
To remedy the problem:
• Assign your account write and full control privileges to
“C:\Program Files \”.
-or• Install OneCommand Manager for VMware vCenter on another
disk, for example, D.
When OneCommand Manager for VMware
vCenter loads within the vSphere console, it
shows a Security warning.
See “Security” on page 251.
When the VMware Web Client is launched, it
requires OneCommand Manager for VMware
vCenter to load in another browser tab and
accept the Emulex Certificate.
See “Security” on page 251.
OCM for VMware vCenter Version 10.2 User Manual
P009805-01A Rev. A
255
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement