Corekit User Manual Emulex
Corekit User Manual Emulex
User Manual
One Network.
One Company.
P004347-01B Rev. A Connect with Emulex.
Copyright © 2003-2010 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
OpenSolaris DHCHAP Notice.
Contains portions of Covered Software subject to the Common Development and Distribution License (CDDL)
Version 1.0. Such portions of Covered Software in Source Code form may be obtained from the web site
www.opensolaris.org, or by contacting online support from the web site www.emulex.com.
Derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.
Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved.
Storport Miniport Driver Intel x86, x64, and IA64 Windows Server 2003 Service Pack
Note: Intel IA64 supported for Fibre 2 or later
Channel adapters only. Windows Server 2008
Windows Server 2008 R2
LPFC 7.4.x Driver Intel x86, EM64T and AMD64 VMware ESX Server 3.5
LPFC 8.2.0.x.x vmw Driver Intel EM64T and AMD64 VMware ESX Server 4.0
LPFC 8.2.0.33.3p Open Intel x86, EM64T, AMD64, PPC64 RHEL 5.3 and later, and SUSE Linux
Source Driver for Red Hat and IA 64 Enterprise Server 10-SP2 and later
(RHEL) 5.3 and later, SUSE
Linux Enterprise Server
(SLES) 10-SP2 and later
LPFC 8.2.8.x Open Source Intel x86, EM64T, AMD64, PPC64 SUSE Linux Enterprise Server 11
Driver for SUSE Linux and IA 64 GM
Enterprise Server 11 GM
Solaris SFS 2.50 Driver Intel x86, EM64T, AMD64 and Sun Solaris 10 and Solaris 11
SPARC
Note: OneConnect adapters are not supported for IA64, PPC64, and Solaris platforms.
Prerequisites
• The LPFC driver must be loaded.
Note: In-band management (FC based management) is not supported on VMware ESX
Server 3.5. Use out-of band management (TCP/IP based management) to remotely
manage adapters on ESX server sytems.
For VMware ESX Server 3.5, the firewall on the ESX Server must be opened to man-
age systems remotely using TCP/IP-based management. To enable TCP port
#23333, run the following commands:
To verify that the correct port is open, run the following command:
esxcfg-firewall -q
The TCP port number can be changed. If it is not changed, the default is 23333.
Refer to the VMware Server Configuration Guide for more details on how to configure
the ESX firewall.
Procedures
To install the OneCommand Manager application CLI:
1. Log in as ‘root’.
2. Copy the elxocmcore-esxNN-<kit version>.<architecture>.rpm file to a directory on the install
machine.
3. CD to the directory to which you copied the rpm file.
4. Install the rpm file. Type:
rpm -U elxocmcore-esxNN-<kit version>.<architecture>.rpm
Where NN is 35 and <architecture> is i386 for an ESX 3.5 system or NN is 40 and <architecture> is
x86_64 for an ESX 4.0 system. The OneCommand Manager application CLI is located in
/usr/sbin/hbanyware.
Prerequisites
For existing systems the following must be installed before installing the OneCommand Manager
application CLI:
On LP21000 series adapters and OneConnect FCoE adapters
• Linux driver version 8.2.0.33.3p or later (For RHEL5 and SLES10 operating systems.)
• Linux driver version 8.2.8.x (For SLES11 operating systems.)
On OneConnect iSCSI adapters
• be2iscsi driver
On OneConnect NIC adapters
• be2net driver
The be2net driver must also be installed if the adapter personality is iSCSI-NIC or FCoE-NIC.
Use the latest or matching driver from the Emulex Web site.
Procedures
To install the OneCommand Manager application CLI:
1. Copy the applications kit tar file to a directory on the installation machine.
2. Change (use cd command) to the directory to which you copied the tar file.
3. Untar the file.
tar zxvf elxocmcore-<supported_os>-<app_ver>-<rel>.tgz
4. Change (use cd command) to the core kit directory created in step 3.
cd elxocmcore-<supported_os>-<app_ver>-<rel>
5. Run the install.sh script.
./install.sh
Note: The core kit consists of 2 rpm files for each supported architecture and each
supported version of Linux:
1. elxocmlibhbaapi-*.rpm
2. elxocmcore-*.rpm
Note: The OneCommand Manager application core kit cannot be installed if a previous
version of HBAnyware is installed.
You have two options when installing the OneCommand Manager application CLI on a Linux system:
• Upgrade - preserve existing settings
• Clean install - overwrite existing settings
To upgrade:
1. You must install the current core kit as detailed in “In a New Linux System” on page 3.
The rpm file handles the configuration file upgrade.
Note: Your configuration files are backed up by rpm with a .rpmsave extension.
2. Install the specific rpm file for your driver for Linux version. For information on installing the rpm
file, see “In a New Linux System” on page 3.
In Solaris SFS
Prerequisites
• The Solaris SFS 2.50 driver must be installed.
Procedures
To install the OneCommand Manager application CLI:
1. Copy the OneCommand Manager application core kit to a temporary directory on the system.
2. Untar the core kit. Type:
tar xvf elxocmcore-<kit version>.tar
3. Change to the newly created elxocmcore-<kit version> directory:
cd ./elxocmcore-<kit version>/
4. Run the install script and follow the instructions.
./install
If the HBAnyware utility, the OneCommand Manager application core kit, the OneCommand
Manager application enterprise kit, or the Solaris SFS driver utilities are already present on the
system, the install script attempts to first remove them.
To complete the removal of the OneCommand Manager Application CLI RPM, install
the Emulex CIM provider RPM that is included on the ESX 4.0 DVD. The correct file
for a system with ESX 4.0 is:
The correct file for a system with ESX 4.0 Update 1 is:
In Linux
To uninstall the OneCommand Manager application CLI on Linux:
1. Run the uninstall script uninstall_ocmanager.sh located in /usr/sbin/hbanyware/scripts.
Or
Run the uninstall script uninstall.sh located in the installation tar file.
In Windows
To upgrade from the OneCommand Manager application CLI to the full-featured OneCommand Manager
application enterprise kit:
1. From the desktop, run the elxocm-windows-<kit version>.exe file that contains the full
application kit.
Running this executable file removes the OneCommand Manager application CLI and installs a
full-featured version of the OneCommand Manager application that includes the CLI and the
GUI.
In Linux
To upgrade from the OneCommand Manager application CLI to the full-featured OneCommand Manager
application enterprise kit:
1. Run the install.sh script of the OneCommand Manager application enterprise kit.
The install script executes an rpm upgrade (rpm -U *.rpm) to upgrade the installed core kit to an
enterprise kit.
In Solaris SFS
To upgrade from the OneCommand Manager application CLI to the full-featured OneCommand Manager
application enterprise kit:
1. Download the OneCommand Manager application enterprise kit to a temporary directory on your
system.
2. Untar the OneCommand Manager application enterprise kit tar file:
tar xvf elxocm-<kit version>.tar
3. Change to the newly created elxocm-<kit version> directory:
cd ./elxocm-<kit version>/
4. Run the install script and follow the instructions.
./install
For VMware ESX Server 3.5, the firewall on the ESX Server must be opened to man-
age systems remotely using TCP/IP-based management. To enable TCP port
#23333, run the following commands:
To verify that the correct port is open, run the following command:
esxcfg-firewall -q
The TCP port number can be changed. If it is not changed, the default is 23333.
Refer to the VMware Server Configuration Guide for more details on how to configure
the ESX firewall.
Note: The OneCommand Manager application CLI running on VMware ESX 3.5 and
VMware ESX 4.0 COS does not support management of adapters using the CIM
interface.
For example, run the following command to display a list of adapters managed for a specified host using
CIM interface:
In Windows:
C:\Program Files\Emulex\Util\HBAnyware>hbacmd h=10.192.113.128 m=cim
u=root p=root n=elxhbacmpi/cimv2 listhba
In Linux:
/usr/sbin/hbanyware/hbacmd h=10.192.113.128 m=cim u=root p=root
n=elxhbacmpi/cimv2 listhba
In Solaris:
# /opt/HBAnyware/hbacmd h=10.192.113.128 m=cim u=root p=root
n=elxhbacmpi/cimv2 listhba
Node WWN : 20 00 00 00 c9 6b 62 2b
Port WWN : 10 00 00 00 c9 6b 62 2b
Port Symname :
Port FCID : 0000
Port Type : Fabric
Port State : Unknown
Port Service Type : 12
Port Supported FC4 : 00 00 01 20 00 00 00 01
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
Port Active FC4 : 00 00 01 00 00 00 00 01
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
Port Supported Speed: 1 2 4 GBit/sec.
Port Speed : 4 GBit/sec.
Max Frame Size : 2048
OS Device Name :
Num Discovered Ports: 0
Fabric Name : 00 00 00 00 00 00 00 00
• If the parameter 'm=CIM' is specified, then the OneCommand Manager application CLI uses the
CIM interface to talk to the CIM server running on the ESX server to get the management
information.
• If the parameter 'm=CIM' is not specified, then the OneCommand Manager application CLI uses
the RM interface to talk to the RM server to get the management information.
Syntax Rules
The syntax rules for hbacmd are as follows:
• All CLI Client commands and their arguments are not case sensitive.
• 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 (:) or spaces ( ). When
using space separators, the entire WWPN must be enclosed in quotes (").
• When a MAC address is specified the fields are separated by a dash (-).
Note: The following hbacmd commands are supported using the CIM interface:
HbaAttributes, PortAttributes, PortStatistics, ServerAttributes, GetDriverParam,
GetDriverParamsGlobal, SetDriverParam, Download, AddHost, RemoveHost,
Listhba, SetCimCred, and GetCimCred.
The following additional commands are supported to manage the adapters on the
ESX4i platform with SMI-S v2.x.x provider: ChangeWWN, GetWWNCap, ReadWWN,
RestoreWWN, CEE Download, GetCEEParams, SetCEEParam, GetXcvrData,
LoadList, Reset and GetVPD.
All other hbacmd commands return an error message “This command is currently not
available via the CIM interface”. Within this supported command list, there are some
entries that are not available in the SMI-S provider v1.2.1 and v2.x.x. For those
entries, hbacmd shows “Not Available”. For details on parameters not supported for
specific commands, see Table 2 on page 13.
If you are running older adapter firmware or managing a remote host running
HBAnyware version 4.x, the PG 1 and PG 2 settings and all bandwidth settings are
disabled and the Enable Host Ethernet Priority Flow Control (PFC) Linkage is
disabled.
Note: X indicates the attribute is not available on the particular OS. Blank table cells
indicate that the attribute is available.
Node WWN
Fabric Name X
Flags X
Host Name
Mfg
Serial No.
Port Number
Mode
Discovery
Manufacturer
Serial Number
Model
Model Desc
Node WWN
Node Symname
HW Version
FW Version
Vendor Spec ID X
Number of Ports
Driver Name
Device ID X
HBA Type
Operational FW X X X
SLI1 FW X
SLI2 FW X
SLI3 FW X
IEEE Address X
Boot Code X
Driver Version
Kernel Version X
HBA
Temperature
Port WWN
Port Symname
Port FCID X
Port Type
Port State
Port Service
Type
Port Supported
FC4
Port Supported
Speed
Port Speed
OS Device Name X
Num Discovered X
Ports
Fabric Name X
FW Resource X X X
Path
DP Resource X X X
Path
HBAnyware
Server Version
Host OS Version X
Responder X
Exchange Count
Tx Seq Count X
Rx Seq Count X
Tx Frame Count
Rx Frame Count
Tx Word Count
Rx Word Count
Tx KB Count
Rx KB Count
LIP Count
NOS Count
Error Frame
Count
Dumped Frame
Count
Link Failure
Count
Loss of Sync
Count
Loss of Signal
Count
Invalid Tx Word
Count
Invalid Rx Frame
CRC Cnt
Link Transition X
Count
Rx Port Busy
Count
Rx Fabric Busy
Count
Primary X
Sequence
Timeout
Elastic Buffer X
Overrun
Arbitration X
Timeout
GetVPD X
GetxcvrData X
LoadList X
SetDriverParama
WWN X
Management
Note: For the LoadList command, the attribute Program ID is displayed as “Not Available”,
on ESX 3i U4 via CIM Provider v 2.0.9.x.
Read-Only Mode
The OneCommand Manager application CLI does not allow the execution of certain commands when
the OneCommand Manager application is configured for read-only mode. An error message is displayed
if such a command is attempted: Error: Read-only management mode is currently set on
this host. The requested command is not permitted in this mode.
Help Commands
These “help” commands list the various levels of help for the hbacmd console application.
Help
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Help
Description: Shows a list of all help commands for the OneCommand Manager application CLI Client.
Parameters: None
Help Boot
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Help Boot
Description: Shows a list of all help commands for the boot commands.
Parameters: None
Help BootParams
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Help BootParams <Parameter Name>
Description: Shows a summary of parameter settings for the adapter and the boot device. Several
parameters have detailed help available.
Parameters:
Parameter Name (optional) - Specify one of the following boot parameters: AutoScan, BootTargetScan,
DevicePathSelection, LinkSpeed, PlogiRetryTimer, or BootParams Topology.
Help GetBootParams
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Help GetBootParams
Attributes Commands
HBAAttributes
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd HBAAttributes <WWPN | MAC>
Description: Shows a list of all adapter attributes.
Parameters:
WWPN - World Wide Port Name of the adapter whose attributes you want to view.
MAC - MAC address of the NIC or iSCSI port of the adapter whose attributes you want to view.
PortAttributes
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd PortAttributes <WWPN | MAC>
Description: Shows a list of all port attributes for the adapter.
Parameters:
WWPN - World Wide Port Name of the port whose port attributes you want to view.
MAC - MAC address of the NIC or iSCSI port whose port attributes you want to view.
PortStatistics
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd PortStatistics <WWPN>
Description: Shows all port statistics for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose port statistics you want to view.
ServerAttributes
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd ServerAttributes <WWPN | MAC>
Description: Shows a list of server attributes for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose server attributes you want to view.
Note: Ensure that all I/O on the port is stopped before disabling the port.
Note: When the SetPortEnabled command is used to disable an FC port, the adapter must
be reset to activate the new setting. Only OneConnect adapters do not require a reset
when the adapter port is enabled or disabled.
Authentication Commands
AuthConfigList
Supported by: Windows, Solaris SFS and Linux
Syntax: hbacmd AuthConfigList <WWPN>
Description: Returns the list of WWPNs that have an authentication connection configuration with the
specified adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose configuration data you want to retrieve.
DeleteAuthConfig
Supported by: Windows, Solaris SFS and Linux
Syntax: hbacmd DeleteAuthConfig <WWPN1> <WWPN2> <PasswordType> <Password>
Description: Deletes the authentication configuration on the adapter.
Parameters:
WWPN1 - World Wide Port Name of the adapter whose authentication configuration you want to delete.
WWPN2 - Must be "ff:ff:ff:ff:ff:ff:ff:ff" for switch or actual WWPN for target.
PasswordType - 1 = ASCII, 2 = Hex (binary), 3 = Password not yet defined.
Password - Current password value.
GetAuthConfig
Supported by: Windows, Solaris SFS and Linux
Syntax: hbacmd GetAuthConfig <WWPN1> <WWPN2>
Description: Retrieves the authentication configuration for the adapter.
Boot Commands
<…> = Required, […] = Optional
EnableBootCode
Note: Not supported for OneConnect adapters. The boot code is always enabled on
OneConnect adapters.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd EnableBootCode <WWPN | MAC> <Flag>
Description: Enables or disables the boot code on the FC adapter or PXE BIOS of the NIC on the CNA
adapter. If the boot code is disabled on the FC adapter, the adapter will not boot from the SAN,
regardless of the value for the EnableBootFromSan boot param. If the boot code is enabled on the FC
adapter, the adapter will boot from the SAN if the EnableBootFromSan parameter is also enabled. If the
PXE BIOS is disabled on the CNA adapter's NIC, it will prevent booting from the NIC. If the PXE BIOS is
enabled on the CNA adapter's NIC, it will allow booting from the NIC.
Parameters:
WWPN - World Wide Port Name of object adapters.
MAC - MAC address of the NIC port of the CNA adapter.
Flag - E = Enable the boot code, D = Disable the boot code.
GetBootParams
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetBootParams <WWPN> <Type>
Description: Shows the boot parameters. If any arguments are missing or invalid, a suitable error is
reported. If all arguments are ok, the data is displayed in tabular form.
Parameters:
WWPN - World Wide Port Name of object adapter.
Type - X86, EFI, OB
SetBootParam
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetBootParam <WWPN> <Type> <Param> <Value1> [BootDev <Value2>]
CEE Commands
Note: Converged Enhanced Ethernet (CEE) commands are for CEE management of
LP21000 series and OneConnect adapters only.
Note: CEE commands are not supported for NIC only adapters.
CEEDownload
Note: Supported for LP21000 series adapters only. Not supported for OneConnect
adapters.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd CEEDownload <WWPN> <Filename>
Description: Updates the CEE firmware on the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter.
Filename - Name of the file to download.
GetCEEParams
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetCEEParams <WWPN | MAC>
Description: Shows the Internal Host PFC flag value and DCBX mode (i.e. CEE version). For CNAs
(both iSCSI and FCoE) Priorities, Priority Groups, and the corresponding bandwidths are shown. The
LLDP state is also displayed.
Parameters:
WWPN - World Wide Port Name of the FCoE adapter port.
MAC - MAC address of the NIC or iSCSI port.
SetCEEParam
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetPGInfo <WWPN | MAC>
Description: Shows the priority membership and bandwidth percentages for up to eight priority groups
for the port.
Parameters:
WWPN - World Wide Port Name of the adapter.
MAC - MAC address of the NIC or iSCSI port.
SetPGBW
Note: Supported for LP21000 series adapters only. Not supported for OneConnect
adapters (see SetCnaPGBW).
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetPGBW <WWPN> <BW0> <BW1> <BW2>
Description: Set the bandwidth percentages for each of the three priority groups supported.
The bandwidth percentages must add up to 100% and cannot exceed the bandwidth percentage for the
priority group (e.g. BW1 cannot be greater than 40).
Parameters:
WWPN - World Wide Port Name of the adapter.
BW0 - Bandwidth percentage for the priority group 0.
BW1 - Bandwidth percentage for the priority group 1.
BW2 - Bandwidth percentage for the priority group 2.
Example:
This command sets the priority group 0 bandwidth to 40% and the priority groups 2 and 3 bandwidths to
30%:
hbacmd setpgbw 10:00:00:00:c9:3c:f7:88 40 30 30
Note: While there are eight CEE priority groups in which the CEE priorities can be
assigned, only two of those groups can be assigned priorities. The FCoE or iSCSI
priority is assigned to one priority group and the other seven (NIC) priorities must be
assigned to one and only one other priority group.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetCeePriority <WWPN | MAC> <PFC Priorities> <Priorities of PGID0> < Priorities of
PGID1> < Priorities of PGID2> ..<Priorities of PGID7>
Description: Sets the priorities for a priority group. The values must be set according to the following
rules:
1. The priorities can range from 0 to 7.
2. The Priority group ID's (PGID) can range from 0 to 7.
3. Each set of priorities for a group must be separated by a space.
4. Multiple priorities for the same group are specified by a comma separated list of values (for
example 3, 5, 7).
5. To specify none, use "-" for the argument.
6. Same priority values cannot be specified to different groups.
7. All priorities from 0 to 7 must be assigned to some PGID.
Parameters:
WWPN - World Wide Port Name of the FCoE adapter port for which you want to set CEE priority.
MAC - MAC address of the NIC or iSCSI port for which you want to set CEE priority.
PFC Priorities - These are the priorities that enable PFC. This also would be a comma separated list.
Example:
This command sets the priorities of the priority groups in the following order:
PFC Priorities = 3
PGID0 = 0,1,2,4,5,6,7
PGID1 = 3
PGID2 = NONE
PGID3 = NONE
PGID4 = NONE
PGID5 = NONE
PGID6 = NONE
PGID7 = NONE
hbacmd setceepriority 10:00:00:00:c9:3c:f7:88 3,0,1,2,4,5,6,7,3 - - - - - -
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetCnaPGBW <WWPN | MAC> <BW0 … BW7>
Description: Sets the bandwidth percentage of a priority group. The values must be set according to the
following rules.
1. The bandwidth percentage can be 0-100% with a granularity of 1%.
2. The sum of all the bandwidth must add up to 100 or else an error message will be displayed.
3. The first value is for PGID0, the second is for PGID1, and so on until PGID7.
4. All eight bandwidths must be specified.
Parameters:
WWPN - World Wide Port Name of the adapter for which you want to set the bandwidth percentage of a
priority group.
MAC - MAC address of the NIC or iSCSI port for which you want to set the bandwidth percentage of a
priority group.
BW - Bandwidth that is allocated for each Priority Group.
Example:
This command sets the bandwidth of PGID0 to 50 PGID1 to 40 and the rest to 0%.
hbacmd setcnapgbw 10:00:00:00:c9:3c:f7:88 50 50 0 0 0 0 0 0
FCoE Commands
GetFIPParams
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetFIPParams <WWPN>
Description: Show the FIP parameters of the FC port.
Parameters:
WWPN - World Wide Port Name of the adapter.
SetFIPParam
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetFIPParam <WWPN> <Param> <Value>
Description: Set the various FIP parameters of the FC port.
Parameters:
WWPN - World Wide Port Name of the adapter.
pfabric - 8 byte fabric name (format XX:XX:XX:XX:XX:XX:XX:XX)
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetFCFInfo <WWPN>
Description: Show the FCF information of the FC port.
Parameters:
WWPN - World Wide Port Name of the adapter.
Diagnostic Commands
Note: Diagnostic commands are not available using the CIM interface.
EchoTest
Note: Not supported for OneConnect adapters.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd EchoTest <WWPN Source> <WWPN Destination> <Count> <StopOnError> <Pattern>
Description: Runs the echo test on adapters.
Note: Support for remote adapter is TCP/IP access only. The EchoTest command fails if the
target WWPN does not support the ECHO ELS command.
Parameters:
Source WWPN - World Wide Port Name of the originating adapter.
Destination WWPN - World Wide Port Name of the destination (echoing) adapter.
Count - Number of times to run the test. 0 = run test infinitely.
StopOnError - Should the test be halted on Error? 0 = No halt, 1 = Halt.
Pattern - Hexadecimal data pattern to transmit (up to 8 characters).
GetBeacon
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetBeacon <WWPN | MAC>
Description: Shows the current beacon status for the adapter specified by the WWPN or MAC address.
Parameters:
WWPN - World Wide Port Name of the FC port whose current beacon you want to view.
MAC - MAC address of the NIC or iSCSI port whose current beacon you want to view.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd LoadList <WWPN>
Description: Shows the flash load list data for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose flash load list data you want to view.
LoopBackTest
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd loopback <WWPN | MAC> <Type> <Count> <StopOnError> [Pattern]
Description: Runs the loop test on the adapter specified by the WWPN or MAC address.
Note: Loopback tests can be run on FC ports being managed locally or remotely managed
through TCP/IP-based management.
Parameters:
WWPN - World Wide Port Name of the FC or FCoE port on which you want to run loopback test.
MAC - MAC address of the NIC or iSCSI port on which you want to run loopback test.
Type - 0 = PCI LoopBack Test, 1 = Internal LoopBack Test, 2 = External LoopBack Test (requires
loopback plug), 3 = DMA Loopback Test, 4 = PHY Loopback Test.
Note: Loopback tests 0 and 1are not supported for OneConnect adapters and Loopback
tests 3 and 4 are only supported for OneConnect adapters.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd PostTest <WWPN>
Description: Runs the POST on the adapter. Support for a remote adapter is TCP/IP access only.
Parameters:
WWPN - World Wide Port Name of the adapter on which you want to run a POST.
Wakeup
Note: Not supported for OneConnect adapters.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Wakeup <WWPN>
Description: Shows wakeup parameter data for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose wakeup parameter data you want to view.
Note: Driver Parameters that are set temporarily and globally (using the "G" and "T" flags)
must be read using the "GetDriverParams" hbacmd command to view the current
value of the parameter. The "GetDriverParamsGlobal" hbacmd command will display
only permanently set driver parameter values. Additionally, if temporary, global values
have been set for one or more driver parameters, the "SaveConfig" hbacmd com-
mand must be run with the "N" flag (using the "N" flag is analogous to the hbacmd
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.
DriverConfig
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Note: For VMware ESX Server 3.5: When the DriverConfig driver command is used to set a
driver parameter persistently and/or requires a reboot, the ramdisk must be rebuilt.
Note: Driver Parameters that are set temporarily and globally (using the "G" and "T" flags)
must be read using the "GetDriverParams" hbacmd command to view the current
value of the parameter. The "GetDriverParamsGlobal" hbacmd command will display
only permanently set driver parameter values. Additionally, if temporary, global values
have been set for one or more driver parameters, the "SaveConfig" hbacmd com-
mand must be run with the "N" flag (using the "N" flag is analogous to the hbacmd
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.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SaveConfig <WWPN> <FileName> <Flag>
Description: Saves the specified adapter’s driver parameters to a file. 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>.
Saves either the values of the global set or those specific to the adapter. The file created by this
command is stored in the Emulex Repository directory.
Parameters:
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetDriverParam <WWPN> <Flag1> <Flag2> <Param> <Value>
Description: Changes the value of a driver parameter and designates the scope of that change.
Parameters:
WWPN - World Wide Port Name of the adapter whose driver parameters you want to change.
Flag1 - L = Make change local for this adapter only, G = Make change global (all adapters on this host).
Flag2 - P = Make change permanent (persists across reboot), T = Make change temporary.
Note: For VMware ESX Server version 3.5.0 or earlier, CtrlWord - P = Make change per-
manent, G = Make change global, B = Both, N = Neither.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetDriverParamDefaults <WWPN> <Flag1> <Flag2>
Description: Changes all values to the default for the adapter(s).
Parameters:
WWPN - World Wide Port Name of the adapter whose values you want to change to the default.
Flag1 - L = Make changes local for this adapter only, G = Make changes global (all adapters on this
host).
Flag2 - P = Make changes permanent (persists across reboot), T = Make changes temporary.
Caution: Disruption of service can occur if a diagnostic dump is run during I/O activity.
Note: The diagnostic dump feature enables you to create a “dump” file for a selected
adapter. Dump files contain various information such as firmware version, driver
version, and so on. This information is particularly useful when troubleshooting an
adapter. (Not available in read-only mode.)
DeleteDumpFiles
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd DeleteDumpFiles <WWPN>
Description: Deletes all diagnostic dump files for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose diagnostic dump files you want to delete.
Dump
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server.
Syntax: hbacmd dump <WWPN>
Description: Shows the maximum number of diagnostic dump files that be can stored for an adapter.
Creates a diagnostic dump file in the hbacmd dump file directory.
Parameters:
WWPN - World Wide Port Name of the adapter whose dump information you want to view.
GetDumpDirectory
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetDumpDirectory <WWPN>
Description: Shows the dump file directory associated with the adapter.
Note: The dump directory applies to all adapters in the server. Each adapter does not have
a separate dump directory.
Parameters:
WWPN - World Wide Port Name of the adapter on which you want to view the dump directory.
GetRetentionCount
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetRetentionCount <WWPN>
Description: Shows the maximum number of diagnostic dump files stored for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter on which you want to get the retention count.
SetRetentionCount
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd SetRetentionCount <WWPN> <Value>
Parameters:
WWPN - World Wide Port Name of the adapter on which you want to set the retention count.
Value - Value you want to assign to the set retention count.
GetLunList
Supported by: Windows and Solaris SFS
Syntax: hbacmd GetLunList <HBA WWPN> <Target WWPN> <Option>
Description: Queries for the presence of any LUNs.
Parameters:
HBA WWPN - World Wide Port Name of the adapter you want to query.
Target WWPN - World Wide Port Name of the target you want to query.
Option - 0 = Get information from driver, 1 = Get information from configuration.
GetLunUnMaskbyHBA
Supported by: Windows and Solaris SFS
Syntax: hbacmd GetLunUnMaskByHBA <HBA WWPN> <Option>
Description: Queries for the presence of any unmasked LUNs by adapter.
Parameters:
HBA WWPN - World Wide Port Name of the adapter you want to query.
Option - 0 = Get information from driver, 1 = Get information from configuration.
GetLunUnMaskbyTarget
Supported by: Windows and Solaris SFS
Syntax: hbacmd GetLunUnMaskByTarget <HBA WWPN> <Target WWPN> <Option>
Description: Queries for the presence of any unmasked LUNs by target.
Parameters:
Miscellaneous Commands
<…> = Required, […] = Optional
Download
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Download <WWPN|MAC> <FileName>
Description: Loads the firmware image to the FC or CNA port specified by the WWPN or MAC address.
Parameters:
WWPN - World Wide Port Name of the adapter to which you want to load firmware.
MAC - MAC address of the NIC or iSCSI port to which you want to load firmware.
FileName - File name of the firmware image to load (this can be any file accessible to the CLI client
application).
Note: Due to the amount of information that must be obtained and reported, this command
can take a very long time on large SAN configurations.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd exportsaninfo [format]
Note: [format] is optional. If the format parameter is specified as csv, adapter information is
shown in csv format. If the format parameter is specified as xml, adapter information
is shown in xml format. Leaving the format parameter blank shows the data in xml
format.
Description: For reporting purposes, captures the SAN information in xml or csv format.
Parameters: None
GetVPD
Supported by: Windows, Solaris SFS Linux and VMware ESX Server
Syntax: hbacmd GetVPD <WWPN>
Description: Shows the port’s Vital Product Data (VPD).
Parameters:
WWPN - World Wide Port Name of the adapter whose VPD you want to view.
ListHBAs
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd ListHBAs
Description: Shows a list of the manageable Emulex adapters found by local, remote in-band (over FC),
and remote out-of-band (over TCP/IP) discovery. For a NIC-only or iSCSI adapter instead of the Port
WWN, the MAC address is displayed. The Node WWN and Fabric WWN are not displayed. The Mode
field indicates whether the port is a NIC or an iSCSI port.
Note: The OneCommand Manager application CLI does its own discovery of FC, NIC, and
iSCSI ports and does not use the Discovery server.
Note: The Mode field indicates whether the adapter is operating as a “Target” or an “Initia-
tor”.
Parameters: None
CnaGetEventlog
Note: Supported for OneConnect adapters only.
Note: Supported only for FC and FCoE ports, not supported for NIC and iSCSI ports.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Reset <WWPN>
Description: Resets the adapter. An adapter reset can require several seconds to complete, especially
for remote devices. Once the reset command is completed, the system command prompt is displayed.
Parameters:
WWPN - World Wide Port Name of the adapter you want to reset.
TargetMapping
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd TargetMapping <WWPN>
Description: Shows a list of mapped targets and the LUNs for the port.
Parameters:
WWPN - World Wide Port Name of the adapter whose target mapping you want to view.
Version
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd Version
Description: Shows the current version of the OneCommand Manager CLI Client application.
Parameters: None
GetCimCred
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd GetCimCred
Description: Shows the encrypted value of the password.
Parameters: None
AllNodeInfo
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd AllNodeInfo <WWPN>
Description: Shows target node information for each target accessible by the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose target node information you want to view.
BindingCapabilities
Supported by: Windows and Solaris SFS
Syntax: hbacmd BindingCapabilities <WWPN>
Description: Shows the binding capabilities present for the adapter. If a binding is configured, it means
the binding is maintained across reboots.
Parameters:
WWPN - World Wide Port Name of the adapter whose binding capabilities you want to view.
BindingSupport
Supported by: Windows and Solaris SFS
Syntax: hbacmd BindingSupport <WWPN> <Source>
Description: Shows the binding support available for the adapter.
Parameters:
WWPN - World Wide Port Name of the adapter whose binding support you want to view.
Source - C = Configuration support, L = Live support.
VPort Commands
Note: Supported for FC and FCoE adapters only.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd listvms
Description: Lists all virtual machines and their information for all manageable ports.
If the host is specified with the “h=<host>” option or just the physical wwpn is given, only the virtual
machines for that host are displayed. If the physical port and the virtual port are specified, only the
virtual machine for the specified virtual port is displayed.
Parameters:
Physical WWPN - World Wide Port Name of the adapter on the targets are visible.
Virtual WWPN - The WWPN for the virtual port.
Note: WWN Management validates WWNs very carefully to avoid name duplication. Therefore,
you may see error and warning messages if a name duplication is detected. It is strongly
recommended that the activation requirement be fulfilled after each WWN change or
restore. When running with “pending changes”, some diagnostic and maintenance features
are not allowed.
ChangeWWN
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: ChangeWWN <WWPN> <New WWPN> <New WWNN> <Type>
Description; Changes the volatile or non-volatile state of WWNs. If the volatile change is requested on
an adapter that does not support Volatile WWNs, a “not supported” error is displayed.
Note: When a volatile change is supported, a reboot is required to activate the new setting.
Volatile names are active until system power-down or adapter power-cycle.
Note: For VMware ESX Server: After changing the WWN of an adapter, be sure your zon-
ing settings are updated before you reboot your ESX server. If the zoning is not
updated before your reboot, the subsequent boot may take a long time.
Note: For VMware ESX 4i: After changing the WWN of an adapter, you must reboot the
ESX 4i system before trying to access the adapter on that system. For information on
rebooting the ESX 4i system, refer to VMware documentation.
Note: For ESX 4.0 COS: If you are using the CIM Interface to access adapters, after
changing the WWN of an adapter you must restart the CIMOM (i.e. SFCB) on the
ESX 4.0 COS system before trying to access the adapter on that system. For
information on restarting the CIMOM, refer to VMware documentation.
Parameters:
WWPN - World Wide Port Name of object adapter.
New WWPN - New World Wide Port Name of object adapter.
New WWNN - New World Wide Node Name of object adapter.
Type - 0 = Volatile, 1 = Non-Volatile
Get Capabilities (GetWWNCap on VMware and Solaris)
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd getwwncap <WWPN>
Description: Shows if volatile change is supported for the WWPN.
Parameters:
WWPN - World Wide Port Name of object adapter.
Note: For VMware ESX 4i: After changing the WWN of an adapter, you must reboot the
ESX 4i system before trying to access the adapter on that system. For information on
rebooting the ESX 4i system, refer to VMware documentation.
Note: For ESX 4.0 COS: If you are using the CIM Interface to access adapters, after
changing the WWN of an adapter you must restart the CIMOM (i.e. SFCB) on the
ESX 4.0 COS system before trying to access the adapter on that system. For
information on restarting the CIMOM, refer to VMware documentation.
Parameters:
WWPN - World Wide Port Name of object adapter.
Type - 0 = Restore Default WWNs, 1 = Restore NVRAM WWNs.
iSCSI Commands
Note: iSCSI commands are supported only for OneConnect adapters running the iSCSI
protocol.
The following commands support the iSCSI interface in the OneCommand Manager application CLI. The
commands and their syntax are listed here.
<…> = Required, […] = Optional
The MAC address <MAC_Address> must be passed to each command as the first argument. The MAC
address refers to the CNA port upon which the command will operate.
Some of the commands in this document require that values are set using a format similar to the
following: "option_name=value". This format requires you to either type out the full option name, or the
abbreviated option name detailed in the following table, and then the value.
ShowTargetPortal
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] ShowTargetPortal <MAC_Address> [<Target_IP>
<Port>]
Description: Shows the properties for a specified SendTarget Portal. If the Target_IP and Port are not
specified, all SendTarget Portals and their associated properties are displayed.
Parameters:
MAC_Address - MAC address of the CNA port.
Target_IP - IP address of the target portal (for example: 10.192.1.1).
Port - Port number of the target portal (value: 1024-65535).
ShowTarget
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] ShowTarget <MAC_Address> [iscsi_target_name |
refreshtargets]
Description: Shows the properties for a specified Target. If the iSCSI target name <iscsi_target_name>
is not specified, all targets and their associated properties are displayed. If "refreshtargets" is specified
in place of the iSCSI Target Name, a refresh of all targets will be done before displaying the information.
If no iSCSI Target Name is provided and "refreshtargets" is not specified, only the targets from the last
refresh are displayed.
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
refreshtargets - Refresh all targets before displaying the information.
Note: Only one "Optional" command option can be specified with this command. If the
<iscsi_target_name> is provided, "refreshtargets" cannot be and likewise, if
"refreshtargets" is specified then the <iscsi_target_name> cannot be specified.
TargetLogin
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] TargetLogin <MAC_Address> <iscsi_target_name>
[target_portal_ip <port>] [InitialR2T=<0|1>] [ImmediateData=<0|1>] [HeaderDigest=<0|1>]
[DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]
Description: The iSCSI target name <iscsi_target_name> is the only mandatory option. The target's
portal <target_portal> and port <port> information are optional and if they are not provided a default
target portal will be used. If the remaining options are not specified, these options are set to their default
values. When you set the Authentication Method <Auth> to a value other than "0" additional parameters
must be set to specify the initiator, target CHAP name, and secret strings. These strings should be
enclosed in quotations to avoid mangling by the Windows, Linux, Solaris, or VMware shell's parser.
If the Authentication Method is set to "One-Way CHAP (value of 1)", the "Target CHAP Name" and
"Target Secret" must also be specified.
Example:
hbacmd TargetLogin 00-11-22-33-44-55 iscsitarget Auth=1 "TgtChapName"
"TargetSecret1"
If the Authentication Method is set to "Mutual CHAP (value of 2)", all 4 values must be specified.
Example:
hbacmd TargetLogin 00-11-22-33-44-55 iscsitarget Auth=2 "TgtChapName"
"TargetSecret1" "InitCHAPName" "InitialSecret1"
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
Port - Port number of the Target Portal (value: 1024-65535).
InitialR2T - 0 = No, 1 = Yes (default: 1).
ImmediateData - 0 = No, 1= Yes (default: 1).
HeaderDigest - 0 = None, 1= CRC32C (default: 0).
DataDigest - 0 = None, 1= CRC32C (default: 0).
Auth - 0 = None, 1= One-Way CHAP, 2 = Mutual CHAP (default: 0).
TgtCHAPName - Target CHAP Name enclosed in quotes (string length: 1-256).
TgtSecret - Target Secret enclosed in quotes (string length: 12-16).
InitCHAPName - Initiator CHAP Name enclosed in quotes (string length: 1-256).
TargetLogout
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] TargetLogout <MAC_Address>
<iscsi_target_name> <TSIH | <ISID_Qual Target_IP>>Description: Logout of a session. The required
fields are the iSCSI target name <iscsi_target_name> and either the TSIH <TSIH> of the session or the
session's ISID qualifier <ISID_Qual> and the target's IP address <Target_IP>.
Parameters:
MAC_Address - The MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
TSIH - TSIH value of the session to log out (values: 1-65535).
ISID_Qual - ISID qualifier of the session to logout (value: 0-65535)
Target_IP - The Target's IP address.
AddTargetPortal
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.
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] AddTargetPortal <MAC_Address> <Target_IP>
<Port> [InitialR2T=<0|1>] [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>]
[Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]
Description: Adds a new SendTarget Portal for the initiator and runs a target discovery once the
SendTarget Portal is created. This command requires that a valid portal IP address <Target_IP> and a
valid port number <Port> are specified. If the remaining options are not specified, these options are set
to their default values. When you set the Authentication Method <Auth> to a value other than "0"
additional parameters must be set to specify the initiator, target CHAP name, and secret strings. These
strings should be enclosed in quotations to avoid mangling by the Windows, Linux, Solaris, or VMware
shell's parser.
If the Authentication Method is set to "One-Way CHAP (value of 1)", the "Target CHAP Name" and
"Target Secret" must also be specified.
Example:
hbacmd AddTargetPortal 00-11-22-33-44-55 10.0.0.1 8000 Auth=1 "TgtCHAPName"
"TargetSecret1"
If the Authentication Method is set to "Mutual CHAP (value of 2)", all 4 values must be specified.
Example:
hbacmd AddTargetPortal 00-11-22-33-44-55 10.0.0.1 8000 Auth=2 "TgtChapName"
"TargetSecret1" "InitCHAPName" "InitialSecret1"
Parameters:
MAC_Address - MAC address of the CNA port.
RemoveTargetPortal
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] RemoveTargetPortal <MAC_Address> <Target_IP>
<Port>
Description: Removes the SendTarget Portal containing the target IP <Target_IP> and the port <Port>
from the list of portals for the specified initiator.
Parameters:
MAC_Address - MAC address of the CNA port.
Target_IP - IP address of the Target Portal.
Port - Port number of the Target Portal (value: 1024-65535).
AddTarget
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] AddTarget <MAC_Address> <Target_IP> <Port>
<iscsi_target_name> [InitialR2T=<0|1>] [ImmediateData=<0|1>] [HeaderDigest=<0|1>]
[DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]
Description: Adds a target to the list of targets seen by the initiator and logs into the target once it has
been successfully created. This command requires that a valid target IP <Target_IP>, port number
<Port>, and iSCSI name <iscsi_target_name> are all specified. If the remaining options are not
specified, these options are set to their default values. When you set the Authentication Method <Auth>
to a value other than "0" additional parameters must be set to specify the initiator, target CHAP name,
and secret strings. These strings should be enclosed in quotations to avoid mangling by the Windows,
Linux, Solaris, or VMware shell's parser.
If the Authentication Method is set to "One-Way CHAP (value of 1)", the "Target CHAP Name" and
"Target Secret" must also be specified.
Example:
SetTargetLoginProperties
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] SetTargetLoginProperties <MAC_Address>
<iscsi_target_name> [InitialR2T=<0|1>] [ImmediateData=<0|1>] [HeaderDigest=<0|1>]
[DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]
Description: Sets the login and authentication properties associated with a specific target. This
command requires that a valid iSCSI target name <iscsi_target_name> is specified. If some of the
remaining properties are not specified, these options are set to their default values. However, if no
properties are changed, an error is generated. At least one property must be altered for this command to
return successfully. When you set the Authentication Method <Auth> to a value other than "0" additional
parameters must be set to specify the initiator, target CHAP name, and secret strings. These strings
should be enclosed in quotations to avoid mangling by the Windows, Linux, Solaris, or VMware shell's
parser.
If the Authentication Method is set to "One-Way CHAP (value of 1)", the "Target CHAP Name" and
"Target Secret" must also be specified.
Example:
hbacmd SetTargetLoginProperties 00-11-22-33-44-55 iscsitarget Auth=1 "TgtCHAPName"
"TargetSecret1"
If the Authentication Method is set to "Mutual CHAP (value of 2)", all 4 values must be specified.
RemoveTarget
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] RemoveTarget <MAC_Address>
<iscsi_target_name>
Description: Removes the target with the specified iSCSI target name <iscsi_target_name>.
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
ShowiSNSServer
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] ShowiSNSServer <MAC_Address>
Description: Shows the currently configured Internet Storage Name Server. This command also
indicates whether or not iSNS discovery is enabled.
Parameters:
MAC_Address - MAC address of the CNA port.
DiscoveriSNSServer
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] DiscoveriSNSServer <MAC_Address>
GetiSCSILuns
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] GetiSCSILuns <MAC_Address>
<iscsi_target_name>
Description: Shows all the LUNs and their information for a specified target. The iSCSI target name
<iscsi_target_name> instructs the command to gather the information from the specified iSCSI target.
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
ListSessions
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] ListSessions <MAC_Address>
<iscsi_target_name>
Description: Lists all the sessions on a specified target. The iSCSI target name <iscsi_target_name>
instructs the command to gather the information from the listed iSCSI target name.
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
GetSessionInfo
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] GetSessionInfo <MAC_Address>
<iscsi_target_name> <TSIH | <ISID_Qual Target_IP>>
Description: Lists all session information for a specified session. The iSCSI target name
<iscsi_target_name> and either the TSIH <TSIH> of the session or the session's ISID Qualifier
<ISID_Qual> and the target's IP address <Target_IP> must be specified. These parameters instruct the
command to gather the information from the specified target and session. The TSIH and ISID qualifier
can be determined by running the ListSessions command.
Parameters:
MAC_Address - MAC address of the CNA port.
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255).
TSIH - TSIH value of the session (value: 1-65535).
ISID_Qual - 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.
Note: IP_Address and Subnet_Mask are required only if DHCP is set to "Disabled";
otherwise these values should be omitted.
GetiSCSIPortStats
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] GetiSCSIPortStats <MAC_Address>
Description: Shows all the port statistics for a specified port.
Parameters:
MAC_Address - MAC address of the CNA port.
GetQoSInfo
Supported by: Windows, Solaris SFS, Linux and VMware ESX Server
Syntax: hbacmd [h=host_IP[:port] | hostname[:port]] GetQoSInfo <MAC_Address>
Description: Shows the QoS information for a specified NIC port.