Performing Failovers From The Command Line

Command line interface can be used to perform failovers.

Before You Begin

Verify that no CSLiveSync backup or replication jobs are running. If there are any jobs that are currently running, wait for the replication jobs to complete before you initiate a planned failover.
After initial configuration or any failover (production, production maintenance, or test failover), make sure you allow a CsLiveSync backup and replication cycle to run before performing another failover. (Expect a full backup and replication to run after failover.)
Make sure that the SQL Client from both the production and standby CommServe hosts can communicate with the CommServe and with each other.

Tip

Open the Process Manager associated with the SQL Server client. From the Failover Assistant tab, under Node Information, make sure that both the Production Node and Passive Node(s) have the green light.
All the clients in the CommCell must be able to reach the standby CommServe host after the failover, either through a proxy or any other method used to communicate with the standby CommServe host.
If the CommServe is currently in a "lockdown" mode where client certificate authentication is forced during installation, reset the CommServe lockdown by setting the Force per-client certificate authentication option to No from the CommCell Console > Control Panel > Certificate Administration dialog box.

Open command prompt and navigate to the following folder associated with the SQL client:

<software_installation_folder>\base

For example: C:\Program Files\Commvault\ContentStore2\Base

Execute the following command:

Syntax:

CvFailover -OpType <OpType> -FailoverType <Failover Type> -TargetNode <Target Node Name>

Example:

To perform a production failover to a standby CommServe with the hostname My_standby_CS:

CvFailover -OpType Failover -FailoverType Production -TargetNode My_standby_CS

<OpType> can be one of the following operations:

Failover - To perform a failover operation.

GetFailoverConfig - To display the failover configuration status.

ResetFailoverOperation - To reset a partial failover operation.

ResetFailoverConfig - To reset an existing failover configuration. (To be used in case of xml corruption.)
<Failover Type> can be one of the following failover types:

Production - To perform a production failover.

ProductionMaintenance - To perform a maintenance failover.

MaintenanceFailback option - To reset maintenance failover.

Test - To perform a test failover.

TestFailback - To reset a test failover.
<Target Node Name> is the name of the target SQL client in the CommServe host to which the operation must be failed over.
-forceUnplannedFailover can be used when the setup is stuck and only when the target node is the node with latest database, to avoid major data loss.

The failover is initiated and the sequence of tasks performed during the process is displayed.

If client certificate authentication during installation was disabled before the failover, set the Force per-client certificate authentication option to Yes from the CommCell Console > Control Panel > Certificate Administration dialog box.