Using Artifactory 5.x ?
JFrog Artifactory 5.x User Guide


Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Complete System Backup

You can automatically and periodically backup the entire Artifactory system.  The backup process creates a time-stamped directory in the target backup directory.

To define multiple backups, in the Admin module, select Services | Backups. Each backup may have its own schedule and repositories to either process or exclude.

Page Contents

Backup content is stored in standard file system format and can be loaded into any repository, so that Artifactory never locks you out.

Backing up very large filestores

If you are backing up more than 1TB of storage, please refer to this article in our Knowledge Base for instructions.

In the Backups page you may select an existing Backup to edit, or click "New" to create a new Backup.

Editing a backup configuration

Backup Key
A unique logical name for this backup
Cron Expression

A valid Cron expression that you can use to control backup frequency. For example, to back up every 12 hours use a value of: 0 0 /12 * * ?

Next Time Backup
When the next backup is due to run
Server Path for Backup

The directory to which local repository data should be backed up as files
The default is $ARTIFACTORY_HOME/backup/[backup_key]

Each run of this backup will create a new directory under this one with the time stamp as its name.

Send Mail to Admins if there are Backup Errors

If set, all Artifactory administrators will be notified by email if any problem is encountered during backup.

Exclude Builds
Exclude all builds from the backup.
Retention Period

The number of hours to keep a backup before Artifactory will clean it up to free up disk space. Applicable only to non-incremental backups.

Do not store any custom files under the target backup directory, since the automatic backup cleanup processes may delete them!

Verify enough disk space is available for backup
If set, Artifactory will verify that the backup target location has enough disk space available to hold the backed up data. If there is not enough space available, Artifactory will abort the backup and write a message in the log file.
Incremental

When set, this backup should be incremental. In this case, only changes from the previous run will be backed up, so the process is very fast.

The backup directory name will be called current (as opposed to using the timestamp)

The backup files can be used by any incremental file-system based backup utility (such as rsync).

Backup to a Zip Archie (Slow and CPU Intensive)

If set, backups will be created within a Zip archive



Monitoring Backup Progress

During a system backup, Artifactory writes several messages to the ARTIFACTORY_HOME/logs/artifactory.log file. To monitor progress of the backup process, look for messages that indicate the beginning and the end of a full system export as in the following example:

2016-06-09 02:00:00,023 [art-exec-1] [INFO ] (o.a.s.ArtifactoryApplicationContext:508) - Beginning full system export...
...
2016-06-09 02:00:00,357 [art-exec-1] [INFO ] (o.a.s.ArtifactoryApplicationContext:620) - Full system export completed successfully.

Restoring a Backup

To restore a system backup you need perform a system import. For details please refer to System Import and Export.





  • No labels