Migration Guide#
The migration of MSR metadata and image binaries to a new Kubernetes or Swarm cluster can be a complex operation. To help you to successfully complete this task, Mirantis provides the Mirantis Migration Tool (MMT).
With MMT, you can transition to the same MSR version you already have in use, or you can opt to upgrade to a more recent major, minor, or patch version of the software. In addition, MMT allows you to switch cluster orchestrators and deployment methods as part of the migration process.
Available MSR system orchestrations include:
| MSR system | Orchestration |
|---|---|
| - MSR 3.1.x, Helm - MSR 3.1.x, Operator - MSR 3.0.x, Helm |
Kubernetes orchestration |
| - MSR 3.1.x, Swarm | Docker Swarm orchestration |
| - MSR 3.1.x, Helm - MSR 3.1.x, Operator - MSR 3.1.x, Swarm - MSR 3.0.x, Helm - MSR 2.9.x |
MKE orchestration |
Migration paths#
Note
MMT does not support migrating to 2.9.x target systems.
| Source MSR system | Target MSR system |
|---|---|
| MSR 2.9 | - MSR 3.1, Helm - MSR 3.1, Operator - MSR 3.1, Swarm - MSR 3.0, Helm |
| MSR 3.0, Helm | - MSR 3.1, Helm - MSR 3.1, Operator - MSR 3.1, Swarm |
| MSR 3.1, Helm | - MSR 3.1, Operator - MSR 3.1, Swarm |
| MSR 3.1, Operator | - MSR 3.1, Helm - MSR 3.1, Swarm |
| MSR 3.1, Swarm | - MSR 3.1, Helm - MSR 3.1, Operator |
The workflow for migrating MSR deployments is a multi-stage sequential operation.
Migrations from MSR 2.9.x:
- Source verification
- Estimation
- Extraction
- Transformation
- Restoration
Migrations from MSR 3.x.x:
- Extraction
- Restoration
Note
Refer to kubernetes-migrations for all migrations that include Kubernetes-based source or target systems.
Backup and restoration paths#
You can use MMT to create an MSR system backup as well as to restore an MSR system from a previously created backup.
| Source MSR system | Target MSR system |
|---|---|
| MSR 3.0, Helm | MSR 3.0, Helm |
| MSR 3.1, Helm | MSR 3.1, Helm |
| MSR 3.1, Operator | MSR 3.1, Operator |
| MSR 3.1, Swarm | MSR 3.1, Swarm |