12 command line interface usage in vcem – HP Insight Management-Software User Manual
Page 97
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 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
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]
Perform VC Server Profile failover on specified VC Domain bay server
97