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.

Supported migration paths

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:

1. Source verification

2. Estimation

3. Extraction

4. Transformation

5. Restoration

Migrations from MSR 3.x.x:

1. Extraction

2. 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
  • Verify the source system configuration
  • Estimate the migration
  • Extract the data
  • Transform the data extract
  • Restore the data extract
• 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