HP Virtual Connect Enterprise Manager 7.2 Command Line Interface User Guide Abstract This user guide is intended for HP Virtual Connect administrators who are familiar with both Virtual Connect and the Virtual Connect management suite, including HP Virtual Connect Manager, Virtual Connect Enterprise Manager and upper level managers such as HP Matrix OE logical server management and HP Matrix Operating Environment.
© Copyright 2011, 2013 Hewlett-Packard Development Company, L.P. 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. The information contained herein is subject to change without notice.
Contents 1 Getting started...........................................................................................6 VCEMCLI prerequisites..............................................................................................................6 Installing the VCEMCLI..............................................................................................................6 Removing the VCEMCLI..........................................................................................................
add fcoe-connection...............................................................................................................43 set fcoe-connection.................................................................................................................46 remove fcoe-connection...........................................................................................................49 add iscsi-connection............................................................................................
Warranty information.......................................................................................................109 HP authorized resellers.....................................................................................................109 Related information...............................................................................................................109 Documents..................................................................................................................
1 Getting started The HP Virtual Connect Enterprise Manager (VCEM) Command Line is a family of executables that provide the facilities necessary for the most frequently used management operations for the VCEM infrastructure. The VCEM Command Line Interface (VCEMCLI) can be used as an alternative method for managing common Virtual Connect operations. The VCEM.CMD executable provides failover management. VCEMCLI.EXE is useful when scripting bulk operations on multiple Virtual Connect (VC) server profiles.
• Run scripts in response to HP Systems Insight Manager events or from the Windows job scheduler. • Leverage the comma-separated values (CSV) export of profile data to answer questions such as: ◦ Where is this MAC address or WWN used? ◦ Which profiles use this network? ◦ Which profiles use this fabric? ◦ What is different between these profiles? Leveraging the VCEM web user interface The VCEMCLI is designed to be used in addition to the VCEM web user interface.
Security on the CMS The VCEMCLI is installed on the CMS. By installing on the CMS, you get the benefits of the security measures already in place for the CMS. The trade-off is that the script execution imposes additional load on the CMS. HP recommends that you evaluate the amount of load that the script places on the CMS, and either program in pauses or reduce the amount of work that each invocation of the script accomplishes.
2 Using the VCEMCLI The VCEMCLI can be executed from the Windows command-line or from scripts written in any Windows-supported scripting language. Executable The vcemcli.exe executable is located in the HP VCEM Installation Root Directory\Virtual Connect Enterprise Manager CLI directory. During the VCEM installation process, the directory that contains vcemcli.exe is added to the %PATH% environment variable (EV).
Table 1 Common options (continued) CLI options Description NOTE: When you are using this option, sequential edits queued for the same profile might conflict with the changes being applied. HP recommends that you use blocking operations when you are performing multiple changes to a given profile. This approach ensures that the changes for each edit are applied to the profile before the next group of changes are initiated. Do not submit multiple non-blocked commands for a single profile.
echo Add network connection complete - Update network connections -------------------------for /L %%I in (1,1,%MAXPROFILES%) DO ( echo Assigning enet connection %NEWNET% to port 3 of PROFILE-%%I %CLI% -set enet-connection -profilename PROFILE-%%I -network %NEWNET% -portnumber 3 if ERRORLEVEL 1 goto ERRORHANDLER ) echo Assign the profiles to bays that have servers present --------------------------------for /L %%I in (1,1,%MAXPROFILES%) DO ( ::Turn off the server in the target bay ONLY if a server is present
Session lifetime VCEMCLI logon sessions remain active for a single command execution. The CLI automatically logs out of the VCEM server after the execution finishes, whether the command succeeded or failed. Role-based access control (RBAC) You can use RBAC to designate which operations and resources can be manipulated. RBAC Details VCEM provides the following role-based user types.
Table 2 RBAC privileges (continued) VCEM Domain Group Limited Operator VCEM Administrator VCEM Domain Group Administrator VCEM Domain Group Operator -add fc-connection, see “add fc-connection” (page 38) x x x -set fc-connection, see “set fc-connection” (page 40) x x x -remove fc-connection, see “remove fc-connection” (page 42) x x x -add fcoe-connection, see “add x fcoe-connection” (page 43) x x -set fcoe-connection, see “set x fcoe-connection” (page 46) x x -remove fcoe-connection, se
Table 2 RBAC privileges (continued) VCEM Domain Group Administrator VCEM Domain Group Operator VCEM Domain Group Limited Operator VCEM User (Read Only) -show version, see “show version” x (page 75) x x x x -show vcem-status, see “show vcem-status” (page 76) x x x x x -startvcdfwupdate, see “startvcdfwupdate” (page 77) x x -completevcdfwupdate, see “completevcdfwupdate” (page 78) x x -startvcdmaint, see “startvcdmaint” (page 79) x x -cancelvcdmaint, see “cancelvcdmaint” (page 80) x
Working with server profiles The VCEMCLI provides the most commonly used server profile operations, including: • Server profile creation or update • Server profile assignment, unassignment, move or export to CSV For more information on server profiles and the available server profile operations, see the HP Virtual Connect Enterprise Manager User Guide available at: http://www.hp.com/go/vcem/.
NOTE: The minimum number of network connections is two. You cannot remove these two default connections. You cannot add more than the maximum allowed network connections. The maximum allowed network connections is based on the VC firmware mode. For more information see the HP Virtual Connect Enterprise Manager User Guide available at: http:// www.hp.com/go/vcem/.
well as between domain groups. Moving server profiles between domain groups offers new options when upgrading hardware or firmware. As part of the move process, the source and destination domain groups are checked for compatibility of network and storage connections. Warnings or errors are reported, based on the severity of any mismatches that are detected. The VCEMCLI move command can be executed from a script triggered from Systems Insight Manager in response to designated events.
Displaying job details The –show job -jobid command displays details for the specified VCEM job. The command returns a value that corresponds to the current state of the job. The job state return codes are: • COMPLETED (0)—The job is complete. • PENDING (10)—The job is waiting to run. • RUNNING (11)—The job is still running. • WARNING (12)—The job succeeded with minor errors. • FAILED (13)—The job failed. Sample job details: Y:\>vcemcli -show job -jobid 10 Listing details for specified VCEM job...
Accessing the VCEMCLI help Obtain help by running the VCEMCLI without any arguments.
-targetport2 -tobayname -tovcdg -toenclosurename -untagged -uplinkset -username -validate -vcdomaingroup -vlanid -vlanids -wwntypeoverride : : : : : : : : : : : : The TCP port associated with the alternate target IP address. The name or number of the bay in the target enclosure The target Virtual Connect domain group name The target Virtual Connect enclosure name Controls whether the network handles untagged packets The name of the shared uplinkset Username for CHAP and CHAPM authentication.
3 Using VCEM commands This chapter describes VCEMCLI commands. add profile The -add profile command creates a profile from the supplied description of a server profile.
Minimum required role-based security VCEM Group Administrator Remarks This command creates a new unassigned server profile. VCEM fills empty attributes with a default value. VCEM generates a profile based on the value settings associated with the -vcDomainGroup argument (it fills all the minimum required attributes to create a profile with default values), and it overwrites some of the default values with the values specified on the VCEMCLI command-line.
set profile The -set profile command modifies the properties on an existing server profile. Syntax -set profile -profilename [-name ] [-efistate absent] Parameters Table 4 Parameter descriptions for -set profile Parameter Description Required Optional -profilename Specifies the name of the profile you want to modify. x -name Specifies the new name of the server profile. x -efistate Specifies the presence of EFI state information.
assign profile The -assign profile command assigns the profile identified by the ProfileName to the bay specified by the BayName. Syntax -assign profile –ProfileName -enclosurename -bayname [-poweronbay] Parameters Table 5 Parameter descriptions for -assign profile Parameter Description Required -profilename Specifies the unique name of the server profile to be assigned. x -enclosurename Specifies the enclosure that contains the bay to assign the profile to.
Remarks You can obtain the job status of non-blocking operations by executing the VCEMCLI with the –show job command and providing the associated jobid. For more information, see “show job” (page 74). The system page in HP Systems Insight Manager provides the enclosure name, as shown circled in red in Figure 1 (page 25). Figure 1 Enclosure name The bay name is a string representation of the bay number. The first bay is “1”; the second bay is “2”.
export profiles The -export profiles command exports server profiles to a CSV file for use with external tools. Syntax -export profiles –exportfile Parameters Table 6 Parameter descriptions for -export profiles Parameter Description Required -exportfile Specifies the name of the file x to receive the exported profile data in CSV format Examples vcemcli -export profiles -exportfile MyProfiles.
move profile The -move profile command moves a server profile across VC domain groups.
When –validate is specified, the job is not triggered; only precondition validation is performed. The CLI will return the results of the validation.
remove profile The -remove profile command removes a server profile from VCEM. Syntax -remove profile —profilename Parameters Table 8 Parameter descriptions for -remove profile Parameter Description Required -profilename Specifies the name of the profile to be removed x Optional Output The function returns the results of the remove operation or a jobid if –nb is specified.
unassign profile The -unassign profile command unassigns the selected server profile. Syntax -unassign profile -profilename Parameters Table 9 Parameter descriptions for -unassign profile Parameter Description Required -profilename Specifies the name of a x server profile that is currently assigned to a device bay. Optional Output The function returns the result of the unassign operation or a jobid if –nb is specified.
add enet-connection The -add enet-connection command adds a new Ethernet network connection to an existing server profile in the VC domain. NOTE: The maximum number of Ethernet connections that can be added to a server profile depends on the Virtual Connect firmware version. For more information, see the HP Virtual Connect Enterprise Manager User Guide available at: http://www.hp.com/go/vcem/.
Table 10 Parameter descriptions for -add enet-connection (continued) Parameter Description -speedtype Specifies the requested operational speed for the server port. Valid values include auto, preferred, and custom. Default value is preferred. The following list describes the speed type: Required Optional x • auto—Allocates the maximum port speed, constrained by the maximum configured speed for the network.
• Add a new Ethernet network connection to a profile: vcemcli -add enet-connection –profilename MyNewProfile –network SomeNetwork • Add a new Ethernet network connection and enable PXE: vcemcli -add enet-connection –profilename MyNewProfile –network SomeNetwork2 –pxe enabled • Add a new Ethernet network connection and leave the network unassigned for now: vcemcli -add enet-connection –profilename MyNewProfile • Add a new Ethernet network connection and set the speed to preferred: vcemcli -add enet-co
set enet-connection The -set enet-connection command modifies an Ethernet connection of a server profile.
Table 11 Parameter descriptions for -set enet-connection (continued) Parameter Description -speedtype Specifies the requested operational speed for the server port. Valid values include auto, preferred, and custom. Default value is preferred. The following list describes the speed type: Required Optional x • auto—Allocates the maximum port speed, constrained by the maximum configured speed for the network.
• Change the associated network of an Ethernet connection: vcemcli -set enet-connection –profilename MyProfile2 -portnumber 1 –network NewNetworkName • Set an Ethernet network connection to unassigned: vcemcli -set enet-connection –profilename -RedProfile1 -portnumber 1 –network "" • Disable PXE on an Ethernet network connection: vcemcli -set enet-connection –profilename GreenProfile3 -portnumber 1 –pxe disabled • Modify an Ethernet network connection to set the speed to preferred: vcemcli -set enet-
remove enet-connection The -remove enet-connection command removes the last Ethernet network connection from an existing server profile. Syntax -remove enet-connection –profilename Parameters Table 12 Parameter descriptions for -remove enet-connection Parameter Description Required -profilename Specifies the name of the profile that is being disconnected from the Ethernet connection.
add fc-connection The -add fc-connection command adds a new FC connection to a server profile. Syntax -add fc-connection –profilename -connectionbay [-fabric ] [-speed ] Parameters Table 13 Parameter descriptions for -add fc-connection Parameter Description Required Optional -profilename Specifies the name of an existing profile to add the new connection to. x -connectionbay Specifies the bay for the connection.
Examples • Add a new FC SAN fabric connection to a profile: vcemcli -add fc-connection –profilename MyNewProfile –connectionbay 5 –fabric SAN_5 • Add a new FC SAN connection and configure the port speed: vcemcli -add fc-connection –profilename MyNewProfile –connectionbay 6 –fabric SomeFabric –speed 4Gb • Add a new FC SAN connection and use the next available fabric: vcemcli -add fc-connection –profilename MyNewProfile –connectionbay 5 Minimum required role-based security VCEM Group Operator Remarks Y
set fc-connection The -set fc-connection command modifies an existing FC connection to a server profile.
Table 14 Parameter descriptions for -set fc-connection (continued) Parameter Description Required -bootport Specifies the target World Wide Port Name (WWPN) of the controller interface on the Fibre Channel storage target. The port name is a 64-bit identifier in the following format: x Optional IMPORTANT: The -bootport parameter is required only when the -bootpriority parameter is set to either primary or secondary. NN:NN:NN:NN:NN:NN:NN:NN The designation N stands for a hexadecimal number.
remove fc-connection The -remove fc-connection command removes the last FC connection from a server profile. Syntax -remove fc-connection –profilename Parameters Table 15 Parameter descriptions for -remove fc-connection Parameter Description Required -profilename Specifies the name of an existing profile from which the last FC connection is removed. x Optional Output The function returns the result of the remove operation or a jobid if –nb is specified.
add fcoe-connection The -add fcoe-connection command adds a new FCoE connection to a server profile.
Table 16 Parameter descriptions for -add fcoe-connection (continued) Parameter Description -speedtype Specifies the port speed of the connection port. Valid values include auto, 1Gb, 2Gb, 4Gb, 8Gb, custom, disabled, and preferred. The default port speed is 4Gb. Required Optional x The –customspeed parameter is required if the speed type is custom and is the user-defined speed for the server port. Valid values include 100 Mb to 10 Gb configured in 100 Mb increments.
Minimum required role-based security VCEM Group Operator Remarks You can obtain the job status for the jobid by executing the VCEMCLI with the –show job command and providing the associated job ID. For more information, see “show job” (page 74). Creating FCoE connections requires a VC module that supports FCoE. For more information about hardware and firmware, see the HP Virtual Connect for c-Class BladeSystem User Guide.
set fcoe-connection The -set fcoe-connection command modifies an existing FCoE connection.
Table 17 Parameter descriptions for -set fcoe-connection (continued) Parameter Description Required Optional The default port speed is preferred. IMPORTANT: The speed type Auto does not apply to fabrics and 1 Gb to 8 Gb does not apply to FCoE networks. -customspeed -bootpriority Specifies the user-defined speed for the server port. Valid values include 100 Mb to 10 Gb configured in 100 Mb increments. The acceptable value is 100 Mb/s to 10,000 Mb/s.
Examples • Change the fabric of a FCoE SAN fabric connection: vcemcli -set fcoe-connection –profilename MyProfile –portnumber 1 –fabric SAN_5 • Set a FCoE SAN fabric connection to unassigned: vcemcli -set fcoe-connection –profilename RedProfile –portnumber 2 –fabric "" • Modify the FCoE connection and set the speed to 5 Gb: vcemcli -set fcoe-connection –profilename MyProfile –portnumber 1 –speedtype custom –customspeed 5000 • Change the SAN boot priority and set additional boot parameters: vcemcli -s
remove fcoe-connection The -remove fcoe-connection command removes the last FCoE connection from an existing server profile. Syntax -remove fcoe-connection –profilename Parameters Table 18 Parameter descriptions for -remove fcoe-connection Parameter Description Required -profilename Specifies the name of an x existing profile from which the last FCoE connection will be removed. Optional Output The function returns the result of the remove operation or a jobid if –nb is specified.
add iscsi-connection The -add iscsi-connection command adds a new iSCSI connection to an existing VC server profile. NOTE: The -add iscsi-connection command can be executed only if the current VC domain is managing one or more VC modules that support iSCSI connections.
Table 19 Parameter descriptions for -add iscsi-connection (continued) Parameter Description -speedtype Specifies the requested operational speed for the server port. Valid values include auto, preferred, and custom. Default value is preferred. The speed types are: Required Optional x • auto—Allocates the maximum port speed, constrained by the maximum configured speed for the network.
• Add a new iSCSI network connection and set the speed to preferred: vcemcli -add iscsi-connection –profilename MyProfile –network MyNetwork –speedtype preferred • Add a new iSCSI network connection and set the speed to 2 Gb: vcemcli -add iscsi-connection –profilename MyProfile –network MyNetwork –speedtype custom–speed 2000 Minimum required role-based security VCEM Group Operator Remarks You can obtain the job status for the jobid by executing the VCEMCLI with the –show job command and providing the a
set iscsi-connection The –set iscsi-connection command modifies the properties of a specified iSCSI connection. Syntax -set iscsi-connection –profilename -portnumber [-network ] [-speedtype ] [–speed ] Parameters Table 20 Parameter descriptions for –set iscsi-connection Parameter Description Required -profilename Specifies the profile for the iSCSI connection. x -portnumber Specifies the port number for x the iSCSI connection.
Table 20 Parameter descriptions for –set iscsi-connection (continued) Parameter Description -speedtype Specifies the requested operational speed for the server port. Valid values include auto, preferred, and custom. The default value is preferred. The speed types are: Required Optional x • auto—Allocates the maximum port speed, constrained by the maximum configured speed for the network.
• Set the speed to preferred: vcemcli -set iscsi-connection –profilename MyProfile –portnumber 1 –network MyNetwork –speedtype preferred • Modify the iSCSI connection and set the speed to 2 Gb: vcemcli -set iscsi-connection –profilename MyProfile –portnumber 1 –speedtype custom –speed 2000 Minimum required role-based security VCEM Group Operator Remarks You can obtain the job status for the jobid by executing the VCEMCLI with the –show job command and providing the associated job ID.
remove iscsi-connection The remove iscsi-connection command removes the highest-numbered iSCSI connection from the server VC profile. If no connections exist, an error message appears. Syntax -remove iscsi-connection –profilename Parameters Table 21 Parameter descriptions for –remove iscsi-connection Parameter Description Required -profilename The name of an existing profile to remove the connection from.
set iscsi-boot-param The -set iscsi-boot-param command configures the basic iSCSI boot parameters on the specified iSCSI connection.
Table 22 Parameter descriptions for -set iscsi-boot-param (continued) Parameter Description Required -initiatorname Specifies the name used for the iSCSI initiator on the booting system. The initiator name length can be a maximum of 223 characters. If the initiator name string contains non-alphanumeric characters, it should be enclosed in quotation marks. x Specifies the IP address that x the iSCSI initiator uses. This NOTE: The value is in dotted decimal -initiatorip parameter format.
Table 22 Parameter descriptions for -set iscsi-boot-param (continued) Parameter Description -targetport2 Specifies the TCP port x associated with the alternative target IP address. NOTE: The -targetport2 parameter The default value is 3260. is required if the -targetip2 parameter is specified. -authentication Specifies the authentication method. The initiator and target must agree on an authentication method or the iSCSI initiator cannot log on to the target.
Table 22 Parameter descriptions for -set iscsi-boot-param (continued) Parameter Description Required Optional selection for this attribute is disabled, which allows for static configuration. -networkparamdhcp Allows the iSCSI option ROM to retrieve the TCP/IP parameters from DHCP or through static configuration. Valid values are enabled and disabled. The default selection for this attribute is disabled, which allows for static configuration.
remove iscsi-boot-param The –remove iscsi-boot-param command removes all the iSCSI boot parameters configured on the specified iSCSI connection. Syntax -remove iscsi-boot-param –profilename -port Parameters Table 23 Parameter descriptions for –remove iscsi-boot-param Parameter Description Required -profilename Specifies the name of the x profile from which the boot parameter is to be removed. -port Specifies the port number x from which the boot parameter will be removed.
add server-port-map The -add server-port-map command adds a new server port network mapping, and it allows server ports to be shared among multiple VC Ethernet networks.
Output The function returns the result of the add operation or a jobid if –nb is specified.
set server-port-map The -set server-port-map command modifies the properties of a server port network mapping. Syntax -set server-port-map –profilename -portnumber -network [-vlanid ] [–untagged ] Parameters Table 25 Parameter descriptions for -set server-port-map Parameter Description Required Optional -profilename Specifies the name of an existing profile to associate with the server port map to be modified.
NOTE: When VCEM sets a VLAN ID in an untagged VLAN, it sets the VLAN ID to zero and does not return an error. This is because zero is the correct value to use for an untagged VLAN. Minimum required role-based security VCEM Group Operator Remarks You can obtain the job status for the jobid by executing the VCEMCLI with the –show job command and providing the associated job ID. For more information, see “show job” (page 74).
remove server-port-map The –remove server-port-map command removes a server port network mapping. NOTE: The –remove server-port-map command cannot be used if the domain setting vlantagcontrol is set to tunnel. This restriction is lifted for VC domain groups running VC 3.30 and later firmware mode.
add server-port-map-range The -add server-port-map-range command adds multiple network port mappings to a server profile. Syntax -add server-port-map—range –profilename -portnumber [-uplinkset ] [-vlanids ] [-matchUplinkSet] Parameters Table 27 Parameter descriptions for -add server-port-map-range Parameter Description Required -profilename Specifies the name of the x profile where the server port map will be added.
Table 27 Parameter descriptions for -add server-port-map-range (continued) Parameter Description Required Optional have the force same VLAN mapping attribute specified. Output The function returns the result of the add operation or a jobid if –nb is specified, or error code 265 if the profile is not found.
remove server-port-map-range The -remove server-port-map-range command removes multiple network port mappings from a server profile. Syntax -remove server-port-map—range –profilename -portnumber [-vlanids ] Parameters Table 28 Parameter descriptions for -remove server-port-map-range Parameter Description Required -profilename Specifies the name of the x profile where the server port map will be removed.
poweroff devicebay The -poweroff devicebay command sends a power-off request to Virtual Connect Manager for a given bay. Syntax -poweroff devicebay –enclosurename —bayname [-force|-forceontimeout] Parameters Table 29 Parameter descriptions for -poweroff devicebay Parameter Description Required -enclosurename Specifies the name of the enclosure that contains the bay to be powered off. x -bayname Specifies the name of the bay to be powered off.
• Conduct a normal power-off operation on device bay 2 of an enclosure that has the ID enc0. If the timeout occurs, the system is forced to power off.
poweron devicebay The -poweron devicebay command sends a power-on request to Virtual Connect Manager for a given bay. Syntax -poweron devicebay -enclosurename -bayname Parameters Table 30 Parameter descriptions for -poweron devicebay Parameter Description Required -enclosurename Specifies the name of the enclosure that contains the bay to be powered on. x -bayname Specifies the name of the bay to be powered on.
show power-status The -show power-status command displays the power status of the indicated bay. Syntax -show power-status -enclosurename -bayname Parameters Table 31 Parameter descriptions for -show power-status Parameter Description Required -enclosurename Specifies the name of an enclosure in the domain. x -bayname Specifies the name of the bay in the enclosure. x Optional NOTE: For a multiblade server, the bay name must be the name of the primary bay.
show job The -show job command reports the status of the indicated job. Syntax -show job –jobid Parameters Table 32 Parameter descriptions for -show job Parameter Description Required -jobid Specifies the ID of an existing job. x Output The -show job command displays the status of the indicated job. VCEM jobs can have the status values as listed in Table 33.
show version The -show version command displays version information for the VCEM server. Syntax -show version Parameters None Output The -show version command reports version information for the VCEM server.
show vcem-status The -show vcem-status command displays the VCEM management status for the specified VC domain. Syntax -show vcem-status -domainname Parameters Table 34 Parameter descriptions for -show vcem-status Parameter Description Required -domainname Specifies the name of domain for which VCEM status will be displayed. x Optional Output The -show vcem-status command displays the VCEM management status of the indicated domain. VCEM status codes are shown in Table 35 (page 76).
startvcdfwupdate The -startvcdfwupdate command starts VC firmware updates on VC 3.50 or later domains when used in combination with VCSU 1.7.0 or later. Syntax -startvcdfwupdate Parameters Table 36 Parameter descriptions for -startvcdfwupdate Parameter Description Required -startvcdfwupdate Specifies the name of the domain to be enabled for firmware update. x Optional Output This function returns the results of the start firmware update operation or a jobid, if –nb is specified.
completevcdfwupdate The -completevcdfwupdate command finishes a VC firmware update that was started using the startvcdfwupdate command on a VC 3.50 or later domain when used in combination with VCSU 1.7.0 or later. Syntax -completevcdfwupdate Parameters Table 37 Parameter descriptions for -completevcdfwupdate Parameter Description Required Optional -completevcdfwupdate Specifies the name of the x domain that was enabled for firmware update.
startvcdmaint The -startvcdmaint command starts the VC domain maintenance operation on the specified VC domain. For more information on the VCM operations that are allowed in VC domain maintenance mode, see the HP Virtual Connect Enterprise Manager User Guide available at: http://www.hp.com/go/vcem/.
cancelvcdmaint The -cancelvcdmaint command cancels the VC domain maintenance operation on the specified VC domain. Syntax -cancelvcdmaint Parameters Table 39 Parameter descriptions for -cancelvcdmaint Parameter Description Required -cancelvcdmaint Specifies the name of the x domain where maintenance mode will be canceled. Optional Output The -cancelvcdmaint command returns the result of the cancel VC domain maintenance operation, reporting success or indicating the reason for failure.
completevcdmaint The -completevcdmaint command completes the VC domain maintenance operation on the specified VC domain and propagates changes across all domain group members. Syntax -completevcdmaint [-restoreConfig] Parameters Table 40 Parameter descriptions for -completevcdmaint Parameter Description Required -completevcdmaint Specifies the name of the x domain where maintenance will be completed.
4 Error messages To help you troubleshoot symptoms, Table 41 (page 82), Table 42 (page 82) and Table 43 (page 85) list error message numbers and descriptions.
Table 42 VCEMCLI error messages and descriptions (continued) Error message number Error message description 21 Multiple subcommands found. 22 Missing subcommand. 23 Password argument not found. 24 Unsupported managed element for subcommand. 25 Subcommand not implemented. 27 Unsupported managed element for subcommand. 28 Corresponding value for argument was not found. 30 Corresponding value for argument was not found. 31 Invalid result from getArgPair. 32 Index out of range.
Table 42 VCEMCLI error messages and descriptions (continued) 84 Error message number Error message description 200 No help information available. 224 JOB_FAILED 225 Unable to get job. 226 VCEM job ID does not exist. 242 Operation timed out. 260 VC domain group does not exist. 261 Failed to assign profile to bay in enclosure. 262 Failed to unassign profile. 264 No managed element defined for the profile operation. 265 Server profile does not exist.
Table 42 VCEMCLI error messages and descriptions (continued) Error message number Error message description 380 VlanId range list is invalid because %s is smaller than Minimum of 1. 381 VlanId range list contains invalid format. 382 VlanId range list contains invalid character %s. VlanId range can only consist of numeric characters, hyphens (-), and comma (,). 383 VlanId range length too long, the maximum length is 9. 384 VlanId range starting value cannot be bigger than ending value.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. Guide to verify the VC firmware versions supported by each VC domain group firmware mode. 2041 The new VC Domain configuration is using uplink ports from a VC Ethernet module of an cabinet [x] that is not configured in all VC Domains from a VC domain group [x].
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2108 VCEM cannot perform the requested operation because the VC Domain [x] firmware version [x] is not supported. Verify that the VC Domain has a supported firmware version and perform the operation again.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. using the resources involved in this operation and then perform the operation again. 2170 The operation could not be completed because the VC Domain is under maintenance.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. - The VC Domain firmware version was downgraded to a version that does not support the VC Ethernet modules in the VC Domain. - The VC Domain has remote enclosure(s) with VC Ethernet modules disposition different than the primary enclosure VC Ethernet modules disposition.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. the Virtual Connect user guide for more information if there is a lost communication.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2552 Server profile name is duplicate. Another server profile with the same name already exists in VCEM. 2553 There are more than one network interfaces (NIC) configured with PXE enabled. Only one NIC in the profile can be PXE enabled. 2554 Cannot remove network connection.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number 92 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2604 The target server bay is already in use by another server profile. 2605 The target server bay does not exist or does not belong to the same VC domain group that the server profile belongs.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2619 Cannot perform server profile unassignment because the specified server profile is not currently assigned to a server bay. 2620 Cannot perform the {0} operation because the VC Domain maintenance is not completed. Perform these steps: 1.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number 94 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2638 Cannot move the server profile because the specified target Server Bay does not belong to the same VC domain group that the server profile belongs. 2639 The target server is powered up. The operation requires the server to be powered down.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2660 In the ethernet connection for port , the port speed is incorrect. Unassigned ethernet connections must have port speed set to Preferred. 2661 In the Ethernet connection for port , the port speed is incorrect. The minimum and maximum port speeds cannot be empty.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number 96 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2685 Cannot perform server profile assignment because the specified VC Domain was not licensed. Apply a license and then perform the operation again. 2709 The slot number associated with node is not valid for a server blade. Valid numbers are 1 - 16.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2735 Cannot create Server Profile because an address is already in use by Server Profile. To resolve this: 1. Access VCEM and delete the Server Profile with the address reported as in use, or choose another valid address. 2. Perform the Create Profile operation again.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number 98 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2748 There are more than one FCoE connection configured as secondary boot. Only one FCoE connection can be configured as secondary boot.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. xx-xx-xx-xx-xx-xx-xx-xx, or xxxxxxxxxxxxxxxx, where each x is a hexadecimal digit. 2763 In the FCoE connection for port number and interconnect bay , the specified boot target LUN is missing or invalid.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2783 There was a problem allocating the address because it is already in use by another connection port number in Server Profile. 2784 VCEM cannot add connection because a Virtual Connect interconnect module was added.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2812 VCEM cannot perform the operation because the database server is not responding. Possible causes are: - No connectivity with the database server (in case a remote database). - Too many database operations being performed at the same time.
Table 43 VCEM server error messages and descriptions (continued) Error message description Error message number NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 5068 Invalid FCoE connection connection bay. Verify that the VC Domain has an FCoE module on this connection bay. 5069 Invalid FCoE connection boot priority. 5070 Invalid profile FCoE connection speed type. 5071 Invalid FCoE connection port number.
5 Troubleshooting the VCEMCLI This section provides information on resolving VCEMCLI issues. VCEMCLI calls result in access denied errors To resolve access denied errors, verify that the credentials used with the VCEMCLI have the required RBAC privileges configured in the CMS for the operation and resource being modified.
Unable to assign a profile to a domain group If the profile is not the same configuration as the VC domain group, you might not be able to assign the profile to the VC domain group. To resolve this issue, verify that the profile meets the requirements for the intended VC domain group. For additional troubleshooting information, see the HP Virtual Connect Enterprise Manager User Guide available at: http://www.hp.com/go/vcem/ for additional troubleshooting information.
BladeSystem c-Class Virtual Connect Support Utility Version User Guide and the HP BladeSystem c-Class Virtual Connect Support Utility Version Release Notes. For more information about supported VC firmware, go to http://www.hp.com/go/vcem. Creating a server profile fails Attempting to create a profile can fail if any of the following situations occur: • VCEM does not have enough free MAC or WWN addresses • Some MAC or WWN addresses are already being used by another server profile.
As a result, VCEM APIs can report false job results such as, Completed with success, even though the server profile changes have not taken effect.
following error message appears whenever an -add profile or -set profile operation is performed and one or more server profiles is inside the VC domains that have a boot LUN that does not comply with the required conditions. An invalid boot LUN was entered. Check the storage arrays for the proper LUN number Correct the boot LUN value in the server profiles to resolve the issue. A valid value is either a 3-digit decimal between 0 and 255 or a 16-digit hexadecimal between 0 and FFFFFFFFFFFFFFFF.
6 Support and other resources Information to collect before contacting HP Be sure to have the following information available before you contact HP: • Software product name • Hardware product model number • Operating system type and version • Applicable error message • Third-party hardware or software • Technical support registration number (if applicable) How to contact HP Use the following methods to contact HP technical support: • In the United States, see the Customer Service / Contact HP U
an electronic license to use are eligible for electronic updates only.) With this service, customers benefit from expedited problem resolution as well as proactive notification and delivery of software updates. For more information about this service, see http://www.hp.com/services/ insight.
Websites For additional information, see the following HP websites: • http://www.hp.com/go/assistance • http://www.hp.com/go/support • http://www.hp.com/service_locator • http://www.hp.com/go/hpsc • http://www.hp.com/go/vcem/ Typographic conventions This document uses the following typographical conventions: Book title The title of a book. On the web, this can be a hyperlink to the book itself. 110 Command A command name or command phrase, for example ls -a.
7 Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, send a message to: docsfeedback@hp.com Include the document title and part number in your message. All submissions become the property of HP.
Index A add enet-connection command, 31 add fc-connection command, 38 add fcoe-connection command, 43 add iscsi-connection command, 50 add profile command, 21 add server-port-map command, 62 add server-port-map-range command, 67 assign profile command, 24 C cancelvcdmaint command, 80 command add enet-connection, 31 add fc-connection, 38 add fcoe-connection, 43 add iscsi-connection, 50 add profile, 21 add server-port-map, 62 add server-port-map-range, 67 assign profile, 24 cancelvcdmaint, 80 completevcdfwup
R RBAC, 12 RBAC types, 12 related documentation, 109 remove enet-connection command, 37 remove fc-connection command, 42 remove fcoe-connection command, 49 remove iscsi-boot-param command, 61 remove iscsi-connection command, 56 remove profile command, 29 remove server-port-map command, 66 remove server-port-map-range command, 69 role-based access control, 12 command, 30 username authentication, 11 username authentication, 11 V variables environment, 9 vcem authenticating, 11 VCEMCLI executable, 9 W websi
