Migrate to the Artifactory Federation Service

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

Use the JFrog CLI to migrate your repository Federations (including their configuration, states, and events) from the legacy Federation service in Artifactory to the standalone Artifactory Federation Service that was introduced in release 7.104.5. This topic also describes how to return (rollback) to the legacy service, if required.

Note

It is recommended to verify that no Full Sync operations are in progress before starting the migration process.

Prerequisite

You must activate the Artifactory Federation Service before performing migration. For more information, see Install the Artifactory Federation Service.Installing Artifactory Federation Service

Install the Plugin

Run the following command to install the migration plugin from the official registry of JFrog CLI plugins:

jf plugin install federation-migrator

This command installs the plugin and the jar of the migration tool, which performs all required operations with one command.

Migration Procedure

Run the following command to execute the migration to the standalone Federation service:

jf federation-migrator migrate_rtfs <base url without /artifactory> <access token>

Note

It can take anywhere from a few seconds to several minutes to complete the operation. You do not need to restart Artifactory after performing migration.

Note

For details about generating an access token, see Access Tokens.Access Tokens

Verify Migration Status

Perform the following steps to verify that the migration has succeeded:

  1. Execute the following API: curl -X GET -uadmin:password "http://{{artifactory_url}}/artifactory/api/federation/migration/status"

    If the service has been enabled, this API will return the status of the migration:

    MIGRATION_STARTED
MIGRATING_EVENTS_TO_RTFS
MIGRATION_COMPLETED

    If the service has not been enabled, this API returns: Status not configured

  2. Execute the following API to verify that migration has completed: curl -X GET -uadmin:password "http://{{platform_url}}/federation/rtfs"

    The API will return true if migration has completed successfully.

  3. The new Federation monitoring dashboard should be available in the platform UI. In the Administration module, go to Monitoring > Federation. For more information, see View the Status of All Repository Federations.

Rollback Procedure

Run the following command to return to the legacy Federation service:

jf federation-migrator migrate_rt <base url without /artifactory> <access token>

Note

It can take anywhere from a few seconds to several minutes to complete the operation. You do not need to restart Artifactory after returning to the legacy Federation service.

Tip

For additional information, add --help after each command:

  • jf federation-migrator --help

  • jf federation-migrator migrate_rtfs --help

  • jf federation-migrator migrate_rt --help