HP Virtual Connect 8Gb 24-port Fibre Channel Module for c-Class BladeSystem User Manual

HP Virtual Connect Manager Command Line Interface for c-Class BladeSystem Version 3.51/3.60

User Guide

Abstract

This document contains user information for the HP Virtual Connect Manager version 3.51/3.60 CLI. This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels.

Part Number: 677486-003

June 2012

Edition: 3

© Copyright 2012 Hewlett-Packard Development Company, L.P.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.

Microsoft®, Windows®, and Windows NT® are U.S. registered trademarks of Microsoft Corporation.

Contents
Introduction..................................................................................................................................	6
What's new..............................................................................................................................................	6
Changes from VC 3.30 to 3.51 ........................................................................................................	6
Virtual Connect overview............................................................................................................................	6
Using multiple enclosures..................................................................................................................	7
Command line overview.............................................................................................................................	8
Command line syntax ................................................................................................................................	8
Parameters .....................................................................................................................................	8
Options..........................................................................................................................................	9
Properties .......................................................................................................................................	9
Command batching .........................................................................................................................	9
Supporting comments and blank lines in CLI scripts ............................................................................	10
Unassigning multiple profiles...........................................................................................................	11
CLI command execution modes .................................................................................................................	11
Remote access to the Virtual Connect Manager ...........................................................................................	12
Command output filtering .........................................................................................................................	12
Command line............................................................................................................................	13
Subcommands ........................................................................................................................................	13
Managed elements..................................................................................................................................	13
all ...............................................................................................................................................	15
version.........................................................................................................................................	15
banner .........................................................................................................................................	15
config ..........................................................................................................................................	16
configbackup................................................................................................................................	17
devicebay ....................................................................................................................................	19
domain ........................................................................................................................................	19
enclosure......................................................................................................................................	22
enet-connection .............................................................................................................................	23
enet-vlan ......................................................................................................................................	26
external-manager ..........................................................................................................................	27
fabric...........................................................................................................................................	29
fc-connection.................................................................................................................................	31
fcoe-connection .............................................................................................................................	34
firmware ......................................................................................................................................	37
igmp............................................................................................................................................	37
igmp-group...................................................................................................................................	38
interconnect ..................................................................................................................................	38
interconnect-mac-table....................................................................................................................	40
iscsi-boot-param ............................................................................................................................	40
iscsi-connection .............................................................................................................................	43
ldap ............................................................................................................................................	46
ldap-certificate ..............................................................................................................................	47
ldap-group....................................................................................................................................	48
link-dist-interval..............................................................................................................................	49
lldp..............................................................................................................................................	50
log-target......................................................................................................................................	50
Contents	3

loop-protect ..................................................................................................................................	52
mac-cache ....................................................................................................................................	53
nag-network..................................................................................................................................	54
network........................................................................................................................................	55
network-access-group .....................................................................................................................	59
network-range ...............................................................................................................................	60
port-monitor ..................................................................................................................................	63
profile ..........................................................................................................................................	65
radius ..........................................................................................................................................	69
radius-group .................................................................................................................................	70
role .............................................................................................................................................	72
server ..........................................................................................................................................	73
serverid........................................................................................................................................	75
server-port ....................................................................................................................................	76
server-port-map .............................................................................................................................	76
server-port-map-range.....................................................................................................................	78
snmp ...........................................................................................................................................	79
snmp-trap .....................................................................................................................................	80
ssh...............................................................................................................................................	83
ssl ...............................................................................................................................................	84
ssl-certificate .................................................................................................................................	84
ssl-csr ...........................................................................................................................................	85
stackinglink...................................................................................................................................	86
statistics........................................................................................................................................	86
statistics-throughput ........................................................................................................................	88
status ...........................................................................................................................................	88
storage-management......................................................................................................................	89
supportinfo ...................................................................................................................................	90
systemlog .....................................................................................................................................	91
tacacs ..........................................................................................................................................	91
uplinkport .....................................................................................................................................	92
uplinkset.......................................................................................................................................	95
user .............................................................................................................................................	97
user-security ..................................................................................................................................	98
vcm .............................................................................................................................................	99
User privileges ......................................................................................................................................	100
Help subsystem .....................................................................................................................................	104
Output format .......................................................................................................................................	106
Interactive user output format ........................................................................................................	106
Scriptable output format ...............................................................................................................	108
Statistics descriptions .............................................................................................................................	110
Ethernet modules .........................................................................................................................	110
Fibre Channel modules.................................................................................................................	120
Configuring the Virtual Connect domain using the CLI...................................................................	125
Basic configuration................................................................................................................................	125
Logging in to the CLI ....................................................................................................................	125
Domain setup..............................................................................................................................	126
Network setup.............................................................................................................................	129
Server VLAN Tagging Support ......................................................................................................	134
Fibre Channel setup.....................................................................................................................	135
Serial number settings ..................................................................................................................	136
Server profile setup......................................................................................................................	137
Logging out of the CLI ..................................................................................................................	147
	Contents 4

Common management operations ...........................................................................................................	147
Port status conditions .............................................................................................................................	148
Resetting the Virtual Connect Manager.....................................................................................................	149
Support and other resources ......................................................................................................	151
Before you contact HP............................................................................................................................	151
HP contact information...........................................................................................................................	151
Acronyms and abbreviations......................................................................................................	152
Documentation feedback ...........................................................................................................	156
Index.......................................................................................................................................	157

Contents 5

Introduction

What's new

The command line interface user guide contains the following changes for VC 3.51:

•The output for the show server-port command has been updated.

Changes from VC 3.30 to 3.51

Command	Changes	Virtual Connect 3.30	Virtual Connect 3.51
show server-port	This command now shows the link	The FlexNIC port	The FlexNIC port
	status for FlexNIC ports. The	output columns were	output columns are
	profile column has been	Adapter Type,	Status, Network, MAC
	removed. The profile associated	Network, MAC	Address, Fabric, Port,
	with the FlexNIC ports is now	Address, Fabric, Port,	and WWN.
	displayed as part of the physical	WWN, and Profile.
	port information.

Virtual Connect overview

HP Virtual Connect is a set of interconnect modules and embedded software for HP BladeSystem c-Class enclosures that simplifies the setup and administration of server connections. Virtual Connect includes the following components:

•VC-Enet modules

o HP 1/10Gb Virtual Connect Ethernet Module for c-Class BladeSystem

o HP 1/10Gb-F Virtual Connect Ethernet Module for the c-Class BladeSystem o HP Virtual Connect Flex-10 10Gb Ethernet Module for BladeSystem c-Class

o HP Virtual Connect FlexFabric 10Gb/24-port Module for BladeSystem c-Class, which provides the capability to configure Ethernet and FC/FCoE or iSCSI connections

•VC-FC modules

o HP 4Gb Virtual Connect Fibre Channel Module for c-Class BladeSystem

o HP Virtual Connect 4Gb Fibre Channel Module for BladeSystem c-Class (enhanced NPIV) o HP Virtual Connect 8Gb 24-Port Fibre Channel Module for BladeSystem c-Class

o HP Virtual Connect 8Gb 20-Port Fibre Channel Module for BladeSystem c-Class

•HP Virtual Connect Manager

Virtual Connect implements server edge virtualization between the server and the data center infrastructure so networks can communicate with pools of HP BladeSystem servers, and so you can upgrade, replace, or move server blades within the enclosures without changes being visible to the external LAN and SAN environments. The external networks connect to a shared resource pool of servers rather than to individual

Introduction 6

servers. Virtual Connect cleanly separates server enclosure administration from LAN and SAN administration.

VCM is embedded on the VC-Enet module. You can access VCM through a web-based GUI or CLI. The Onboard Administrator provides a web link to the Virtual Connect GUI.

The VC modules support the HP BladeSystem c7000 Enclosure, the HP BladeSystem c3000 Enclosure, and all the server blades and networks contained within the enclosure. FlexFabric modules are only supported in BladeSystem c7000 enclosures and G6 or newer server blades with Virtual Connect firmware v3.15 and later.

VC-Enet modules enable connectivity to all brands of data center Ethernet switches. VC-Enet modules can also be directly connected to other types of devices, such as printers, laptops, rack servers, and network storage devices.

The VC-FC and FlexFabric modules enable connectivity of the enclosure to Brocade, Cisco, McDATA, or QLogic data center FC switches. Every FC fabric is limited in the number of switches it can support, but the VC-FC modules do not appear as switches to the FC fabric and do not count against FC fabric limits.

A basic Virtual Connect domain includes a single HP c-Class BladeSystem c7000 Enclosure for a total of 16 servers (or up to 32 servers if the double-dense option is enabled), or a single HP c-Class BladeSystem c3000 Enclosure for a total of 8 servers (or up to 16 servers if the double-dense option is enabled). For more information on the double-dense option, see "Double-dense server bay option" in the user guide. Within the domain, any server blade with the requisite LAN or SAN devices can access any LAN or SAN connected to a VC module, and a server blade of a given processor type (Integrity or X86) can be used as a spare for any server blade of the same processor type within the same enclosure, as long as the server has the requisite number and type of connections. Using network access groups feature, the network administrator can clearly define a separation of networks based on their allowed functionality and prevent the server administrator from assigning specific network combinations in the same server profile.

By stacking (cabling) the VC-Enet modules together within the domain and connecting the VC-FC or FlexFabric module FC uplinks on the same bay of all enclosures to the same FC switch, every server blade in the domain can be configured to access any external network or fabric connection. With this configuration, you can use VCM to deploy and migrate a server blade profile to any server in the Virtual Connect domain without changing external LAN or SAN configurations.

Using multiple enclosures

Multiple enclosure support enables up to four c7000 enclosures to be managed within a single Virtual Connect domain for a total of 128 servers, if double-dense support is enabled while using the Domain Setup Wizard. There are 16 half-height or 8 full-height server bays in a c7000 enclosure. A combination of full-height and half-height servers can be used in the same enclosure.

Multiple enclosure domains are not supported on c3000 enclosures. The VC-Enet or FlexFabric modules use stacking cables between enclosures so that network traffic can be routed from any server Ethernet port to any uplink within the VC domain. Since FC does not support stacking, the VC-FC or FlexFabric module FC uplinks on the same bay of all enclosures must be connected to the same FC switch to enable profile mobility.

The management interfaces for all enclosure Onboard Administrators and VC modules within the same VC domain must be on the same lightly loaded subnet and highly reliable network. Overloads or loss of connectivity can disable configuration attempts until the connectivity is re-established and synchronized with the domain. The Onboard Administrator IP addresses used must be configured to be static. The Onboard Administrator user credential for all enclosures must be consistent to enable VCSU firmware updates for VC modules in the remote enclosures. All FC-capable modules in the same horizontally adjacent bay pair (bays 1-2, 3-4, and so on) must be of the same type and position in all enclosures.

Introduction 7

Multi-enclosure double-dense domains require similar and compatible VC-FC modules in bays 5, 6, 7, and 8 in all enclosures if FC connectivity is required. If a multi-enclosure double-dense configuration contains incompatible VC-FC modules in bays 5, 6, 7, or 8 in the local or remote enclosures, some or all of the compatible VC-FC modules in the remote enclosures might be designated INCOMPATIBLE after import.

Command line overview

The VCM Command Line Interface can be used as an alternative method for administering the VCM. Using the CLI can be useful in the following scenarios:

•You can develop tools that utilize VCM functions for data collection and for executing provisioning and configuration tasks.

•When no browser is available or you prefer to use a command line interface, you can access management data and perform configuration tasks.

•You can batch commands using script files. These script files can be run manually or scheduled to run automatically.

Command line syntax

CLI input is case-insensitive, except when otherwise noted. The general CLI syntax format is as follows:

<subcommand> <managed element> <parameters> [<options>] [<properties>]

Item	Description
subcommand	Operation performed on a managed element
managed element	Target management entity
parameters	Command extensions for a particular management operation
options	Attributes used to customize or control command execution behavior such as output
	format, quiet-mode, and others
properties	One or more name and value pairs that are accessories to the command operation,
	mainly for set and add operations

Example: ->add user mark password=asdf89g fullname="Mark Smith" enabled=true

In the example, add is the subcommand, user is the managed element, mark is a required parameter for the operation, password is a required property, and fullname and enabled are optional properties.

Depending on the specific command being executed, certain parameters or properties might be required. For example, when adding a new user, both a parameter representing the user name, as well as a password (in the form of a property) must be specified. All other user properties are optional at the time the user is added. In general, the properties are in the format name=value. Separate multiple properties with spaces.

Parameters

Parameters are command extensions that provide extra information needed for the execution of a particular command. Whether or not a parameter is required depends on the specific command being executed. For example, the show user command has an optional parameter, which represents the user name if the user instance is being managed. If show user is entered without the optional parameter, then a summary listing of all users is shown. However, if the optional parameter (user name) is provided, only a single user instance is displayed, for example, show user paul.

Introduction 8

Some commands require that a parameter be specified, for example, the add user command. The required parameter is the user name (add user jake), and if the username is not provided, an error message displays indicating that a required parameter is missing.

Options

Options enable users to control certain behavior characteristics available during the command execution. Some examples of options include controlling output format and specifying a quiet mode to suppress interactive prompts.

Distinguish options from other command line elements by using a preceding hyphen (-). Option arguments are required or optional, depending on the option being specified. For example, the -output option requires an argument, which is a list of one or more output format attributes. However, the -quiet option does not require any arguments to be specified.

The general format of a CLI option is as follows:

-<option>[=argument1>,<argument2>, . . .] Example: ->show user suzi -output=script1

In the example, -output is the option, and script1 is an option argument.

Properties

Properties are specific configuration attributes of a managed element. Properties are commonly used during set operations or add operations where a managed element is being modified or created. In some limited circumstances, properties might also be used as a part of a show or other command.

IMPORTANT: If a property value contains embedded spaces, then the entire property value must be contained within single or double quotes. Likewise, if a double quote is part of a property value, it should be contained within single quotes, and if a single quote is part of a property value, it should be contained within double quotes.

Command batching

Scripts are useful for batching many CLI commands. You can create a single CLI script to configure an entire VC domain from scratch and use it on multiple enclosures.

When using a Linux SSH client, simply redirect the script into SSH. If the SSH keys are not configured on the client and in the firmware, a password prompt appears. To enable script automation and better security, SSH

public/private key-pairs can be generated and uploaded to the public key to the VC firmware. For example:

>ssh Admin@192.168.0.120 < myscript.txt

When using a Windows-based SSH client, pass the file to the client using the -m option. If the SSH keys are not configured on the client and in the firmware, a password prompt appears. To allow script automation and better security, SSH public/private key-pairs can be generated and uploaded to the public key to the VC

firmware. For example:

>plink Admin@192.168.0.120 -m myscript.txt

The CLI enables you to enter multiple CLI commands in a single command-line invocation. This capability is useful when batching several commands together and executing them in a particular sequence, within the context of the same SSH session. This method improves the overall performance of lengthy script processing.

Example 1: Sample commands with no command batching

Introduction 9

add profile Profile1 add network Network1 add uplinkset UplinkSet1

Example 2: Sample commands using command batching

add profile Profile1;add network Network1;add uplinkset UplinkSet1

Supporting comments and blank lines in CLI scripts

The CLI supports command scripts that contain blank lines and comments. Support for comments and blank lines enables you to maintain descriptive notes within the configuration script.

The following sample script illustrates a CLI script that contains this type of formatting. All comment lines must begin with "#".

#------------------------------------------------------------------------

#This is my sample Virtual Connect Domain Configuration Script

#Revision 1.0.1.2

#February 15, 2012

#------------------------------------------------------------------------

# Add Users

add user SomeNetworkUser password=pass1 privileges=network add user SomeStorageUser password=pass2 privileges=storage add user SomeDomainUser password=pass6 privileges=domain add user SomeAdminUser password=pass3 privileges=*

add user DomainNetworkUser password=764dhh privileges=domain,network

#Add Profiles with Default VC-Enet and VC-FC Connections add profile MyProfile

add profile AnotherProfile add profile Profile45

#Add VC-Enet Networks

add network MyNetwork add network Network2

# Add uplink ports to the networks

add uplinkport enc0:1:1 network=MyNetwork add uplinkport enc0:1:2 network=Network2

# Create a Shared Uplink Port Set add uplinkset SharedSet1

Introduction 10

#Assign a profile to a device bay assign profile MyProfile enc0:1

#Done!!!

Unassigning multiple profiles

The unassign profile command includes the ability to unassign multiple profiles from device bays with a single command.

The following example illustrates four server profiles being unassigned from device bays with a single CLI command. If an operation fails on one of the device bays, an error message appears for that server or device

bay, but the remaining operations continue.

->unassign profile *

SUCCESS: Profile1 unassigned from device bay enc0:1 SUCCESS: MyProfile2 unassigned from device bay enc0:2 SUCCESS: GreenProfile unassigned from device bay enc0:3 SUCCESS: RedProfile unassigned from device bay enc0:4

CLI command execution modes

The Virtual Connect Manager CLI provides two different methods for executing commands: interactive shell mode and non-interactive mode.

Interactive Shell Mode

This mode is used to invoke CLI command operations with the dedicated management shell. The shell is provided after you log in with valid credentials, and only accepts known VCM CLI commands as input. You can quit the shell by using the exit command. See the example of logging in to the interactive management

shell below. In the example, the primary VCM is located at IP address 192.168.0.120.

>ssh 192.168.0.120

login as: michael password: ***********

--------------------------------------------------------------------

HP Virtual Connect Management CLI v3.51/3.60

(C) Copyright 2006-2012 Hewlett-Packard Development Company, L.P. All Rights Reserved

--------------------------------------------------------------------

GETTING STARTED:

help	:	displays a list of available subcommands
exit	:	quits the command shell
<subcommand> ? :		displays a list of managed elements for a subcommand

<subcommand> <managed element> ? : displays detailed help for a command ->

Non-Interactive Mode

Introduction 11

In some cases, you might want to write automated scripts that execute a single command at a time. These scripts can be used to batch several commands in a single script file from the SSH client. See the example of how to use the non-interactive mode for CLI command execution below. In the example, the primary VCM is

located at IP address 192.168.0.120.

->ssh Administrator@192.160.0.120 show enclosure <command output displayed to user's screen>

IMPORTANT: To suppress prompting for a password during login, you must first setup the SSH encryption keys using the VCM Web GUI, and configure your SSH client properly with the keys. For additional information on configuring the SSH keys, see the HP Virtual Connect for c-Class BladeSystem User Guide.

Remote access to the Virtual Connect Manager

To access the VCM CLI remotely through any SSH session:

1.Using any SSH client application, start an SSH session to the Virtual Connect Manager.

2.When prompted, enter the assigned IP address or DNS name of the Virtual Connect Manager.

3.Enter a valid user name.

4.Enter a valid password. The CLI command prompt appears.

5.Enter commands for the Virtual Connect Manager.

6.To terminate the remote access SSH session, close the communication software or enter exit at the CLI command prompt.

To access the VCM CLI remotely through the Onboard Administrator CLI, run the connect interconnect command from the Onboard Administrator CLI.

Command output filtering

The CLI provides output filtering capabilities that enable you to display only properties of interest. This feature is useful for filtering large amounts of output data for specific information. One or more properties can be specified in the output filtering rules.

The following examples illustrate some common usage scenarios for output filtering:

Example 1: Displaying all enabled users

->show user enabled=true

Example 2: Displaying all VC Ethernet modules

->show interconnect type=VC-ENET

Example 3: Displaying all external uplinks that have a link established

->show uplinkport status=linked

Example 4: Displaying all uplink ports with connector type of RJ-45 and speed configured to Auto

->show uplinkport type=RJ45 Speed=Auto

Example 5: Displaying all servers currently powered on

->show server power=On

Introduction 12

Command line

Subcommands

Command	Description
add	Add a new object to the domain or to another object
assign	Assign a server profile to a device bay
copy	Copy a configuration from one server profile to another server profile
delete	Delete the domain configuration
exit	Exit the Virtual Connect Manager command-line shell
help	Display context-sensitive help for a command or object
import	Import an enclosure into the domain
load	Transfer a file from a remote location to the domain
poweroff	Power off one or more servers
poweron	Power on one or more servers
reboot	Reboot one or more servers
remove	Remove or delete an existing object (for example, users or profiles)
reset	Perform a reset operation on an object (for example, vcm)
restore	Restore a file from a remote location
save	Transfer a file from the domain to a remote location
set	Modify one or more configuration properties of an object
show	Display properties or information about an object
test	Test the configuration of an object (for example, log-target)
unassign	Unassign a server profile from a device bay

Managed elements

Managed element	Description
all (on page 15)	Display all VC domain-managed elements
banner (on page 15)	Manage the login screen banner configuration
config (on page 16)	Display all commands for all objects defined in the domain
configbackup (on page 17)	Manage configuration backup and restore operations
devicebay (on page 19)	Display enclosure device bay information
domain (on page 19)	Manage general Virtual Connect domain settings and
	information
enclosure (on page 22)	Manage general enclosure settings and information
enet-connection (on page 23)	Manage Ethernet network connections
enet-vlan (on page 26)	Manage Ethernet VLAN connections
external-manager (on page 27)	Manage external manager settings and information
fabric (on page 29)	Manage Fibre Channel SAN fabrics
	Command line 13

Managed element	Description
fc-connection (on page 31)	Manage Fibre Channel SAN fabric connections
fcoe-connection (on page 34)	Manage FCoE SAN fabric connections
firmware (on page 37)	Manage interconnect module firmware
igmp (on page 37)	Manage Ethernet IGMP Snooping settings
igmp-group (on page 38)	Display interconnect module IGMP Group table information
interconnect (on page 38)	Manage I/O interconnect modules
interconnect-mac-table (on page 40)	Display interconnect module MAC table information
iscsi-boot-param (on page 40)	Manage iSCSI boot parameters
iscsi-connection (on page 43)	Manage iSCSI connections
ldap (on page 46)	Manage LDAP configuration settings
ldap-certificate (on page 47)	Manage LDAP certificate information
ldap-group (on page 48)	Manage LDAP group configuration settings
link-dist-interval (on page 49)	Manage the FC login re-distribution interval
lldp (on page 50)	Display LLDP information received on a port
log-target (on page 50)	Manage remote log destination settings
loop-protect (on page 52)	Manage network loop protection settings
mac-cache (on page 53)	Manage Ethernet MAC cache failover settings
nag-network (on page 54)	Manage network access group memberships
network (on page 55)	Manage Virtual Connect Ethernet networks
network-access-group (on page 59)	Manage network access groups
network-range (on page 60)	Manage ranges of networks
port-monitor (on page 63)	Monitor port monitor configurations
profile (on page 65)	Manage Virtual Connect server profiles
radius (on page 69)	Manage RADIUS authentication settings
radius-group (on page 70)	Manage RADIUS group configuration settings
role (on page 72)	Manage user authentication order by access role (privilege)
server (on page 73)	Manage physical HP BladeSystem server blades
serverid (on page 75)	Manage virtual server ID configuration settings
server-port (on page 76)	Display all physical server ports
server-port-map (on page 76)	Manage shared server downlink port mapping configuration
server-port-map-range (on page 78)	Manage ranges of shared server downlink port mapping
	configurations
snmp (on page 79)	Modify SNMP configurations
snmp-trap (on page 80)	Modify SNMP-trap configurations
ssh (on page 83)	Manage SSH configuration and information
ssl (on page 84)	Manage SSL configuration and Information
ssl-certificate (on page 84)	Manage SSL certificate information
ssl-csr (on page 85)	Manage an SSL certificate signing request
stackinglink (on page 86)	Display stacking link information and status
statistics (on page 86)	Display or reset statistics on a designated interconnect module
	port
statistics-throughput (on page 88)	Manage the port throughput statistics
status (on page 88)	Display overall Virtual Connect domain status information
storage-management (on page 89)	Manage iSCSI storage management information
	Command line 14

Managed element	Description
supportinfo (on page 90)	Manage Virtual Connect support information
systemlog (on page 91)	Display Virtual Connect Manager system event log
tacacs (on page 91)	Manage TACACS+ authentication settings
uplinkport (on page 92)	Manage interconnect module uplink ports
uplinkset (on page 95)	Manage shared uplink port sets
user (on page 97)	Manage local Virtual Connect user configurations
user-security (on page 98)	Manage user security settings
vcm (on page 99)	Manage the Virtual Connect domain manager
version (on page 15)	Display CLI version information

The following sections provide detailed information on how to use the subcommands with each managed element.

To display command help, enter a command followed by ? or -help. For more information on the help subcommand, see "Help subsystem (on page 104)."

all

Manage all Virtual Connect domain elements.

Supported actions: help, show

Item	Description
show all	Display all Virtual Connect domain configuration objects. This command is
	typically useful for displaying a snapshot of the entire domain configuration with a
	single command.
Syntax	show all [*]
Examples
	->show all
	Displays all configuration objects (summary view)
	->show all *
	Displays all configuration objects (detailed view)

version

Display CLI version information.

Supported actions: help, show

Item	Description
show version	Display CLI version information.
Syntax	show version
Example	->show version
	Displays CLI version and copyright information

banner

Manage the login screen banner configuration.

Command line 15

Supported actions: add, help, remove, show

Item	Description
add banner	Add banner text to the login screen. You can access VCM through ssh or the OA.
	After banner text is added, the banner is displayed before the user credential
	prompt when VCM is accessed.
Syntax	add banner text=[”<banner text>”|’<banner text>’]
Properties
text (required)	The text to display on the login in screen. Multi-line banner text can be entered
	through multiple add banner commands. New lines are appended to existing
	text. The banner text limit is 1500 bytes. If the accumulated banner text length
	exceeds 1500 bytes, either from one or multiple add banner commands, an
	error message appears. Only printable characters are allowed.
Examples
	->add banner text="This is a private system, unauthorized
	access is not allowed."
	Adds banner text with a single command
	->add banner text="This is a private system."
	->add banner text=""
	->add banner text="Unauthorized access is prohibited."
	->add banner text=""
	->add banner text="Communications are monitored."
	Adds banner text with multiple commands (A blank line is displayed in between
	each line of text in this example.)

Item	Description
remove banner	Remove configured banner text.
Syntax	remove banner
Example
	->remove banner
	Removes the configured banner text

Item	Description
show banner	Display the configured banner text.
Syntax	show banner
Example
	->show banner
	Displays the configured banner text

config

Display all CLI commands for all objects defined in the domain. The show config command is useful for generating a CLI script that can be used for creating a domain configuration. The generated script is only valid for the firmware version currently running. A script generated on one version of firmware is unlikely to be properly executed by a different version of firmware.

There are no bulk commands. Using the generated CLI script to create a large configuration with more than 300 networks is not recommended, as it can take a long time unless you rewrite the script to use the bulk commands.

Command line 16

Any useror VC-defined MAC addresses, WWNs, and logical serial numbers will not appear in the output to avoid duplicating these values.

Supported actions: help, show

Item	Description
show config	Generate a configuration script from the running domain.
Syntax	show config
Example
	->show config
	Displays the configuration script for the running domain

configbackup

Manage the domain configuration file.

Supported actions: help, restore, save

Item	Description
restore configbackup	Transfer a configuration file from a remote TFTP or FTP server and restore the
	configuration. Be sure that the domain state is IMPORTED before attempting to
	restore the configuration.
Syntax	restore configbackup [-quiet][-maskEncryptKey]
	address=<tftp://ipaddress/[filename] |
	ftp://user:password@ipaddress/[filename]>
	[encryptionkey=<secret password>]
	[ignoreenclosureid=<true|false>]
	[ignorefwversion=<true|false>]
Option
quiet (optional)	Suppresses user confirmation prompts
maskEncryprtKey	Enables you to interactively specify the encryption key as a masked string at the
(optional)	command prompt
Properties
Address (required)	A valid IP address of a TFTP or FTP server with user name and password (where
	needed) and the name of the configuration backup file. If not specified, the
	default file name is "vc-config-backup". The file path specified is treated as
	relative to the login directory for the user on the FTP server. Be sure that the
	permissions are appropriate for a successful transfer.
EncryptionKey	A password used to encrypt the configuration backup file
(optional)
IgnoreEnclosureID	Restores a configuration that was generated on another enclosure. Valid values
(optional)	are "true" and "false". The default value is "false". When the value is set to
	"false", the configuration generated on another enclosure is rejected.
IgnoreFWVersion	Restores a configuration that was generated on another firmware version. Valid
(optional)	values are "true" and "false". The default value is "false". When the value is set
	to "false", the configuration generated on another firmware version is rejected.
Example
	->restore configbackup
	address=tftp://192.168.10.12/<filename>
	Restores a configuration backup file from a remote TFTP server
	->restore configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	Restores a configuration backup file from a remote FTP server
	Command line 17

Item	Description
	->restore configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	ignoreenclosureid=true
	Restores a configuration backup file from a remote FTP server and ignores the
	serial number
	->restore configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	ignorefwversion=true
	Restores a configuration backup file from a remote FTP server and ignores the
	firmware version
	->restore configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	encryptionkey=secret
	Restores a configuration backup file from a remote FTP server with an encryption
	key
	->restore configbackup -maskEncryptKey
	address=ftp://user:password@192.168.10.12/<filename>
	Restores a configuration backup file from a remote FTP server with a masked
	encryption key
	->restore configbackup -quiet
	address=ftp://192.168.10.12/<filename>
	Restores a configuration backup file without user confirmation prompts

Item	Description
save configbackup	Generate and transfer a Virtual Connect configuration backup file to a remote
	TFTP or FTP server.
Syntax	save configbackup [-maskEncryptKey]
	address=<tftp://ipaddress/[filename] |
	ftp://user:password@ipaddress/[filename]>
	[encryptionkey=<secret password>]
Option
maskEncryprtKey	Enables you to interactively specify the encryption key as a masked string at the
(optional)	command prompt
Properties
Address (required)	A valid IP address of a TFTP or FTP server with user name and password (where
	needed) and the name of the configuration backup file. If not specified, the
	default file name is "vc-config-backup". The file path specified is treated as
	relative to the login directory for the user on the FTP server. Be sure that the
	permissions are appropriate for a successful transfer.
EncryptionKey	A password used to encrypt the configuration backup file
(optional)
Examples
	->save configbackup
	address=tftp://192.168.10.12/<filename>
	Saves a configuration backup file to a remote TFTP server
	->save configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	Saves a configuration backup file to a remote FTP server
	->save configbackup
	address=ftp://user:password@192.168.10.12/<filename>
	encryptionkey=secret
	Saves a configuration backup file to a remote FTP server with an encryption key

Command line 18

Item	Description
	->save configbackup -maskEncryptKey
	address=ftp://user:password@192.168.10.12/<filename>
	Saves a configuration backup file to a remote FTP server with a masked
	encryption key

devicebay

Manage general enclosure device bay settings and information.

Supported actions: help, show

Item	Description
show devicebay	Display device bays of all enclosures that exist in the Virtual Connect domain.
Syntax	show devicebay [<DeviceBayID>|*]
Parameter
DeviceBayID	The reference ID of a device bay in the domain
(Optional)	The format of the device bay ID is <EnclosureID:DeviceBay>.
	Example: “enc0:1” indicates device bay 1 of the local enclosure being managed.
	Use "*" to display detailed information for all enclosures.
	If EnclosureID is not specified, the default enclosure is the local enclosure where
	the Virtual Connect Manager and domain exist.
	If a multi-blade server is present, use the DeviceBayID of the monarch bay. This is
	the ID value shown by show devicebay.
Examples
	->show devicebay
	Displays a summary listing of all device bays
	->show devicebay *
	Displays detailed information for all device bays
	->show devicebay enc0:2
	Displays detailed information for device bay 2 of the local enclosure
	->show devicebay enc1:4
	Displays detailed information for device bay 4 of a remote enclosure
	->show devicebay enc0:5
	Displays detailed information for a multi-blade server in device bays 5-8 of the
	primary enclosure.

domain

Manage general Virtual Connect domain settings and information.

Supported actions: delete, help, set, show

Item	Description
delete domain	Delete the existing Virtual Connect domain configuration.
	Deleting the domain removes the entire Virtual Connect domain configuration and
	resets it to the original defaults. After the domain is deleted, you are logged out and
	the Virtual Connect Manager resets.
Syntax	delete domain [-quiet]
Option
quiet	Suppresses user confirmation prompts. This option is useful when scripting delete
	domain operations.
	Command line 19

Item	Description
Examples
	->delete domain
	Deletes the Virtual Connect domain configuration and prompts for user
	confirmation
	->delete domain -quiet
	Deletes the Virtual Connect domain quietly without prompting for user confirmation
	(primarily used in automated scripting scenarios)

Item	Description
set domain	Modify general Virtual Connect domain configuration properties, such as the
	domain name, domain IP address, and MAC and WWN address pool settings.
Syntax	set domain [Name=<NewName>] [DomainIp=<Enabled|Disabled>]
	[IpAddress=<IPAddress>] [SubnetMask=<mask>]
	[Gateway=<Gateway>] [MacType=<VC-Defined|Factory-Default|
	User-Defined>] [MacPool=<1-64>] [MacStart=<MAC address>]
	[MacEnd=<MAC address>] [WwnType=<VC-Defined |
	Factory-Default | User-Defined>] [WwnPool=<1-64>]
	[WwnStart=<WWN Address>] [WwnEnd=<WWN Address>]
	[SingleDense=true|false]
Properties
Name(optional)	The new name of the domain. Valid characters include alphanumeric, "_", and ".".
	The maximum length of the name is 31 characters.
DomainIP (optional)	Enables or disables the Virtual Connect domain IP address. If enabled, a valid IP
	address and subnet mask must be configured. If disabled, DHCP is used to obtain
	a valid IP address.
	Enabling domain IP address configuration or changing the domain IP address can
	cause a temporary loss of connectivity to the Virtual Connect Manager. Use caution
	when changing these settings. Valid values include "Enabled" and "Disabled".
IpAddress (Required	A valid IP address to use for the domain IP address configuration. The IP address
if DomainIP is	must be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and 9, for
enabled)	example, 192.168.0.10.
SubnetMask (Required	A valid subnet mask for the domain IP address configuration. The subnet mask must
if IP address	be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and 9, for
specified)	example, 255.255.255.0.
Gateway (Required if	A valid gateway address for the domain IP address configuration. The gateway
IP address	address must be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and
specified)	9, for example, 192.168.0.1.
MacType (optional)	The type of MAC address source to use for assignment. Valid values include
	"VC-Defined", "Factory-Default", and "User-Defined".
MacPool (optional)	The pre-defined MAC pool to use for address assignment. Valid values include
	integers from 1 to 64. This property is valid only if the MacType is set to
	"VC-Defined". If not specified, the default pool ID is 1.
MacStart (Required	The starting MAC address in a custom user-defined range. This property is valid
if MacType is	only if the MacType is set to "User-Defined".
User-Defined)
MacEnd (Required if	The ending MAC address in a custom user-defined range. This property is valid
MacType is	only if the MacType is set to "User-Defined".
User-Defined)
WwnType(optional)	The type of WWN address source to use for assignment. Valid values include
	"VC-Defined", "User-Defined", and "Factory-Default".
WwnPool(optional)	The pre-defined WWN pool to use for address assignment. Valid values include
	integers from 1 to 64. This property is valid only if the WwnType is set to
	"VC-Defined". If not specified, the default pool ID is 1.
	Command line 20

Item	Description
WwnStart (Required	The starting WWN address in a custom user-defined range. This property is valid
if WwnType is	only if the WwnType is set to "User-Defined".
User-Defined)
WwnEnd (Required if	The ending WWN address in a custom user-defined range. This property is valid
WwnType is	only if the WwnType is set to "User-Defined".
User-Defined)
SingleDense	If the imported domain supports double-dense server blades, this property enables
(optional)	the device bay display format to support the display for single-dense servers along
	with the double-dense servers. In a double-dense supported configuration, the
	default for this property is false, which disables the display of single-dense servers.
Examples
	->set domain Name=MyNewDomainName
	Changes the name of the Virtual Connect domain
	->set domain DomainIp=Enabled
	Enables the domain IP address
	->set domain DomainIp=Enabled IpAddress=192.168.0.120
	SubnetMask=255.255.255.0 Gateway=192.168.0.1
	Configures the domain IP address and enables it
	->set domain DomainIp=Disabled
	Disables the domain IP address and uses DHCP instead
	->set domain MacType=VC-Defined MacPool=10
	Sets the MAC address source to VC-Defined with a pre-defined range
	->set domain MacType=Factory-Default
	Sets the MAC address source to use factory default MAC addresses
	->set domain MacType=User-Defined MacStart=00-17-A4-77-00-00
	MacEnd=00-17-A4-77-00-FF
	Sets the MAC address source to a custom, user-defined address range
	->set domain WwnType=VC-Defined WwnPool=5
	Sets the WWN address source to VC-Defined with a pre-defined range
	->set domain WwnType=Factory-Default
	Sets the WWN address source to use factory default WWN addresses
	->set domain WwnType=User-Defined
	WwnStart=50:06:0B:00:00:C2:62:00
	WwnEnd=50:06:0B:00:00:C2:62:FF
	Sets the WWN address source to a custom, user-defined address range
	->set domain SingleDense=true
	Sets the display option to support single-dense servers in a double-dense supported
	configuration

Item	Description
show domain	Display general Virtual Connect domain information, including the Virtual Connect
	domain name, the VCM domain IP address settings, and MAC/WWN address
	settings for the domain.
Syntax	show domain [addressPool]
Parameter
addressPool	Displays all VC-defined address pool range available for use
(Optional)
Examples
	->show domain
	Displays domain information
	->show domain addressPool
	Displays the VC-defined address pools for the domain
	Command line 21

enclosure

Manage general enclosure settings and information.

Supported actions: help, import, remove, show

Item	Description
import enclosure	Import local and remote enclosures into the Virtual Connect domain. Virtual
	Connect supports up to four c7000 enclosures in a single domain.
Syntax	import enclosure [<IPv4Address|DNSname>]
	[UserName=<username>] [Password=<password>]
	[DoubleDense=<True|False>]
	For enclosures that are not imported, the password field is optional. If not
	specified, the system interactively prompts you for the password.
Parameter
IpAddress (Optional)	The IPv4 address or DNS name of the remote enclosure to be imported. If not
	specified, the local enclosure is assumed.
Option
quiet	This option suppresses user confirmation prompt while importing a remote
	enclosure, and is typically used in automated scripting scenarios.
Properties
UserName (Required for	A valid user name with access to the Onboard Administrator for the enclosure to
enclosures that are	import. The user must have full administrative rights to all enclosure elements,
not imported)	such as device bays, I/O bays, and OAs).
Password (Required)	A valid OA user password for importing the enclosure. If no password is
	specified, the system interactively prompts you for a password during the import
	operation.
DoubleDense	This setting can only be specified during the import of the local enclosure, and it
(Optional)	affects the behavior of all other enclosures imported later.
	If the enclosure being imported supports double-dense servers, this property
	enables the device bay display format to display double-dense servers. The
	default behavior is to display single-dense servers in the enclosure.
Examples
	->import enclosure UserName=Administrator Password=fgg7h*1
	Imports the local enclosure into the domain
	->import enclosure UserName=Administrator Password=fgg7h*1
	DoubleDense=true
	Imports the local enclosure with a double-dense device bay display format
	->import enclosure 2001::34/64 UserName=admin
	password=am123
	Imports a remote enclosure into the domain
	->import enclosure
	Imports the previously discovered local enclosure
	->import enclosure 192.168.0.120
	Imports a previously discovered remote enclosure

Item	Description
remove enclosure	Remove a remote enclosure that has been imported into the domain. The local
	enclosure cannot be removed from the domain using the remove enclosure
	command.
Syntax	remove enclosure <EnclosureID|*>
Parameter
	Command line 22

Item	Description
EnclosureID	The enclosure ID of the remote enclosure to be removed from the domain. Use "*"
(required)	to remove all remote enclosures in the domain. The enclosure IDs can be
	identified for a particular enclosure by using the show enclosure command.
	The local enclosure cannot be removed from the domain with this command.
Examples
	->remove enclosure encl
	Removes a remote enclosure
	->remove enclosure *
	Removes all remote enclosures from the domain

Item	Description
show enclosure	Display all enclosures in the domain.
Syntax	show enclosure [<EnclosureID>|*]
Parameter
EnclosureID	The ID of an enclosure in the domain. If specified, only details for that enclosure
(optional)	appear.
Examples
	->show enclosure
	Displays a summary of all enclosures
	->show enclosure *
	Displays detailed information for all enclosures
	->show enclosure enc0
	Displays detailed information for a specific enclosure

enet-connection

Manage Ethernet network connections.

Supported actions: add, help, remove, set, show

Item	Description
add enet-connection	Add a new Ethernet network connection to an existing server profile.
	The maximum number of Ethernet connections that can be added to a
	server profile is 128.
Syntax	add enet-connection <ProfileName>
	[Network=<NetworkName>]
	[PXE=<enabled|disabled|UseBios>]
	[AddressType=<Factory-Default|User-Defined>]
	[EthernetMAC=<MAC Address> iScsiMAC=<MAC Address>]
	[SpeedType=<Auto|Preferred|Custom>] [Speed=<speed>]
Parameter
ProfileName (required)	The name of an existing profile to which the new connection is added
Properties
Network (optional)	The name of an existing network to associate with the connection. If the
	network name is not specified, or is set to "unassigned", the network
	remains unassigned and can be assigned later.
PXE (optional)	Enables or disables PXE on the network connection. Valid values are
	"enabled", "disabled", and "UseBios". If not specified, the default is
	"UseBios".
	Only one connection can have PXE enabled per profile.
	Command line 23

Item	Description
AddressType (optional)	The source of MAC address assignments to be used during the creation of
	the new connection. If not specified, the default is the domain default. If
	"User-Defined" is specified, both an Ethernet MAC Address and iSCSI
	MAC Address must also be specified. Valid values include
	"Factory-Default" and "User-Defined".
	IMPORTANT: "User-Defined" addresses within the domain address pool
	range are permanently depleted from the pool and can only be re-used as
	"User-Defined". Deleting the profile does not return the address to the
	pool. Deleting the domain is the only way to return "User-Defined"
	addresses to the pool.
EthernetMAC (required if	The user-defined Ethernet MAC address to use for the connection. This
AddressType is	property is required if the AddressType specified is "User-Defined".
User-Defined)
iScsiMAC (required if	The user-defined iSCSI MAC address to use for the connection. This
AddressType is	property is required if the AddressType specified is "User-Defined".
User-Defined)
SpeedType (optional)	The requested operational speed for the server port. Valid values include
	"Auto", "Preferred", and "Custom". The default value is "Preferred".
	If the speed type is "Auto", the maximum port speed is determined by the
	maximum configured speed for the network.
	If the speed type is "Preferred", the speed of the network is the same as the
	preferred speed of the network to which the connection is associated. If no
	preferred speed is configured for a network, it defaults to "Auto".
	If the speed type is "Custom", you can configure a speed from 100Mb to
	MAX configured speed for the network in 100Mb increments.
Speed (required if the	The user-defined speed for the server port. Valid values include 100Mb to
SpeedType is Custom)	MAX configured speed for the network in 100Mb increments.
Examples
	->add enet-connection MyNewProfile
	Network=SomeNetwork
	Adds a new Ethernet network connection to a profile
	->add enet-connection MyNewProfile
	Network=SomeNetwork2 PXE=enabled
	Adds a new Ethernet network connection and enables PXE
	->add enet-connection MyNewProfile
	Adds a new Ethernet network connection and leaves the network
	unassigned
	->add enet-connection MyNewProfile
	AddressType=Factory-Default
	Adds a new Ethernet network connection and uses factory default
	addresses
	->add enet-connection MyNewProfile
	AddressType=User-Defined
	EthernetMAC=00-17-A4-77-00-00
	iScsiMAC=00-17-A4-77-00-01
	Adds a new Ethernet network connection and provides user-defined MAC
	addresses
	->add enet-connection MyProfile Network=MyNetwork
	SpeedType=Preferred
	Adds a new Ethernet network connection and sets the speed to
	"Preferred"
	->add enet-connection MyProfile Network=MyNetwork
	SpeedType=Custom Speed=2000
	Adds a new Ethernet network connection and sets the speed to 2Gb
	Command line 24

Item	Description
remove enet-connection	Remove the last Ethernet network connection from an existing server
	profile.
Syntax	remove enet-connection <ProfileName>
Parameter
ProfileName (required)	The name of the profile from which the Ethernet connection is removed
Example
	->remove enet-connection MyProfile
	Removes an Ethernet network connection from a profile

Item	Description
set enet-connection	Modify an Ethernet connection of a server profile.
Syntax	set enet-connection <ProfileName> <Port>
	[Network=<NetworkName>]
	[PXE=<enabled|disabled|UseBios>]
	[SpeedType=<Auto|Preferred|Custom>] [Speed=<speed>]
Parameters
ProfileName (required)	The name of the server profile that contains the connection to modify
Port (required)	The port number of the connection being modified
Properties
Network (optional)	The name of the Ethernet network to associate with the connection. This
	applies to Ethernet network connections only. A blank string makes the
	Ethernet connection unassigned.
PXE (optional)	Enables or disables PXE on a connection. Valid values are "enabled",
	"disabled", and "UseBios". This applies to Ethernet network connections
	only.
	PXE can be enabled on one connection per profile.
SpeedType (optional)	The requested operational speed for the server port. Valid values include
	"Auto", "Preferred", and "Custom". The default value is "Preferred".
	If the speed type is "Auto", the maximum port speed is determined by the
	maximum configured speed for the network.
	If the speed type is "Preferred", the speed of the network is the same as the
	preferred speed of the network to which the connection is associated. If no
	preferred speed is configured for a network, it defaults to "Auto".
	If the speed type is "Custom", you can configure a speed from 100Mb to
	MAX configured speed for the network in 100Mb increments.
Speed (required if the	The user-defined speed for the server port. Valid values include 100Mb to
SpeedType is Custom)	MAX configured speed for the network in 100Mb increments.
Examples
	->set enet-connection MyProfile 2
	Network=NewNetworkName
	Changes the associated network of an Ethernet connection
	->set enet-connection RedProfile 1 Network=""
	Sets a network connection to "Unassigned"
	->set enet-connection GreenProfile 3 PXE=disabled
	Disables PXE on an Ethernet connection
	->set enet-connection MyProfile 1 SpeedType=Preferred
	Modifies the Ethernet network connection to set the speed to "Preferred"
	->set enet-connection MyProfile 1 SpeedType=Custom
	Speed=2000
	Modifies the Ethernet network connection to set the speed to 2Gb
	Command line 25

Item	Description
show enet-connection	Display the Ethernet connections associated with the server profiles.
Syntax	show enet-connection [<ConnectionID>]
Parameter
ConnectionID (optional)	The ID of an existing Ethernet connection. The ID format is
	<ProfileName:Port>. Use <ProfileName:*> to display all profile
	Ethernet connections. Use "*" to display all connections in the domain.
Examples
	->show enet-connection *
	Displays all Ethernet connections in the domain
	->show enet-connection Profile1:*
	Displays all Ethernet connections of a profile named Profile1
	->show enet-connection Profile1:1
	Displays a specific Ethernet connection of a profile named Profile1

enet-vlan

Manage Ethernet VLAN configuration settings.

Supported actions: help, set, show

Item	Description
set enet-vlan	Modify general Ethernet VLAN configuration settings.
Syntax	set enet-vlan [-quiet][SharedServerVLanId=<true|false>]
	[PrefSpeedType=<Auto|Custom>] [PrefSpeed=<speed>]
	[MaxSpeedType=<Unrestricted|Custom>] [MaxSpeed=<speed>]
	[VlanCapacity=<Legacy|Expanded>]
Option
quiet	This option suppresses user confirmation prompt, and is typically used in
	automated scripting scenarios.
Properties
SharedServerVLanId	Enables or disables the option to force server ports connected to multiple VC
(optional)	Ethernet networks to use the same VLAN mappings as those used by
	corresponding shared uplink sets. Valid values include "true" and "false".
	Setting the value to "true" restricts the server network connections to be selected
	from a single shared uplink, and the VLAN ID cannot be modified.
	Setting the value to "false" enables you to select any VC Ethernet network for the
	server Ethernet connections, and VLAN ID mappings can be modified to ensure
	uniqueness.
PrefSpeedType	The default connection speed for any Ethernet connection using multiple
(optional)	networks. Valid values include "Auto" and "Custom". "Custom" enables you to
	configure the preferred speed. The default value is "Auto".
PrefSpeed (required if	The default connection speed for any Ethernet connection using multiple
PrefSpeedType is	networks. Valid values range from 100Mb to 10Gb in 100Mb increments.
Custom)
MaxSpeedType	The maximum connection speed for any Ethernet connection using multiple
(optional)	networks. Valid values include "UnRestricted" and "Custom". "Custom" enables
	you to configure the preferred speed. The default value is "Unrestricted".
MaxSpeed (required if	The maximum connection speed for any Ethernet connection using multiple
MaxSpeedType is	networks. Valid values range from 100Mb to 10Gb in 100Mb increments.
Custom)
	Command line 26

Item	Description
VlanCapacity	The VLAN capacity mode. Valid values include 'Legacy' and 'Expanded'.
(optional)	'Legacy' mode allows up to 320 VLANs per module and 28 VLANs per server
	connection. All VC-Enet modules are supported. This is the default setting.
	'Expanded' mode allows up to 1000 VLANs per domain and 162 VLANs per
	physical server port. 1/10Gb Ethernet modules are NOT supported.
UplinkResources	The number of VLAN translations allocated to the uplinks. This attribute can be set
(optional)	only when VlanCapacity is "Extended". Valid values range from 240 to 4080 in
	increments of 16 (enclosure) or 24 (rack). The default value is 640.
Examples
	->set enet-vlan SharedServerVLanId=true
	Enables SharedServerVLanId
	->set enet-vlan PrefSpeedType=Custom PrefSpeed=500
	MaxSpeedType=Custom MaxSpeed=2500
	Sets the preferred connection speed for all connections using multiple networks to
	500Mb, and the maximum connection speed to 2.5Gb
	->set enet-vlan VlanCapacity=Expanded
	Sets the VLAN capacity mode to Expanded to allow for larger network
	configurations

Item	Description
show enet-vlan	Display general Ethernet VLAN configuration settings.
Syntax	show enet-vlan
Example
	->show enet-vlan
	Displays Ethernet VLAN configuration settings

external-manager

Manage external manager settings and information.

Supported actions: help, remove, set, show

Item	Description
remove	Remove an existing external manager (VCEM) and regain local management
external-manager	profile control of the domain.
	When releasing the profile control, you must specify values for each MacType,
	WwnType, and ServerIdType.
	IMPORTANT: You must set the external manager enabled to "false" using the set
	external-manager command before using the remove external-manager
	command.
Syntax	remove external-manager [-quiet] [UserName=<username>]
	[MacType=<Factory-Default| User-Defined>] [MacStart=<MAC
	address>] [MacEnd=<MAC address>]
	[WwnType=<Factory-Default|User-Defined>] [WwnStart=<WWN
	address>] [WwnEnd=<WWN address>]
	[ServerIdType=<Factory-Default| User-Defined>]
	[ServerIdStart=<ServerId address>] [ServerIdEnd=<ServerId
	address>]
Option
quiet	This option suppresses user confirmation prompts and is useful when scripting
	operations.
	Command line 27

Item	Description
Properties
UserName (optional)	A valid external manager user name. The user name can be identified using the
	show external-manager command.
MacType (optional)	The type of MAC address source to use for assignment. Valid values include
	"Factory-Default" and "User-Defined".
MacStart (required	The starting MAC address in a custom user-defined range. This property is valid
if the MacType is	only if the MacType is set to "User-Defined".
User-Defined)
MacEnd (required if	The ending MAC address in a custom user-defined range. This property is valid
the MacType is	only if the MacType is set to "User-Defined".
User-Defined)
WwnType (optional)	The type of WWN address source to use for assignment. Valid values include
	"Factory-Default" and "User-Defined".
WwnStart (required	The starting WWN address in a custom user-defined range
if the WwnType is
User-Defined)
WwnEnd (required if	The ending WWN address in a custom user-defined range
the WwnType is
User-Defined)
ServerIdType	The type of the virtual serial number source. When server profiles are created, the
(optional)	virtual serial numbers and UUID values are allocated from the specified pool
	source. Valid values include "Factory-Default" and "User-Defined".
ServerIdStart	The starting serial number in a user-defined range. This property is only valid for
(required if Type is	user-defined serial number types.
User-Defined)
ServerIdEnd	The ending serial number in a user-defined range. This property is only valid for
(required if Type is	user-defined serial number types.
User-Defined)
Examples
	->show external-manager
	->set external-manager UserName=A17005068 Enabled=false
	(where A17005068 is the username reported by the previous command)
	->remove external-manager username=A17005068
	mactype=User-Defined MacStart=00-17-A4-77-00-00
	MacEnd=00-17-A4-77-03-FF wwnType=User-Defined
	WwnStart=50:06:0B:00:00:C2:62:00
	WwnEnd=50:06:0B:00:00:C2:65:FF serverIdType=User-Defined
	serverIdStart=VCX0000000 serverIdEnd=VCX00000ZZ
	Displays the username, disables the external manager, and then removes the
	external manager and releases the profile control
	->remove external-manager UserName=A17005068
	Removes only the external management control of the VC Manager
	->remove external-manager macType=Factory-Default
	wwnType=Factory-Default serverIdType=Factory-Default
	Releases only the profile control
	->remove external-manager username=A1010345
	macType=Factory-Default wwnType=Factory-Default
	serverIdType=Factory-Default
	Removes the external manager and releases the profile control

Item	Description
set external-manager	Enable or disable the control of an existing external manager over the Virtual
	Connect domain.
Syntax	set external-manager [-quiet] UserName=<username>
	Enabled=<true|false>
	Command line 28

Item	Description
Option
quiet	Suppresses user confirmation prompts and is useful when scripting operations
Properties
UserName (required)	A valid external manager user name. The user name can be identified using the
	show external-manager command.
Enabled (required)	Enables or disables the external manager. Valid values include "true" and "false".
Examples
	->set external-manager UserName=A17005068 Enabled=false
	Disables the external manager
	->set external-manager UserName=A17005068 Enabled=true
	Enables the external manager

Item	Description
show	Display the information of an existing external manager.
external-manager
Syntax	show external-manager
Example
	->show external-manager
	Displays the information of an existing external manager

fabric

Manage Fibre Channel SAN fabrics.

Supported actions: add, help, remove, set, show

Item	Description
add fabric	Add a new fabric to the domain.
Syntax	add fabric <Name> Bay=<BayNum> Ports=<PortList>
	[Speed=<Auto|2Gb|4Gb|8Gb>] [LinkDist=<Auto|Manual>]
Parameter
Name (required)	A unique name for the new fabric being added to the domain.
Properties
Bay (required)	The specific interconnect bay number with which the fabric is associated.
Ports (required)	A list of one or more logical FC ports to be added to the fabric. Each port is specified
	in the format "<port1>,<port2>,...", where port is the interconnect module port number
	to be added to the fabric, for example "1, 2, 3, 4" (affects all modules within a bay
	group).
	For HP VC FlexFabric 10Gb/24-port Modules, port numbers 1, 2, 3, and 4
	correspond to ports X1, X2, X3, and X4, respectively.
Speed (optional)	The port speed for the uplink ports in the fabric. Valid values include "Auto", "2Gb",
	"4Gb", and "8Gb". The default port speed is "Auto".
	Speed restrictions:
	• For the HP 4Gb VC-FC Module and HP Virtual Connect 4Gb FC Module, valid
	speed values include "Auto", "2Gb", and "4Gb".
	• For the HP VC 8Gb 24-Port FC Module, HP VC 8Gb 20-Port FC Module, and HP
	VC FlexFabric 10Gb/24-port Module, valid speed values include "Auto", "2Gb",
	"4Gb", and "8Gb".
	Command line 29

Item	Description
LinkDist	Specifies the login re-distribution scheme to use for load balancing. Valid values
(optional)	include "Auto" and "Manual". The default login re-distribution is "Manual".
	The HP 4Gb VC-FC Module, HP Virtual Connect 4Gb FC Module, HP VC 8Gb 20-Port
	FC Module, and HP VC 8Gb 24-Port Module support only manual login redistribution.
	The HP VC FlexFabric 10Gb/24-port Module supports both auto and manual login
	redistribution.
Examples
	->add fabric MyFabric1 Bay=3 Ports=1,2
	Adds a new fabric, using default values
	->add fabric MyFabric2 Bay=3 Ports=1 Speed=2Gb
	Adds a new fabric with speed set to 2Gb
	->add fabric MyFabric3 Bay=3 Ports=1,2,3,4 LinkDist=Auto
	Adds a new fabric with automatic login re-distribution
	->add fabric MyFabric4 Bay=3 Ports=1,2
	Adds a new fabric with two logical ports

Item	Description
remove fabric	Remove an existing fabric from the domain.
Syntax	remove fabric <Name|*>
Parameter
Name (required)	The name of a specific fabric. Use "*" to remove all existing fabrics.
Examples
	->remove fabric VFabric_1
	Removes VC FC SAN fabric VFabric_1
	->remove fabric *
	Removes all VC FC SAN fabrics from the domain

Item	Description
set fabric	Modify properties of an existing fabric. This command can also be used to force load
	balancing of a fabric if login re-distribution is configured.
Syntax	set fabric <Name> [-LoadBalance] [Name=<NewName>]
	[Ports=<PortList>] [Speed=<Auto|2Gb|4Gb|8Gb>]
	[LinkDist=<Auto|Manual>]
Parameter
Name (required)	A unique name for the fabric
Option
LoadBalance	Performs load balancing on a fabric configured for manual login re-distribution
Properties
Name (optional)	The new name of the fabric
Speed (optional)	The port speed for the uplink ports in the fabric. Valid values include "Auto", "2Gb",
	"4Gb", and "8Gb". The default port speed is "Auto".
	Speed restrictions:
	• For the HP 4Gb VC-FC Module and HP Virtual Connect 4Gb FC Module, valid
	speed values include "Auto", "2Gb", and "4Gb".
	• For the HP VC 8Gb 24-Port FC Module, HP VC 8Gb 20-Port FC Module, and HP
	VC FlexFabric 10Gb/24-port Module, valid speed values include
	"Auto","2Gb","4Gb", and "8Gb".
LinkDist	Specifies the login re-distribution scheme for load balancing. Valid values include
(optional)	"Auto" and "Manual". The default login re-distribution is "Manual".

Command line 30