HP Virtual Connect Manager Command Line Interface Version 2.
© Copyright 2007, 2008 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.
Contents Introduction .................................................................................................................................. 5 Virtual Connect overview............................................................................................................................ 5 Command line overview............................................................................................................................. 6 Command line syntax ....................................
ssl ............................................................................................................................................... 58 stackinglink................................................................................................................................... 59 status ........................................................................................................................................... 59 supportinfo ....................................................
Introduction Virtual Connect overview 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.
Command line overview The HP Virtual Connect Manager Command Line Interface can be used as an alternative method for managing the Virtual Connect Manager. Using the CLI can be useful in the following scenarios: • HP Management Applications (for example, Systems Insight Manager or Insight Control tools) can query the Virtual Connect Manager for information these tools need to present a complete management view of HP BladeSystem enclosures and devices.
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.
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 Scripts are useful for batching many CLI commands. Administrators can create a single CLI script to configure an entire VC domain from scratch and use it on multiple enclosures. The updated version of the CLI supports command scripts that contain blank lines and comments.
add profile AnotherProfile add profile Profile45 # Add a few VC-Enet Networks add network MyNetwork add network Network2 # Add a few 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 # Assign a profile to a device bay assign profile MyProfile enc0:1 # Done!!! Unassigning multiple profiles In previous firmware releases, if the user needed to unassign multiple profiles from several device
This mode is used to invoke CLI command operations using the dedicated management shell. The shell is provided after the user logs in with valid credentials, and only accepts known VCM CLI commands as input. Users can quit the shell by using the exit command. An example of logging into the interactive management shell is provided below. In the example, the primary VCM is located at IP address 192.168.0.120. >ssh 192.168.0.
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. Command output filtering The CLI provides output filtering capabilities that enable users 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.
Command line Subcommands Command Description add Add a new object to the domain or to another object assign Assign a server profile to a device bay delete Delete the domain configuration exit Exit the Virtual Connect Manager command-line shell help Display context-sensitive help for a command or object import Import an enclosure into the domain load Transfer a file from a remote location to the domain poweroff Power off one or more servers poweron Power on one or more servers reboot Reb
Managed element Description firmware (on page 29) Manage interconnect module firmware igmp (on page 30) Manage Ethernet IGMP Snooping settings interconnect (on page 31) Manage I/O interconnect modules ldap (on page 32) Manage LDAP configuration settings ldap-certificate (on page 33) Manage LDAP certificate information ldap-group (on page 34) Manage LDAP group configuration settings log-target (on page 35) Manage remote log destination settings mac-cache (on page 37) Manage Ethernet MAC cach
Supported actions: help, show Item Description show all Display all Virtual Connect domain configuration objects. This command is typically useful for displaying a snapshot of the entire domain configuration with a single command. Syntax show all [*] Examples ->show all Displays all configuration objects (summary view) ->show all * Displays all configuration objects (detailed view) devicebay Manage general enclosure device bay settings and information.
Item Description delete domain Delete the existing Virtual Connect domain configuration. Deleting the domain removes the entire Virtual Connect domain configuration and resets it to the original defaults. After the domain has been deleted, you are logged out and the Virtual Connect Manager resets. Syntax delete domain [-quiet] Option quiet Suppresses user confirmation prompts. This option is useful when scripting delete domain operations.
Item Description MacPool (optional) The pre-defined MAC pool to use for address assignment. Valid values include integers 1-64. This property is only valid if the MacType is set to "VC-Defined". If not specified, the default pool ID is 1. MacStart (Required if IP address specified) The starting MAC address in a custom user-defined range. This property is only valid if the MacType is set to "User-Defined". MacEnd (Required if IP address specified) The ending MAC address in a custom user-defined range.
Item Description ->set domain WwnType=User-Defined WwnStart=50:06:0B:00:00:C2:62:00 WwnEnd=50:06:0B:00:00:C2:62:FF Sets the WWN address source to a custom, user-defined address range ->set domain SingleDense=true Sets the display option to support single-dense server blades in a double-dense supported configuration Item Description show domain Display general Virtual Connect domain information, including the Virtual Connect domain name, the VCM domain IP address settings, and MAC/WWN address settings f
Item Description ->import enclosure UserName=Administrator Password=fgg7h*1 DoubleDense=true Imports the local enclosure with double-dense device bay display format Item Description remove enclosure Remove a remote enclosure that has been imported into the domain. The local enclosure is not allowed to be removed from the domain using the remove enclosure command.
Item Description add enet-connection Add a new Ethernet network connection to an existing server profile. The maximum number of Ethernet connections that can be added to a server profile is 32.
Item Description ->add enet-connection MyNewProfile Network=SomeNetwork2 PXE=enabled Adds a new Ethernet network connection and enables PXE ->add enet-connection MyNewProfile Adds a new Ethernet network connection and leaves the network unassigned ->add enet-connection MyNewProfile AddressType=Factory-Default Adds a new Ethernet network connection and uses factory default addresses ->add enet-connection MyNewProfile AddressType=UserDefined EthernetMAC=00-17-A4-77-00-00 iScsiMAC=0017-A4-77-00-01 Adds a new
Item Description PXE Enables or disables PXE on a connection. Valid values are "enabled", "disabled", and "UseBios". Applies to Ethernet network connections only. PXE can be enabled on one connection per profile. SpeedType (optional) The requested operational speed for the server port. Valid values include "Auto", "Preferred", and "Custom". The default value is "Preferred". If the speed type is "Auto", the maximum port speed is determined by the maximum configured speed for the network.
Item Description ->show enet-connection Profile1:1 Displays a specific Ethernet connection of profile Profile1 enet-vlan Manage Ethernet VLAN connections. Supported actions: help, set, show Item Description set enet-vlan Modifiy general Ethernet VLAN configuration settings.
Item Description ->set enet-vlan VLanTagControl=Map SharedServerVLanId=true Sets the VLanTagControl to Map and SharedServerVLanId ->set enet-vlan PrefSpeedType=Custom PrefSpeed=500 MaxSpeedType=Custom MaxSpeed=2500 Sets the preferred connection speed for all connections using multiple networks to 500Mb and maximum connection speed to 2.5Gb Item Description show enet-vlan Display general Ethernet VLAN configuration settings.
Item Description MacStart (Required if the MacType is User-Defined) The starting MAC address in a custom user-defined range. This property is only valid if the MacType is set to "User-Defined". MacEnd (Required if the MacType is User-Defined) The ending MAC address in a custom user-defined range. This property is only valid if the MacType is set to "User-Defined". WwnType (Optional) The type of WWN address source to use for assignment. Valid values include: "Factory-Default" and "User-Defined".
Item Description UserName (required) A valid external manager username. The username can be identified using the show external-manager command. Enabled (required) Enables or disables the external manager. Valid values include "true" and "false". Examples ->set external-manager UserName=A17005068 Enabled=false Disables the external manager ->set external-manager UserName=A17005068 Enabled=true Enables the external manager fabric Manage Fibre Channel SAN fabrics.
Item Description Syntax remove fabric Parameter Name (required) The name of an existing fabric or "*" to be removed Examples ->remove fabric VFabric_1 Removes VC FC SAN fabric VFabric_1 ->remove fabric * Removes all VC FC fabrics from the domain Item Description set fabric Modify an existing FC SAN fabric.
Item Description Syntax show fabric [ | *] Parameter FabricName (optional) Name of an existing FC SAN fabric. “*” displays detailed output of all the fabrics in the VC domain. If not specified, summary output of all fabrics is displayed.
Item Description ->add fc-connection MyNewProfile Fabric=SAN_5 Adds a new FC SAN fabric connection to a profile ->add fc-connection MyNewProfile Fabric=SomeFabric Speed=4Gb Adds a new FC SAN connection and configures the port speed ->add fc-connection MyNewProfile Adds a new FC SAN connection and uses the next available fabric ->add fc-connection MyNewProfile AddressType=FactoryDefault Adds a new FC SAN connection and uses factory-default addresses ->add fc-connection MyNewProfile AddressType=UserDefined P
Item Description BootPort (optional) 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 BootLun (optional) The LUN of the volume used for SAN boot. Valid values include an integer from 0-255 or 16 hex digits (HP-UX only).
Item Description ->show firmware Displays current version of the firmware ->show firmware * Displays detailed listing of all firmware Item Description update firmware Update the firmware on all Virtual Connect modules in the domain. Syntax update firmware [-quiet] URL= Parameter quiet Suppresses progress messages and displays only SUCCESS and FAILURE messages Option URL (required) The location and name of the firmware image to use for the update. The default protocol to use is HTTP.
Item Description Example ->show igmp Displays IGMP Snooping settings interconnect Manage I/O interconnect modules. Supported actions: help, remove, show Item Description remove interconnect Remove a module from the domain that has been removed physically from an enclosure. Normally this command is used if a module has been physically removed from the enclosure. To be removed, the module must not be currently in use by any element in the domain.
Item Description ->show interconnect enc0:* Displays interconnect modules in all bays of a specific enclosure ->show interconnect enc0:3 Displays detailed information on a specific interconnect module in interconnect bay 3 of the primary enclosure ldap Manage Virtual Connect directory server authentication settings. Supported actions: help, set, show Item Description set ldap Modify and test the Virtual Connect LDAP directory server authentication settings.
Item Description ->set ldap -test Enabled=true ServerAddress=192.168.0.27 Tests the directory service changes without applying ->set ldap Enabled=true ServerAddress=192.168.0.124 SslPort=636 SearchContext1=”ou=users,dc=company,dc=com” Enables directory services authentication for users Item Description show ldap Display the Virtual Connect LDAP authentication settings.
Item Description ->remove ldap-certificate * Removes all LDAP certificates Item Description show ldap-certificate Display LDAP certificate information. Syntax show ldap-certificate [ | *] Parameter SerialNumber (optional) The serial number of an existing LDAP certificate in a colon format. "*"displays detailed output of all the LDAP certificates in the VC domain. If not specified, then displays summary output of all the LDAP certificates.
Item Description GroupName (required) The name of the directory group to be removed or "*" to remove all LDAP groups Example ->remove ldap-group MyGroup Removes a directory group Item Description set ldap-group Modify the properties of an existing directory group.
Item Description Severity (optional) Severity of the log messages that should be sent to the specified destination. Valid values include "Critical", "Error", "Warning", and "Info". The default value is "Info". Transport (optional) The transport protocol to be used for sending the log messages to the destination. Valid values include "TCP" and "UDP". The default value is "UDP". Port (optional) The port to be used on the destination to send the log messages. Valid values include 1 to 65536.
Item Description Severity (optional) Severity of the log messages that should be sent to the specified destination. Valid values include "Critical", "Error", "Warning", and "Info". The default value is "Info". Transport (optional) The transport protocol to be used for sending the log messages to the destination. Valid values include "TCP" and "UDP". The default value is "UDP". Port (optional) Secure transmission of the log messages. Valid values include "None" and "STunnel".
Item Description set mac-cache Modify Ethernet MAC Cache failover settings. Syntax set mac-cache [Enabled=] [Refresh=] Properties Enabled (optional) Refresh (optional) Enables or disables MAC cache failover. Valid values include "true" and "false". The refresh interval for the MAC Cache (in seconds). Valid values include integers from 1-30. The default refresh interval is 5 seconds.
Item Description UplinkSet (optional) The name of an existing shared uplink port set to use with this new network. If this property is specified, then a valid VLAN ID must also be provided. The limit is 32 networks per shared uplink set. VLanID (required if network is associated with shared uplink set) The VLAN ID associated with the network (used with shared uplink port set only). The VLAN ID is a valid number between 1 and 4094. State (optional) Enables or disables the network.
Item Description ->add network Network1 UplinkSet=Uplinkset1 VLANID=100 NativeVLAN=Enabled Creates a new network with a shared uplinkset and tags it as Native VLAN ->add network Network1 ConnectionMode=Failover Creates a new network and sets the connection mode as failover ->add network Network1 VLanTunnel=Enabled Creates a new network and enables VLAN tunneling ->add network Network1 PrefSpeedType=Custom PrefSpeed=4000 MaxSpeedType=Custom MaxSpeed=6000 Creates a new network with a preferred connection spe
Item Description NativeVLAN (optional) Enables or disables the network to act as a native VLAN. Valid values are "Enabled" and "Disabled". The default value is "Disabled". This property can be configured only if it is a applied to a shared network. Private (optional) Enables or disables the network to act as a private network. Valid values are "Enabled" and "Disabled". The default value is "Disabled".
Item Description ->set network Network1 PrefSpeedType=Custom PrefSpeed=4000 MaxSpeedType=Custom MaxSpeed=6000 Modifies network to preferred connection speed of 4Gb and maximum connection speed of 6Gb Item Description show network Display all Ethernet networks in the domain. Syntax show network [ | *] Parameter NetworkName (optional) Name of an existing network in the VC domain. "*" displays a detailed view of all the networks.
Item Description MonitorPort (optional) The server port to be monitored. The format of the monitored port is: ::. If the enclosure ID is not specified, the default enclosure is the local enclosure. Direction (optional) The ID for the monitor port can be referenced from the ID column in the output of the show server-port command. The direction of network traffic on the port being monitored. Valid values include: "ToServer", "FromServer", and "Both".
Item Description Duplex (optional) The port duplex mode of the network analyzer port. Valid values include: "Auto", "Half", and "Full". The default value is "Auto". MonitorPort (required if the Direction property is being modified) The server port to be monitored. The format of the monitored port is: ::. Direction (optional) If the enclosure ID is not specified, the default enclosure is the local enclosure where the domain resides.
Item Description NoDefaultEnetConn Do not add default Ethernet Network connections when creating the server profile. NoDefaultFcConn Do not add default FC SAN connections when creating the server profile. Properties SNType (Optional) The source of the serial number assignment to be used during the profile creation. If not specified, the serial number is assigned as per the Virtual connect default domain settings. Valid values include "Factory-Default" and "UserDefined".
Item Description ->assign profile MyProfile1 enc0:1 Assigns a profile to device bay 1 of the primary enclosure Item Description remove profile Remove one or more server profiles from the domain. Syntax remove profile Parameter ProfileName (required) Name of an existing profile in the VC domain.
Item Description ->show profile Displays a summary listing of all server profiles ->show profile * Displays detailed information for all profiles ->show profile MyProfile Displays detailed information for a specific profile including if a profile is configured for SAN Boot Item Description unassign profile Unassign a server profile from a device bay Syntax unassign profile Parameter ProfileName (required) Example The name of a server profile that is currently assigned to a devic
Item Description ->poweroff server * Powers off all servers in the domain ->poweroff server enc0:* Powers off all servers in a specific enclosure ->poweroff server enc0:2 -ForceOnTimeout Attempts a graceful poweroff, but forces a shutdown at the end of the timeout period ->poweroff server * -timeout=180 Shuts down all servers and specifies a custom timeout of 3 minutes Item Description poweron server Power on one or more physical servers.
Item Description Timeout Specifies the timeout period (in seconds) to wait for the operation to complete (per server). The default timeout is 120 seconds.
Item Description set serverid Modifiy Virtual Server ID domain settings. The serial number attributes can be changed only in one of the following scenarios: Syntax • Virtual Server ID source is Factory-Default. • Virtual Server ID source is VC-Defined or User-Defined but no profiles are using server IDs from this source. • Virtual Server ID source is User-Defined and this range is being extended by lowering the start or increasing the end values.
Supported actions: help, show Item Description show server-port Display physical port information. Syntax show server-port Parameter PortID (Optional) The reference of a port mapping ID. The PortID format is EnclosureID:IOBay:Port. The Port ID can be referenced from the ID column in the summary display. The detailed display shows any Flex NICs that might be associated with a server port.
Item Description UntaggedD (optional) Enable or disable the network to handle untagged packets. Only one network in an Ethernet network connection can be made to handle untagged packets. The default value is "false". If a shared uplink set is being used, then the untagged network is the same as the native network, if present, but any other network can be configured to handle untagged packets.
Item Description VLanID (optional) The new VLAN ID to be used for the mapping server port to network. Valid values include 1 to 4094. Untagged (optional) Enables or disables the network to handle untagged packets. Only one network in an Ethernet network connection is allowed to handle untagged packets. The default value is "false". If a shared uplink set is being used, then untagged network is the same as the native network if present, but any network can also be configured to handle untagged packets.
Item Description Properties ReadCommunity (optional) Read-Only Community String for SNMP. The default value is "Public" if not specified. SystemContact SNMP system contact information Enabled (optional) Enables or disables the SNMP agent. The default value is "true". Valid values include "true" or "false". SmisEnabled (optional) This property is valid only for FC modules. The default value is "false". Valid values include "true" or "false".
Item Description TrapID (required) (Required) The reference name of the new trap destination to be added. The format of the trap ID is : where the address is the IP address of the trap destination host. Property Community (optional) The SNMP community name string for the specified trap.Default is "public". For VC-ENET modules, maximum string length is 39. For VC-FC modules, maximum string length is 24. Examples ->add snmp-trap ENET:192.112.34.
Item Description Type (optional) This parameter indicates the type of VC modules for which to display SNMP trap information. The default behavior is to display all SNMP trap information if a specific type is not specified. Valid types include "Enet:
" and "FC:", where "Address" can be a specific IP address or "*".Item Description show ssh Display the SSH key configuration. Syntax show ssh Example ->show ssh Displays the SSH key configuration ssl-certificate View and upload the SSL certificate from a remote FTP server. Supported actions: help, load, show Item Description load ssl-certificate Transfer an SSL Certificate from a remote FTP server and apply it to the Virtual Connect Manager web server. After a new SSL certificate is applied, the web server is reset.
Item Description save ssl-csr Generate and transfer an SSL certificate signing request (CSR) to a remote FTP server. Syntax save ssl-csr address= [filename=] Properties Address (required) A valid IP address or host name of the FTP server, with username and password Filename (required) The name of the file to which the generated SSL CSR will be stored on the FTP server. If not specified, the default file name will be "vc-ssl.csr".
stackinglink Display stacking link information and status. Supported actions: help, show Item Description show stackinglink Display stacking links and their status. Syntax show stackinglink Example ->show stackinglink Displays a summary listing of all stacking links and status status View overall domain status information. Supported actions: help, show Item Description show status Display the status of the domain and all components in the domain.
Supported actions: help, show Item Description show systemlog Display the Virtual Connect manager system log. Syntax show systemlog [-Last=] [-First=] [-Pause=] Options Last Display the last n records. If this option is specified and no value is provided, the default is the last 10 records First Display the first n records. If this option is specified and no value is provided, the default is the first 10 records. Pause Number of records to be viewed before prompting for key press.
Item Description Role (optional) The Role played by the port if the connection mode of the network or shared uplink set is selected as "Failover". The default is "Primary".
Item Description Network (optional) The name of the network to which the port belongs UplinkSet (optional) The name of the shared uplink port set to which the port belongs Speed (optional) Specifies the port speed for the port. Acceptable values include "Auto", "10Mb", "100Mb", "1Gb", and "Disabled". Role (optional) The Role played by the port if the connection mode of the network or shared uplinkset is selected as "Failover". The default value is "Primary".
Item Description Parameter UplinkSetName (required) The unique name of the new shared uplink port set to create (required) Property ConnectionMode (optional) Specifies the connection type that is formed when multiple ports are added to the uplinkset. Valid values include "Auto" and "Failover". The default value is "Auto".
Item Description Syntax show uplinkset [ | *] Parameter UplinkSetName (optional) Name of an existing uplink port set. "*" displays a detailed view of all the uplink port sets. If not specified, summary of all uplink port sets will be displayed.
Item Description ->add user bill Password=HGtwf7272562 Privileges="domain,network" FullName="Bill Johnson" ContactInfo=billj@company.com Enabled=true Adds a new user and configures additional user properties ->add user Admin Password=hjkhfd Privileges=* Adds an "Admin" user with all privileges Item Description remove user Remove a user from the Virtual Connect Manager database. Syntax remove user Parameter UserName (required) The name of an existing user that will be removed.
Item Description ->set user bill Password=HGtwf7272562 Privileges="domain,network" FullName="Bill Johnson" ContactInfo=billj@company.com Enabled=true Modifies several properties of an existing user ->set user tom privileges=* Gives a user all privileges Item Description show user Display user summary or user details. Syntax show user [] Parameter UserName (optional) Name of an existing user in the VC domain. If not specified, then summary of all existing user will be displayed.
Item Description show user-security Display general domain user security settings. Syntax show user-security Example ->show user-security Displays strong user password settings vcm Reset the Virtual Connect Manager. Supported actions: help, reset Item Description reset vcm Reset the Virtual Connect Manager. A failover to the standby VCM may also be specified (optional), if there is a standby VCM available.
• • Help summary—lists all supported actions and a short description of each: >help (or ?) add add an element to an existing object assign assign a server profile to a device bay . . .
- Display a summary listing of all device bays: ->show devicebay - Show detailed information for all device bays: ->show device bay * - Show detailed information for a specific device bay 2 of a specific enclosure: ->show devicebay enc0:2 Output format The CLI provides two different output formats: • Interactive user output format • Scriptable output format The interactive user output format is the default.
network storage ---------------------------------------------------------------------------brad domain Brad Mills brad.mills@hp.com true server ---------------------------------------------------------------------------jim network Jimmy Joe jimmy.joe@hp.com true ---------------------------------------------------------------------------alice storage Alice Candle alice.candle@hp.
Privileges FullName ContactInfo Enabled : : : : network Jimmy Joe jimmy.joe@hp.com true UserName Privileges FullName ContactInfo Enabled : : : : : alice storage Alice Candle alice.candle@hp.com false Scriptable output format Scriptable output format allows scripts to invoke CLI commands and receive command responses that can be easily parsed by the scripts. This capability is provided by two options that are available: output=script1 and -output=script2.
Full Name= Contact Info= Enabled=true Example 3: Scriptable output format displaying all users (with table header) ->show user -output=script2 UserName;Privileges;FullName;ContactInfo;Enabled Administrator;domain,server,network,storage;Steve Johnson;steve.johnson@hp.com;true Admin;domain,server,network,storage;Admin;Admin;true steve;domain,server,network,storage;Steve Johnson;steve.johnson@hp.
Configuring the Virtual Connect domain using the CLI Basic configuration A Virtual Connect domain consists of an enclosure and a set of associated modules and server blades that are managed together by a single instance of the Virtual Connect Manager. The Virtual Connect domain contains specified networks, server profiles, and user accounts that simplify the setup and administration of server connections.
• password: LDAP Authentication >ssh 192.168.0.120 login as: password: Domain setup A Virtual Connect domain consists of an enclosure and a set of associated modules and server blades that are managed together by a single instance of the Virtual Connect Manager. the Virtual Connect domain contains specified networks, server profiles, and user accounts that simplify the setup and administration of server connections.
• • • >add user bob password=fhkjdhfk privileges=domain,network Modify an existing user >set user bob fullname="Bob J Smith" enabled=false Remove an existing user >remove user bob Remove all local users except for the Administrator account >remove user * Display local users: • • • Summary display >show user Detailed display >show user * Displaying info on a single user >show user steve Up to 32 local user accounts can be created.
It is possible to create a user with no privileges. This user can only view status and settings. NOTE: The vcmuser_ account is an internal Onboard Administrator account created and used by Virtual Connect Manager to communicate with the Onboard Administrator. This account can show up in the Onboard Administrator system log. This account cannot be changed or deleted. Configuring LDAP authentication support for users • • • • Set LDAP properties >set ldap ipaddress=192.168.0.
override the factory default MAC addresses while the server remains in that Virtual Connect enclosure. When configured to assign MAC addresses, Virtual Connect securely manages the MAC addresses by accessing the physical NICs through the enclosure Onboard Administrator and the iLO interfaces on the individual server blades. Always establish control processes to ensure that a unique MAC address range is used in each Virtual Connect domain in the environment.
Creating an enet-network To create a new Ethernet network use the add network command: >add network MyNetworkName Modifying enet-network properties To modify Ethernet network properties, use the set network command: >set network MyNetworkName state=enabled name=NewName smartlink=enabled Displaying enet-networks To display Ethernet network properties, use the show network command: • • • Summary display >show network Detailed display >show network * Single network display > show network MyNetwork Adding
Because VLAN tags are added or removed when Ethernet packets leave or enter the VC-Enet shared uplink, the VLAN tags have no relevance after the Ethernet packet enters the enclosure. IMPORTANT: If you are deploying a server where VLAN tags will be used (added) on the server itself, do not connect the server Ethernet port carrying VLAN-tagged traffic to a shared uplink set. Identifying an associated network as the native VLAN causes all untagged incoming Ethernet packets to be placed onto this network.
accessing the physical FC HBA through the enclosure Onboard Administrator and the iLO interfaces on the individual server blades. When assigning WWNs to a FC HBA port, Virtual Connect will assign both a port WWN and a node WWN. Because the port WWN is typically used for configuring fabric zoning, it is the WWN displayed throughout the Virtual Connect user interface. The assigned node WWN is always the same as the port WWN incremented by one.
boot environments and host operating system software as the hardware addresses. To use administered MAC addresses, select a range of HP pre-defined or user-specified MAC addresses. Be sure to review the following list of guidelines before creating and deploying server profiles: • The server blade firmware and option card firmware must be at a revision that supports Virtual Connect profile assignment. See the HP website (http://www.hp.com/go/bladesystemupdates).
Creating server profiles To create a new server profile, use the add profile command: >add profile MyProfile After an enclosure is imported into a Virtual Connect domain, server blades that have not been assigned a server profile are isolated from all networks to ensure that only properly configured server blades are attached to data center networks. A server profile can be assigned and defined for each device bay so that the server blade can be powered on and connected to a deployment network.
When a VC-Enet uplink that was previously in standby mode becomes active, it can take several minutes for external Ethernet switches to recognize that the c-Class server blades can now be reached on this newly-active connection. Enabling Fast MAC Cache Failover causes Virtual Connect to transmit Ethernet packets on newly-active links, which enables the external Ethernet switches to identify the new connection (and update their MAC caches appropriately.
Operation Examples Display server profiles • Summary display >show profile • Detailed display >show profile * • Single profile display >show profile MyProfile Delete the domain configuration >delete domain Update interconnect module firmware >update firmware url=http://www.mywebserver.com/images/vc1.31.
Virtual Connect Manager not found at this IP address. If the user attempts to login to the alternate I/O bay, they might receive the error message during the attempted login: Unable to communicate with the Virtual Connect Manager. Please retry again later. The login should succeed after the Virtual Connect Manager has restarted on this alternate Virtual Connect Ethernet module. Allow up to 5 minutes, depending on the enclosure configuration.
Technical support Before you contact HP Be sure to have the following information available before you call HP: • Technical support registration number (if applicable) • Product serial number • Product model name and number • Product identification number • Applicable error messages • Add-on boards or hardware • Third-party hardware or software • Operating system type and revision level HP contact information For the name of the nearest HP authorized reseller: • See the Contact HP worldwi
Acronyms and abbreviations BIOS Basic Input/Output System CLI Command Line Interface DHCP Dynamic Host Configuration Protocol DNS domain name system EFI extensible firmware interface FC Fibre Channel HBA host bus adapter I/O input/output IGMP Internet Group Management Protocol IP Internet Protocol iSCSI Internet Small Computer System Interface LDAP Lightweight Directory Access Protocol Acronyms and abbreviations 87
LUN logical unit number MAC Media Access Control PXE Preboot Execution Environment SAN storage area network SNMP Simple Network Management Protocol SOAP Simple Object Access Protocol SSH Secure Shell SSL Secure Sockets Layer TCP Transmission Control Protocol UDP User Datagram Protocol UUID universally unique identifier VCM Virtual Connect Manager WWN World Wide Name WWPN worldwide port name Acronyms and abbreviations 88
Index A all 13 authorized reseller 86 B basic configuration 73 C CLI command execution modes 9 command batching 7 command line overview 6 command line syntax 6 common management operations 83 configuring LDAP 76 configuring the Virtual Connect domain 73 configuring, user accounts 74 connection mode 38 D devicebay command 14 domain command 14 domain name 74 domain setup 74 E enclosure command 17 e-net networks, displaying 78 enet-connection command 18 enet-network connections, adding to a profile 82 enet
P parameters 6 port monitor 42 private networks 38 profile command 44 properties 7 R remote access 10 resetting Virtual Connect Manager 84 uplinkport command 60 uplinkset command 62 user command 64 user profile 66 V vcm command 67 version command 67 VLAN tunneling, enable or disable 38 S scriptable output format 71 server command 47 server identification 49 server profile, assigning to a device bay 82 server-port 50 server-port-map command 51 setting the domain name 74 shared uplink port set, creating 7
