HP Insight Software Virtual Connect Enterprise Manager Command Line Interface Version 6.3 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..........................................................................................6 VCEMCLI Prerequisites..............................................................................................................6 Installing VCEMCLI...................................................................................................................6 Removing VCEMCLI..............................................................................................................
add fcoe-connection...............................................................................................................39 set fcoe-connection.................................................................................................................41 remove fcoe-connection...........................................................................................................44 add iscsi-connection............................................................................................
Index.........................................................................................................
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. New to this release, 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.
%CLI% -poweroff devicebay -enclosureName %ENCLNAME% -bayname %%I -forceOnTimeout 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 VCEMCLI commands for read operations require minimum VCEM privilege, whereas write operations require full privilege to the affected resource.
default connections. Subsequent VCEMCLI operations on the same server profile define other network and SAN connections. Creation of a server profile requires only two mandatory attributes: • Profile name • VC Domain Group to which the profile will belong The profile name must be unique, less than 64 characters in length, and contain only alphanumeric characters, hyphens, and underscores. For more information see “add profile” (page 18).
NOTE: You can remove all the iSCSI connections. You cannot add more connections than the maximum allowed. The maximum allowed connections is based on VC firmware mode. See the HP Virtual Connect Enterprise Manager 6.3 User Guide for more information. • 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.
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.
fcoe-connection iscsi-boot-param iscsi-connection job power-status profile profiles server-port-map version : : : : : : : : : FCoE Fabric Connections iSCSI Boot Parameter information iSCSI Network Connections VCEM jobs Bay power status Virtual Connect Server Profile VCEMCLI profile export information Shared Server Downlink Port Mapping Configuration VCEMCLI Version Information Error Reporting All VCEMCLI commands can report errors.
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.
Minimum Required Role Based Security VCEM Group Limited Operator CAUTION: If VCEMCLI is used in environments where logical server managers or upper level managers are present, assigning a server profile can make it inconsistent with the upper level manager. HP recommends using the upper level manager to assign server profiles. Remarks The job status of non-blocking operations can be obtained by executing VCEMCLI with the –show job command and providing the associated job ID.
• The bay must belong to the same VC Domain Group where the server profile belongs. • The bay is not an auxiliary bay. VCEM currently does not provide a method to detect auxiliary or covered bays. A server profile cannot be assigned to an auxiliary or covered bay. VCEMCLI reports an error if an attempt is made to assign a server profile to an auxiliary or covered bay. • If the server is a BL890 multisystem, the target bay must be the one containing the primary blade.
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 User Guide.
Table 8 Parameter descriptions for -Add enet-connection (continued) Parameter Description -pxe Enables or disables PXE on the network connection. If this value is not specified, the default will be Usebios. Required Optional x NOTE: Only one connection can have PXE enabled per profile. -speedtype The requested operational speed for the server port. Valid values include auto, preferred and custom.
• 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-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 V
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 -profileName The name of the server profile that contains the connection to modify.
Table 9 Parameter descriptions for -set enet-connection (continued) Parameter Description -pxe Enables or disables PXE on a connection. Valid values are enabled, disabled, and usebios. Required Optional x NOTE: Only one connection can have PXE enabled per profile. -speedtype The requested operational speed for the server port. Valid values include auto, preferred and custom.
• Disable PXE on an Ethernet network connection: vcemcli -set enet-connection –profilename GreenProfile3 -portnumber 1 –pxe disabled • 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
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.
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 next available fabric: vcemcli -add fc-connection –profilename MyNewProfile –connectionbay 5 Minimum Required Role Based Security VCEM Group Operator Remarks The j
Creating FC connections must be done in order, otherwise an error is reported. Ensure that the fcFabric you choose for the fcConnection is mapped correctly to the FC module. For example, in a multi-blade server environment, the server profile already has port 1 and port 2 in place. When you try to create the third one, ensure that the connectionBay is 5 and fcFabric is created using FC module in Bay 5.
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 -customspeed User-defined speed for the server port. Valid values include 100Mb-10Gb configured in 100Mb increments The acceptable value is 100 to 10000 Mb/s. x -bootpriority Optional IMPORTANT: The -customspeed parameter is required if the speed type is custom. Controls whether the FC HBA port is enabled for SAN boot and affects the BIOS boot order.
• Modify the FCoE connection and set the speed to 5Gb: vcemcli -set fcoe-connection –profilename MyProfile –portnumber 1 –speedtype custom –customspeed 5000 • Change the SAN boot priority and set additional boot parameters: vcemcli -set fcoe-connection –profilename BlueProfile –portnumber 1 -bootpriority primary –bootport 50:06:0B:00:00:C2:62:00 –bootlun 5 Minimum Required Role Based Security VCEM Group Operator Remarks The job status for the jobid can be obtained by executing VCEMCLI with the –show jo
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 -speedtype The requested operational speed for the server port. Valid values include auto, preferred and custom.
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 67). VC firmware 3.10 or later is required in order to use iSCSI. VC supports a maximum of 32 iSCSI connections.
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 48 Parameter Description Required -profilename The profile for the iscsi-connection x -portnumber The port number for the isci-connection.
Table 20 Parameter descriptions for –set iscsi-connection (continued) Parameter Description -speedtype The requested operational speed for the server port. Valid values include auto, preferred and custom. The default value is preferred.
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 67).
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.
Table 24 Parameter descriptions for -add server-port-map (continued) Parameter Description Required -network The name of a valid network x to which the mapping will be added. Optional NOTE: A network can be configured once for every profile connection and every profile connection can be configured for a maximum of 28 networks. -uplinkset -vlanid -untagged The name of the shared uplinkset.
Examples • Add a new server port to dedicated network mapping: vcemcli -add server-port-map –profilename MyProfile –portnumber 1 –network Network1 –vlanid 100 • Add a new server port to shared network mapping: vcemcli -add server-port-map –profilename MyProfile –portnumber 2 –network RedNetwork –uplinkset MyUplinkSet1 • Add a new server port to shared network and label it as untagged: vcemcli -add server-port-map –profilename MyProfile –portnumber 3 –network GreenNetwork –uplinkset MyUplinkset1 –untagg
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 Optional -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 Optional 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.
4 Error messages To help you troubleshoot symptoms, Table 31 and Table 32 (page 70) displays error message numbers and descriptions.
Table 31 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 32 VCEM server error messages and descriptions (continued) Error message number Error message description 2040 The operation cannot be performed because VC firmware version is not supported by VCEM. Refer to the VCEM User Guide to verify the VC firmware versions supported by each VC Domain Group firmware mode 2057 The operation cannot be performed because the entered MAC addresses range is invalid.
Table 32 VCEM server error messages and descriptions (continued) 72 Error message number Error message description 2551 Server profile name is empty or invalid. Names can only have alphanumeric characters, hyphens (-) or underbars (_) and are limited to 64 characters. 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.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 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. 2606 In the FC SAN connection for interconnect bay , the entered boot target WWPN is not well formed.
Table 32 VCEM server error messages and descriptions (continued) 74 Error message number Error message description 2620 Cannot perform the operation because the VC Domain maintenance is not completed. Perform these steps: 1. Go to the VCEM - VC Domains tab and select the VC Domain that is under maintenance. 2. Click VC Domain Maintenance. 3.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 2646 In the ethernet connection for port, the selected Network does not exist. The provided Network must exist in the VC Domain group the Server profile belongs. 2647 A server profile cannot have more than x Ethernet network connections where x represents a number. 2650 Cannot find FC connection for the specified interconnect bay because the interconnect bay number is invalid.
Table 32 VCEM server error messages and descriptions (continued) 76 Error message number Error message description 2678 In the FC SAN connection for port number and interconnect bay , the specified boot target WWPN is 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. 2679 In the FC SAN connection for port number and interconnect bay , the specified boot target LUN is invalid.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 2729 There are duplicated server VLAN Ids. Type a different VLAN Id for each mapping. 2731 The provided configuration for multiple networks does not have the minimal number of VNet mappings. At least one VNet mapping is required. 2732 There is no VNet selected.
Table 32 VCEM server error messages and descriptions (continued) 78 Error message number Error message description 2744 In the iSCSI connection for port , the port speed exceeds the maximum allowed port speed for the selected network (Gb). 2745 In the iSCSI connection for port , the port speed is lower than the minimum allowed port speed for the selected network (Gb). 2746 There are missing or duplicate FCoE connections.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 2760 In the FCoE connection for interconnect bay , the WWN range type is not compatible with the addresses inside the connection. 2761 Invalid number of WWN addresses in the FCoE connection for interconnect bay .
Table 32 VCEM server error messages and descriptions (continued) 80 Error message number Error message description 2779 Cannot perform Server Profile operation because the VC Domain Group does not support adding FCoE connections. 2781 VCEM cannot update Server Profile. The connection port number is not arranged in order. 2782 VCEM cannot update Server Profile. The connection port number is out of supported port range.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 2806 This user does not have authorization to use or view HP Virtual Connect Enterprise Manager. 2807 The entered logon token is invalid. Obtain a new token and perform the operation again. 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).
Table 32 VCEM server error messages and descriptions (continued) 82 Error message number Error message description 5070 Invalid profile FCoE connection speed type. 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. At least one VNet mapping is required.
Table 32 VCEM server error messages and descriptions (continued) Error message number Error message description 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. Verify that the selected bay supports the assign operation.
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 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. 2. 3. 4.
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.
Commands -add profile or -set profile error messages VCEM requires the boot target LUN configuration and server profiles to be either a three-digit decimal between 0–255, or a 16-digit hexadecimal value between 0 and FFFFFFFFFFFFFFFF. The 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.
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
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.
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 add enet-connection command, 26 add fc-connection command, 33 add fcoe-connection command, 39 add iscsi-connection command, 45 add profile command, 18 add server-port-map command, 57 assign profile command, 21 H help accessing, 16 J job details displaying, 15 L lifetime session, 10 C command add enet-connection, 26 add fc-connection, 33 add fcoe-connection, 39 add iscsi-connection, 45 add profile, 18 add server-port-map, 57 assign profile, 21 export profiles, 24 poweroff devicebay, 63 poweron de
set fcoe-connection command, 41 set iscsi-boot-param command, 52 set iscsi-connection command, 48 set profile command, 20 set server-port-map command, 60 show job command, 67 show power-status command, 66 show version command, 68 T technical support service locator website, 91 types RBAC, 11 U unassign profile command, 25 username authentication, 10 username authentication, 10 V variables environment, 8 VCEM authenticating, 10 VCEMCLI executable, 8 W websites HP , 91 93