Restore a backup from a previous version via Backups

If you restore a backup that was created in a previous major Collibra Data Intelligence Cloud version via the Backups page, you then have to upgrade the database, as described in this section.

However, we highly recommend to follow this procedure if you restore a backup from a previous major version.

Tip  If your backup was created in the same version as your current environment, follow the restore a backup procedure.

Warning 
  • If you restore a backup, you will lose all current Collibra data.
  • Backups from versions older than 5.5.x do no include certificates. You have to reinstall any necessary certificates, for example for secure communication with the Jobserver.

  • If you restore a backup that does not include history and was made from a version older than 5.7.x, the data quality metrics will not work correctly. To solve this issue, after you restore the backup in your latest environment, upgrade the data, create a new backup and restore the new backup in the same environment.

Steps

  1. Open Collibra Console with a user profile that has at least the ADMIN role.
    Collibra Console opens with the Infrastructure page.
  2. In the main menu, click Backups.
    The backups page appears.
  3. Click Restore in the row of the backup that you want to restore.
  4. Fill in the Restore from backup form:
    OptionDescription
    EnvironmentSelect the environment in which you want to restore the backup.
    BackupSelect the backup that you want to restore.
    Include

    You can restore a backup fully or partially.

    Note The backup itself should include the items you select below. For example, if the backup does not contain the configuration and you include configuration for restoring the backup, it will be restored successfully, though without the configuration.

     Data
    		Select to include the core (database) data from the backup. This is all the data related to communities, domains, assets, users, operating model and so on.
     History
    		Select to include all historic data (activity and snapshot-related) from the backup.
     Configuration

    Select to include the configuration and license from the backup.

    Warning Do not select this option if you restore a backup from another environment, as this will overwrite the configuration of your current environment. It can prevent your environment from starting up again.

     Customizations

    Select to include custom modules, styling, page-definitions and email template files.

    This will add files to the Collibra user home directory and files that are used to customize the Collibra DGC instance (/opt/collibra_data/console/config). This concerns all the files in the following directories:

    • email-templates
    • groovy-lib
    • images
    • page-definitions
    • security
    • styling
    • translations
    • modules (if available)

  5. Click Restore backup.
  6. Click Close.
    When the restore is complete, your environment will be partially running.
  7. In the main menu, click Infrastructure.
  8. Click the name of the environment that is partially running.
    The details of the environment appear.

  9. Click Upgrade to start the upgrade of your restored data.
  10. In the Upgrade dialog box, click Upgrade.
    After the upgrade, your environment is up and running again.
Note 

If you look in the upgrade logs (upgrade-task.log), you will see one of the following lines near the end:

  • INFO - COMPLETED Upgrade the database version to [5.2]
  • INFO - *** Results of upgrade from version 5.1 to version 5.2 ***

This means that the repository has upgraded to 5.2 at this point. The upgrade to a later version, for example 5.7.10, is performed during the start of the DGC service and is therefore not logged in this log file, but in dgc.log, which you can find in the diagnostic file.