Artifactory maintains all security entities (users, groups, permissions and access tokens) when doing a system import.
Note
The System Import and Export feature is not available for Artifactory Cloud users.
Copy the $JFROG_HOME Master Key
Copying the $JFROG_HOME/artifactory/var/etc/security/master.key is a critical step in the import process - for both single node and HA imports. The master.key is an AES secret key (128 or 256 bit) that is used by Artifactory for encrypting and decrypting the shared data in the database and is, therefore, required for the import process.
Warning
We do not recommend that you import and export between different versions of Artifactory.
Tip
It is very important that the import files on the server should be readable and owned by the same user running the Artifactory process.
Note
Although we do not recommend it, when you import from a 6.x export into a 7.x installation, you need to replace the logback.xml in the export with a 7.x logback.xml otherwise logging will break during import.
To access import and export of your entire system, in the Administration module, select Artifactory | Import & Export | System.
Field | Description |
|---|---|
Export Path on Server | The target directory for the exported files. You may browse your file system to select the directory |
Exclude Content | Export: When set, repository binaries are excluded from the export. Import: When set, binaries and metadata are excluded from the import. Only builds and configuration files are imported. |
Exclude Metadata | When set, repository metadata are excluded from the import/export. (Maven 2 metadata is unaffected by this setting) Docker repositories must have metadataFor Docker repositories to work they must have their metadata intact. Therefore, if you have Docker repositories, make sure that Exclude Metadata is not checked when doing a system export or import. |
Create .m2 Compatible Export | When set, includes Maven 2 repository metadata and checksum files as part of the export |
Create a Zip Archive (Slow and CPU Intensive!) | When set, creates and exports to a zip archive. NoteIf there is failure when you import a zip file, extract the zip file to a folder and select the extracted folder for import. |
Output Verbose Log | When set, lowers the log level to "debug" and redirects the output from the standard log to the import-export log. Monitoring the logYou can monitor the log in the System Logs page. |
The source/target of the import/export operations are folders (Zip archives are not recommended) on the Artifactory server itself.
You can use the built-in server-side browsing inside Artifactory to select server-side source/target folders:
Note
Importing or exporting a large amount of data may be time consuming. During the import/export operation you can browse away from the page and sample the System Logs to monitor progress.