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.Important
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