Chapter 1. Migration toolkit for containers overview
You can migrate stateful application workloads between OpenShift Container Platform 4 clusters at the granularity of a namespace by using the Migration Toolkit for Containers (MTC). To learn more about MTC see understanding MTC.
If you are migrating from OpenShift Container Platform 3, see about migrating from OpenShift Container Platform 3 to 4 and installing the legacy Migration Toolkit for Containers Operator on OpenShift Container Platform 3.
1.1. Installing MTC
You must install the Migration Toolkit for Containers Operator that is compatible for your OpenShift Container Platform version:
- OpenShift Container Platform 4.6 and later versions: Install the Migration Toolkit for Containers Operator by using Operator Lifecycle Manager (OLM).
- OpenShift Container Platform 4.5 and earlier versions: Manually install the legacy Migration Toolkit for Containers Operator.
Then you configure object storage to use as a replication repository.
1.2. Upgrading MTC
You can upgrade the MTC by using OLM.
1.3. Reviewing MTC checklists
Before you migrate your application workloads with the Migration Toolkit for Containers (MTC), review the premigration checklists.
1.4. Migrating applications
You can migrate your applications by using the MTC web console or the command line.
1.5. Advanced migration options
You can automate your migrations and modify the MigPlan and MigrationController custom resources in order to perform large-scale migrations and to improve performance. You can check the following items:
1.6. Troubleshooting migrations
You can perform the following troubleshooting tasks:
- Viewing plan resources
- Viewing the migration plan aggregated log file
- Using the migration log reader
- Accessing performance metrics
-
Using the
must-gathertool - Using the Velero CLI to debug Backup and Restore CRs
- Debugging a partial migration failure
- Using MTC custom resources for troubleshooting
- Checking common issues and concerns
1.7. Rolling back a migration
You can roll back a migration by using the MTC web console, the CLI or manually.
1.8. Uninstalling MTC and deleting resources
You can uninstall the MTC and delete its resources to clean up the cluster.
