Planned Failovers

A planned failover can be performed to alternate between the active and passive CommServe hosts.

Before You Begin

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


  1. Log on to either the production CommServe host computer, or the standby CommServe host computer.
  2. Click Start and point to All Programs.
  3. Click Commvault > Process Manager. Open the Process Manager associated with the SQL client.

    Tip: The SQL client will have the Failover Assistant tab as shown in the following sample image.

  4. On the Failover Assistant tab, select the following options:
    • From the Failover To list, click the name of the passive node that must be used for performing the failover.
    • From the Failover Type list, click Production.
  5. Click Initiate Failover.
  6. On the Confirm prompt, type confirm and click Ok.


  • The failover is initiated and the sequence of tasks performed during the process is displayed in the Process Manager window.
  • If a floating CommServe name is not used, make sure to open the CommCell Console and Command Center from the new active CommServe host, after a successful failover. (Type or choose the name of the active CommServe host in the CommCell list displayed in the Connect to CommCell dialog box.)

    Recommendation: To ensure that the Commcell Console and Command Center points to the correct CommServe, use a floating name. Even if the CommServe is not installed with a floating name, you can create a virtual DNS record and point to the IP address associated with the active CommServe. For other alternatives, see Third-Party Port Mappings (TPPM or Network Proxy).

    If you have failed over to a CommServe host located in a Cloud, or behind a firewall where port 8401 (GxEvMgrS port) is not reachable, make sure to enable the Connect through firewall option, click the Configure button, and then specify the proxy computer details in the Proxy hostname or IP address and Proxy port number boxes. Ideally this proxy computer must be a standalone computer which is accessible to both the CommServe host and the clients.

Caution: If there is a failure during a planned failover, follow the steps described in Unplanned Failovers to failover to the standby CommServe host.

Post Failover Tasks for a CommServe Using A Floating CommServe Name

Perform the following steps after a failover:

  • Update DNS to re-point the floating CommServe name to the IP address of the standby CommServe host. For information on changing the IP address, refer to the documentation associated with DNS software implemented in your environment.
  • Test and verify that the floating CommServe host resolves to the IP address associated with the standby CommServe host using ping or the equivalent network command.
  • If you have Data Interface Pairs (DIP) defined, make sure that the floating CommServe name is used to connect to the CommServe. This is especially important in older setups where DIPs was configured before setting up the LiveSync feature.

    For more information about setting up DIPs, see Dedicated Backup Network.

  • If clients connect to the CommServe using the two-way Commvault network routes (or network throttle routes), use the following steps to push the network configuration to all clients after a failover.
    1. From the CommCell Browser, open Network Topologies.
    2. Right-click the network topology, and then click Push Network Configuration.
  • If clients connect to the CommServe using one-way network routes from the client to the CommServe, perform the following steps to maintain the floating CommServe Hostname in the DB and registry.
    1. Navigate to the following folder in the active CommServe:

      Program Files\Commvault\ContentStore\Base

    2. Use the following command to set the the floating CommServe Hostname in the DB and registry.

      SetPreImagedNames.exe CSNAME -hostname <CS_Floating_Name> <CS_Physical_name> -skipodbc -passiveCS

      For example:

      SetPreImagedNames.exe CSNAME -hostname floatingCS.company.com passiveCS.company.com -skipodbc -passiveCS

    3. Restart the Commvault Communications Service (GxCVD)on the CommServe. For more information about restarting services, see Restarting a Service on Windows Clients.

Last modified: 12/24/2019 9:41:14 PM