Migrate Your Filestore 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, you need to 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 be configured to perform the filestore migration automatically. To do so, you need to create the following links in $JFROG_HOME/artifactory/var/data/artifactory/eventual/(create it if the eventual folder does not exist - it is created automatically when the eventual binary provider is applied via an Artifactory restart 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