Migration Rollback
Revert from RTFS to the legacy Federation service using the JFrog CLI migration plugin.
Return to the legacy Federation service if the migration to the Artifactory Federation Service (RTFS) does not complete as expected.
Who can perform this task: Platform Administrators (self-managed)
Prerequisites:
- The migration plugin is installed
Run the Rollback
To roll back to the legacy Federation service:
-
Run the following command:
jf federation-migrator migrate_rt <base url without /artifactory> <access token>Where:
<base url without /artifactory>is the base URL of your Artifactory instance<access token>is a valid access token
For example:
jf federation-migrator migrate_rt mycompany.jfrog.io <access token>
The migrate_rt command supports the same command options as the migration command. For the full list of options, see Migration Procedure.
Note
The operation can take anywhere from a few seconds to several minutes to complete. You do not need to restart Artifactory after returning to the legacy Federation service.
When to Rollback
The migration process is designed to prevent inconsistent or "stuck" states. If the migration process doesn't complete as expected, contact JFrog Support.
Tip
For additional information, add
--helpafter the command:
jf federation-migrator migrate_rt --help
Frequently Asked Questions
This section provides answers to frequently asked questions.
FAQs
Q: How do I roll back from RTFS to Legacy Federation?
A: Run jf federation-migrator migrate_rt <base url without /artifactory> <access token> after installing the migration plugin. See Run the Rollback for the full command.
Q: Does rolling back to Legacy Federation require downtime?
A: No. The migration tool is designed to perform the rollback without requiring downtime, and you don't need to restart Artifactory afterward.
Q: What command options does the rollback command support?
A: The migrate_rt command supports the same options as the migration command. See Migration Procedure for the full list.
Q: When should I contact JFrog Support during a rollback?
A: Contact JFrog Support if the migration process doesn't complete as expected — it's designed to prevent inconsistent or "stuck" states, so a persistent issue warrants a support case.
Related Topics
Updated about 7 hours ago