Performing Test Failovers in a Linux Environment

A test failover can be performed to ensure that the failover process succeeds and the services are successfully started. Test failovers do not affect the current jobs and activities on the production CommServe host. Note that backups and restores are not allowed from the standby CommServe host during a test failover.

Before You Begin

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. (This setting can be re-enabled once the failover is completed.) For more information on client certificates, see Client Certificates - Enforcing Authentication of Client Certificates during Installations.

Procedure

1. Log on to either the production CommServe host, or the standby CommServe host.

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

   For example: opt/commvault2/Base

3. Execute the following command to perform a planned test failover, to the SQL client in a standby CommServe host:

   ./CvFailover -OpType Failover -FailoverType Test -TargetNode StandbySQLClient

   Syntax:

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

   Where:

   • <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.

Result

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

What to Do Next

After the successful completion of a test failover, reset the test failover.

Related Topics

• Production failovers can be performed to alternate between the active and passive CommServe hosts. For more information, see Performing Production Failovers.

• Maintenance failovers can be performed to install the Commvault Feature Release on the CommServe hosts. For more information, see Installing Feature Releases On High Availability CommServe Host Setup.