Staging the CommServe Database

Use the CommServe Recovery Assistant tool to stage your production CommServe database on another CommServe host for troubleshooting purposes.

Caution

This process must be used strictly for troubleshooting the CommServe database.
If you are using the tool for disaster recovery purposes, see Restoring the CommServe Database.

After recovery, the tool automatically performs post staging operations on the CommServe database, so that the CommServe host is not reachable to any clients or MediaAgents in the CommCell group. Also, all schedules are disabled after the restore.

Before You Begin

Review the following tasks:

  • Run a full backup of the CommServe databases on the destination CommServe host to ensure that no current activity is lost. For instructions on performing a Disaster Recovery Backup for a CommServe database, go to Performing a Disaster Recovery Backup.

  • Make sure that the destination CommServe host is at the same service pack level as the DR backup or higher.

  • Make sure that you have the latest version of the disaster recovery backup (SET_XXX folder) on the destination CommServe host.

    • If you have the disaster recovery backup files in the network location, copy the files to the local disk on the CommServe host.

    • If you have the disaster recovery backup files on a disk or tape media, see Retrieving Disaster Recovery Backup from Media.

Procedure

  1. On the CommServe computer, go to the Commvault\ContentStore\Base folder.

  2. Double-click CSRecoveryAssistant.exe.

  3. In the CommServe Recovery Assistant dialog box, click Staging / Troubleshooting, and then click Next.

  4. If you have already restored the CommServe database on this computer, select the Database already restored on this computer check box and click Next.

  5. In the Enter the path to the database dump folder box, enter or browse the name of the Disaster Recovery export folder (SET_XXX folder) where the dump files are located, and then click Next.

    Make sure the dump files are available on the local disk of the CommServe host.

  6. In the Enter the path to extract the database files box, type the destination path where you want the database to be restored and then click Next.

    Alternatively, click Browse and select the restore path.

    By default, all the database files are restored to the CommServe database path located on the destination CommServe host.

  7. In the Summary screen, review the selections, and then click Start Recovery.

  8. The tool now performs the following operations on the CommServe system:

    • Stop services on your CommServe computer

    • Restore the database to the specified restore path

    • Verifies and upgrades the database if required

    • Synchronize the CommServe system and the restored database

    • Run post operations on the CommServe computer

    When all the above operations are complete, click Next.

  9. The CommServe host name and client name of the destination CommServe host and the restored database are displayed. If the names are different, the tool also displays the updated host name and client name of the current CommServe host.

  10. If you are migrating the database from a non-clustered to a clustered environment, complete the following steps:

    1. Select the Convert to cluster check box.

    2. In the Physical Node text boxes type the names of the physical CommServe nodes as they appear in the Microsoft Failover Cluster Manager.

      Do not copy and paste the physical node name from the registry, or add the characters "_node" to the node name. The characters "_node" are automatically added to the physical node name during the database restore operation.

    3. Send the update status to the CommServe database by configuring the bSendUpdateStatusToCS additional setting.

      On the CommServe computer, add the bSendUpdateStatusToCS additional setting with value1. For instructions on adding the additional setting from the CommCell Console, see Adding or Modifying Additional Settings from the CommCell Console.

      Refer to the following table for applicable values:

      Property

      Value

      Name

      bSendUpdateStatusToCS

      Category

      UpdateFlags

      Type

      Integer

      Value

      Select one of the following values:

      1 - to send the update status information to the CommServe database during client service restarts

      0 - to disable the update status sync

  11. If you are migrating the database from a clustered to a non-clustered environment, select the Convert to non-cluster check box and click Next.

    A completion message appears.

  12. Click Finish.

What To Do Next

When finished, start all services on the destination CommServe host. See, Starting a Service.

Note

The admin password for the staged CommServe database is reset to admin.

Loading...