ADx and Conversion packages contain the
restore-backup.sh scripts. As a best practice, we recommend to use those scripts to back up your current installation before installing a new version. In case of errors in the new version, you can quickly restore the working runtime from a backup package. Update procedure is the same for ADx and Conversion.
Note that these scripts only back up ADx/Conversion installation and NOT the whole system (which relies on external components, such as databases, file systems or cloud storage at your organization). To back up the whole system you need to follow your organization guidelines for backing up the external components, in addition to backing up ADx/Conversion installation.
On this page
All files in the installation root. These include existing ADx/Conversion runtime and its configuration, as defined in the installation settings file at the time when ADx/Conversion was installed:
- Installation license
- Default admin user
- Tribefire-services URL
- Database connection settings (but NOT the database data!)
- File system paths used (but NOT the file system data itself!)
- Default repository settings - if they were used
- Runtime properties
Essentially, the entire ADx or Conversion installation directory that you enter in
create-backup.sh is backed-up as a
The backup script creates a backup of a single installation folder. Therefore, the backup does NOT include:
- Any database data, i.e. neither system nor business data!
- Any files shared between the cluster nodes, such as business files (documents, images) and Elasticsearch data!
- Any other files which are not part of the installation root. This depends on the installation settings, but log files and temporary files are not included by default.
If you changed the installation settings when previously installing ADx/Conversion so that any of the files mentioned above are written to the installation folder, they will also be backed up. This is not a recommended practice though and it will cause backups to be larger and slower.
Our backup script creates a
.zip package from a valid ADx/Conversion installation directory.
Open the deployment package. The following files should be available (for example when you list with
./create-backup.sh --installationFolder [installation folder] --backupFolder [backup folder]. Assuming your installation folder is
/opt/braintribe/adx/installation, and you want to create the back-up archive in
/opt/braintribe/adx/backups, you need to execute the following command:
./crate-backup.sh --installationFolder /opt/braintribe/adx/installation --backupFolder /opt/braintribe/adx/backups
You can also use aliases:
As a result, a
.ziparchive with a timestamp (similar to
adx-20200206-132812.zip) containing your installation files is now available in
/opt/braintribe/adx/backups. The script allows creating multiple archives in the same folder.
For command-line help, run
Restoring an installation essentially means un-zipping previously created backup package into a new directory.
Open the deployment package.
restore-backup.shshould be available among other files.
./restore-backup.sh --backupArchive [backup archive] --installationFolder [installation folder]. Assuming your backup directory is
/opt/braintribe/adx/backups, you want to restore from the
adx-20200206-132812.ziparchive, and you want to restore ADx in
/opt/braintribe/adx/restored_installation, you need to execute the following command:
./restore-backup.sh --backupArchive /opt/braintribe/adx/backups/adx-20200206-132812.zip --installationFolder /opt/braintribe/adx/restored_installation
You can also use aliases:
--installationFolder. To see command-line help, run
As a result, the following happens:
- If your
--installationFolderdirectory already contained an ADx or Conversion runtime before, it is backed up into a new directory. This new directory is appended with a timestamp-based suffix, such as
installation-folder-backup-20201224-123456. If the
--installationFolderdirectory didn't exist before, it is now created. If it exists, but doesn't contain a valid runtime, the restore script will fail.
- Files from the archive are unzipped into the
--installationFolderdirectory, replacing the original runtime (unless the directory was only created now).
You can now start the restored ADx runtime! To do so, open the restore directory, go to
- If your