Migration Guide#

This guide provides instructions for performing migration from MSR 2.9 and 3.1 to MSR 4. MSR supports two migration paths:

The following comparison highlights the key differences to help you choose the most appropriate option for your environment.

Migration

Description

Manual migration

Transfers repository data only.

Benefits
* Simple and fast to implement with minimal dependencies.
- Suitable for small environments or limited migration scope.

Considerations
- Does not migrate repository-level permissions.
- Does not migrate push and poll mirroring policies.
- Manually recreating access controls can be time-consuming.
- Prone to human error in large deployments.

Tool-based migration

Transfers repositories, associated permissions, and push and poll mirroring policies using Mirantis-provided automation tools.

Benefits
- Automates migration, reducing manual overhead.
- Improves consistency in complex or large-scale deployments.
- Transfers metadata using offline copies for consistency.

Considerations
- Requires setup and configuration of a migration tool.
- Best suited for complex or large-scale environments.