HP Virtual Connect Enterprise Manager Software - Manual (Page 83)

12 Command Line Interface usage in VCEM
VCEM provides support for a command line interface (CLI) to perform several failover-related functions. These
same functions are also available in the VCEM GUI.
Perform VC profile failover on specified VC Domain bay server
This CLI command initiates a VC profile failover operation. Options for specifying the source server as the
VC profile failover target are:
•
Specifying a VC Domain enclosure name and bay number as the source server
>vcem –failover –bay “EnclosureName:BayNumber”
•
Specifying a VC Domain bay server host name as the source server
>vcem –failover –host “BayServerHostname”
•
Specifying a VC Domain bay server IP address as the source server
>vcem –failover –ip “BayServerIPAddress”
If the CLI Failover command for any of these three options is successful, the exit code from the CLI is
zero, and the following example output displays (through stdout) on the screen. The CLI also displays
the job number of the VCEM Failover job (represented by N below) that has just been initiated.
Performing VC Profile Failover on the specified VC Domain Bay Server...
VC Profile Failover has been initiated: "EnclosureName:BayNumber"
VCEM Failover Job Number is: N
Performing VC Profile Failover on the specified VC Domain Bay Server...
VC Profile Failover has been initiated: "BayServerHostname"
VC Profile Failover Job Number is: N
Performing VC Profile Failover on the specified VC Domain Bay Server...
VC Profile Failover has been initiated: "BayServerIPAddress"
VC Profile Failover Job Number is: N
If the CLI Failover command for any of these three options has failed, the exit code is some value greater
than zero and the associated error message appears. The following shows some output examples.
Performing VC Profile Failover on the specified VC Domain Bay Server...
ERROR (30) - Could not initiate VC Profile Failover
Internal VCEM Error Code: 5013
Internal VCEM Error Message: Specified server bay number is out of range, it must be between 1 – 16.
Performing VC Profile Failover on the specified VC Domain Bay Server...
ERROR (30) - Could not initiate VC Profile Failover
Internal VCEM Error Code: 5058
Internal VCEM Error Message: Enclosure name contains too many characters - limit is 32
Performing VC Profile Failover on the specified VC Domain Bay Server...
ERROR (30) - Could not initiate VC Profile Failover
Internal VCEM Error Code: 5009
Internal VCEM Error Message: Invalid format for IP address - it must be: [0-255].[0-255].[0-255].[0-255]
List details for specified VCEM job
This CLI command can be used to list the details and status for a particular VCEM job and can be used to
determine the status of a CLI failover job.
Perform VC profile failover on specified VC Domain bay server 83