Loading...

Recovering the CommServe Database Using the Command Line Interface

 Use the command line interface to run the CommServe Recovery Assistant tool that will recover the CommServe databases from a disaster recovery backup.

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.
  • If you are restoring to a different or a new CommServe host, obtain a new IP address change license from your software account manager or support..
  • 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.
  • If you are using this procedure to recover the CommServe database from a disaster or for hardware refresh or to test DR recovery in maintenance mode, stop services on the original production CommServe host.

Procedure

To run the CommServe Recovery Assistant tool from the command line interface:

  •  On the command line, go to Software_Installation_Directory/Base and type the command after substituting the appropriate parameter values.

    Note: The parameters marked within [ ] are optional.

    CSRecoveryAssistant.exe -operation operation mode -skipdump -dbdumplocation db dump location [-dbfilelocation 'path to extract the database files'] [-groupName 'test failover group name'] [-license 'path to new license file'] [-tononcluster] [-tocluster 'physical node1,physical node2']

    For information on supported parameters, see Command Line Parameters for CommServe Recovery Assistant Tool.

Examples

  • To recover the databases to the same CommServe host:

    CSRecoveryAssistant.exe –operation Recovery –dbdumplocation “c:\dr\set_xxx”

  • To recover the databases to a different CommServe host:

    CSRecoveryAssistant.exe –operation Recovery –dbdumplocation “c:\dr\set_xxx” –license <path>

  • To stage the CommServe databases for troubleshooting purposes:

    CSRecoveryAssistant.exe –operation Staging –dbdumplocation “c:\dr\set_xxx”

  • To disable all the clients except the clients present in a client group :

    CSRecoveryAssistant.exe –operation Maintenance –skipdump -groupName "Test_Failover_Group"

Result

After the DR restore, you will notice a considerable increase in the job ID for new jobs. This increase is added to avoid conflicts with job IDs referenced in the deduplication databases (DDBs) when the DDBs are resynchronized.

What to Do Next

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