Tool Migration

This guide offers comprehensive, step-by-step instructions for migrating artifacts from Mirantis Secure Registry (MSR) versions 2.9 and 3.1 to MSR 4 using the official migration tool.

The migration process is designed as an A/B operation. Your existing MSR deployment remains active and unaffected while data is copied to a new MSR 4.x instance. The migration tool runs independently on a separate host with network access to both source and destination environments. This design ensures operational continuity and limits risk to the current deployment.

Key characteristics of the migration:

  • Migration is non-disruptive to your existing MSR system until the final cutover.

  • Metadata are transferred using offline copies for consistency.

  • The database backend changes from RethinkDB to PostgreSQL.

  • Team names and repository paths may change. You will need to update pipelines accordingly.

  • Image data migration can take significant amount of time dependent on attributes of the customer environment such as image and layer count and size, as well as network and storage capabilities. It may be scheduled to manage network and storage usage or run immediately.

  • To minimize downtime during the final cutover, image migration can be repeated to reduce the size of the remaining delta before the last sync.

Before proceeding, review the following topics:

If you have any questions, contact support for further guidance.

Tool Migration Contents

Step

Description

What to expect when transitioning to MSR4

Summarizes major behavioral and architectural changes between MSR versions. Review before planning your migration timeline.

Migration Prerequisites

Lists the technical requirements needed to run the migration tool successfully.

Database Access Configuration

Describes how to configure and provision the PostgreSQL instance.

Install Migration Tool

Explains how to download, verify, and install the migration tool on your migration host.

Perform Migration

Outlines how to run the migration tool to export data from the source MSR and import it into the MSR 4 deployment.

Migrate Projects

Describes how to migrate projects.

Migrate Permissions

Describes how to migrate permissions.

Migrate Push and Poll Mirroring Policies

Describes how to migrate push and poll mirroring policies.

Validate Migration Data

Details optional steps to confirm that repositories, metadata, and user configurations were migrated correctly.

Post-Migration Configuration

Provides guidance on updating pipelines, credentials, and access controls for the new MSR system.

Post-Migration Cleanup

Lists cleanup tasks, including retiring the old MSR deployment and releasing temporary resources.

Migration Tool Reference

Contains command-line options and configuration parameters for the migration tool.