HP StoreOnce Backup System CLI Reference Guide

hardware failover
NOTE: This information applies to multi-node products.
Description of Command Function
Forces the implementation of the high availability feature for the file server node defined within
the command. After this command is executed, the backup node within the couplet takes over the
service set functions originally residing on the defined node.
Command Syntax
hardware failover NODEX
Command Authority
Administrator
Command Object Requirements
NODE X – this object must appear in the command entry after hardware failover. NODEX is
used to define an individual file server node. X is a unique numeric index. NODEX is a label uniquely
defining the hardware component. It is assigned during the initial automatic hardware initialization
and configuration, and its value resides in the node_config file. A complete list of the NODEX
labels can be obtained using the hardware show node status command (see “hardware
show node status” (page 80)).
Command Parameter Requirements
Not applicable – no parameters exist within this command.
Requirements for Command Execution
• The command entry must conform to command syntax.
• The node to which failover is to occur must be in a Good state.
Successful Command Output
Upon successful completion of the command, the following is displayed:
NODEX has successfully failed over, where NODEX is the file server node defined in
the command entry.
Command Operation during Abnormal Conditions
If the command does not conform to the required syntax the following is displayed:
Command Failed - the command does not conform to the required syntax,
SYNTAX, where SYNTAX is the command syntax as described under Command Syntax in this
section.
Example
# hardware failover node1
NODE1 has successfully failed over
hardware failover 69