HP Virtual Connect Manager Command Line
Part Number: 762319-001
Interface for c-Class BladeSystem Version 4.20
User Guide
Abstract
This document contains user information for the HP Virtual Connect Manager version 4.20 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.
April 2014
Edition: 1
© Copyright 2014 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.
RedHat® is a registered trademark of Red Hat, Inc. in the United States and other countries.
Contents
Introduction .................................................................................................................................. 6
What's new .............................................................................................................................................. 6
Changes from VC 4.10 to VC 4.20 ................................................................................................... 7
Unassigning multiple profiles ...................................................................................................................... 9
Supporting comments and blank lines in CLI scripts ........................................................................................ 9
Virtual Connect overview .......................................................................................................................... 10
Using multiple enclosures ................................................................................................................ 12
CLI command execution modes ................................................................................................................. 12
Remote access to the Virtual Connect Manager ........................................................................................... 13
Command output filtering ......................................................................................................................... 14
Command line overview ........................................................................................................................... 14
Command line syntax .............................................................................................................................. 14
Options ........................................................................................................................................ 15
Properties ..................................................................................................................................... 15
Command batching ....................................................................................................................... 15
Command line ............................................................................................................................ 17
Subcommands ........................................................................................................................................ 17
Managed elements .................................................................................................................................. 17
activity ......................................................................................................................................... 20
all ............................................................................................................................................... 20
auto-deployment ............................................................................................................................ 20
banner ......................................................................................................................................... 22
cli ................................................................................................................................................ 23
config .......................................................................................................................................... 23
configbackup ................................................................................................................................ 24
connection-map ............................................................................................................................. 26
devicebay .................................................................................................................................... 27
domain ........................................................................................................................................ 27
enclosure ...................................................................................................................................... 30
enet-connection ............................................................................................................................. 32
enet-vlan ...................................................................................................................................... 35
external-manager .......................................................................................................................... 37
fabric ........................................................................................................................................... 39
fc-connection ................................................................................................................................. 42
fcoe-connection ............................................................................................................................. 45
firmware ...................................................................................................................................... 49
igmp-group ................................................................................................................................... 49
igmp ............................................................................................................................................ 49
interconnect-mac-table .................................................................................................................... 50
interconnect .................................................................................................................................. 51
iscsi-boot-param ............................................................................................................................ 52
iscsi-connection ............................................................................................................................. 55
lacp-timer ..................................................................................................................................... 58
ldap-certificate .............................................................................................................................. 58
ldap-group.................................................................................................................................... 60
ldap ............................................................................................................................................ 61
Contents 3
link-dist-interval .............................................................................................................................. 62
lldp .............................................................................................................................................. 63
local-users .................................................................................................................................... 63
log-target ...................................................................................................................................... 64
loop-protect .................................................................................................................................. 66
mac-cache .................................................................................................................................... 67
mcast-filter-rule .............................................................................................................................. 67
mcast-filter-set ................................................................................................................................ 68
mcast-filter .................................................................................................................................... 70
mfs-filter ....................................................................................................................................... 72
nag-network .................................................................................................................................. 72
name-server .................................................................................................................................. 74
network-access-group ..................................................................................................................... 74
network-range ............................................................................................................................... 75
network ........................................................................................................................................ 78
port-monitor .................................................................................................................................. 83
port-protect ................................................................................................................................... 85
profile .......................................................................................................................................... 86
qos-class ...................................................................................................................................... 91
qos-classifier ................................................................................................................................. 93
qos-map ....................................................................................................................................... 94
qos .............................................................................................................................................. 95
radius-group ................................................................................................................................. 97
radius .......................................................................................................................................... 98
role ............................................................................................................................................. 99
server-port-map-range ................................................................................................................... 100
server-port-map ........................................................................................................................... 101
server-port .................................................................................................................................. 103
server ........................................................................................................................................ 104
serverid ...................................................................................................................................... 106
session ....................................................................................................................................... 107
sflow .......................................................................................................................................... 108
sflow-module ............................................................................................................................... 108
sflow-ports .................................................................................................................................. 110
sflow-receiver .............................................................................................................................. 112
snmp-access ................................................................................................................................ 114
snmp-trap ................................................................................................................................... 115
snmp ......................................................................................................................................... 117
ssh............................................................................................................................................. 118
ssl-certificate ............................................................................................................................... 119
ssl-csr ......................................................................................................................................... 120
ssl ............................................................................................................................................. 123
stackinglink ................................................................................................................................. 123
statistics...................................................................................................................................... 124
statistics-throughput ...................................................................................................................... 126
status ......................................................................................................................................... 127
storage-management .................................................................................................................... 128
supportinfo ................................................................................................................................. 129
systemlog ................................................................................................................................... 130
tacacs ........................................................................................................................................ 131
uplinkport ................................................................................................................................... 132
uplinkset ..................................................................................................................................... 135
user-security ................................................................................................................................ 137
Contents 4
user ........................................................................................................................................... 138
vcm ........................................................................................................................................... 140
version ....................................................................................................................................... 141
User roles ............................................................................................................................................. 141
Help subsystem ..................................................................................................................................... 147
Output format ....................................................................................................................................... 148
Interactive user output format ........................................................................................................ 149
Scriptable output format ............................................................................................................... 150
Statistics descriptions ............................................................................................................................. 152
Ethernet modules ......................................................................................................................... 152
Fibre Channel modules ................................................................................................................. 162
Configuring the Virtual Connect domain using the CLI ................................................................... 167
Basic configuration ................................................................................................................................ 167
Logging in to the CLI .................................................................................................................... 167
Domain setup .............................................................................................................................. 168
Network setup............................................................................................................................. 173
Server VLAN Tagging Support ...................................................................................................... 177
Fibre Channel setup ..................................................................................................................... 178
Serial number settings .................................................................................................................. 179
Server profile setup ...................................................................................................................... 180
Server profile setup ...................................................................................................................... 182
Logging out of the CLI .................................................................................................................. 194
Common management operations ........................................................................................................... 194
Port status conditions ............................................................................................................................. 195
Resetting the Virtual Connect Manager ..................................................................................................... 195
Support and other resources ...................................................................................................... 197
Before you contact HP ............................................................................................................................ 197
HP contact information ........................................................................................................................... 197
Acronyms and abbreviations ...................................................................................................... 198
Documentation feedback ........................................................................................................... 202
Index ....................................................................................................................................... 203
Contents 5
Introduction
What's new
The command line interface user guide contains the following changes for VC 4.20:
• Added the following managed elements:
o cli (on page 23)
o sflow (on page 108)
o sflow-module (on page 108)
o sflow-ports (on page 110)
o sflow-receiver (on page 112)
• Updated the Ethernet uplink port speed selection to include 40Gb in the following commands:
o port-monitor (on page 83)
o uplinkport (on page 132)
• VC 4.20 supports the HP VC FlexFabric-20/40 F8 Module.
• The following commands support an uplink port label of Qx:y:
o lldp (on page 63)
o port-monitor (on page 83)
o statistics (on page 124)
o statistics-throughput (on page 126)
o uplinkport (on page 132)
• Updated the following commands to include the "Pool-Specified" option:
o enet-connection (on page 32)
o fc-connection (on page 42)
o fcoe-connection (on page 45)
o iscsi-connection (on page 55)
o profile (on page 86)
• Updated the following command to include the -fip_snooping option:
o show interconnect ("interconnect" on page 51)
Introduction 6
show sflow-receiver
show lldp <PortID>
show lldp <PortID>
Q<x>.<y>
Changes from VC 4.10 to VC 4.20
Command Changes Virtual Connect 4.10 Virtual Connect 4.20
set cli
help cli
set sflow
show sflow
help sflow
help sflow-module
reset sflow-module
set sflow-module
show sflow-module
add sflow-ports
help sflow-ports
remove sflow-ports
set sflow-ports
show sflow-ports
add sflow-receiver
remove sflow-receiver
help sflow-receiver
set sflow-receiver
show lldp
reset statistics
show statistics
add uplinkport
remove uplinkport
set uplinkport
show uplinkport
The new managed
element modifies
command execution
behavior in script
mode and
auto-deployment.
The new managed
element configures
the existing VC
Ethernet network used
to send datagrams to
the receiver.
The new managed
element configures
the network settings
for the network
interface created for
sflow.
The new managed
element configures
the ports to be
sampled or polled for
a receiver.
The new managed
element configures
the receivers.
Modified the
commands to include
QSFP+ uplink ports
Not supported Both of these commands
Not supported All of these commands are
Not supported All of these commands are
Not supported All of these commands are
Not supported All of these commands are
where the format of the
<PortID> is
<EnclosureID>:<Int
erconnectBay>:<Por
tLabel>
are supported.
supported.
supported.
supported.
supported.
where the format of the
<PortID> is
<EnclosureID>:<Int
erconnectBay>:<Por
tLabel>.
For QSFP+ ports, the
<PortLabel> format is
.
Introduction 7
add port-monitor
add port-monitor
Q<x>.<y>
[Speed=<Auto|10Mb|
[Speed=<Auto|10Mb|
Command Changes Virtual Connect 4.10 Virtual Connect 4.20
add port-monitor
remove port-monitor
set port-monitor
add port-monitor
set port-monitor
add uplinkport
set uplinkport
show config
add profile
add enet-connection
add fc-connection
add fcoe-connection
add iscsi-connection
show interconnect
Modified the
commands to include
QSFP+ uplink ports in
the AnalyzerPort
property
Modified the
commands to include
the "40Gb" speed
type
The
includePoolInfo
option provides
VC-defined
addresses and
user-defined
addresses for
profiles, to be used to
restore the profiles
while maintaining the
pool-specified IDs.
The
PoolSpecified
option supports
creating a profile and
its connections with
pool-specified
addresses, if
available in the
specified domain
pool.
The
-fip_snooping
option displays FIP
snooping information
for the specified
interconnect module.
[AnalyzerPort=<Por
tID>]
[Speed=<Auto|10Mb|
100Mb|1Gb|10Gb|Dis
abled>]
[Duplex=<Auto|Half
|Full>]
[MonitorPort=<Port
ID>]
[Direction=<ToServ
er|FromServer|Both
>]
where the format of the
network analyzer
<PortID> is
<EnclosureID>:<Int
erconnectBay>:<Por
tNumber>
[AnalyzerPort=<Por
tID>]
[Speed=<Auto|10Mb|
100Mb|1Gb|10Gb|40G
b|Disabled>]
[Duplex=<Auto|Half
|Full>]
[MonitorPort=<Port
ID>]
[Direction=<ToServ
er|FromServer|Both
>]
where the format of the
network analyzer
<PortID> is
<EnclosureID>:<Int
erconnectBay>:<Por
tNumber>.
For QSFP+ ports, the
<PortNumber> format is
100Mb|1Gb|10Gb|Dis
abled>]
100Mb|1Gb|10Gb|40G
b|Disabled>]
Not available Available
Not available Available
Not available Available
.
Introduction 8
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
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, 2014
#------------------------------------------------------------------------
# Add Users
add user SomeNetworkUser password=pass1 role=network
add user SomeStorageUser password=pass2 role=storage
add user SomeDomainUser password=pass6 role=domain
add user SomeAdminUser password=pass3 role=*
add user DomainNetworkUser password=764dhh role=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
Introduction 9
# 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
# Add a new FCoE SAN fabric connection to a profile
add fcoe-connection MyNewProfile Fabric=SAN_5
# Reset the active QoS configuration type to the factory default settings but
does not change the saved configuration types
reset qos -active
# Set the domain default LACP timer to the short setting (one second)
set lacp-timer default=Short
# Add a Multicast Filter "filter1" to Filterset "mfs1"
add mfs-filter FilterSet=mfs1 McastFilter =filter1
# Set the global option to enable the loop protection and pause flood protection
set port-protect networkLoop=Enabled PauseFlood=Enabled
# Set idle user sessions to expire after 20 minutes of inactivity
set session Timeout=20
# Create a new Multicast Filter and adds it to the domain
add mcast-filter MyMcastFilter
# Assign a profile to a device bay
assign profile MyProfile enc0:1
# Done!!!
Virtual Connect overview
HP Virtual Connect is a set of interconnect modules and embedded software for HP BladeSystem c-Class
enclosures. VC simplifies the setup and administration of server connections and includes the following
components:
Introduction 10
• VC-Enet modules
o HP VC Flex-10 10Gb Ethernet Module for BladeSystem c-Class
o HP VC FlexFabric 10Gb/24-port Module for BladeSystem c-Class, which provides the capability to
configure Ethernet and FC/FCoE or iSCSI connections
o HP VC FlexFabric-20/40 F8 Module for BladeSystem c-Class, which provides the capability to
configure Ethernet and FC/FCoE or iSCSI connections
o HP VC Flex-10/10D Module for BladeSystem c-Class
NOTE: Using a Flex-10 capable NIC with an HP VC Flex-10 or FlexFabric module provides the
ability to divide a 10Gb NIC into four FlexNICs with configurable bandwidth.
• VC-FC modules
o HP VC 4Gb Fibre Channel Module for BladeSystem c-Class (enhanced NPIV)
o HP VC 8Gb 24-Port Fibre Channel Module for BladeSystem c-Class
o HP VC 8Gb 20-Port Fibre Channel Module for BladeSystem c-Class
Please note this document may have references to yet to be announced products. For details, please contact
your HP representative.
• HP VCM
NOTE: Beginning with VC 4.10, the HP 4GB Virtual Connect Fibre Channel Module is no longer
VC implements server edge virtualization between the server and the data center infrastructure so networks
can communicate with individual servers or pools of HP BladeSystem server blades. Upgrade, replace, or
move server blades within the enclosures without visible changes to the external LAN and SAN environments.
The external networks connect to a shared resource server pool rather than to individual servers. VC cleanly
separates server enclosure administration from LAN and SAN administration.
supported.
VCM is embedded on VC-Enet modules. Access VCM through a web-based GUI or CLI. The Onboard
Administrator provides a web link to the VC GUI. The CLI can be accessed remotely through any SSH session
or through the Onboard Administrator CLI.
The VC modules support the HP BladeSystem c7000 Enclosure, the HP BladeSystem c3000 Enclosure, and
all server blades and networks contained within the enclosure. FlexFabric 10 Gb modules are supported only
in BladeSystem c7000 enclosures with G6 or newer server blades or Integrity i2 and i4 server blades with
VC firmware v3.15 and later. FlexFabric-20/40 F8 modules are supported only with v4.20 and later on the
following HP BladeSystem c-Class c7000 enclosure SKUs: 507014-B21, 507015-B21, 507016-B21,
507017-B21, 507019-B21, 681840-B21, 681842-B21 and 681844-B21. For information on updated
SKUs, see the QuickSpecs on the HP website (http://www.hp.com/go/productbulletin).
VC-Enet modules enable connectivity to 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 data center FC switches. Every FC
fabric is limited in the number of switches it can support, but the VC-FC and FlexFabric modules do not
appear as switches to the FC fabric and do not count against FC fabric limits.
A basic VC 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
Introduction 11
Loading...