HP Virtual Connect Manager Command Line Interface for c-Class BladeSystem Version 3.
© Copyright 2010 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 What's New ................................................................................................................................................ 5 Virtual Connect overview .............................................................................................................................. 5 Using multiple enclosures ...................
ssl-certificate .................................................................................................................................... 61 ssl-csr .............................................................................................................................................. 62 stackinglink ..................................................................................................................................... 63 statistics .............................................
Introduction What's New This version of the command line interface user guide contains the following changes: • Support for the HP Integrity BL8x0c i2 Series Servers This server is a multi-blade server, which has one bay identified as the monarch bay. All operations on the multi-blade server are done on the monarch bay, although the operation, such as power on or assigning a profile, affects the entire multi-blade server. • Removed the update firmware command.
The Virtual Connect Ethernet modules can also be connected to other devices, such as printers, laptops, rack servers, and storage devices. To connect to devices other than switches, create a VC network for that device and only connect uplinks for that network to that device. If you connect uplinks from that network to other devices, one of the uplinks becomes standby due to the loop avoidance algorithm.
• When no browser is available or you prefer to use a command line interface, you can access management data and perform configuration tasks. Command line syntax CLI input is case-insensitive except when otherwise noted.
Options are distinguished from other command line elements by using a hyphen (-) in front of the option. 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: -
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. In previous firmware versions, all commands that were provided as input to the CLI through scripts could only be valid commands.
# 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 bays, the unassign profile command could be used at the command line.
login as: michael password: *********** -------------------------------------------------------------------HP Virtual Connect Management CLI v3.00 (C) Copyright 2006-2007 Hewlett-Packard Development Company, L.P.
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. The examples below illustrate some common usage scenarios for output filtering.
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 31) Manage interconnect module firmware igmp (on page 32) Manage Ethernet IGMP Snooping settings interconnect (on page 32) Manage I/O interconnect modules ldap (on page 33) Manage LDAP configuration settings ldap-certificate (on page 35) Manage LDAP certificate information ldap-group (on page 36) Manage LDAP group configuration settings log-target (on page 37) Manage remote log destination settings mac-cache (on page 40) Manage Ethernet MAC cach
all Manage all Virtual Connect domain elements. Supported actions: help, show Item Description show all Display all Virtual Connect domain configuration objects. This command is typically useful for displaying a snapshot of the entire domain configuration with a single command.
Item Description Displays detailed information for a multi-blade server in device bays 5-8 of the primary enclosure. domain Manage general Virtual Connect domain settings and information. Supported actions: delete, help, set, show Item Description delete domain Delete the existing Virtual Connect domain configuration. Deleting the domain removes the entire Virtual Connect domain configuration and resets it to the original defaults.
Item Description and 9. Example: 192.168.0.10 SubnetMask (Required if IP address specified) 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. Example: 255.255.255.0 Gateway (Required if IP address specified) 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. Example: 192.168.0.
Item Description ->set domain MacType=User-Defined MacStart=00-17-A4-7700-00 MacEnd=00-17-A4-77-00-FF Sets the MAC address source to a custom, user-defined address range ->set domain WwnType=VC-Defined WwnPool=5 Sets the WWN address source to VC-Defined with a pre-defined range ->set domain WwnType=Factory-Default Sets the WWN address source to use factory default WWN addresses ->set domain WwnType=User-Defined WwnStart=50:06:0B:00:00:C2:62:00 WwnEnd=50:06:0B:00:00:C2:62:FF Sets the WWN address source t
Item Description UserName (Required for enclosures that are not imported) A valid user name of the Onboard Administrator user for the enclosure to be imported. Password (Required) A valid OA user password for importing the enclosure. If no password is given at the command line, the system interactively prompts the user for a password during the import operation.
Item Description EnclosureID (optional) The ID of an enclosure in the domain. If specified, then only details for the specified enclosure appear. Examples ->show enclosure Displays a summary listing of all enclosures ->show enclosure * Displays detailed information for all enclosures ->show enclosure enc0 Displays detailed information for a specific enclosure enet-connection Manage Ethernet network connections.
Item Description "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", the user can configure any speed from 100Mb to MAX configured speed for the network in 100Mb increments.
Item Description ->remove enet-connection MyProfile Removes an Ethernet network connection from a profile. Item Description set enet-connection Modify an Ethernet connection of a server profile.
Item Description ->set enet-connection MyProfile 1 SpeedType=Custom Speed=2000 Modifies the Ethernet network connection to set the speed to 2Gb Item Description show enet-connection Display the ethernet connections associated with the server profiles. Syntax show enet-connection [] Parameter ConnectionID (optional) The ID of an existing Ethernet connection. The ID format is . can be used to display all profile Ethernet connections.
Item Description 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 the user to select any VC Ethernet network for the server Ethernet connections, and VLAN ID mappings can be modified to ensure uniqueness. SharedServerVLanId can be "true" only if VLanTagControl is set to "Map".
Item Description address>] [MacEnd=] [WwnType=] [WwnStart=] [WwnEnd=] [ServerIdType=] [ServerIdStart=] [ServerIdEnd=] Option quiet This option suppresses user confirmation prompts and is useful when scripting operations.
Item Description Removes the external manager and releases the profile control Item Description set externalmanager Enable or disable an existing external manager’s control of the Virtual Connect domain. Syntax set external-manager [-quiet] UserName= Enabled= Option quiet This option suppresses user confirmation prompts and is useful when scripting operations. Properties UserName (required) Enabled (required) A valid external manager user name.
Item Description specified in the format ",,...", where port is the interconnect module port number to be added to the fabric (affects all modules within a bay group). Example: "1, 2, 3, 4". For HP VC FlexFabric 10Gb/24-Port Modules, port numbers 1, 2, 3, and 4 correspond to ports X1, X2, X3, and X4, respectively. Speed (optional) The port speed for the uplink ports in the fabric. Valid values include "Auto", "2Gb", "4Gb', and "8Gb". The default port speed is "Auto".
Item Description Parameter Name (required) A unique name for the fabric Option LoadBalance Performs load balancing on a fabric configured for manual login re-distribution Properties Name (optional) The new name of the fabric Speed (optional) The port speed for the uplink ports in the fabric Valid values include “Auto”, “2Gb”, "4Gb", and “8Gb”. The default port speed is “Auto”.
Item Description Displays detailed information for all FC SAN fabrics ->show fabric SAN_5 Displays detailed information for a specific FC SAN fabric fc-connection Manage Fibre Channel SAN connections. Supported actions: add, help, remove, set, show Item Description add fc-connection Add a new FC SAN connection to an existing server profile.
Item Description ->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 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 Remove the last FC connection from an e
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 to 255 or 16 hex digits (HP-UX only).
Examples ->show firmware Displays a summary listing of all firmware ->show firmware * Displays a detailed listing of all firmware 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 Manage Ethernet IGMP Snooping settings.
Item Description Syntax remove interconnect Parameter ModuleID(required) The ID of the module to remove. The ID format is :. To display a list of the IDs corresponding to modules in the domain, use the show interconnect command.
Item Description set ldap Modify and test the Virtual Connect LDAP directory server authentication settings.
Item Description ->show ldap Displays LDAP information ldap-certificate View and upload LDAP certificates from a remote FTP server. Supported actions: help, load, remove, show Item Description load ldapcertificate Download an LDAP Certificate from a remote FTP server and apply it to the VC domain.
Item Description not specified, then displays summary output of all the LDAP certificates. Examples ->show ldap-certificate Displays LDAP certificate details ->show ldap-cerificate * Displays detailed information for all LDAP certificates ->show ldap-certificate B4:02:C0:29:B5:E5:B4:81 Displays detailed information for a specific LDAP certificate ldap-group Manage Virtual Connect directory groups.
Item Description set ldap-group Modify the properties of an existing directory group. Syntax set ldap-group [Description=] [Privileges=] Parameter GroupName (required) The name of an existing group to modify Properties Description (optional) Privileges (optional) A user-friendly description for the group A set of one or more privileges for the group. Valid values include any combination of "domain", "server", "network", and "storage".
Item Description Properties Destination (required) The IpAddress or the DNS of the remote log destination that has been configured. 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".
Item Description modified Properties Destination (optional) The IpAddress or the DNS of the remote log destination that has been configured 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".
Item Description Example ->test log-target Sends a test message all log-targets mac-cache Manage Ethernet MAC Cache failover settings. Supported actions: help, set, show 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).
Item Description [ConnectionMode=] [VLanTunnel=] [PrefSpeedType=] [PrefSpeed=<100Mb–10Gb in 100Mb increments] [MaxSpeedType=] [MaxSpeed=<100Mb–10Gb in 100Mb increments>] Parameter NetworkName (required) The unique name of the new network to create Option Quiet Suppresses user confirmation prompts during network creation and modification. This option is used mainly in automated scripting scenarios.
Item Description ->add network Network1 Private=Enabled Configures a private network when adding a new network ->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 Pref
Item Description SmartLink (optional) Enables or disables the SmartLink capability for a port. Valid values include "Enabled" and "Disabled". SmartLink cannot be modified unless one or more ports are added to the network. 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 applied to a shared network.
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 Duplex (optional) The duplex mode of the network analyzer port. Valid values include "Auto", "Half", and "Full". The default value is "Auto". 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.
Item Description configured properly before port monitoring can be enabled. AnalyzerPort (optional) The uplink port used for monitoring network traffic. The format of the network analyzer port is ::. If the enclosure ID is not specified, the default enclosure is the local enclosure. Speed (optional) The port speed for the network analyzer port. Valid values include "Auto", "10Mb", "100Mb", "1Gb", "10Gb", and "Disabled". The default value is "Auto".
Item Description Syntax add profile [-NoDefaultEnetConn] [NoDefaultFcConn] [-NoDefaultFcoeConn] [SNType=] [SerialNumber=] [UUID=] assigned to a device bay using the "assign" subcommand. Parameter ProfileName The unique name of the new server profile to create Options NoDefaultEnetConn Do not add default Ethernet Network connections when creating the server profile.
Item Description ->add profile MyNewProfile SNType=User-Defined SerialNumber=VCX0113121 UUID=15713c60-fcf2-11dc-a6560002a5d5c51b Creates a new profile and specifies a custom virtual serial number and UUID Item Description assign profile Assign a server profile to a device bay.
Item Description Name (required) The new name of the server profile EFIState (required) Specifies the presence or absence of EFI state information Examples ->set profile MyProfile Name=MyNewProfileName Changes the name of a server profile ->set profile Profile1 EFIState=absent Removes EFI partition block information from a profile Item Description show profile Display all server profiles that exist in the domain and a summary of the associated Ethernet, iSCSI, FC, and FCoE connections.
Item Description Syntax poweroff server [-Force | -ForceOnTimeout] [-timeout=] Parameter ServerID (required) The reference ID of a physical server in the domain. The format of the server ID is . If the Enclosure ID is not provided, then the primary or local enclosure is used by default. "*" powers off all servers in the domain. For a multi-blade server, the ServerID must be that of the monarch bay. This is the ID displayed by the show server command.
Item Description Timeout The timeout period (in seconds) to wait for the operation to complete. The default timeout is 60 seconds.
Item Description ->reboot server enc0:1 Reboots a specific multi-blade server that occupies bayes 1-4 of the primary enclosure Item Description show server Display all servers in the domain. Syntax show server Parameter ServerID (optional) The reference ID of a server in the domain. The format of the server ID is . If the EnclosureID is not provided, then the primary or local enclosure is used by default.
Item Description Type (required) 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-Defined" (default), "VC-Defined", and "UserDefined". PoolID (optional) The VC-Defined Pool ID to be used. If not specified, the default Pool ID is 1. This property is only valid for VC-Defined-serial number types.
Item Description ->show server-port Displays a summary listing of all physical server ports ->show server-port * Displays detailed information for all physical server ports ->show server-port enc0:3:d2 Displays detailed information for a specific server port server-port-map Manage shared server downlink port mapping configuration Supported actions: add, help, remove, set, show Item Description add server-portmap Add a new server port network mapping, and allow server ports to be shared among multipl
Item Description Uplinkset=MyUplinkset1 UnTagged=true Adds a new server port to shared network and label it as untagged Item Description remove serverport-map Remove a server port network mapping. This command cannot be used if the domain setting VLanTagControl is set to "Tunnel". Syntax remove server-port-map [] Parameters ConnectionID (required) The reference ID of an existing enet-connection associated with a profile and a server port.
Item Description Modifies the VLAN ID of an existing server port network mapping ->set server-port-map MyProfile:1 Network1 Untagged=true Modifies the existing server port network mapping to handle untagged packets Item Description show server-portmap Display a server port network mapping. This command cannot be used if the domain setting, VLanTagControl, is set to "Tunnel".
Item Description Examples ->set snmp enet ReadCommunity=mydatacenter1 SystemContact=admin@datacenter1.com Enabled=true Enables the SNMP agent for VC-Enet modules and supplies a community string ->set snmp fc ReadCommunity=mydatacenter SystemContact=FcAdmin Enabled=true Enables the SNMP agent for VC-FC modules Item Description show snmp Display the SNMP configuration settings for the VC domain. Syntax show snmp [Type] Parameter Type (optional) Indicates the type of SNMP configuration to display.
Item Description For VC-FC modules, the maximum string length is 24. Format Format of the new trap. Valid values are "SNMPv1" and "SNMPv2". The default is "SNMPv1" if not specified. Severities Trap severities to send to the destination. Valid values are "Normal", "Unknown", "Info", "Warning", "Minor", "Major", "Critical", "All", and "None". Multiple severities can be provided, separated by commas. The default severity is "None".
Item Description set snmp-trap Modifies an existing SNMP trap destination Syntax set snmp-trap [Name=][Address=][Community=][Format=][Severity=][DomainCategory=][EnetCategory=][FcCategory=] Parameter TrapName (required) The name of the trap to be modified Properties Name New name of
Item Description Name (optional) The name of the trap configuration to be displayed. If no trap name is specified, or "*" is entered, then all configured traps are displayed. Examples ->show snmp-trap MyTrap1 Displays the SNMP trap configuration for a single trap ->show snmp-trap * Displays all configured SNMP traps Item Description ->test snmp-trap Generates an SNMP test trap and sends it to all configured destinations.
Item Description Example ->remove ssh Removes SSH keys Item Description show ssh Display the SSH key configuration. Syntax show ssh Example ->show ssh Displays the SSH key configuration ssl Allow or disallow weak SSL encryption (browser/SOAP). Supported actions: set, show, help Item Description set ssl Allow modifications to be made to the SSL configuration, and enable or disable string encryption for SSL communication with the web server.
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 address=ftp://user:password@192.168.10.12 Generates and transfers an SSL CSR to the remote FTP server ->save ssl-csr address=ftp://user:password@192.168.10.12 filename=new-ssl.csr Generates and transfers an SSL CSR and save with a new filename stackinglink Display stacking link information and status. Supported actions: help, show Item Description show stackinglink Display stacking links and their status.
Item Description Examples ->show statistics enc0:5:X1 Displays statistics for uplink port X1 on interconnect module 3 of the primary enclosure. ->show statistics enc0:1:d3 Displays statistics for downlink port d3 on Ethernet interconnect module 1 of the primary enclosure. 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.
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 port speed is "Auto". If there is no connector present on the uplink port, only "Auto" and "Disabled" can be configured as a possible speed. Speed restrictions apply. 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 :: Properties Network (required) The name of the network to which the port belongs if the uplink set name is not specified. UplinkSet (required) The name of the shared uplink port set to which the port belongs if the network name is not specified. Speed (optional) Specifies the port speed for the port. Acceptable values include "Auto", "10Mb", "100Mb", "1Gb", "10Gb", and "Disabled".
Item Description ->show uplinkport ID=enc0:1 Displays all the uplink ports for the specific bay (for example, for bay 1) ->show uplinkport status=Linked Displays all the uplink ports that are linked ->show uplinkport ID=enc0:1 type=RJ45 Displays all the uplink ports for the specific bay 1 with connector type RJ-45 uplinkset Manage shared uplink port sets Supported actions: add, help, remove, set, show Item Description add uplinkset Create a new shared uplink port set.
Item Description UplinkSetName (required) The name of an existing shared uplink set to modify Properties Name (optional) The new name of the shared uplink set 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 Password (required) The password of the new user. The password of the new user can be entered as clear text in the command or as a masked string at the prompt. FullName (optional) The full name of the user ContactInfo (optional) Contact information for the user Enabled (optional) Enables or disables the user. Valid values include "true" and "false". If not specified, then the new user is enabled by default. Privileges (optional) The allowed privileges for the user.
Item Description FullName (optional) The full name of the user ContactInfo (optional) Contact information for the user Enabled (optional) Enables or disables the user. Valid values include "true" and "false". Privileges (optional) The allowed privileges for the user. Privileges can be any combination of "domain", "server", "network", "storage" separated by commas. If the privilege is blank, then the user has no privileges and can display domain information only.
Item Description StrongPasswords (optional) Enables or disables strong password enforcement. If enabled, then new, local users that are created are validated against the password characteristics specified. Valid values include: "Enabled" and "Disabled". MinPasswordLength (optional) The minimum password length allowed for new passwords when adding a new user and when changing an existing password. The default value is 3.
version Display CLI version information. Supported actions: help, show Item Description show version Display CLI version information. Syntax show version Example ->show version Displays CLI version and copyright information Help subsystem The help subsystem consists of three options: • • 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 . . .
This command displays all device bays in the domain Syntax: show devicebay [ | *] Parameters: DeviceBayName : The reference name of a device bay in the domain.
Administrator domain Steve Johnson steve.johnson@hp.com true server network storage ---------------------------------------------------------------------------Admin domain Admin Admin true server network storage ---------------------------------------------------------------------------steve domain Steve Johnson steve.johnson@hp.com true server network storage ---------------------------------------------------------------------------brad domain Brad Mills brad.mills@hp.
UserName Privileges FullName ContactInfo Enabled : : : : : steve domain,server,network,storage Steve Johnson steve.johnson@hp.com true UserName Privileges FullName ContactInfo Enabled : : : : : brad domain,server Brad Mills brad.mills@hp.com true UserName Privileges FullName ContactInfo Enabled : : : : : jim network Jimmy Joe jimmy.joe@hp.com true UserName Privileges FullName ContactInfo Enabled : : : : : alice storage Alice Candle alice.candle@hp.
The following examples provide some common scenarios for using the script output format options.
Statistics descriptions Ethernet modules Ethernet uplink and downlink ports Name RFC Description rfc1213_IfInDiscards 1213 The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space.
Name RFC Description be transmitted to a subnetworkunicast address, including those that were discarded or not sent. rfc1213_IfOutOctets 1213 The total number of octets transmitted out of the interface, including framing characters. rfc1213_IfOutQLen 1213 The length of the output packet queue (in packets). rfc1213_IfOutUcastPkts 1213 The total number of packets that higher-level protocols requested be transmitted to a subnetworkunicast address, including those that were discarded or not sent.
Name RFC ExceededDiscards Description by this port due to an excessive size. It is incremented by both transparent and source route bridges. rfc1213_Dot1dPortInDiscard s 1493 Count of valid frames received which were discarded (i.e., filtered) by the Forwarding Process. rfc1213_Dot1dTpPortInFram es 1493 The number of frames that have been received by his port from its segment.
Name RFC Description Probe location plays a much smaller role when considering 10BASE-T. 14.2.1.4 (10BASE-T) of IEEE standard 802.3 defines a collision as the simultaneous presence of signals on the DO and RD circuits (transmitting and receiving at the same time). A 10BASE-T station can only detect collisions when it is transmitting. Thus probes placed on a station and a repeater, should report the same number of collisions.
Name RFC Description integral number of octets (Alignment Error). Note that this definition of jabber is different than the definition in IEEE-802.3 section 8.2.1.5 (10BASE5) and section 10.3.1.4 (10BASE2). These documents define jabber as the condition where any packet exceeds 20 ms. The allowed range to detect jabber is between 20 ms and 150 ms. rfc1757_StatsMulticastPkts 1757 The total number of good packets received that were directed to a multicast address.
Name RFC Description rfc1757_StatsPkts1024to15 18Octets 1757 The total number of packets (including bad packets) received that were between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS octets). rfc1757_StatsPkts128to255 Octets 1757 The total number of packets (including bad packets) received that were between 128 and 255 octets in length inclusive (excluding framing bits but including FCS octets).
Name RFC Description initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime. rfc2233_IfHCInMulticastPkts 2233 The number of packets, delivered by this sub-layer to a higher (sub)layer, which were addressed to a multicast address at this sub-layer. For a MAC layer protocol, this includes both Group and Functional addresses. This object is a 64-bit version of ifInMulticastPkts.
Name RFC Description management system, and at other times as indicated by the value of ifCounterDiscontinuityTime. rfc2233_IfHCOutMulticastPk ts 2233 The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast address at this sub-layer, including those that were discarded or not sent. For a MAC layer protocol, this includes both Group and Functional addresses. This object is a 64-bit version of ifOutMulticastPkts.
Name RFC Description rfc2665_Dot3InPauseFrames 2665 A count of MAC Control frames received on this interface with an opcode indicating the PAUSE operation. This counter does not increment when the interface is operating in half-duplex mode. Discontinuities in the value of this counter can occur at reinitialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.
Name RFC Description by an instance of this object is incremented at most once per transmission attempt, even if the carrier sense condition fluctuates during a transmission attempt. This counter does not increment when the interface is operating in full-duplex mode. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.
Name RFC Description obtain are, according to the conventions of IEEE 802.3 Layer Management, counted exclusively according to the error status presented to the LLC. Note: Coding errors detected by the physical layer for speeds above 10 Mb/s will cause the frame to fail the FCS check. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.
Name RFC Description receive errors on a particular interface that are not otherwise counted. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime. rfc2665_Dot3StatsInternalM acTransmitErrors 2665 A count of frames for which transmission on a particular interface fails due to an internal MAC sublayer transmit error.
Name RFC Errors Description of times that the SQE TEST ERROR message is generated by the PLS sublayer for a particular interface. The SQE TEST ERROR is set in accordance with the rules for verification of the SQE detection mechanism in the PLS Carrier Sense Function as described in IEEE Std. 802.3, 1998 Edition, section 7.2.4.6. This counter does not increment on interfaces operating at speeds greater than 10 Mb/s, or on interfaces operating in full-duplex mode.
Name RFC Description occurrence of an event that causes the PHY to indicate 'Data reception error' or 'carrier extend error' on the GMII. For an interface operating in fullduplex mode at 1000 Mb/s, the number of times the receiving media is non-idle a carrier event) for a period of time equal to or greater than minFrameSize, and during which there was at least one occurrence of an event that causes the PHY to indicate 'Data reception error' on the GMII.
Name RFC Description of Class 2 frames transmitted out of this port. fcClass3Discards 4044 fcmPortClass3Discards - The number of Class 3 frames that were discarded upon reception at this port. fcClass3RxFrames 4044 fcmPortClass3RxFrames - The number of Class 3 frames received at this port. fcClass3TxFrames 4044 fcmPortClass3TxFrames - The number of Class 3 frames transmitted out of this port.
Name RFC Description Error Status Block (LESB). fcInvalidTxWords 4044 fcmPortInvalidTxWords - The number of invalid transmission words received at this port. This count is part of FC-PH's Link Error Status Block (LESB). fcLinkFailures 4044 fcmPortLinkFailures - The number of link failures. This count is part of FCPH's Link Error Status Block (LESB). fcLossOfSynchronization 4044 fcmPortLossofSynchs - The number of instances of synchronization loss detected at this port.
Name RFC Description fcTotalRxFrames N/A Total number of frames received. fcTotalTxBytes N/A Total number of bytes transmitted. fcTotalTxFrames N/A Total number of frames transmitted. fcTxByteRate N/A Average transmit byte rate (Byte/s) for sample period of once a second. fcTxFrameRate N/A Average transmit frame rate (frame/s) for sample period of once a second. fcTxLinkResets 4044 fcmPortTxLinkResets - The number of Link Reset (LR) Primitive Sequences transmitted.
Name RFC Description numFBSYFrames FCMGMT -MIB connUnitPortStatCountFBSYFrames Count of times that FBSY was returned to this port as a result of a frame that could not be delivered to the otherend of the link. This occurs if either the Fabric or the destination port is temporarily busy. Port can only occur on SOFc1 frames (the frames that establish a connection). This is the sum of all classes.
Name RFC Description PH 29.8). numLossOfSync FCMGMT -MIB connUnitPortStatCountLossofSynchroni zation - Count of instances of synchronization loss detected at port. This count is part of the Link Error Status Block (LESB). (FC-PH 29.8). Note numMcastFramesRx FCMGMT -MIB connUnitPortStatCountRxMulticastObje cts - Count of Multicast Frames or Packets received at this port.
Name RFC Description – (frames/sec) rxFrameRate N/A Receive instantaneous frame rate (frames/sec) samplingRate N/A This controls the rate of statistics sampling in switch ports. Polling must be frequent enough to avoid counter overflow for errors and tx/rx bytes sfpStatus N/A SFP status.
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.
• 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.
• 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 * • Display info on a single user >show user steve Up to 32 local user accounts can be created.
o Select the WWNs to be used by the domain o Set up the connections to the external FC Fabrics o Configure FC SNMP settings 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.
IMPORTANT: Configuring Virtual Connect to assign server blade MAC addresses requires careful planning to ensure that the configured range of MAC addresses is used once within the environment. Duplicate MAC addresses on an Ethernet network can result in a server network outage. Each server blade Ethernet NIC ships with a factory default MAC address. The MAC address is a 48-bit number that uniquely identifies the Ethernet interface to other devices on the network.
IMPORTANT: If you plan to use RDP for RedHat Linux installation and also plan to use Useror HP-defined MAC addresses, you must import the enclosure before running RDP. NOTE: After any server profiles are deployed using a selected MAC address range, that range cannot be changed until all server profiles are deleted.
Virtual Connect places no special restrictions on which VLAN identifiers can be used, so the VLAN IDs already used for the networks in the data center can be used on these shared uplinks. To configure a shared uplink set for VLAN tagging, obtain a list of the network names and their VLAN IDs. A shared uplink set enables multiple ports to be included to support port aggregation and link failover with a consistent set of VLAN tags.
avoid this scenario, the server connections can be forced to use the same VLAN mappings as the shared uplink sets. >set enet-vlan VLanTagControl=Map SharedServerVLanId=true When using mapped VLAN tags, the overall link speed can be controlled as follows: > set enet-vlan PrefSpeedType=Custom PrefSpeed=500 MaxSpeedType=Custom MaxSpeed=2500 Fibre Channel setup To configure external Fibre Channel connectivity for the HP BladeSystem c-Class enclosure, do the following: 1.
Displaying FC fabrics To display a list of all FC SAN fabrics, use the show fabric command: >show fabric Serial number (logical) settings Virtual Connect Manager can be configured to use logical serial numbers and logical UUIDs with a server profile regardless of the type of physical server. With these configuration values, software licensed with one or both of these values can be migrated to new hardware without re-licensing.
• 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). • Before creating the first server profile, select whether to use moveable, administered MAC addresses and WWNs or whether to use the local server blade factory default MAC addresses and WWNs.
for each Fibre Channel HBA port. After being defined, the server profile can be assigned to any server blade within the Virtual Connect domain. A Virtual Connect domain can have a maximum of 64 Virtual Connect server profiles. Virtual Connect provides the ability to configure PXE settings when using either VC-assigned or factory default MAC addresses. In addition, Use BIOS is an option for PXE, which maintains the current settings as configured by RBSU.
• If PXE, controller boot order, or SAN boot settings are made outside of Virtual Connect (using RBSU or other configuration tools), Virtual Connect will restore the settings defined by the server profile after the server blade completes the next boot cycle. • To boot properly from SAN when using Linux and VMware ESX 3.0.1 and ESX 3.0.2, change the QLogic QMH2462 4Gb FC HBA connection option to 'point-to-point only' in the QLogic BIOS configuration utility.
>add server-port-map MyProfile:1 MyNetwork Uplinkset=MyUplinkset Adding FC fabric connections to a server profile To add a new FC SAN connection to an existing server profile, use the add fc-connection command: >add fc-connection MyProfile fabric=SAN_5 Configuring IGMP settings To set Ethernet IGMP snooping properties, use the set igmp command: > set igmp enabled=true timeout=30 IGMP allows VC-Enet modules to monitor (snoop) the IP multicast membership activities and to configure hardware Layer 2 switchin
Common management operations The following table provides the syntax for the most commonly used management operations. For detailed information on a particular command, see "Managed elements (on page 13).
>reset vcm >reset vcm [-failover] Administrator privileges are required for this operation. If VC Ethernet Modules are configured for redundancy using a primary and secondary Ethernet module, the user can use this feature to manually change which Virtual Connect Ethernet Module hosts the Virtual Connect Manager. The feature can also force the Virtual Connect manager to restart without switching to the alternate Virtual Connect Ethernet module.
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 CRC cyclic redundant checks DHCP Dynamic Host Configuration Protocol DNS domain name system EFI extensible firmware interface FC Fibre Channel HBA host bus adapter IGMP Internet Group Management Protocol iSCSI Internet Small Computer System Interface LDAP Lightweight Directory Access Protocol LESB Link Error Status Block LUN logical unit number MAC Media Access Control Acronyms and abbreviations 114
PXE Preboot Execution Environment SAN storage area network SOAP Simple Object Access Protocol SSH Secure Shell SSL Secure Sockets Layer UDP User Datagram Protocol UUID universally unique identifier VCM Virtual Connect Manager WWN World Wide Name WWPN worldwide port name Acronyms and abbreviations 115
Index A all 15 authorized reseller 113 B basic configuration 98 C CLI command execution modes 10 command batching 8 Command line 13 command line overview 6 command line syntax 7, 8, 9, 10 Command output filtering 12 common management operations 111 configuring LDAP 101 configuring the Virtual Connect domain 98 configuring, user accounts 99 connection mode 40 D devicebay command 15 domain command 16 domain name 99 domain setup 99 E enclosure command 18 e-net networks, displaying 103 enet-connection comma
P T parameters 7 port monitor 44 private networks 40 profile command 46 properties 8 technical support 113 R remote access 11 resetting Virtual Connect Manager 111 S scriptable output format 76 serial number (logical) settings 106 server command 49 server identification 52 server profile overview 107 server profile setup 106 server profile, assigning to a device bay 110 server VLAN tagging support 104 server-port 53, 54 setting the domain name 99 shared uplink port set, creating 103 shared uplink port
