Predefined Workflow - DR Testing

Table of Contents


Use the predefined DRTesting workflow to test the disaster recovery (DR) setup in your environment. The DRTesting workflow is useful when you are setting up a DR environment. This workflow performs a DR backup and restore of the production CommServe database on the DR CommServe. Next, the selected clients and MediaAgent are migrated to the DR CommCell and a test restore of the source subclient backup is performed. Finally, the clients and MediaAgent are reverted to the production CommCell and the test result is emailed to the administrator.

This workflow can be manually executed from the CommCell Console.

How does it work?

The DRTesting predefined workflow performs the following automated operations:

  1. Disables the MediaAgent and DDB mount path, and stops all Services on the MediaAgent. Make sure there are no running jobs on the MediaAgent used for the test.
  2. Performs a DR backup of the production CommCell to the DR CommServe.
  3. Retrieves the latest DR backup file and performs the DR restore operation on the DR CommServe. The DR restore job also includes some post recovery operations, such as disabling the scheduler, suspending all running jobs, and enabling just the restore activity.

    Do not uninstall any of the CommServe components on the DR CommServe during this phase.

  4. Remove the Data Interface Pairs (DIP) that point to the Production CommServe for all MediaAgent and clients used for the test. Also, ensure that you do not create a new DIP between the DR CommServe and the client computer.
  5. Starts the Services on the MediaAgent.
  6. Performs a name change operation. In this phase, the selected client and MediaAgent are moved to the DR CommCell.
  7. Enables the MediaAgent and completes a test restore of the specific subclient.
  8. When the restore operation is complete, reverts the MediaAgent and client to the production CommCell.

The reversion phase includes the following operations:

  1. Stops Services on the DR CommCell.
  2. Performs name change operations to move the client and MediaAgent back to the production CommCell.
  3. Performs readiness check to ensure that client and MediaAgent connectivity with the CommServe are restored.


Prior to executing the workflow, ensure the following:

  • No jobs are running on the MediaAgent or client used for the test
  • Microsoft SQL studio application is not running on the DR CommServe

Running the Workflow

To verify your DR setup, run the DR Testing workflow using the following steps:

  1. From the CommCell Browser, go to Workflows.
  2. Right-click DRTestingWorkflow and then click All Tasks > Execute.
  3. On the Inputs tab, from the Run workflow on list, select the workflow engine  and enter the value of the following variables in the Value column:
    • For ProductionCSUsername, specify the user name with administrative privileges on the production CommServe.
    • For the ProductionCSPassword, specify the password for the production CommServe user name.
    • For DRCSName, specify the fully qualified DR CommServe name.
    • For DRCSUsername, specify the CommCell username with administrator privileges to execute the workflow.
    • For DRCSPassword, specify the password for the DR user name.
    • For DRCSComputerUsername, specify the user name to access the DR CommServe computer.
    • For DRCSComputerPassword, specify the password for the DR CommServe computer user name.
    • For DRCSSqlPassword_sa_user, specify the SQL user name for the DR CommServe.
    • For IsProdCSandDRCSonSameDomain, specify 'True' if the production and DR CommServes are on the same domain.
    • For dbDumpPath, specify the location where the DR backup dump file is created on the DR CommServe.
    • For clientList, specify the client computers used for the DR testing.
    • For mediaAgent, specify the fully qualified name of the MediaAgent computer used for DR testing.
    • For MAComputerUsername, specify the user name to access the MediaAgent  computer.
    • For MAComputerPassword, specify the password for the MediaAgent user name.
    • For IsProdCSandMAonSameDomain, specify 'True' if the production CommServe and the MediaAgent computer are on the same domain.
    • For SubclientName, specify the name of the subclient that is used for backup on the source client.
    • For sourceClient, specify the source client name that has the data to be restored as part of the DR testing workflow.
    • For restoreClient, specify the destination client name on which the data will be restored as part of DR testing workflow.

      If you are using a single client for the test, specify the same client name for the sourceClient and restoreClient input variables.

    • For sourcePath, specify the location of the data used for the restore on the source client.
    • For destinationPath, specify the location on the restore client where the data is restored.
    • For CopyPrecedenceNumber, specify the precedence number of the auxiliary copy to be used for the test restore operation. By default, the secondary auxiliary copy is used for the test restore operation.
    • For EmaiID, specify the email address of the administrator who will receive the workflow notifications. To send an email to multiple users, specify the email addresses separated by a comma (,).
  4. Click OK.

    You can track the progress of the workflow job from the Job Controller.

When the workflow is complete, the administrator receives an email on the workflow result.

  • If the workflow job completed successfully, the administrator can verify the restored files on the destination client and confirm that the workflow was successful.
  • If the workflow job failed, the reason for the failure is included in the email.