Skip to main content
Delphix

How to backup and restore a Mission Control Engine configuration

Methodology for backing up and restoring a Mission Control Engine configuration

Issue

In extreme cases, a redeployment of Mission Control OVA may be required.  As this would require re-adding all of the configured Delphix Engine parameters, it can result in a significant amount of busywork to be performed by the sysadmin.  

Resolution

In order to work around this worst-case scenario, a backup/restore script backup-restore-config.py can be leveraged to save the existing engine configuration in JSON format, to be relocated from the VM and later restored.

This mechanism does NOT backup any historical data collected, or custom reports; only engine configuration is captured.

The current implementation of this script resides in dlpx-app-gate, but is not distributed with the product today.  The latest version of this script is updated by MC-425, which removes working path requirements.  If this version cannot be located from a current dCenter Delphix engine (/export/home/delphix/dlpx-app-gate/appliance/controller/tools/), or from your local git repository, a copy of the script is attached to this document.

Backup

To perform a backup of Mission Control:

  1. scp the backup-restore-config script to Mission Control VM.

    -bash-4.3$ scp backup-restore-config.py root@<missioncontrol>:~/
  2. Execute the script with backup (-b) and JSON file (-j) options.  If the operation is successful, no output is expected.

    -bash-4.3$ ~/backup-restore-config.py -b -j ~/mcbackup.json
  3. scp the resulting JSON file to another location.

    -bash-4.3$ scp ~/mcbackup.json <user>@<remotehost>:<path>

Restore

To perform a restore of engine data to Mission Control:

  1. scp the backup-restore-config.py script and JSON backup file to Mission Control VM.

    -bash-4.3$ scp backup-restore-config.py root@<missioncontrol>:~/
    -bash-4.3$ scp mcbackup.json root@<missioncontrol>:~/
  2. Execute the script with restore (-r) and JSON file (-j) options.

    -bash-4.3$ ~/backup-restore-config.py -r -j ~/mcbackup.json
    Adding host: ac5021.dcenter.delphix.com...
    Successfully added host: ac5021.dcenter.delphix.com
    Adding host: sean5022.dcenter.delphix.com...
    Successfully added host: sean5022.dcenter.delphix.com
    .
    .
  3. Verify the engines are now present in GUI, or by checking MongoDB.

    [root@mission-control ~]# mongo delphix
    MongoDB shell version: 2.6.4
    connecting to: delphix
    
    
    > db.delphixEngines.find().pretty()
    {
    	"_id" : "sean5022.dcenter.delphix.com",
    	"username" : "delphix_admin",
    	"password" : "password",
    	"version" : "Delphix Engine 5.0.2.2",
    	"tag" : "",
    	"status" : "Connected"
    }
    {
    	"_id" : "ac5021.dcenter.delphix.com",
    	"username" : "delphix_admin",
    	"password" : "delphix",
    	"version" : "Delphix Engine 5.0.2.1",
    	"tag" : "",
    	"status" : "Connected"
    }
    .
    .
     
Topic Type internal_kb
Delphix Engine Version  
Database Platform  
Operating System  
Subject Area System Administration
Effective Date of this Article 05.19.2016
Last Modification of this Article 06.16.2016
This Article Scheduled for Review 09.14.2016
  • Was this article helpful?