Mirantis Migration Tool Guide¶
The Mirantis Migration Tool (MMT) provides a tool with which you can migrate metadata and image binaries to a new Kubernetes or Swarm MSR cluster. It is quite flexible, in that you can switch cluster orchestrators and deployment methods during the migration process, as well as transition to the same version or opt for an upgrade to a later major, minor, or patch version.
Note
MMT does not support migrating to 2.9.x target systems.
Source |
Destination |
---|---|
2.9 |
3.0 Helm, 3.1 Swarm |
3.0 Helm |
3.0 Helm, 3.1 Swarm |
3.1 Swarm |
3.1 Swarm |
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.
- MMT architecture
- Migration prerequisites
- Select the storage mode
- Kubernetes migrations
- Step-by-step migration
- Settings not migrated
- Telemetry
- Troubleshoot migration
- Filesystem storage back ends
- Too many open files
- Failure to load data error message
- No space left on device
- Failed to estimate migration error message
- rethinkdb row cannot be restored
- Admin password on MSR 3.0.x target no longer works
- Blob image copy considerations
- Additional parameters
- Additional volume mappings for containers
- Failed to query for metadata size
- flag provided but not defined: -append
- Storage configuration is out of sync with metadata
- The estimate command returns an image data value of 0
- Unable to get FileInfo: /blobs
- failed to run container: mmt-dtr-rethinkdb-backup
- MMT release notes