Filestore Migration to S3

There are two ways to migrate your filestore over to your S3 provider.

• Manually (recommended)
• Automatically

Manual Filestore Migration (Recommended)

To migrate your filestore manually, execute the following steps:

1. Stop Artifactory.
2. Copy the $JFROG_HOME/artifactory/var/data/artifactory/filestore directory to your S3 object storage to the bucket name and path specified when you configured Artifactory to use S3.
3. Configure Artifactory to use S3 in the binarystore.xml file in the $JFROG_HOME/artifactory/var/etc/artifactory folder.
4. Start Artifactory.

Automatic Filestore Migration

Artifactory can perform the filestore migration automatically. Create the following links in $JFROG_HOME/artifactory/var/data/artifactory/eventual/ (create the folder if it does not exist — it is created automatically when the eventual binary provider is applied after restarting Artifactory with an updated binarystore.xml):

• A link with the name _add that points to the $JFROG_HOME/artifactory/var/data/artifactory/filestore directory
• A link with the name _pre that points to the $JFROG_HOME/artifactory/var/data/artifactory/filestore/_pre directory

With this setting, as soon as Artifactory starts up, it will automatically move your complete filestore over to your S3 provider. Artifactory validates each file uploaded to S3 and removes the file from the NFS if the transfer is successful.

⚠️

Your current filestore will be deleted

The process of moving your filestore to your S3 provider will delete your current filestore. We strongly recommend you do a complete system backup before doing this migration.

✅

Tip

Once the migration is complete, you may delete the _pre link and the $JFROG_HOME/artifactory/var/data/artifactory /_pre directory