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

HP Virtual Connect Manager Command Line

Part Number: 677486-003

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.

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.

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 status for FlexNIC ports. The profile column has been removed. The profile associated with the FlexNIC ports is now displayed as part of the physical 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

The FlexNIC port output columns were Adapter Type, Network, MAC Address, Fabric, Port, WWN, and Profile.

The FlexNIC port output columns are Status, Network, MAC Address, Fabric, Port, and WWN.

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

managed element parameters options

properties

Operation performed on a managed element

Target management entity Command extensions for a particular management operation Attributes used to customize or control command execution behavior such as output

format, quiet-mode, and others 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:

Example: ->show user suzi -output=script1

-<option>[=argument1>,<argument2>, . . .]

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

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

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

assign

copy

help

import

load

Transfer a file from a remote location to the domain

poweroff

poweron

reboot

remove

reset

Perform a reset operation on an object (for example, vcm)

restore

save

set

show

unassign

all

Display all VC domain-managed elements

banner

config

configbackup

devicebay

enclosure

enet-connection

enet-vlan

external-manager

fabric

Subcommands

Command Description

add

delete exit

test

Add a new object to the domain or to another object Assign a server profile to a device bay

Copy a configuration from one server profile to another server profile Delete the domain configuration

Exit the Virtual Connect Manager command-line shell Display context-sensitive help for a command or object

Import an enclosure into the domain

Power off one or more servers Power on one or more servers Reboot one or more servers Remove or delete an existing object (for example, users or profiles)

Restore a file from a remote location Transfer a file from the domain to a remote location Modify one or more configuration properties of an object Display properties or information about an object Test the configuration of an object (for example, log-target)

Unassign a server profile from a device bay

Managed elements

Managed element Description

(on page 15)

(on page 15) (on page 16)

(on page 17)

(on page 19)

domain (on page 19)

(on page 22)

(on page 23)

(on page 26)

(on page 27)

(on page 29)

Manage the login screen banner configuration Display all commands for all objects defined in the domain Manage configuration backup and restore operations Display enclosure device bay information Manage general Virtual Connect domain settings and

information Manage general enclosure settings and information Manage Ethernet network connections Manage Ethernet VLAN connections Manage external manager settings and information Manage Fibre Channel SAN fabrics

Command line 13

Managed element Description

fc-connection

fcoe-connection

firmware

igmp

igmp-group

interconnect

interconnect-mac-table

iscsi-boot-param

iscsi-connection

ldap

ldap-certificate

ldap-group

link-dist-interval

lldp

log-target

loop-protect

mac-cache

nag-network

network

network-access-group

network-range

port-monitor

profile

radius

radius-group

role

server

serverid

server-port

server-port-map

snmp

snmp-trap

ssh

ssl

ssl-certificate

ssl-csr

stackinglink

Display or reset statistics on a designated interconnect module

statistics-throughput

status

storage-management

(on page 31)

(on page 34)

(on page 37)

(on page 38)

(on page 40) (on page 40) (on page 43)

(on page 46)

(on page 47)

(on page 48)

(on page 49)

(on page 50)

(on page 52)

(on page 53)

(on page 54)

(on page 55)

(on page 59)

(on page 60)

(on page 63)

(on page 65)

(on page 69)

(on page 70)

(on page 72)

(on page 73)

(on page 75)

(on page 76)

server-port-map-range (on page 78)

(on page 79)

(on page 80)

(on page 83) (on page 84)

(on page 84)

(on page 85)

(on page 86)

statistics (on page 86)

(on page 88)

(on page 89)

Manage Fibre Channel SAN fabric connections Manage FCoE SAN fabric connections

Manage interconnect module firmware Manage Ethernet IGMP Snooping settings Display interconnect module IGMP Group table information Manage I/O interconnect modules Display interconnect module MAC table information Manage iSCSI boot parameters Manage iSCSI connections Manage LDAP configuration settings Manage LDAP certificate information Manage LDAP group configuration settings Manage the FC login re-distribution interval Display LLDP information received on a port Manage remote log destination settings Manage network loop protection settings Manage Ethernet MAC cache failover settings Manage network access group memberships Manage Virtual Connect Ethernet networks Manage network access groups Manage ranges of networks

Monitor port monitor configurations Manage Virtual Connect server profiles

Manage RADIUS authentication settings Manage RADIUS group configuration settings Manage user authentication order by access role (privilege) Manage physical HP BladeSystem server blades Manage virtual server ID configuration settings Display all physical server ports Manage shared server downlink port mapping configuration Manage ranges of shared server downlink port mapping

configurations Modify SNMP configurations Modify SNMP-trap configurations Manage SSH configuration and information

Manage SSL configuration and Information Manage SSL certificate information Manage an SSL certificate signing request Display stacking link information and status

port Manage the port throughput statistics Display overall Virtual Connect domain status information Manage iSCSI storage management information

Command line 14

supportinfo

systemlog

tacacs

uplinkport

uplinkset

user user-security

vcm

version

show all [*]

->show all

->show all * show version

show version

->show version

all

Managed element Description

Manage Virtual Connect support information Display Virtual Connect Manager system event log Manage TACACS+ authentication settings Manage interconnect module uplink ports Manage shared uplink port sets Manage local Virtual Connect user configurations

Manage user security settings Manage the Virtual Connect domain manager Display CLI version information

(on page 91)

(on page 97)

(on page 99)

(on page 90)

(on page 91)

(on page 92)

(on page 95)

(on page 98)

(on page 15)

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)."

Manage all Virtual Connect domain elements.

Supported actions: help, show Item Description

show all

Syntax Examples

version

Display CLI version information.

Supported actions: help, show Item Description

Syntax Example

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.

Displays all configuration objects (summary view)

Displays all configuration objects (detailed view)

Display CLI version information.

Displays CLI version and copyright information

banner

Manage the login screen banner configuration.

Command line 15

Supported actions: add, help, remove, show

add banner text=[”<banner text>”|’<banner text>’]

->add banner text="This is a private system, unauthorized

->add banner text="This is a private system."

remove banner

->remove banner

Display the configured banner text.

show banner

->show banner

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 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

access is not allowed." Adds banner text with a single command

->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 Example

Item Description

show banner

Syntax Example

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.

Removes the configured banner text

Displays the configured banner text

Command line 16

Any user- or VC-defined MAC addresses, WWNs, and logical serial numbers will not appear in the output

show config

->show config

restore configbackup [-quiet][-maskEncryptKey]

[ignorefwversion=<true|false>]

quiet (optional)

(optional)

->restore configbackup

to avoid duplicating these values.

Supported actions: help, show Item Description

show config

Syntax Example

configbackup

Manage the domain configuration file.

Supported actions: help, restore, save Item Description

restore configbackup

Syntax

Option

maskEncryprtKey (optional)

Properties

Address (required)

EncryptionKey

IgnoreEnclosureID (optional)

IgnoreFWVersion (optional)

Example

Generate a configuration script from the running domain.

Displays the configuration script for the running domain

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.

address=<tftp://ipaddress/[filename] | ftp://user:password@ipaddress/[filename]> [encryptionkey=<secret password>] [ignoreenclosureid=<true|false>]

Suppresses user confirmation prompts Enables you to interactively specify the encryption key as a masked string at the

command prompt

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.

A password used to encrypt the configuration backup file

Restores a configuration that was generated on another enclosure. Valid values are "true" and "false". The default value is "false". When the value is set to "false", the configuration generated on another enclosure is rejected.

Restores a configuration that was generated on another firmware version. Valid 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.

address=tftp://192.168.10.12/<filename> Restores a configuration backup file from a remote TFTP server

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

->restore configbackup -maskEncryptKey

->restore configbackup -quiet

save configbackup [-maskEncryptKey]

[encryptionkey=<secret password>]

(optional) (optional)

->save 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

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

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

address=ftp://user:password@192.168.10.12/<filename> Restores a configuration backup file from a remote FTP server with a masked encryption key

address=ftp://192.168.10.12/<filename> Restores a configuration backup file without user confirmation prompts

Item Description

save configbackup

Syntax

Option

maskEncryprtKey

Properties

Address (required)

EncryptionKey

Examples

Generate and transfer a Virtual Connect configuration backup file to a remote TFTP or FTP server.

address=<tftp://ipaddress/[filename] | ftp://user:password@ipaddress/[filename]>

Enables you to interactively specify the encryption key as a masked string at the command prompt

A password used to encrypt the configuration backup file

address=tftp://192.168.10.12/<filename> Saves a configuration backup file to a remote TFTP server

address=ftp://user:password@192.168.10.12/<filename> Saves a configuration backup file to a remote FTP server

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

show devicebay

show devicebay [<DeviceBayID>|*]

Example: “enc0:1” indicates device bay 1 of the local enclosure being managed.

show devicebay

->show devicebay

->show devicebay *

->show devicebay enc0:2

->show devicebay enc1:4

->show devicebay enc0:5

delete domain [-quiet]

devicebay

Manage general enclosure device bay settings and information.

Supported actions: help, show Item Description

Syntax Parameter

DeviceBayID (Optional)

Examples

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

Display device bays of all enclosures that exist in the Virtual Connect domain.

The reference ID of a device bay in the domain The format of the device bay ID is <EnclosureID:DeviceBay>.

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

Displays a summary listing of all device bays

Displays detailed information for all device bays

Displays detailed information for device bay 2 of the local enclosure

Displays detailed information for device bay 4 of a remote enclosure

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

Syntax Option

quiet

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.

Suppresses user confirmation prompts. This option is useful when scripting delete domain operations.

Command line 19

Item Description

->delete domain

->delete domain -quiet

set domain [Name=<NewName>] [DomainIp=<Enabled|Disabled>]

[SingleDense=true|false]

address and subnet mask must be configured. If disabled, DHCP is used to obtain

Gateway (Required if

User-Defined)

Examples

Deletes the Virtual Connect domain configuration and prompts for user confirmation

Deletes the Virtual Connect domain quietly without prompting for user confirmation (primarily used in automated scripting scenarios)

Item Description

set domain

Syntax

Properties

Name(optional)

DomainIP (optional)

IpAddress (Required if DomainIP is enabled)

SubnetMask (Required if IP address specified)

IP address specified)

MacType (optional)

MacPool (optional)

MacStart (Required if MacType is

MacEnd (Required if MacType is

WwnType(optional)

WwnPool(optional)

Modify general Virtual Connect domain configuration properties, such as the domain name, domain IP address, and MAC and WWN address pool settings.

[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>]

The new name of the domain. Valid characters include alphanumeric, "_", and ".". The maximum length of the name is 31 characters.

Enables or disables the Virtual Connect domain IP address. If enabled, a valid IP

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".

A valid IP address to use for the domain IP address configuration. The IP address must be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and 9, for example, 192.168.0.10.

A valid subnet mask for the domain IP address configuration. The subnet mask must be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and 9, for example, 255.255.255.0.

A valid gateway address for the domain IP address configuration. The gateway address must be in the format xxx.xxx.xxx.xxx, where x is a number between 0 and 9, for example, 192.168.0.1.

The type of MAC address source to use for assignment. Valid values include "VC-Defined", "Factory-Default", and "User-Defined".

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.

The starting MAC address in a custom user-defined range. This property is valid only if the MacType is set to "User-Defined".

The ending MAC address in a custom user-defined range. This property is valid only if the MacType is set to "User-Defined".

The type of WWN address source to use for assignment. Valid values include "VC-Defined", "User-Defined", and "Factory-Default".

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

User-Defined)

->set domain Name=MyNewDomainName

->set domain DomainIp=Enabled

->set domain DomainIp=Enabled IpAddress=192.168.0.120

->set domain DomainIp=Disabled

->set domain MacType=VC-Defined MacPool=10

->set domain MacType=Factory-Default

->set domain MacType=User-Defined MacStart=00-17-A4-77-00-00

->set domain WwnType=VC-Defined WwnPool=5

->set domain WwnType=Factory-Default

->set domain WwnType=User-Defined

->set domain SingleDense=true

show domain [addressPool] (Optional)

->show domain

->show domain addressPool

WwnStart (Required if WwnType is

WwnEnd (Required if WwnType is

SingleDense (optional)

Examples

The starting WWN address in a custom user-defined range. This property is valid only if the WwnType is set to "User-Defined".

The ending WWN address in a custom user-defined range. This property is valid only if the WwnType is set to "User-Defined".

If the imported domain supports double-dense server blades, this property enables 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.

Changes the name of the Virtual Connect domain

Enables the domain IP address

SubnetMask=255.255.255.0 Gateway=192.168.0.1 Configures the domain IP address and enables it

Disables the domain IP address and uses DHCP instead

Sets the MAC address source to VC-Defined with a pre-defined range

Sets the MAC address source to use factory default MAC addresses

MacEnd=00-17-A4-77-00-FF Sets the MAC address source to a custom, user-defined address range

Sets the WWN address source to VC-Defined with a pre-defined range

Sets the WWN address source to use factory default WWN addresses

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

Sets the display option to support single-dense servers in a double-dense supported configuration

Item Description

show domain

Syntax Parameter

addressPool

Examples

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.

Displays all VC-defined address pool range available for use

Displays domain information

Displays the VC-defined address pools for the domain

Command line 21

enclosure

import enclosure [<IPv4Address|DNSname>]

->import enclosure UserName=Administrator Password=fgg7h*1

->import enclosure 2001::34/64 UserName=admin

->import enclosure

->import enclosure 192.168.0.120 remove enclosure <EnclosureID|*>

Manage general enclosure settings and information.

Supported actions: help, import, remove, show Item Description

import enclosure

Syntax

Parameter

IpAddress (Optional)

Option

quiet

Properties

UserName (Required for enclosures that are not imported)

Password (Required)

DoubleDense (Optional)

Examples

Import local and remote enclosures into the Virtual Connect domain. Virtual Connect supports up to four c7000 enclosures in a single domain.

[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.

The IPv4 address or DNS name of the remote enclosure to be imported. If not specified, the local enclosure is assumed.

This option suppresses user confirmation prompt while importing a remote enclosure, and is typically used in automated scripting scenarios.

A valid user name with access to the Onboard Administrator for the enclosure to import. The user must have full administrative rights to all enclosure elements, such as device bays, I/O bays, and OAs).

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.

This setting can only be specified during the import of the local enclosure, and it 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.

Imports the local enclosure into the domain

DoubleDense=true Imports the local enclosure with a double-dense device bay display format

password=am123 Imports a remote enclosure into the domain

Imports the previously discovered local enclosure

Imports a previously discovered remote enclosure

Item Description

remove enclosure

Syntax Parameter

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.

Command line 22

Item Description

->remove enclosure encl

->remove enclosure *

show enclosure

show enclosure [<EnclosureID>|*]

->show enclosure

->show enclosure *

->show enclosure enc0

add enet-connection <ProfileName>

[SpeedType=<Auto|Preferred|Custom>] [Speed=<speed>]

ProfileName (required)

EnclosureID (required)

The enclosure ID of the remote enclosure to be removed from the domain. Use "*" 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

Removes a remote enclosure

Removes all remote enclosures from the domain

Item Description

Syntax Parameter

EnclosureID (optional)

Examples

Display all enclosures in the domain.

The ID of an enclosure in the domain. If specified, only details for that enclosure appear.

Displays a summary of all enclosures

Displays detailed information for all enclosures

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

Syntax

Parameter

Properties

Network (optional)

PXE (optional)

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.

[Network=<NetworkName>] [PXE=<enabled|disabled|UseBios>] [AddressType=<Factory-Default|User-Defined>] [EthernetMAC=<MAC Address> iScsiMAC=<MAC Address>]

The name of an existing profile to which the new connection is added

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.

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

User-Defined)

The user-defined Ethernet MAC address to use for the connection. This

User-Defined)

The user-defined speed for the server port. Valid values include 100Mb to

->add enet-connection MyNewProfile

->add enet-connection MyProfile Network=MyNetwork

AddressType (optional)

EthernetMAC (required if AddressType is

iScsiMAC (required if AddressType is

SpeedType (optional)

Speed (required if the SpeedType is Custom)

Examples

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.

property is required if the AddressType specified is "User-Defined".

The user-defined iSCSI MAC address to use for the connection. This property is required if the AddressType specified is "User-Defined".

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.

MAX configured speed for the network in 100Mb increments.

Network=SomeNetwork Adds a new Ethernet network connection to a profile

Network=SomeNetwork2 PXE=enabled Adds a new Ethernet network connection and enables PXE

Adds a new Ethernet network connection and leaves the network unassigned

AddressType=Factory-Default Adds a new Ethernet network connection and uses factory default addresses

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

SpeedType=Preferred Adds a new Ethernet network connection and sets the speed to "Preferred"

SpeedType=Custom Speed=2000 Adds a new Ethernet network connection and sets the speed to 2Gb

Command line 24

Remove the last Ethernet network connection from an existing server

remove enet-connection <ProfileName>

ProfileName (required)

->remove enet-connection MyProfile set enet-connection

set enet-connection <ProfileName> <Port>

[SpeedType=<Auto|Preferred|Custom>] [Speed=<speed>]

ProfileName (required)

Port (required)

SpeedType is Custom)

->set enet-connection MyProfile 2

->set enet-connection RedProfile 1 Network=""

->set enet-connection GreenProfile 3 PXE=disabled

->set enet-connection MyProfile 1 SpeedType=Preferred

->set enet-connection MyProfile 1 SpeedType=Custom

Item Description

remove enet-connection

profile.

Syntax Parameter

Example

The name of the profile from which the Ethernet connection is removed

Removes an Ethernet network connection from a profile

Item Description

Syntax

Parameters

Properties

Network (optional)

PXE (optional)

SpeedType (optional)

Speed (required if the

Examples

Modify an Ethernet connection of a server profile.

[Network=<NetworkName>] [PXE=<enabled|disabled|UseBios>]

The name of the server profile that contains the connection to modify The port number of the connection being modified

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.

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.

The user-defined speed for the server port. Valid values include 100Mb to MAX configured speed for the network in 100Mb increments.

Network=NewNetworkName Changes the associated network of an Ethernet connection

Sets a network connection to "Unassigned"

Disables PXE on an Ethernet connection

Modifies the Ethernet network connection to set the speed to "Preferred"

Speed=2000 Modifies the Ethernet network connection to set the speed to 2Gb

Command line 25

Display the Ethernet connections associated with the server profiles.

show enet-connection [<ConnectionID>]

->show enet-connection *

->show enet-connection Profile1:*

->show enet-connection Profile1:1

set enet-vlan [-quiet][SharedServerVLanId=<true|false>]

[VlanCapacity=<Legacy|Expanded>]

Custom)

networks. Valid values include "UnRestricted" and "Custom". "Custom" enables

Custom)

Item Description

show enet-connection

Syntax Parameter

ConnectionID (optional)

Examples

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.

Displays all Ethernet connections in the domain

enet-vlan

Manage Ethernet VLAN configuration settings.

Supported actions: help, set, show Item Description

set enet-vlan

Syntax

Option

quiet

Properties

SharedServerVLanId (optional)

PrefSpeedType (optional)

PrefSpeed (required if PrefSpeedType is

MaxSpeedType (optional)

MaxSpeed (required if MaxSpeedType is

Displays all Ethernet connections of a profile named Profile1

Displays a specific Ethernet connection of a profile named Profile1

Modify general Ethernet VLAN configuration settings.

[PrefSpeedType=<Auto|Custom>] [PrefSpeed=<speed>] [MaxSpeedType=<Unrestricted|Custom>] [MaxSpeed=<speed>]

This option suppresses user confirmation prompt, and is typically used in automated scripting scenarios.

Enables or disables the option to force server ports connected to multiple VC 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.

The default connection speed for any Ethernet connection using multiple networks. Valid values include "Auto" and "Custom". "Custom" enables you to configure the preferred speed. The default value is "Auto".

The default connection speed for any Ethernet connection using multiple networks. Valid values range from 100Mb to 10Gb in 100Mb increments.

The maximum connection speed for any Ethernet connection using multiple

you to configure the preferred speed. The default value is "Unrestricted". The maximum connection speed for any Ethernet connection using multiple

networks. Valid values range from 100Mb to 10Gb in 100Mb increments.

Command line 26

Item Description

The number of VLAN translations allocated to the uplinks. This attribute can be set only when VlanCapacity is "Extended". Valid values range from 240 to 4080 in

->set enet-vlan SharedServerVLanId=true

->set enet-vlan PrefSpeedType=Custom PrefSpeed=500

->set enet-vlan VlanCapacity=Expanded

show enet-vlan

->show enet-vlan

set

remove external-manager [-quiet] [UserName=<username>]

address>]

VlanCapacity (optional)

The VLAN capacity mode. Valid values include 'Legacy' and 'Expanded'. '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 (optional)

increments of 16 (enclosure) or 24 (rack). The default value is 640.

Examples

Enables SharedServerVLanId

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

Sets the VLAN capacity mode to Expanded to allow for larger network configurations

Item Description

show enet-vlan

Syntax Example

Display general Ethernet VLAN configuration settings.

Displays Ethernet VLAN configuration settings

external-manager

Manage external manager settings and information.

Supported actions: help, remove, set, show Item Description

remove external-manager

Syntax

Option

quiet

Remove an existing external manager (VCEM) and regain local management 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 external-manager command before using the remove external-manager command.

[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

This option suppresses user confirmation prompts and is useful when scripting operations.

Command line 27

Item Description

show external-manager

User-Defined)

(required if Type is User-Defined)

The ending serial number in a user-defined range. This property is only valid for

->show external-manager

->remove external-manager UserName=A17005068

->remove external-manager macType=Factory-Default

->remove external-manager username=A1010345

set external-manager [-quiet] UserName=<username> Enabled=<true|false>

Properties

UserName (optional)

MacType (optional)

MacStart (required if the MacType is

MacEnd (required if the MacType is

WwnType (optional)

WwnStart (required if the WwnType is

WwnEnd (required if the WwnType is

ServerIdType (optional)

ServerIdStart

ServerIdEnd

Examples

A valid external manager user name. The user name can be identified using the

The type of MAC address source to use for assignment. Valid values include "Factory-Default" and "User-Defined".

The starting MAC address in a custom user-defined range. This property is valid only if the MacType is set to "User-Defined".

The ending MAC address in a custom user-defined range. This property is valid only if the MacType is set to "User-Defined".

The type of WWN address source to use for assignment. Valid values include "Factory-Default" and "User-Defined".

The starting WWN address in a custom user-defined range

The ending WWN address in a custom user-defined range

The type of the virtual serial number source. When server profiles are created, the virtual serial numbers and UUID values are allocated from the specified pool source. Valid values include "Factory-Default" and "User-Defined".

The starting serial number in a user-defined range. This property is only valid for user-defined serial number types.

user-defined serial number types.

->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

command.

Removes only the external management control of the VC Manager

wwnType=Factory-Default serverIdType=Factory-Default Releases only the profile control

macType=Factory-Default wwnType=Factory-Default serverIdType=Factory-Default

Removes the external manager and releases the profile control

Item Description

set external-manager

Syntax

Enable or disable the control of an existing external manager over the Virtual Connect domain.

Command line 28

Item Description

quiet

show external-manager

Enabled (required)

->set external-manager UserName=A17005068 Enabled=false

->set external-manager UserName=A17005068 Enabled=true

external-manager

show external-manager

->show external-manager

add fabric <Name> Bay=<BayNum> Ports=<PortList> [Speed=<Auto|2Gb|4Gb|8Gb>] [LinkDist=<Auto|Manual>]

Name (required)

Bay (required)

•

Option

Properties

UserName (required)

Examples

Suppresses user confirmation prompts and is useful when scripting operations

A valid external manager user name. The user name can be identified using the

Enables or disables the external manager. Valid values include "true" and "false".

Disables the external manager

command.

fabric

Enables the external manager

Item Description

show

Syntax Example

Display the information of an existing external manager.

Displays the information of an existing external manager

Manage Fibre Channel SAN fabrics.

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

add fabric

Syntax

Parameter

Properties

Ports (required)

Speed (optional)

Add a new fabric to the domain.

A unique name for the new fabric being added to the domain.

The specific interconnect bay number with which the fabric is associated. 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.

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

->add fabric MyFabric1 Bay=3 Ports=1,2

->add fabric MyFabric2 Bay=3 Ports=1 Speed=2Gb

->add fabric MyFabric3 Bay=3 Ports=1,2,3,4 LinkDist=Auto

->add fabric MyFabric4 Bay=3 Ports=1,2 remove fabric <Name|*>

Name (required)

->remove fabric VFabric_1

->remove fabric *

set fabric <Name> [-LoadBalance] [Name=<NewName>]

[LinkDist=<Auto|Manual>]

Name (required)

LoadBalance

Name (optional)

•

(optional)

LinkDist (optional)

Specifies the login re-distribution scheme to use for load balancing. Valid values 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

Adds a new fabric, using default values

Adds a new fabric with speed set to 2Gb

Adds a new fabric with automatic login re-distribution

Adds a new fabric with two logical ports

Item Description

remove fabric

Syntax Parameter

Examples

Remove an existing fabric from the domain.

The name of a specific fabric. Use "*" to remove all existing fabrics.

Removes VC FC SAN fabric VFabric_1

Removes all VC FC SAN fabrics from the domain

Item Description

set fabric

Syntax

Parameter

Option

Properties

Speed (optional)

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.

[Ports=<PortList>] [Speed=<Auto|2Gb|4Gb|8Gb>]

A unique name for the fabric

Performs load balancing on a fabric configured for manual login re-distribution

The new name of the fabric 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 "Auto" and "Manual". The default login re-distribution is "Manual".

Command line 30

Item Description

A list of one or more logical FC ports to be added to the fabric. Each port is specified

->set fabric MyFabric1 Name=MyNewName1

->set fabric MyFabric2 Speed=2Gb LinkDist=Auto

->set fabric MyFabric3 Ports=1,2,3,4

->set fabric MyFabric5 -loadBalance show fabric

show fabric [<FabricName>|*]

->show fabric

->show fabric *

->show fabric SAN_5

add fc-connection <ProfileName> [Fabric=<FabricName>]

[PortWWN=<WWN address>] [NodeWWN=<WWN address>]

ProfileName (required)

Fabric (optional)

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 FC Module support only manual login re-distribution. The HP VC FlexFabric 10Gb/24-port Module supports both auto and manual login re-distribution.

Ports (optional)

in the format "<port1>,<port2>,...", where port is the interconnect module port to be modified in the fabric (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.

Examples

Changes the name of an existing fabric

Item Description

Syntax Parameter

Name (optional)

Examples

fc-connection

Modifies the port speed and login re-distribution

Modifies the fabric ports contained in the fabric

Performs load balancing on a fabric with manual login re-distribution

Display all fabric information.

Name of an existing fabric. Use “*” to display a detailed output of all fabrics in the VC domain. If not specified, a summary output of all fabrics appears.

Displays a summary of all FC SAN fabrics

Displays detailed information for all FC SAN fabrics

Displays detailed information for a specific FC SAN fabric

Manage Fibre Channel SAN connections.

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

add fc-connection

Syntax

Parameter

Properties

Add a new FC SAN connection to an existing server profile. For more information, see "General requirements for adding FC or FCoE connections (on page 144)."

[Speed=<Auto|1Gb|2Gb|4Gb|8Gb|Disabled>] [AddressType=<Factory-Default|User-Defined>]

The name of an existing profile to which the new connection is added

The name of an existing fabric to associate with the connection. If the fabric

Command line 31

Item Description

->add fc-connection MyNewProfile Fabric=SAN_5

->add fc-connection MyNewProfile Fabric=SomeFabric

->add fc-connection MyNewProfile

->add fc-connection MyNewProfile AddressType=User-Defined

remove fc-connection <ProfileName>

->remove fc-connection MyProfile

set fc-connection

set fc-connection <ProfileName> <Port>

name is not specified, the connection is marked as “Unassigned” and associated with a specific bay.

Speed (optional)

AddressType (optional)

PortWWN (required if AddressType is User-Defined)

NodeWWN (required if AddressType is User-Defined)

Examples

The port speed of the connection port. Valid values include "Auto", "1Gb", "2Gb", "4Gb", "8Gb", and "Disabled". If not specified, the default port speed is set to "Auto". Speed restrictions: For the HP 4Gb VC-FC Module and HP Virtual Connect 4Gb FC Module, supported speed values include "Auto","1Gb","2Gb", "4Gb", and "Disabled". If the value is set to 8Gb, the speed is auto-negotiated by Virtual Connect.

The source of WWN 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, then both a Port WWN and Node WWN must also be specified. Valid values include "Factory-Default" and "User-Defined".

The user-defined Port WWN address to use for the connection. This property is required if the AddressType specified is "User-Defined". The PortWWN must be an unused WWN address.

The user-defined Node WWN address to use for the connection. This property is required if the AddressType specified is "User-Defined". The NodeWWN must be an unused WWN address.

Adds a new FC SAN connection to a profile

Speed=4Gb Adds a new FC SAN connection and configures the port speed

Adds a new FC SAN connection and uses the next available fabric

AddressType=Factory-Default Adds a new FC SAN connection and uses factory-default addresses

PortWWN=50:06:0B:00:00:C2:62:00 NodeWWN=50:06:0B:00:00:c2:62:01

Adds a new FC SAN connection and provides user-defined WWN addresses

Item Description

remove fc-connection

Syntax

Parameter

ProfileName (required)

Example

Remove the last FC connection from an existing server profile.

The name of an existing profile from which the last FC connection is being removed

Removes an FC connection from a profile

Item Description

Syntax

Modify an existing FC SAN connection.

Command line 32

Item Description

[Fabric=<FabricName>]

[BootLun=<LUN>]

ProfileName (required)

The name of the server profile that contains the connection being modified

Port (required)

->set fc-connection MyProfile 1 Fabric=SAN_5

->set fc-connection RedProfile 2 Fabric=""

->set fc-connection BlueProfile 1 Fabric=SAN_7

->set fc-connection BlueProfile 1 Speed=4Gb

->set fc-connection BlueProfile 1 BootPriority=Primary

show fc-connection [<ConnectionID>]

[Speed=<Auto|1Gb|2Gb|4Gb|8Gb|Disabled>] [BootPriority=<priority>] [BootPort=<portName>]

Parameters

Properties

Fabric (optional)

Speed (optional)

BootPriority (optional)

BootPort

(Required if the Boot Priority is either Primary or Secondary optional)

BootLun (Required if the Boot Priority is either Primary or Secondary optional)

Examples

The port number of the connection being modified

The name of the FC SAN fabric to associate with the connection. The fabric being specified should be associated with the same bay as the FC connection. A blank string makes the FC connection unassigned.

The port speed of the FC SAN connection. Valid values include "Auto", "8Gb", "4Gb", "2Gb", "1Gb", and "Disabled". Speed restrictions: For the HP 4Gb VC-FC Module and HP Virtual Connect 4Gb FC Module, supported speed values include "Auto","1Gb","2Gb", "4Gb", and "Disabled". If the value is set to 8Gb, the speed is auto-negotiated by Virtual Connect.

Controls whether the FC HBA port is enabled for SAN boot and affects the BIOS boot order. Valid values include "BIOS", "Primary", "Secondary", and "Disabled".

The target WWPN of the controller interface on the Fibre Channel storage target. The port name is a 64-bit identifier in the format NN:NN:NN:NN:NN:NN:NN:NN, where N is a hexadecimal number.

The LUN of the volume used for SAN boot. Valid values include an integer from 0 to 255 or 16 hex digits (HP-UX only).

Changes the fabric of an FC SAN fabric connection

Sets an FC SAN fabric connection to "Unassigned"

Changes the FC SAN fabric of an FC SAN connection

Changes the port speed of an FC SAN connection

BootPort=50:06:0B:00:00:C2:62:00 BootLun=5 Changes the SAN boot priority and sets additional boot parameters

Item Description

show fc-connection

Syntax Parameter

Display the FC SAN connections associated with the server profiles.

Command line 33

Item Description

->show fc-connection

->show fc-connection Profile1:*

->show fc-connection Profile1:1

add fcoe-connection <ProfileName> [Fabric=<FabricName>]

[EthernetMac=<MAC Address>]

ProfileName (required)

The user-defined speed for the server port. Valid values include 100Mb to

Defined" is specified, both a Port WWN and Node WWN must also be

User-Defined)

(optional)

ConnectionID (optional)

Examples

fcoe-connection

Manage FCoE connections.

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

add fcoe-connection

Syntax

Parameter

Properties

Fabric (optional)

SpeedType (optional)

CustomSpeed (required if SpeedType is Custom)

WWNAddressType (optional)

PortWWN (required if WWNAddressType is

NodeWWN (required if WWNAddressType is

MACAddressType

The ID of an existing FC SAN connection. The ID format is <ProfileName:Port>. Use <ProfileName:*> to display all FC SAN connections of a profile. Use "*" to display all FC SAN connections in the domain.

Displays all FC SAN connections in the domain

Displays all FC SAN connections of a profile named Profile1

Displays a specific FC SAN connection of a profile named Profile1

Add a new FCoE connection to an existing server profile. For more information, see "General requirements for adding FC or FCoE connections (on page 144)."

The name of an existing profile to which the new connection is added

The name of an existing fabric created on an FCoE module to associate with the connection. If the fabric name is not specified, the connection is marked as “Unassigned” and associated with a specific bay.

The requested operation speed for the server port. Valid values include "1Gb", "2Gb", "4Gb", "8Gb", "Custom", and "Disabled". The default value is "4Gb". If the SpeedType is "Custom", you can configure any speed from 100Mb to 10Gb in 100Mb increments.

10Gb configured in 100Mb increments. The source of WWN address assignments to be used during the creation of the

new connection. If not specified, the default is the domain default. If "Userspecified. Valid values include "Factory-Default" and "User-Defined".

The user-defined Port WWN address to use for the connection. The PortWWN must be an unused WWN address.

The user-defined Node WWN address to use for the connection. The NodeWWN must be an unused WWN address.

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

Command line 34

Item Description

User-Defined)

->add fcoe-connection MyNewProfile Fabric=SAN_5

->add fcoe-connection MyNewProfile Fabric=SomeFabric

->add fcoe-connection MyNewProfile

->add fc-connection MyNewProfile Fabric=MyFabric

->add fcoe-connection MyNewProfile

remove fcoe-connection <ProfileName>

The name of an existing profile from which the last FCoE connection is being

->remove fcoe-connection MyProfile

set fcoe-connection

set fcoe-connection <ConnectionID> [Fabric=<FabricName>]

[BootPort=<portName>] [BootLun=<LUN>]

(required)

"User-Defined" is specified, EthernetMAC must also be specified. Valid values include "Factory-Default" and "User-Defined".

EthernetMAC (required if MACAddressType is

Examples

The user-defined Ethernet MAC address to use for the connection

Adds a new FCoE connection to a profile

SpeedType=4Gb Adds a new FCoE connection and configures the port speed

Adds a new FCoE connection and leaves it unassigned

SpeedType=Custom CustomSpeed=5000 Adds a new FCoE connection and sets a custom speed of 5Gb

WWNAddressType=Factory-Default Adds a new FCoE connection and uses factory-default WWN addresses

WWNAddressType=User-Defined PortWWN=50:06:0B:00:00:C2:62:00 NodeWWN=50:06:0B:00:00:C2:62:01

Adds a new FCoE connection and provides user-defined WWN addresses

->add fcoe-connection MyNewProfile MACAddressType=Factory-Default

Adds a new FCoE connection and uses factory-default MAC addresses

->add fcoe-connection MyNewProfile MACAddressType=User-Defined EthernetMAC=00-17-A4-77-00-00

Adds a new FCoE connection and provides a user-defined MAC address

Item Description

remove fcoe-connection

Remove the last FCoE connection from an existing server profile.

Syntax Parameter

ProfileName (required)

removed

Example

Removes an FCoE connection from a profile

Item Description

Modify an existing FCoE connection.

Syntax

Parameters

ConnectionID

[SpeedType=<1Gb|2Gb|4Gb|8Gb|Custom|Disabled>] [CustomSpeed=<100Mb-10Gb>] [BootPriority=<priority>]

The ID of an existing FCoE connection. The ID format is <ProfileName:Port>.

Command line 35

Item Description

"1Gb","2Gb", "4Gb", "8Gb", "Custom", and "Disabled". If the SpeedType is

The user-defined speed for the server port. Valid values include 100Mb to

->set fcoe-connection MyProfile:1 Fabric=SAN_5

->set fcoe-connection RedProfile:2 Fabric=""

->set fcoe-connection MyProfile:1 SpeedType=Custom

->set fcoe-connection BlueProfile:1 BootPriority=Primary

show fcoe-connection [<ConnectionID>]

->show fcoe-connection

->show fcoe-connection Profile1:*

Properties

Fabric (optional)

SpeedType (optional)

CustomSpeed (required if the SpeedType is Custom)

The name of the fabric to associate with the connection. The fabric being specified should be associated with the same bay as the FCoE connection.

The requested operational speed for the server. Valid values include

"Custom", you can configure a speed from 100Mb to 10Gb in 100Mb increments.

10Gb configured in 100Mb increments.

BootPriority (optional)

BootPort

(Required if the Boot Priority is either Primary or Secondary)

BootLun (Required if the Boot Priority is either Primary or Secondary)

Examples

Controls whether the FCoE HBA port is enabled for SAN boot and affects the BIOS boot order. Valid values include "BIOS", "Primary", "Secondary", and "Disabled".

The target WWPN of the controller interface on the Fibre Channel storage target. The port name is a 64-bit identifier in the format NN:NN:NN:NN:NN:NN:NN:NN, where N is a hexadecimal number.

The LUN of the volume used for SAN boot. Valid values include an integer from 0 to 255 or 16 hex digits (HP-UX only).

Changes the fabric of an FCoE SAN fabric connection

Sets a FCoE SAN fabric connection to "Unassigned"

CustomSpeed=5000 Modifies the FCoE connection and sets a custom speed of 5Gb

BootPort=50:06:0B:00:00:C2:62:00 BootLun=5 Changes the SAN boot priority and sets additional boot parameters

Item Description

show fcoe-connection

Syntax Parameter

ConnectionID (optional)

Examples

Display the FCoE connections associated with the server profiles.

The ID of an existing FCoE connection. The ID format is <ProfileName:Port>. Use <ProfileName:*> to display all FCoE connections of a profile. Use "*" to display all FCoE connections in the domain.

Displays all FCoE connections in the domain

Command line 36

Item Description

->show fcoe-connection Profile1:1

show firmware

->show firmware

->show firmware *

set igmp

set igmp [Enabled=<true|false>] [Timeout=<interval>] (optional)

->set igmp Enabled=true

->set igmp Enabled=true Timeout=30 show igmp

show igmp

->show igmp

Displays all FCoE connections of a profile named Profile1

firmware

Display the Virtual Connect interconnect module firmware version.

Support actions: help, show

Syntax Examples

To update firmware, use the HP BladeSystem c-Class Virtual Connect Support Utility. For more information on installing the firmware, see the HP BladeSystem c-Class Virtual Connect Support Utility documentation on the HP website (http://www.hp.com/go/bladesystem/documentation).

igmp

Displays a specific FCoE connection of a profile named Profile1

Display the firmware information for all interconnect modules in the domain.

Displays a summary listing of all firmware

Displays a detailed listing of all firmware

Manage Ethernet IGMP Snooping settings.

Supported actions: help, set, show Item Description

Syntax Properties

Enabled

Timeout (optional)

Examples

Modify Ethernet IGMP Snooping settings.

Enables or disables IGMP Snooping. Valid values include "true" and "false".

The idle timeout interval (in seconds) for IGMP Snooping. Valid values include integers from 1-3600. The default IGMP idle timeout is 260 seconds.

Enables IGMP Snooping

Enables IGMP Snooping and sets the idle timeout

Item Description

Syntax Example

Display Ethernet IGMP Snooping settings.

Displays IGMP Snooping settings

Command line 37

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

Specifications and Main Features

Frequently Asked Questions

User Manual

Abstract

Contents

Introduction

What's new

Changes from VC 3.30 to 3.51

Virtual Connect overview

Using multiple enclosures

Command line overview

Command line syntax

Parameters

Options

Properties

Command batching

Supporting comments and blank lines in CLI scripts

Unassigning multiple profiles

CLI command execution modes

Remote access to the Virtual Connect Manager

Command output filtering

Command line

Subcommands

Managed elements

version

banner

config

configbackup

devicebay

domain

enclosure

enet-connection

enet-vlan

external-manager

fabric

fc-connection

fcoe-connection

firmware

igmp