Hp Insight Management-Software Manuale Utente

HP Virtual Connect Enterprise Manager 7.2Command Line Interface User GuideAbstractThis user guide is intended for HP Virtual Connect administrators wh

Table 1 Common options (continued)DescriptionCLI optionsNOTE: When you are using this option, sequential editsqueued for the same profile might confli

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

5 Troubleshooting the VCEMCLIThis section provides information on resolving VCEMCLI issues.VCEMCLI calls result in access denied errorsTo resolve acce

Unable to assign a profile to a domain groupIf the profile is not the same configuration as the VC domain group, you might not be able to assignthe pr

BladeSystem c-Class Virtual Connect Support Utility Version User Guide and the HP BladeSystemc-Class Virtual Connect Support Utility Version Release N

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 one or more server profiles is inside the VC domain

6 Support and other resourcesInformation to collect before contacting HPBe sure to have the following information available before you contact HP:• So

an electronic license to use are eligible for electronic updates only.) With this service, customersbenefit from expedited problem resolution as well

echo Add network connection complete - Update network connections --------------------------for /L %%I in (1,1,%MAXPROFILES%) DO ( echo Assigning e

WebsitesFor additional information, see the following HP websites:• http://www.hp.com/go/assistance• http://www.hp.com/go/support• http://www.hp.com/s

7 Documentation feedbackHP welcomes your feedback. To make comments and suggestions about product documentation,send a message to:[email protected]

IndexAadd enet-connectioncommand, 31add fc-connectioncommand, 38add fcoe-connectioncommand, 43add iscsi-connectioncommand, 50add profilecommand, 21add

RRBAC, 12RBAC types, 12related documentation, 109remove enet-connectioncommand, 37remove fc-connectioncommand, 42remove fcoe-connectioncommand, 49remo

Session lifetimeVCEMCLI logon sessions remain active for a single command execution. The CLI automaticallylogs out of the VCEM server after the execut

Table 2 RBAC privileges (continued)VCEM User(Read Only)VCEMDomainGroupLimitedOperatorVCEMDomainGroupOperatorVCEM DomainGroupAdministratorVCEMAdministr

Table 2 RBAC privileges (continued)VCEM User(Read Only)VCEMDomainGroupLimitedOperatorVCEMDomainGroupOperatorVCEM DomainGroupAdministratorVCEMAdministr

Working with server profilesThe VCEMCLI provides the most commonly used server profile operations, including:• Server profile creation or update• Serv

NOTE: The minimum number of network connections is two. You cannot remove these twodefault connections. You cannot add more than the maximum allowed n

well as between domain groups. Moving server profiles between domain groups offers newoptions when upgrading hardware or firmware. As part of the move

Displaying job detailsThe –show job -jobid command displays details for the specified VCEM job. The commandreturns a value that corresponds to the cur

Accessing the VCEMCLI helpObtain help by running the VCEMCLI without any arguments.GETTING STARTED:-help : displays a list of available commands and m

© Copyright 2011, 2013 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or

-targetport2 : The TCP port associated with the alternate target IP address.-tobayname : The name or number of the bay in the target enclo

3 Using VCEM commandsThis chapter describes VCEMCLI commands.add profileThe -add profile command creates a profile from the supplied description of a

Minimum required role-based securityVCEM Group AdministratorRemarksThis command creates a new unassigned server profile.VCEM fills empty attributes wi

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 –

RemarksYou can obtain the job status of non-blocking operations by executing the VCEMCLI with the –showjob command and providing the associated jobid.

export profilesThe -export profiles command exports server profiles to a CSV file for use with externaltools.Syntax-export profiles –exportfile <ex

move profileThe -move profile command moves a server profile across VC domain groups.Syntax-move profile —profilename <profile name> [-tovcdg &l

When –validate is specified, the job is not triggered; only precondition validation is performed.The CLI will return the results of the validation.28

remove profileThe -remove profile command removes a server profile from VCEM.Syntax-remove profile —profilename <profile name>ParametersTable 8

Contents1 Getting started...6VCEMCLI prerequisites...

unassign profileThe -unassign profile command unassigns the selected server profile.Syntax-unassign profile -profilename <profileName>Parameters

add enet-connectionThe -add enet-connection command adds a new Ethernet network connection to an existingserver profile in the VC domain.NOTE: The max

Table 10 Parameter descriptions for -add enet-connection (continued)OptionalRequiredDescriptionParameterxSpecifies the requestedoperational speed for

• Add a new Ethernet network connection to a profile:vcemcli -add enet-connection –profilename MyNewProfile –networkSomeNetwork• Add a new Ethernet ne

set enet-connectionThe -set enet-connection command modifies an Ethernet connection of a server profile.Syntax-set enet-connection –profilename <pr

Table 11 Parameter descriptions for -set enet-connection (continued)OptionalRequiredDescriptionParameterxSpecifies the requestedoperational speed for

• Change the associated network of an Ethernet connection:vcemcli -set enet-connection –profilename MyProfile2 -portnumber 1–network NewNetworkName• S

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>

Examples• Add a new FC SAN fabric connection to a profile:vcemcli -add fc-connection –profilename MyNewProfile –connectionbay5 –fabric SAN_5• Add a ne

add fcoe-connection...43set fcoe-connectio

set fc-connectionThe -set fc-connection command modifies an existing FC connection to a server profile.Syntax-set fc-connection –profilename <prof

Table 14 Parameter descriptions for -set fc-connection (continued)OptionalRequiredDescriptionParameterxIMPORTANT: The-bootport parameter isrequired on

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 profile.Syntax-add fcoe-connection –profilename <profile

Table 16 Parameter descriptions for -add fcoe-connection (continued)OptionalRequiredDescriptionParameterxSpecifies the port speed ofthe connection por

Minimum required role-based securityVCEM Group OperatorRemarksYou can obtain the job status for the jobid by executing the VCEMCLI with the –show jobc

set fcoe-connectionThe -set fcoe-connection command modifies an existing FCoE connection.Syntaxset fcoe-connection –profilename <profileName>

Table 17 Parameter descriptions for -set fcoe-connection (continued)OptionalRequiredDescriptionParameterThe default port speed ispreferred.IMPORTANT:

Examples• Change the fabric of a FCoE SAN fabric connection:vcemcli -set fcoe-connection –profilename MyProfile –portnumber 1–fabric SAN_5• Set a FCoE

remove fcoe-connectionThe -remove fcoe-connection command removes the last FCoE connection from an existingserver profile.Syntax-remove fcoe-connectio

Warranty information...109HP authorized resellers.

add iscsi-connectionThe -add iscsi-connection command adds a new iSCSI connection to an existing VC serverprofile.NOTE: The -add iscsi-connection comm

Table 19 Parameter descriptions for -add iscsi-connection (continued)OptionalRequiredDescriptionParameterxSpecifies the requestedoperational speed for

• Add a new iSCSI network connection and set the speed to preferred:vcemcli -add iscsi-connection –profilename MyProfile –networkMyNetwork –speedtype

set iscsi-connectionThe –set iscsi-connection command modifies the properties of a specified iSCSI connection.Syntax-set iscsi-connection –profilename

Table 20 Parameter descriptions for –set iscsi-connection (continued)OptionalRequiredDescriptionParameterxSpecifies the requestedoperational speed for

• Set the speed to preferred:vcemcli -set iscsi-connection –profilename MyProfile –portnumber 1–network MyNetwork –speedtype preferred• Modify the iSC

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 22 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterxNOTE: The-initiatornameparameter is required

Table 22 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterxNOTE: The-targetport2 parameteris required i

1 Getting startedThe HP Virtual Connect Enterprise Manager (VCEM) Command Line is a family of executables thatprovide the facilities necessary for the

Table 22 Parameter descriptions for -set iscsi-boot-param (continued)OptionalRequiredDescriptionParameterselection for this attribute isdisabled, whic

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 a new server port network mapping, and it allowsserver ports to be shared among multiple VC E

OutputThe function returns the result of the add operation or a jobid if –nb is specified.Examples• Add a new server port to a dedicated network mappi

set server-port-mapThe -set server-port-map command modifies the properties of a server port network mapping.Syntax-set server-port-map –profilename &

NOTE: When VCEM sets a VLAN ID in an untagged VLAN, it sets the VLAN ID to zero anddoes not return an error. This is because zero is the correct value

remove server-port-mapThe –remove server-port-map command removes a server port network mapping.NOTE: The –remove server-port-map command cannot be us

add server-port-map-rangeThe -add server-port-map-range command adds multiple network port mappings to aserver profile.Syntax-add server-port-map—rang

Table 27 Parameter descriptions for -add server-port-map-range (continued)OptionalRequiredDescriptionParameterhave the force sameVLAN mapping attribut

remove server-port-map-rangeThe -remove server-port-map-range command removes multiple network port mappingsfrom a server profile.Syntax-remove server

• Run scripts in response to HP Systems Insight Manager events or from the Windows jobscheduler.• Leverage the comma-separated values (CSV) export of

poweroff devicebayThe -poweroff devicebay command sends a power-off request to Virtual Connect Managerfor a given bay.Syntax-poweroff devicebay –enclo

• 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.v

poweron devicebayThe -poweron devicebay command sends a power-on request to Virtual Connect Manager fora given bay.Syntax-poweron devicebay -enclosure

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 32 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<Do

startvcdfwupdateThe -startvcdfwupdate command starts VC firmware updates on VC 3.50 or later domainswhen used in combination with VCSU 1.7.0 or later.

completevcdfwupdateThe -completevcdfwupdate command finishes a VC firmware update that was started usingthe startvcdfwupdate command on a VC 3.50 or l

startvcdmaintThe -startvcdmaint command starts the VC domain maintenance operation on the specifiedVC domain. For more information on the VCM operatio

Security on the CMSThe VCEMCLI is installed on the CMS. By installing on the CMS, you get the benefits of the securitymeasures already in place for th

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 and propagates changes across al

4 Error messagesTo help you troubleshoot symptoms, Table 41 (page 82), Table 42 (page 82) and Table 43 (page85) list error message numbers and descrip

Table 42 VCEMCLI error messages and descriptions (continued)Error message descriptionError message numberMultiple subcommands found.21Missing subcomma

Table 42 VCEMCLI error messages and descriptions (continued)Error message descriptionError message numberNo help information available.200JOB_FAILED22

Table 42 VCEMCLI error messages and descriptions (continued)Error message descriptionError message numberVlanId range list is invalid because %s is sm

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

2 Using the VCEMCLIThe VCEMCLI can be executed from the Windows command-line or from scripts written in anyWindows-supported scripting language.Execut

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to

Table 43 VCEM server error messages and descriptions (continued)Error message descriptionNOTE: The error message descriptions in this table use[x] to