Using the latest JFrog products?
JFrog Platform User Guide
JFrog Distribution 1.x Documentation
To get the latest version, go to the JFrog Unified Platform
JFrog Distribution uses a PostgreSQL instance for data persistence. When configuring DR for JFrog Distribution, we recommend performing one of the following methods to allow Distribution to continue functioning properly:
- Hot Backup: Use PostgreSQL replication capabilities, to support a standby updated server containing all the critical data. It is recommended to set up the standby node in a different region.
- Cold Backup: Periodically take snapshots from Postgres containing all the critical data.
In the event that the master Distribution service goes down, a new Distribution service can be installed on the DR recovery machine, and connect to the standby PostgreSQL node as described in the following sections.
DR for a Docker Installation
Implementing DR for a Docker installation of JFrog Distribution involves the following main steps:
Preparing Snapshots of Home Folders
When installing the Master instance of your JFrog Distribution service, the DISTRIBUTION_MOUNT_ROOT variable is set (this defaults to /home/USER/.jfrog/distribution
). You need to keep backup snapshots of the Distribution and Distributor services Home folders: DISTRIBUTION_MOUNT_ROOT/distribution
DISTRIBUTION_MOUNT_ROOT/distributor
Exception
Make sure to exclude distribution.local.config.yml & distributor.local.config.yml from both folders.
Starting the DR Recovery Service
To get the DR recovery service up and running, follow the steps below:
- Install a new instance of JFrog Distribution. Make sure to install the same version used on the Master service.
- Provide a connection string to replicated PostgreSQL node.
- Provide a connection string to a Redis server. If you have not already done so, you will need to install one first.
Replace the DISTRIBUTION_MOUNT_ROOT/distribution folder with the one you backed up from the Master service installation.
Make sure to keep the distribution.local.config.yml and the distributor.local.config.yml files from the new installation.
Replace the DISTRIBUTION_MOUNT_ROOT/distributor folder with the one you backed up from the Master service installation
Make sure to keep the distribution.local.config.yml and the distributor.local.config.yml files from the new installation.
Run the new JFrog Distribution installation.
DR for a Linux Installation
Implementing DR for a Linux installation of JFrog Distribution involves the following main steps:
Preparing a Snapshot of the Data Folder
When installing the Master instance of your JFrog Distribution service, the Distribution data folder was set (this defaults to /var/opt/jfrog/distribution
). You need to keep a backup snapshot of this folder.
Exception
Make sure to exclude distribution.local.config.yml and the distributor.local.config.yml from the folder.
Starting the DR Recovery Service
To get the DR recovery service up and running, follow the steps below:
Install a new instance of JFrog Distribution. Make sure to install the same version used on the Master service.
Provide a connection string to replicated PostgreSQL node.
Provide a connection string to a Redis server. If you have not already done so, you will need to install one first.
Replace the Distribution data folder with the one you backed up from the Master service installation.
Make sure to keep the distribution.local.config.yml and distributor.local.config.yml files from the new installation.
Run the new JFrog Distribution installation.