Migration prerequisites

You must meet certain prerequisites to successfully migrate an MSR 2.9.x system to MSR 3.0.x using the Mirantis Migration Tool (MMT):

  • Placement of the source MSR 2.9.x registry into read-only mode. To do this, execute the following API request:

    curl -u <username>:$TOKEN -X POST "https://<msr-url>/api/v0/meta/settings" -H "accept: application/json" -H "content-type: application/json" -d "{ \"readOnlyRegistry\": true }"

    A 202 Accepted response indicates success.


    To avoid data inconsistencies, the source registry must remain in read-only mode throughout the migration to MSR 3.0.x.

  • An active MSR 3.0 installation, version 3.0.3 or later, to serve as the migration target.

  • Configuration of the namespace for the MSR 3.0.x target installation, which you set by running the following command:

    kubectl config set-context --current --namespace=<NAMESPACE-for-MSR-3.0.x-migration-target>
  • A kubectl config file, which is typically located in $HOME/.kube.

  • Credentials within the kubectl config file that supply cluster admin access to the Kubernetes cluster that is running MSR 3.0.x.

  • Administrator credentials for the MKE cluster on which the source MSR 2.9 system is running.

  • You must pull the MMT image to both the 2.9.x and 3.0.x systems, using the following commands:

    docker pull registry.mirantis.com/msr/mmt