System Import and Export for an HA Cluster

JFrog Artifactory Documentation

JFrog Artifactory
Content Type
User Guide

When performing a system export and subsequent import for an HA cluster, you need to follow the procedure below to ensure that the cluster is able to correctly synchronize its nodes.


When importing from a 6.x export into a 7.x installation, you will need to replace the logback.xml in the export with a 7.x logback.xml, otherwise logging will break during import.

Set a Target Artifactory
  1. Perform a normal system export from the source cluster as described above.

  2. In the target cluster, keep only one node running, and perform a graceful shutdown to all the rest of the nodes.

  3. Perform normal system import to the target cluster (which now has only one node running) as described above.

  4. For Artifactory versions below 7.12.0, perform a graceful shutdown of the running node and then restart it.

  5. For each additional node:

    1. Delete the following folders:

      • $JFROG_HOME/artifactory/var/etc/access

      • $JFROG_HOME/artifactory/var/etc/security

      • $JFROG_HOME/artifactory/var/etc/artifactory/ui

      • $JFROG_HOME/artifactory/var/etc/artifactory/plugins

    2. Copy the $JFROG_HOME/artifactory/var/etc/security/master.key from the running node to the additional nodes.

    3. Start up the additional nodes.

Once you have completed the import, we recommend verifying that your HA cluster is up and running by checking whether all the nodes and services are online. For more information on viewing service status, see Monitoring Service Statuses.Monitoring Service Statuses


After an import, the services of Distribution, Xray, Pipelines, and Insight should be restarted.