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.