vhba

The vhba command creates a vHBA and attaches it to an existing server profile. The command can also customize a vHBA, remove a vHBA, and display additional information about the vHBA. For instructions on creating a server profile, see server-profile.

Syntax

add vhba vhba.server-profile slot/port none [–local-id=ID] [–mtu=mtu-size] [–wwn-id=wwn-suffix]
remove vhba {vhba.server-profile|wildcard} [–noconfirm]
set vhba {vhba.server-profile|wildcard} clear stats [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} down [–descr=text] [–fabric-link-down-timeout=
     {number|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} full-scan [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} prescan [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} remove-prescan [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} rescan [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
set vhba {vhba.server-profile|wildcard} up [–descr=text]
     [–fabric-link-down-timeout={value|default}] [–if={slot/port|none}]
show vhba {vhba.server-profile|wildcard} alarms [–detail]
show vhba {vhba.server-profile|wildcard} errors [–detail]
show vhba {vhba.server-profile|wildcard} stats [–detail]
show vhba {vhba.server-profile|wildcard} target [–detail]
show vhba {vhba.server-profile|wildcard} targets [–detail]
show vhba {vhba.server-profile|wildcard} throughput [–detail]
show vhba {vhba.server-profile|wildcard} warnings [–detail]
show vhba {vhba.server-profile|wildcard} where [cmds-per-lun|descr|fabric-state|
     flags|if|if-state|local-id|luns-per-target|mtu|name|state|wwnn|wwpn]
     expression operator [–detail]

where:

• expression is evaluated to produce a value.

• operator matches strings following a specific pattern. For a list of operators, see Filters.

• server-profile is the name of a server profile that you already created.

• slot /port are the physical slot and port numbers.

• vhba is the name of the vHBA. It must be unique in the Oracle server profile to which it is assigned.

• wildcard allows you to specify selected wildcard characters (for example, *) to facilitate executing a command.

This hardware command has subcommands that determine its functionality. This table describes the subcommands and provides their syntax.

Subcommand Description alarms Displays vHBA alarms. clear Clears items from the vHBA and leaves it in the state it was in when you issued the clear command. The vHBA can be explicitly named, or you can use a wildcard character (for example, *) to clear all vHBAs. down Deactivates the vHBA and causes the disks on the server to become inoperable. The vHBA can be explicitly named, or you can use a wildcard character (for example, *) to turn down all vHBAs. errors Displays vHBA errors. full-scan Scans for devices using the port login. none Specifies no interface when adding a vHBA. prescan Configures prescan state for an unbound vHBA. remove-prescan Removes a prior configured prescan state, which is required in order to re-issue a new prescan state. After you perform a prescan, the configuration resides on the I/O card. rescan Configures rescan state for a bound vHBA. When running rescan, if any vHBAs are in down state, the rescan process completes and then displays the vHBAs in a down state. stats Displays vHBA statistics. target Displays the storage target attached to the vHBA. targets Displays the storage targets attached to the vHBA. throughput Displays throughput speed for the vHBA. up Brings the vHBA online. The vHBA can be explicitly named, or you can use a wildcard character (for example, *) to bring all vHBAs online. warnings Displays vHBA warnings. where Displays filter criteria, expressions, and operators: cmds-per-lun – Displays the number of commands allowed per LUN. descr – Displays the text describing the vHBA. fabric-state – Describes the state of the fabric, which can be up, down, indeterminate, initialized, or uninitialized. flags – Indicates if LUNs are enabled for a vHBA. if – Displays the termination port. if-state – Displays the interface state. local-id – Displays the ID used by the ESX server to map its HBA to this vHBA. luns-per-target – Displays the number of LUNs allowed per target. mtu – Displays the MTU of the vHBA. name – Displays the name of the vHBA. state – Displays the admin or oper state of the vHBA. wwnn – Displays the World Wide Node Name wwpn – Displays the World Wide Port Name. For a list of operators, see Filters.

Description

An IB connection exists between the fabric interconnect and host servers supporting the Oracle Virtual Networking vHBA host software stack. Up to 24 IB ports are supported. A 2-port FC I/O card connects to an FC switch fabric. All the host server vHBAs multiplex through the FC ports on the I/O card. A storage array is attached to the switch fabric. Initiators are host servers that request I/O processing and actively seek out and interact with target devices. Targets are passive storage devices (arrays, JBODs, RAIDs, and so on) that respond to requests sent by initiators. The Oracle Fabric Interconnect itself is an I/O initiator that provides a conduit for host-server initiators to send commands to the fabric.

The vHBA host software defines how the FC protocol will be transported (in or out) over IB. Without this software and the details of the transport, the vHBA will not function and the payload cannot be sent over IB.

Options

Option Description –descr Applies a text description to the vHBA. Quotes are required around multiple words containing spaces in between. Optional. –detail Displays detailed information (if available) for the vHBA. Optional. –fabric-link-down-timeout Sets a value in milliseconds for the IB fabric to be down before the vHBA is put in operational state down. Set a value between 0 and 255. The default is 0, which can be set through the number zero (0) or through the keyword default. The new value becomes effective after you reboot the FC card. –if Sets a termination slot and port for the vHBA. This option can be used to terminate the vHBA on a different FC port if needed. –local-id The identifier used by ESX Server to map its HBA to this vHBA. Enter 1 to 32. Each ID must be unique per ESX Server. –mtu Size of the MTU: 2048 – 2 MByte 256 – 256 Kbyte 512 – 512 KByte 1024 – 1 Mbyte default – 256 Kbyte –noconfirm Allows you to remove vHBAs without displaying a confirmation prompt. This option assumes yes to the prompt asking for confirmation, and if used, no warning messages will be displayed and the vHBA will be immediately deleted. –wwn-id Specifies a particular WWN. This option allows you to enter the WWN suffix, which is the last 12 bits of the WWN address. The WWN suffix is a 12-bit hexadecimal number from 100 to FFF.

Description

When you bring a vHBA online, it attempts to discover all the attached targets that are available to it. You can also have the vHBA relearn attached targets without bringing the vHBA down, and then up. See Target Prescan and Rescan in Oracle Fabric OS 1.0.2 Administration Guide.

Example: Create a Basic vHBA

This example shows how to create a server profile named crawford and bind it to a physical server connection. The example also shows how to find an FC card and an FC slot and port, and create and bind a vHBA to the server profile. The last command verifies that the vHBA was created.

[OFOS] add server-profile crawford ceasar@iowa:ServerPort24
[OFOS] show iocard
slot       state     descr    type                  v-resources
---------------------------------------------------------------
3          up/up              sanFc2Port16GbCard    0
4          up/up              sanFc2Port16GbCard    2                             
embedded   up/up              spineIb4Gw2PortCard   0                             
3 records displayed
[OFOS] show ioport
name       type               state      descr      v-resources
---------------------------------------------------------------
1/1        sanFc1GbPort       up/up                 0
1/2        sanFc1GbPort       up/up                 0
2/1        sanFc1GbPort       up/up                 0
2/2        sanFc1GbPort       up/up                 0
3/1        sanFc1GbPort       up/up                 0
3/2        sanFc1GbPort       up/up                 0
4/1        sanFc1GbPort       up/up                 1
4/2        sanFc1GbPort       up/up                 1
8 records displayed

[OFOS] add vhba vhba1.crawford 2/1
[OFOS] show -list vhba vhba1.crawford
--------------------------------------
name           vhba1.crawford
state          up/up
fabric-state   up/up
if             2/1
if-state       
wwnn           50:01:39:71:00:02:D1:1E
wwpn           50:01:39:70:00:02:D1:1E
local-id       0
--------------------------------------
1 record displayed

Example: Discover Targets for a VHBA and Bind the Server Profile

This example shows how to discover and display targets attached to a vHBA. The last command shows how to bind the targets to the host server profile.

[OFOS] set vhba vhba1.crawford prescan
[OFOS] show vhba vhba1.crawford targets
vhba             wwnn                     wwpn                     lun-ids
--------------------------------------------------------------------------
vhba1.crawford   2F:9F:00:06:2B:10:C3:BA  2F:9F:00:06:2B:10:C3:BA  3,2,1,0
vhba2.crawford   2F:BF:00:06:2B:10:C3:BA  2F:BF:00:06:2B:10:C3:BA  3,2,1,0
vhba3.crawford   2F:DF:00:06:2B:10:C3:BA  2F:DF:00:06:2B:10:C3:BA  3,2,1,0
vhba4.crawford   2F:FF:00:06:2B:10:C3:BA  2F:FF:00:06:2B:10:C3:BA  3,2,1,0
--------------------------------------------------------------------------
4 records displayed
[OFOS] set server-profile crawford connect ceasar@iowa:ServerPort24

Example: Display vHBA Statistics

[OFOS] show vhba vhba1.crawford stats
--------------------------------------------------
name                                vhba1.crawford
total-io                            27136
read-byte-count                     3380540138
write-byte-count                    0
outstanding-request-count           0
io-request-count                    27136
read-request-count                  27042
write-request-count                 0
task-management-request-count       94
target-count                        36
xsmp-xt-down-count                  3
xsmp-xt-oper-state-request-count    4
map-fmr-count                       27042
ummap-fmr-count                     27042
used-map-fmr-count                  0
abort-command-count                 0
reset-target-command-count          0
reset-bus-command-count             0
link-down-count                     1
disc-info-update-count              3
target-lost-count                   0
target-found-count                  0
cqp-disconnect-count                4
dqp-disconnect-count                4
cqp-ib-snd-err-count                1
dqp-ib-snd-err-count                0
cqp-ib-rcv-err-count                0
dqp-ib-rcv-err-count                0
cqp-ib-remote-disconnect-err-count  0
dqp-ib-remote-disconnect-err-count  0
---------------------------------------------------
1 record displayed