HP Insight Software Virtual Connect Enterprise Manager Command Line Interface Version 6.3.1 User Guide Abstract This user guide is intended for Virtual Connect administrators who are familiar with both Virtual Connect and with the Virtual Connect management suite including Virtual Connect Manager, Virtual Connect Enterprise Manager and upper level managers such as HP Logical Storage Manager and Insight Dynamics.
© Copyright 2011 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..........................................................................................5 VCEMCLI Prerequisites..............................................................................................................5 Installing VCEMCLI...................................................................................................................5 Removing VCEMCLI..............................................................................................................
add iscsi-connection................................................................................................................41 set iscsi-connection..................................................................................................................43 remove iscsi-connection...........................................................................................................45 set iscsi-boot-param.......................................................................................
1 Getting Started The VCEM Command Line is a family of executables that provide the facilities necessary for the most frequently used management operations for the Virtual Connect Enterprise Manager infrastructure. The HP Virtual Connect Enterprise Manager Command Line Interface (VCEMCLI) can be used as an alternate method for managing common Virtual Connect operations. The VCEM.CMD executable provides failover management. VCEMCLI.
Choosing a location for the script files Do not place the scripts you create in the VCEMCLI installation directory as this can prevent product upgrades from functioning. Instead, create your scripts in a separate directory outside the HP installation directory tree. Do not make changes to the example scripts in the VCEMCLI installation directory as this may prevent product upgrades from functioning. Make a copy of the example scripts in a separate location if you want to make changes to them.
2 Using VCEMCLI 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 containing vcemcli.exe is added to the %PATH% environment variable.
Table 1 Common options (continued) CLI options Description –timeout seconds When set, instructs VCEMCLI how long to wait for blocking commands. -pollinginterval seconds When set, instructs VCEMCLI how often to poll VCEM for job or power status. Using VCEMCLI in a script The following example illustrates how VCEMCLI can be used to automate common profile management tasks.
if ERRORLEVEL 1 goto ERRORHANDLER ) echo -----------------------------------------echo The server in bay %%I is off. Assigning profile PROFILE-%%I %CLI% -assign profile -profilename PROFILE-%%I -enclosureName %ENCLNAME% -bayname %%I if ERRORLEVEL 1 goto ERRORHANDLER ) ) goto END :ERRORHANDLER echo Error processing last command.
RBAC Details VCEM provides the following role based user types. Individual VCEMCLI commands require different access permissions based on the resource involved and the read or write operation being called. Access is determined based on the credentials used by VCEMCLI. • VCEM Administrator—Manages all VCEM resources. All operations are permitted to all resources. • VCEM Domain Group Administrator—Manages VC Domains and server profiles in one or more VC Domain Groups.
Table 2 RBAC privileges (continued) VCEM Group Limited VCEM User Operator (read only) Command line options VCEM VCEM VCEM Group Group Administrator Administrator Operator -set iscsi-boot-param x x x -remove iscsi-boot-param x x x -show job x x x x x -show version x x x x x -show vcem-status x x x x x -startvcdmaint x x -cancelvcdmaint x x -completevcdmaint x x VCEMCLI commands for read operations require minimum VCEM privilege, whereas write operations require full priv
Creating a server profile Server profiles are defined in a multi-step process to reduce the number of arguments required in a single VCEMCLI command. In the first step the server profile is created as unassigned and with default connections. Subsequent VCEMCLI operations on the same server profile define other network and SAN connections.
• Select from the following FC connection options: ◦ Add FC SAN connections using the -add fc-connection command. ◦ Modify FC SAN connections using the -set fc-connectioncommand. ◦ Remove FC SAN connections using the -remove fc-connection command. NOTE: You can remove all the FC connections. You cannot add more connections than the maximum allowed. • Edit the Fibre Channel boot parameters using the -set fc-connection command.
Displaying job details The –show job -jobid command displays detail for the specified VCEM job. The command returns a value corresponding to the current state of the job. The following list displays job return codes. • COMPLETED (0)—The job is complete. • PENDING (10)—The job is waiting to run. • RUNNING (11)—The job is still executing. • WARNING (12)—Job succeeded with minor errors. • FAILED (13)— The job failed.
Accessing VCEMCLI help Help is obtained by running VCEMCLI without any arguments.
-----------------------------------------------------------------Managed Elements -----------------------------------------------------------------devicebay : Bay which can contain a Virtual Connect server.
3 Using VCEM commands This chapter describes VCEMCLI commands . add profile The -add profile command creates a profile from the supplied server profile description. Syntax -add profile -vcdomaingroup [-mactypeoverride ] [-wwntypeoverride ] [-sntypeoverride ] Parameters Table 3 Parameter descriptions for -add profile Parameter Description Required Optional -profilename Unique name of a newly created 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 Name of the profile you want to modify. x -name 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 Unique name of the server profile to be assigned x -enclosurename The enclosure containing the x bay to assign the profile to.
The system page in HP Systems Insight Manager provides the enclosure name as displayed circled in red in Figure 1 (page 21). 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”. For a double dense blade, the bay for the 1a blade has the name of “1a” whereas the bay for the 1b blade has the name of “1b”. If an invalid enclosure name and bay name are supplied to VCEMCLI, an error is reported.
export profiles The -export profiles command exports server profiles to a CSV file for use with external tools. Syntax -export profiles –exportfile testfile.csv Parameters Table 6 Parameter descriptions for -export profiles Parameter Description Required -exportfile The name of the file to receive the exported profile data in CSV format. x Examples vcemcli -export profiles -exportfile MyProfiles.
unassign profile The -unassign profile command unassigns the selected server profile. Syntax -unassign profile -profilename Parameters Table 7 Parameter descriptions for -unassign profile Parameter Description Required -profilename The name of a server profile x 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 is used to add 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 6.3.1 User Guide.
Table 8 Parameter descriptions for -Add enet-connection (continued) Parameter Description -speedtype 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 maximum port speed constrained by the maximum configured speed for the network. • Preferred—Speed of the network matches the preferred speed of the network to which the connection is associated.
• Add a new Ethernet network connection and set the speed to Preferred: vcemcli -add enet-connection –profilename MyProfile –network MyNetwork –SpeedType Preferred • Add a new Ethernet network connection and set the speed to 2Gb: vcemcli -add enet-connection –profilename MyProfile –network MyNetwork –speedtype custom –speed 2000 Minimum Required Role Based Security VCEM Group Operator Remarks The job status for the jobid can be obtained by executing VCEMCLI with the –show job command and providing the
set enet-connection The -set enet-connection command modifies an Ethernet connection of a server profile. Syntax -set enet-connection –profilename -portnumber [-network ] [–pxe ] [–speedtype ] [–speed ] Parameters Table 9 Parameter descriptions for -set enet-connection Parameter Description Required Optional -profileName The name of the server profile that contains the connection to modify.
Table 9 Parameter descriptions for -set enet-connection (continued) Parameter Description -speedtype 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 maximum port speed constrained by the maximum configured speed for the network • Preferred—Speed of the network matches the preferred speed of the network to which the connection is associated.
• Modify Ethernet network connection to set the speed to preferred: vcemcli -set enet-connection –profilename MyProfile1 -portnumber 1 –speedtype preferred • Modify Ethernet network connection to set the speed to 2Gb: vcemcli -set enet-connection –profilename MyProfile1 -portnumber 1 –speedtype custom –Speed 2000 Minimum Required Role Based Security VCEM Group Operator Remarks The job status for the jobid can be obtained by executing VCEMCLI with the –show job command and providing the associated job I
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 10 Parameter descriptions for -remove enet-connection Parameter Description Required -profilename The name of the profile that x is being disconnected from the Ethernet connection. Optional Output The function returns the result of the remove operation or a jobid if –nb is specified.
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 11 Parameter descriptions for -add fc-connection Parameter Description Required Optional -profilename The name of an existing profile to add the new connection to.
Minimum Required Role Based Security VCEM Group Operator Remarks The job status for the jobid can be obtained by executing VCEMCLI with the –show job command and providing the associated job ID. For more information see “show job” (page 60). VC firmware version 3.0x and earlier limit the number of FC connections to one per FC interconnect bay. In VC 3.10, this is raised to one per blade in the case of multi-blade servers. In VC firmware 3.
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 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 format: x Optional IMPORTANT: The -bootport parameter is only required when the -bootpriority 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 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 Syntax -add fcoe-connection –profilename -connectionbay [-fabric ] [-speedtype <1Gb|2Gb|4Gb|8Gb|custom|disabled>] [-customspeed <100 — 10000>] Parameters Table 16 Parameter descriptions for -add fcoe-connection Parameter Description Required Optional -profilename The name of an existing profile to add the new connection to.
• Add a new FCoE connection and leave it unassigned: vcemcli -add fcoe-connection MyNewProfile -connectionbay 3 • Add a new FCoE connection and set the speed type to Custom: vcemcli -add fcoe-connection MyProfile -connectionbay 3 –fabric MyFabric –speedtype custom –customspeed 5000 Minimum Required Role Based Security VCEM Group Operator Remarks The job status for the jobid can be obtained by executing VCEMCLI with the –show job command and providing the associated job ID.
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 • secondary • disabled Only one boot parameter is allowed per FCoE connection. -bootport 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 format: x IMPORTANT: The -bootport parameter is only required when the bootpriority parameter is set to either primary or secondary.
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 The name of an existing profile from which the last FCoE connection is to be removed. x 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 Flex-10 10Gb Ethernet Modules.
Table 19 Parameter descriptions for -add iscsi-connection (continued) Parameter Description Required Optional value is 100Mb to the maximum. Output The function returns the result of the add operation or a jobid if –nb is specified.
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 Optional -profilename The profile for the iscsi-connection x -portnumber The port number for the isci-connection.
Output The function returns the result of the set operation or a jobid if –nb is specified.
remove iscsi-connection The remove iscsi-connection command removes the highest numbered iSCSI connection from the server VC profile. If no connections exist, then an error message is displayed. 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 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 quotes. x NOTE: The -initiatorname parameter is required if the -iscsibootparamdhcp is set to disabled. -initiatorip IP address used by the iSCSI x initiator.
Table 22 Parameter descriptions for -set iscsi-boot-param (continued) Parameter Description -targetport2 The TCP port associated with x the alternate target IP address. The default value is NOTE: The -targetport2 parameter 3260. is required if the -targetip2 parameter is specified. -authentication The initiator and target must agree on an authentication method or the iSCSI initiator cannot log on to the target. Supported Authentication values include none, chap and chapm.
Table 22 Parameter descriptions for -set iscsi-boot-param (continued) Parameter Description -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 allowing 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 The name of the profile from x which the boot parameter is to be removed. -port The port number from which x the boot parameter is to be removed.
add server-port-map The -add server-port-map command adds new server port network mapping, and allows server ports to be shared among multiple VC Ethernet networks. NOTE: The -add server-port-map command cannot be used if the domain setting VLanTagControl is currently set to tunnel. This restriction is lifted for VC Domain Groups running VC 3.30 firmware mode and above.
Table 24 Parameter descriptions for -add server-port-map (continued) Parameter Description Required Optional packets. The default value is false. NOTE: If a shared uplink set is being used, then the untagged network is the same as native network, if present. However, any other network can be configured to handle untagged packets. 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. NOTE: This command cannot be used if the domain setting vlantagcontrol is currently set to tunnel.
Examples • Modify the VLAN ID of an existing server port network mapping: vcemcli -set server-port-map –profilename MyProfile –portnumber 1 –network Network1 –vlanid 100 • Modify the existing server port network mapping to handle untagged packets: vcemcli -set server-port-map –profilename MyProfile –portnumber 1 –network Network1 –untagged true NOTE: When setting a VLAN ID in an untagged VLAN, VCEM sets the VLAN ID to zero and does not return an error.
remove server-port-map The –remove server-port-map command removes server port network mapping. NOTE: The –remove server-port-map command cannot be used if the domain setting vlantagcontrol is set to tunnel.
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 27 Parameter descriptions for -poweroff devicebay Parameter Description Required -enclosurename The name of the enclosure containing the bay to be powered off. x -bayname The name of the bay to be powered off.
• Normal power off operation on device bay 2 of an enclosure with ID enc0, if the timeout occurs, then the system is forced into 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 28 Parameter descriptions for -poweron devicebay Parameter Description Required -enclosurename The name of the enclosure containing the bay to be powered on. x -bayname 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 29 Parameter descriptions for -show power-status Parameter Description Required -enclosurename The name of an enclosure in x the domain. -bayname The name of the bay in the enclosure. Optional x NOTE: For a multi-blade server the BayName 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 30 Parameter descriptions for -show job Parameter Description Required -jobid The ID of an existing job x Output The -show job command displays the status of the indicated job.
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 31 Parameter descriptions for -show vcem-status Parameter Description Required -domainname 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.
startvcdmaint The -startvcdmaint command starts the VC domain maintenance operation on the specified VC domain. Syntax -startvcdmaint Parameters Table 33 Parameter descriptions for -startvcdmaint Parameter Description Required -startvcdmaint Name of domain to be placed into maintenance mode x Optional Output The -startvcdmaint command returns the result of the startvcdmaint operation reporting success, or indicating the reason for failure.
cancelvcdmaint The -cancelvcdmaint command cancels the VC domain maintenance operation on the specified VC domain. Syntax -cancelvcdmaint Parameters Table 34 Parameter descriptions for -cancelvcdmaint Parameter Description Required -cancelvcdmaint Name of domain where maintenance mode will be cancelled x Optional Output The -cancelvcdmaint command returns the result of the cancelvcdmaint operation reporting success, or indicating the reason for failure.
completevcdmaint The -completevcdmaint command completes the VC domain maintenance operation on the specified VC domain propagating changes across all domain group members.
4 Error messages To help you troubleshoot symptoms, Table 36 and Table 37 (page 67) displays error message numbers and descriptions.
Table 36 VCEMCLI error messages and descriptions (continued) Error message number Error message description 124 Failed to initialize XML parser 140 Failed to create the export file 141 Invalid path specified for the export file 142 Export file name is too long. Maximum length is 260 characters 144 Failed to find server profile data structure key. Column alignment may be affected 145 Duplicate key found while mapping server profile.
Table 37 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. and that the VC Domain is locked for the VCEM and then perform the operation again. 2015 The operation could not be performed because a VC Domain with name [x] is already being managed by VCEM. Enter a unique name for the VC Domain name and perform this operation again.
Table 37 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. 2057 The operation cannot be performed because the entered MAC addresses range is invalid. Verify it is well formed (NN-NN-NN-NN-NN-NN, where N is a hexadecimal digit (0-F)) and then perform the operation again.
Table 37 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. 2151 VCEM could not update the VC Domain Group configuration because there is at least one unlicensed VC Domain inside the specified VC Domain Group.
Table 37 VCEM server error messages and descriptions (continued) Error message description Error message number 2182 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. The operation cannot be performed because the VC Domain [x] has one or more VC FC modules with invalid status.
Table 37 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. a. Enable the VC Domain maintenance operation. b. Upgrade the managed VC Domains to (at least) the minimum VCEM-supported VC firmware version. c. Complete the VC Domain maintenance operation. 2) Upgrade the VC Domain Group firmware mode to (at least) the minimum supported by VCEM.
Table 37 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. 2420 The operation cannot be performed because VC Domain firmware version [x] is incompatible with VC Domain Group firmware mode [x]. Refer to the VCEM User Guide to verify the VC firmware versions supported by each VC Domain Group firmware mode.
Table 37 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. all port connections are correctly pointing to a valid network and then perform the operation again. 74 2560 In the FC SAN connection for interconnect bay , the selected FC SAN fabric does not have a physical connection to this port.
Table 37 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. SAN boot settings for each FC SAN connection physical port 2610 There are missing or duplicate Ethernet network connections. A continuous sequence finishing on the last valid Ethernet network connection port is required. 2611 The specified VC Domain Group does not exist.
Table 37 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 connection, then edit the server profile again and add a new connection. 76 2629 It was not possible to remove the provided vNet mapping from the server profile. 2630 The target server bay does not support server profiles.
Table 37 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. 2657 The port speed information could not be retrieved for the specified connection. Verify the provided network id corresponds to an existing network. 2658 In the FC SAN connection for interconnect bay , the base boot configuration is not set.
Table 37 VCEM server error messages and descriptions (continued) Error message description Error message number 78 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2682 Missing base initiator configuration in FC SAN connection for interconnect bay . 2683 Cannot perform server profile assignment because bay is an auxiliary server blade. 2684 Cannot assign server profile because the selected bay is covered.
Table 37 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. 2734 The provided network does not exist in the specified VC Domain Group. The network must exist in the VC Domain Group to which the Server Profile belongs. 2735 Cannot create Server Profile because an address is already in use by Server Profile. To resolve this: 1.
Table 37 VCEM server error messages and descriptions (continued) Error message description Error message number 80 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 2747 There are more than one FCoE connection configured as primary boot. Only one FCoE connection can be configured as primary boot. 2748 There are more than one FCoE connection configured as secondary boot.
Table 37 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. 2762 In the FCoE connection for port number and interconnect bay , the specified boot target WWPN is missing or not well-formed. Valid formats are xx:xx:xx:xx:xx:xx:xx:xx, xx-xx-xx-xx-xx-xx-xx-xx, or xxxxxxxxxxxxxxxx, where each x is a hexadecimal digit.
Table 37 VCEM server error messages and descriptions (continued) Error message description Error message number 82 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 37 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 37 VCEM server error messages and descriptions (continued) Error message description Error message number 84 NOTE: The error message descriptions in this table use [x] to represent variables in the error message output. 5071 Invalid FCoE connection port number. Port number must be greater than 0. 5072 Invalid FC connection port number. Port number must be greater than 0. 5073 The provided configuration for multiple networks does not have the minimal number of VNet mappings.
Table 37 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. 6150 The server profile cannot be found. 6152 Cannot perform the operation. Verify there is at least one VC Domain Group already created. 6153 The operation could not be completed because the VC Domain Group is under maintenance. 6156 The selection is not valid.
5 Troubleshooting VCEMCLI 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. VCEMCLI calls result in errors for invalid leading character or invalid characters For leading characters, verify that you are using the ASCII dash characters rather than one of the many UNICODE dash variants.
Unable to assign a profile to a Domain Group If the profile is not the same configuration as the VC Domain Group, then you might not be able to assign the profile to the VC Domain Group. To resolve this, verify that the profile meets the requirements for the intended VC Domain Group. See the HP Virtual Connect Enterprise Manager 6.3.1 User Guide for additional troubleshooting information.
For more information about supported Virtual Connect 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. • The MAC or WWN addresses in use by the VC Domain are not defined as custom ranges in VCEM. To resolve this: 1.
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 there is one or more server profiles 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 three–digit decimal between 0–255 or a 16-digit hexadecimal between 0 and FFFFFFFFFFFFFFFF.
6 Support and other resources Before you contact HP Be sure to have the following information available before you call contact HP: • Technical support registration number (if applicable) • Product serial number • Product model name and number • Product identification number • Applicable error message • 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: • In the Un
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 • Registration for Software Technical Support and Update Service—There are two methods for registering: ◦ If you received a license entitlement certificate, automated registration for this service will take place upon online redemption of the license certificate/key.
HP websites For additional information, see the following HP websites: • http://www.hp.com • http://www.hp.com/service_locator • http://www.hp.com/go/vcem Typographic conventions This document uses the following typographical conventions: %, $, or # A percent sign represents the C shell system prompt. A dollar sign represents the system prompt for the Bourne, Korn, and POSIX shells. A number sign represents the superuser prompt. audit(5) A manpage.
Index A D add enet-connection command, 24 add fc-connection command, 31 add fcoe-connection command, 36 add iscsi-connection command, 41 add profile command, 17 add server-port-map command, 51 assign profile command, 20 displaying job details, 14 document related information, 92 C help accessing, 15 cancelvcdmaint command, 64 command add enet-connection, 24 add fc-connection, 31 add fcoe-connection, 36 add iscsi-connection, 41 add profile, 17 add server-port-map, 51 assign profile, 20 cancelvcdmaint,
remove server-port-map command, 55 role based access control, 9 S set enet-connection command, 27 set fc-connection command, 33 set fcoe-connection command, 38 set iscsi-boot-param command, 46 set iscsi-connection command, 43 set profile command, 19 set server-port-map command, 53 show job command, 60 show power-status command, 59 show vcem-status command, 62 show version command, 61 startvcdmaint command, 63 T technical support service locator website, 93 types RBAC, 10 U unassign profile command, 23 us
