Importing and Exporting

Skip to end of metadata
Comment: Migrated to Confluence 4.0
Go to start of metadata
Table of Contents
Expand all   Collapse all

Overview

Artifactory supports import and export of data on two levels: system-level and repository-level.

On the system-level, Artifactory can export and import the whole Artifactory server - configuration, security information, stored data and metadata. The format used is identical to the system backup format. This is useful for manually running backups and for migrating and restoring a complete Artifactory instance (this is an alternative for using database level backup restore).

On the repository-level, Artifactory can export and import repository stored data and metadata. This is useful for moving store data, including its metadata between repositories and for batch population of a repository.

System Import and Export

System import and export can be access through Admin:Import & Export:System

The source/target of the import/export operations are folders (or a zip archives - 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:

Import or exporting a big amount of data may take some time to complete. You do not necessarily have to watch the page and wait for the operation to finish - you can instead view the logs to determine when import/export completed (Admin:Advanced:System Logs).

Repositories Import and Export

System import and export can be access through Admin:Import & Export:Repositories

You can either export and import to and from server-side folders (browsable though Artifactory - see above), or import a repository by zipping it and uploading it to Artifactory.

You can also import directly into caches and can even take your local Maven repository and upload it into Artifactory to make all your already-locally-stored artifacts available on the server. You can choose if to import multiple repositories ('All Repositories') or a single one.

Import Layout

The expected layout of an imported repository is in the format of a Maven 2 repository layout.

When importing a single repository, the file structure within the folder you select should be similar to:

When importing all repositories, the file structure within the folder you select should be similar to:

When importing all repositories, make sure that the names of the directories that represent the repositories in the archive, match the names of the target repositories in Artifactory.
Labels:
None
Edit Labels

1 Comment

Hide/Show Comments

  1. Dec 15, 2010

    R Thomas

    Be aware that a when an "Entire System" is imported, that includes the admin account, which, assuming you're logged in as admin to perform the import, could prevent you from logging in again as admin after the import.  Be sure you know the admin login credentials of the "Entire System" being imported if they're different than the "Entire System" being overwritten.  It would be helpful if Artifactory's "Import Entire-System" function displayed an additional warning before allowing the current admin user to proceed with an action that wipes out the very admin account being used to perform the import.