Software Owner's manual

12 Failover Command Line Interface Usage in VCEM
VCEM provides support for two types of command line interfaces:
• Failover Command Line Interface—Performs several failover-related functions and is addressed
in this chapter. These same functions are also available in the VCEM GUI.
• The HP Virtual Connect Enterprise Manager Command Line Interface (VCEMCLI)—Can be
used as an alternate method for managing common Virtual Connect operations. The VCEMCLI
is also useful when scripting bulk operations on multiple Virtual Connect Profiles. See the HP
Virtual Connect Enterprise Manager Command Line Interface 6.3.1 User Guide for more
information.
Perform VC Server Profile failover on specified VC Domain bay server
This CLI command initiates a VC server profile failover operation. Options for specifying the source
server as the VC server 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 Server 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
116 Failover Command Line Interface Usage in VCEM