HP Insight Management Virtual ConnectEnterprise ManagerCommand Line Interface Version 7.0 User GuideAbstractThis user guide is intended for Virtual Co
)echo Assign the profiles to bays that have servers present ---------------------------------for /L %%I in (1,1,%MAXPROFILES%) DO ( ::Turn off the
Role based Access Control (RBAC)Role based access control allows you to designate which operations and resources can bemanipulated.RBAC DetailsVCEM pr
Table 2 RBAC privileges (continued)VCEM User(read only)VCEMGroupLimitedOperatorVCEMGroupOperatorVCEMGroupAdministratorVCEMAdministratorCommand line op
Working with server profilesVCEMCLI provides the most commonly used profile operations including:• Server profile creation or update• Server profile a
• Select from the following Flex-10 iSCSI network connection options:Add Flex-10 iSCSI network connections using the -add iscsi-connection command.◦◦
Displaying job detailsThe –show job -jobid command displays detail for the specified VCEM job. The commandreturns a value corresponding to the current
Accessing VCEMCLI helpHelp is obtained by running VCEMCLI without any arguments.GETTING STARTED:-help : displays a list of available commands and mana
------------------------------------------------------------------Managed Elements------------------------------------------------------------------de
3 Using VCEM commandsThis chapter describes VCEMCLI commands .add profileThe -add profile command creates a profile from the supplied server profile d
Minimum Required Role Based SecurityVCEM Group AdministratorRemarksThis command creates a new unassigned server profile.VCEM fills empty attributes wi
© Copyright 2011, 2012 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or
set profileThe -set profile command modifies the properties on an existing server profile.Syntax-set profile -profilename <profileName>[-name &l
assign profileThe -assign profile command assigns the profile identified by the ProfileName to the bayspecified by the BayName.Syntax-assign profile –
The system page in HP Systems Insight Manager provides the enclosure name as displayed circledin red in Figure 1 (page 22).Figure 1 Enclosure nameThe
export profilesThe -export profiles command exports server profiles to a CSV file for use with externaltools.Syntax-export profiles –exportfile testfi
unassign profileThe -unassign profile command unassigns the selected server profile.Syntax-unassign profile -profilename <profileName>Parameters
add enet-connectionThe -add enet-connection command is used to add a new Ethernet network connection toan existing server profile in the VC Domain.NOT
Table 8 Parameter descriptions for -Add enet-connection (continued)OptionalRequiredDescriptionParameterxThe requested operationalspeed for the server
• Add a new Ethernet network connection and set the speed to Preferred:vcemcli -add enet-connection –profilename MyProfile –networkMyNetwork –SpeedTyp
set enet-connectionThe -set enet-connection command modifies an Ethernet connection of a server profile.Syntax-set enet-connection –profilename <pr
Table 9 Parameter descriptions for -set enet-connection (continued)OptionalRequiredDescriptionParameterxThe requested operationalspeed for the server
Contents1 Getting Started...5VCEMCLI Prerequisites...
• Modify Ethernet network connection to set the speed to preferred:vcemcli -set enet-connection –profilename MyProfile1 -portnumber 1–speedtype prefer
remove enet-connectionThe -remove enet-connection command removes the last Ethernet network connection froman existing server profile.Syntax-remove en
add fc-connectionThe -add fc-connection command adds a new FC connection to a server profile.Syntax-add fc-connection –profilename <profileName>
Minimum Required Role Based SecurityVCEM Group OperatorRemarksThe job status for the jobid can be obtained by executing VCEMCLI with the –show job com
set fc-connectionThe -set fc-connection command modifies an existing FC connection to a server profile.Syntax-set fc-connection –profilename <prof
Table 12 Parameter descriptions for -set fc-connection (continued)OptionalRequiredDescriptionParameterxIMPORTANT: The-bootport parameter isonly requir
remove fc-connectionThe -remove fc-connection command removes the last FC connection from a server profile.Syntax-remove fc-connection –profilename &
add fcoe-connectionThe -add fcoe-connection command adds a new FCoE connection to a server profileSyntax-add fcoe-connection –profilename <profileN
• Add a new FCoE connection and leave it unassigned:vcemcli -add fcoe-connection MyNewProfile -connectionbay 3• Add a new FCoE connection and set the
set fcoe-connectionThe -set fcoe-connection command modifies an existing FCoE connection.Syntaxset fcoe-connection –profilename <profileName>
remove fcoe-connection...41add iscsi-connectio
Table 15 Parameter descriptions for -set fcoe-connection (continued)OptionalRequiredDescriptionParameter• secondary• disabledOnly one boot parameter i
remove fcoe-connectionThe -remove fcoe-connection command removes the last FCoE connection from an existingserver profile.Syntax-remove fcoe-connectio
add iscsi-connectionThe -add iscsi-connection command adds a new iSCSI connection to an existing VC serverprofile.NOTE: The -add iscsi-connection comm
Table 17 Parameter descriptions for -add iscsi-connection (continued)OptionalRequiredDescriptionParametervalue is 100Mb to themaximum.OutputThe functi
set iscsi-connectionThe –set iscsi-connection command modifies the properties of a specified iSCSI connection.Syntax-set iscsi-connection –profilename
OutputThe function returns the result of the set operation or a jobid if –nb is specified.Examples• Change the network to a different one:vcemcli -set
remove iscsi-connectionThe remove iscsi-connection command removes the highest numbered iSCSI connectionfrom the server VC profile. If no connections
set iscsi-boot-paramThe -set iscsi-boot-param command configures the basic iSCSI boot parameters on thespecified iSCSI connection.Syntax-set iscsi-boo
Table 20 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterxNOTE: The-initiatornameparameter is required
Table 20 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterxNOTE: The-targetport2 parameteris required i
1 Getting StartedThe VCEM Command Line is a family of executables that provide the facilities necessary for themost frequently used management operati
Table 20 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterxAllows the iSCSI optionROM to retrieve the T
remove iscsi-boot-paramThe –remove iscsi-boot-param command removes all the iSCSI boot parameters configuredon the specified iSCSI connection.Syntax-r
add server-port-mapThe -add server-port-map command adds new server port network mapping, and allowsserver ports to be shared among multiple VC Ethern
OutputThe function returns the result of the add operation or a jobid if –nb is specified.Examples• Add a new server port to dedicated network mapping
set server-port-mapThe -set server-port-map command modifies the properties of a server port network mapping.Syntax-set server-port-map –profilename &
Examples• Modify the VLAN ID of an existing server port network mapping:vcemcli -set server-port-map –profilename MyProfile –portnumber 1–network Netw
remove server-port-mapThe –remove server-port-map command removes server port network mapping.NOTE: The –remove server-port-map command cannot be used
poweroff devicebayThe -poweroff devicebay command sends a power-off request to Virtual Connect Managerfor a given bay.Syntax-poweroff devicebay –enclo
• Normal power off operation on device bay 2 of an enclosure with ID enc0, if the timeoutoccurs, then the system is forced into power off.vcemcli -pow
poweron devicebayThe -poweron devicebay command sends a power-on request to Virtual Connect Manager fora given bay.Syntax-poweron devicebay -enclosure
• Run scripts in response to Systems Insight Manager events or from the Windows job scheduler.• Leverage the CSV export of profile data to answer ques
show power-statusThe -show power-status command displays the power status of the indicated bay.Syntax-show power-status -enclosurename <enclosurena
show jobThe -show job command reports the status of the indicated job.Syntax-show job –jobid <jobNumber>ParametersTable 28 Parameter description
show versionThe -show version command displays version information for the VCEM server.Syntax-show version ParametersNoneOutputThe -show version comma
show vcem-statusThe -show vcem-status command displays the VCEM management status for the specified VCDomain.Syntax-show vcem-status-domainname<Dom
startvcdmaintThe -startvcdmaint command starts the VC domain maintenance operation on the specifiedVC domain. For more information on what VCM operati
cancelvcdmaintThe -cancelvcdmaint command cancels the VC domain maintenance operation on the specifiedVC domain.Syntax-cancelvcdmaint <DomainName&g
completevcdmaintThe -completevcdmaint command completes the VC domain maintenance operation on thespecified VC domain propagating changes across all d
4 Error messagesTo help you troubleshoot symptoms, Table 35 and Table 36 (page 68) displays error messagenumbers and descriptions.Table 35 VCEMCLI err
Table 35 VCEMCLI error messages and descriptions (continued)Error message descriptionError message numberFailed to initialize XML parser124Failed to c
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Security on the CMSVCEMCLI is installed on the CMS. By installing on the CMS, you get the benefits of the securitymeasures already in place for the CM
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
2 Using VCEMCLIVCEMCLI can be executed from the Windows command line or from scripts written in anyWindows-supported scripting language.ExecutableThe
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
Table 36 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to
5 Troubleshooting VCEMCLIVCEMCLI calls result in access denied errorsTo resolve access denied errors, verify that the credentials used with the VCEMCL
Unable to assign a profile to a Domain GroupIf the profile is not the same configuration as the VC Domain Group, then you might not be ableto assign t
For more information about supported Virtual Connect firmware, go to http://www.hp.com/go/vcem.Creating a server profile failsAttempting to create a p
Table 1 Common options (continued)DescriptionCLI optionsNOTE: When using this option, it is possible thatsequential edits queued for the same profile
As a result, VCEM APIs can report false job results such as, Completed with success, eventhough the server profile changes have not taken effect. The
following error message appears whenever an -add profile or -set profile operation isperformed and there is one or more server profiles inside the VC
6 Support and other resourcesBefore you contact HPBe sure to have the following information available before you call contact HP:• Technical support r
Registering for software technical support and update serviceInsight Management includes one year of 24 x 7 HP Software Technical Support and UpdateSe
For more information about Virtual Connect Manager, see:• BladeSystem c-Class Solution Overview• HP Virtual Connect for c-Class BladeSystem User Guide
IndexAadd enet-connectioncommand, 25add fc-connectioncommand, 32add fcoe-connectioncommand, 37add iscsi-connectioncommand, 42add profilecommand, 18add
remove server-port-mapcommand, 56role based access control, 11Sset enet-connectioncommand, 28set fc-connectioncommand, 34set fcoe-connectioncommand, 3
Comments to this Manuals