How to backup, duplicate and restore projects

A project consists of the following components

• data repository (required)
• mongo project data (required)
• plugins (needed if project uses modelling plugins or inspection features)
• user defined functions (needed if recalculating, editing or re-engineering data objects)
• source data files (needed if re-engineering or loading data from file)
• metadata and definition files (needed if engineering and scripting)
• templates (needed if export templates are required by the project)
• script files (may not be specific to a project )

The most robust and complete way of duplicating a project is to recreate the project from source data using script editor.   This will ensure that all data, definition files (including metadata, decodes, mappings etc), plugins, reports, templates and code snippets are present on the new system.   However it is possible to create a simple duplicate of a standard project on another system by copying repository and mongo data only. 

Data Repository

The data repository for the project will be a subdirectory of /datajet/repos that matches the project name.   This entire directory should be copied to the new location.  The name of the directory must not be changed.

Mongo Project Data

The mongo database contains the project metadata, including all object definitions.    To export a copy of the project data, use the backup command to generate a zip file: 

   {
    "method": "Backup",
    "path": "%DATAPATH%mybackup.zip",
    "project": "Demonstration"
  }

To add an exported project to a new server, copy the zip file to the new location and use the restore command to import the zip file into the new system.

{
    "method": "Restore",
    "path": "%DATAPATH%mybackup.zip",
    "targetProject": "DemonstrationCopy",
    "project": "Demonstration"
  }