Backup and Restore

There are two methods for backup and restore when using 1Integrate.

  • Back up and Restore Items

  • Full Repository Backup and Restore (only available to administrative users)

Note: Full repository backup and restore can only be carried out by an administrative user.

When performing the backup and restore of items, the following can be downloaded (backup) or uploaded (restore) from the Navigation Pane:

  • Data stores
  • Discovery specifications
  • Rules
  • Rule templates
  • Actions
  • Action maps
  • Sessions
  • Folders

Note: When uploading a backup from 1Integrate for ArcGIS, certain restrictions apply (see Uploading Items from 1Integrate for ArcGIS).

Backup Items

Performing a back-up downloads your chosen resources in JSON.

Note: You can use the Legacy Backup option to download in the old XML format.

Depending on the item you are downloading, the following will be true:

  • Sessions are downloaded with all the items needed for the run to complete, such as any rules, actions, or discovery specifications referenced in the session.

  • Rules and actions are downloaded with all referenced templates.

  • Action maps are downloaded with referenced rules and actions.

  • Folders are downloaded with the folder structure and all items within the folders.

Closedbackup an item

  1. Within the Navigation Pane, select the item to download.

    Note: Multiple items can be downloaded to the same JSON file by holding the Ctrl key and selecting items in the Navigation Pane. If you select a folder, all items within the folder will be downloaded and the folder structure will be retained. This will download an XML file if Legacyy Backup is used.

  2. Select Tools > Backup.

  3. Click Save (or click Save As and choose the download location).

    Your 1Integrate item is downloaded for future use.

Restoring Items

Uploaded items are placed in the folder structure defined by the location of the items in the backup. If identically named rules or actions already exist at those locations, they are restored with an increasing numbered suffix (e.g. Rule, Rule 2, Rule 3).

Note: File and password information is not included in the backups. If you are restoring file based data stores then you will need to upload all associated files and any data stores requiring password authentication will need their passwords re-entering.

When uploading an JSON or XML file, the system also uploads:

  • All referenced items in a session, such as rules, actions or discovery specifications
  • Any referenced templates within rules and actions
  • Any referenced rules and actions within action maps
  • All items within folders as well as the original folder structure
  • Any associated data stores for a session

Closedrestore an item

  1. Within the Navigation Pane, select Tools > Restore.

  2. Drag and drop files onto the screen, or click Browse then navigate to the file you want to upload and click Open.

    The window you upload a backup file to, either by drag and drop or clicking and browsing a file system.

    Drag and drop an item to upload

  3. Click Upload.

    Each item uploaded is displayed and reasons are given for any items that were not loaded.

    An example of the backup upload window showing a number of restored rules and their status as "OK".

    Items successfully uploaded

  4. Click Done to confirm the upload, or Upload More to select more files.

Backup and Restore Repository

From the Admin Interface of 1Integrate it is possible to perform a full backup and restore of the data contained in your repository.

Performance Tips

Performing a full Backup or Restore of your database can represent a memory intensive process, particularly where the repository contains a lot of data (e.g. datastore features, large sessions and a lot of rules).

We recommend ensuring that 1Integrate has 1GB of memory available per 10,000 items.

To increase the maximum memory allocated to your 1Integrate installation, please see Increase Memory.

ClosedBackup

To back up your entire 1Integrate repository, perform the following steps:

Note: You will need to be logged in as an administrator to perform a full repository backup.

  1. Navigate to the Admin tab of the 1Integrate interface.

  2. Select Download Backup.

    Note: Depending on the size of your repository this can take fairly significant amount of time.

ClosedRestore

To restore a repository, perform the following actions:

  1. Navigate to the Admin tab of the 1Integrate interface.

  2. Select Download Backup.

Note: You will need to be logged in as an administrator to perform a full repository backup.

The following will be true, depending on the status of your 1Integrate when you perform a restoration:

  • Objects only in 1Integrate and not contained in the restored files will be deleted.

  • Objects contained in both the restore data and 1Integrate will use the restored objects.

  • Objects only in the backup will be created in 1Integrate upon restoration.

Uploading Items from 1Integrate for ArcGIS

If uploading an XML backup from 1Integrate for ArcGIS, you will only be able to restore rules and actions (including their name, description and contents).

Additionally:

  • The ruleset and package structure will re-created in the folder structure of 1Integrate (including any descriptions).
  • The Created By property will be set to the current user.
  • The Created Date property will be set to the time of upload.

It is important to note the following restrictions when uploading items from 1Integrate for ArcGIS:

  • Quick rules and Quick actions are not imported. They must first be converted into normal rules and actions using the Make Rule or Make Action functionality within the 1Integrate for ArcGIS Rule Author.
  • Rule and action names must be no more than 255 characters. Trying to restore a rule or action with a name longer than 255 characters will cause an error when uploading.
  • Rules and actions must be complete and valid. Invalid or partial rules or actions will cause an error when uploading.
  • The connection between rules and actions is not maintained.
  • You cannot restore any titles (within the metadata) for rules, actions, packages or rulesets.
  • You cannot restore any comments within rules or actions.
  • Schemas are not imported.