Hbacmd syntax usage – Dell Emulex Family of Adapters User Manual

Page 313

Advertising
background image

OneCommand Manager Command Line Interface Version 10.2 User Manual

P010067-01A Rev. A

4. CLI Client Command Usage

HbaCmd Syntax Usage

313

HbaCmd Syntax Usage

The following syntax rules and usage apply to the HbaCmd application:

Parameters denoted within angle brackets < > are required.

Parameters denoted within square brackets [ ] are optional.

For Linux and Solaris, (which are case-sensitive), program names must be in

lowercase letters, therefore, the command line must begin with “hbacmd”

(rather than “HbaCmd”). Windows is not case-sensitive, so the program name

is not required to be in all lowercase letters.

In order to run the command on a remote host, an IP address or host name must

be specified using the “h” option with the following syntax:

hbacmd [h=IP_Address[:port] | Hostname[:port]] <command> [parameters]

If the “h” option is omitted, the command is run on the local host.

If the “h” option is specified, the command is sent to the specified remote

host (assuming it is specified correctly, the remote host is up, and the remote

host is running the OneCommand Manager remote management agent.

The “:port” option is optional. If omitted, the OneCommand Manager

remote management protocol uses the default TCP port. If specified, it uses

the user-specified TCP port.

Examples:

Using the IP address:

hbacmd h=138.239.91.121 ListHBAs

Using the host name:

hbacmd h=cp-hp5670 ListHBAs

The “h” option is available for all commands except for the AddHost

(page 398), RemoveHost (page 403), and the Version (page 407) commands.

For FC ports, the WWPN of the adapter must be specified. Where the WWPN is

specified, each pair of numbers within the WWPN is separated by colons (:) or

spaces ( ). When using space separators, the entire WWPN must be enclosed in

quotes (“ ”). For example, the following command displays the port attributes

for the adapter with the specified WWPN:

hbacmd PortAttributes 10:00:00:00:c9:20:20:20

For iSCSI and NIC ports, the MAC address must be specified. Where a MAC

address is specified, each pair of numbers within the MAC address is separated

by a dash (-). For example, the following command sets the target properties for

the NIC port with the specified MAC address with an extended timeout value

of “1”:

hbacmd SetTargetProperties 00-11-22-33-44-55 iscsiTarget 1

For NIC ports, only the permanent MAC address is supported for the port

address parameter on an HbaCmd command line.
Normally, for a NIC port, the port’s permanent MAC address and current MAC

address parameters are equal. However, it is possible to set a user-specified

(current) MAC Address that is different from the permanent MAC address.

Advertising