mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
53 lines
2.6 KiB
Plaintext
53 lines
2.6 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * migration_toolkit_for_containers/installing-mtc.adoc
|
|
// * migration_toolkit_for_containers/installing-mtc-restricted.adoc
|
|
|
|
:_mod-docs-content-type: CONCEPT
|
|
[id="migration-compatibility-guidelines_{context}"]
|
|
= Compatibility guidelines
|
|
|
|
You must install the {mtc-first} Operator that is compatible with your {product-title} version.
|
|
|
|
.Definitions
|
|
|
|
legacy platform:: {product-title} 4.5 and earlier.
|
|
modern platform:: {product-title} 4.6 and later.
|
|
legacy operator:: The {mtc-short} Operator designed for legacy platforms.
|
|
modern operator:: The {mtc-short} Operator designed for modern platforms.
|
|
control cluster:: The cluster that runs the {mtc-short} controller and GUI.
|
|
remote cluster:: A source or destination cluster for a migration that runs Velero. The Control Cluster communicates with Remote clusters via the Velero API to drive migrations.
|
|
|
|
You must use the compatible {mtc-short} version for migrating your {product-title} clusters. For the migration to succeed both your source cluster and the destination cluster must use the same version of {mtc-short}.
|
|
|
|
MTC 1.7 supports migrations from {product-title} 3.11 to 4.9.
|
|
|
|
MTC 1.8 only supports migrations from {product-title} 4.10 and later.
|
|
|
|
.{mtc-short} compatibility: Migrating from a legacy or a modern platform
|
|
|===
|
|
|Details |{product-title} 3.11 |{product-title} 4.0 to 4.5 |{product-title} 4.6 to 4.9 |{product-title} 4.10 or later
|
|
|
|
|Stable {mtc-short} version
|
|
|{mtc-short} v.1.7._z_
|
|
|{mtc-short} v.1.7._z_
|
|
|{mtc-short} v.1.7._z_
|
|
|{mtc-short} v.1.8._z_
|
|
|
|
|Installation
|
|
|
|
|
|Legacy {mtc-short} v.1.7._z_ operator: Install manually with the `operator.yml` file.
|
|
|
|
[*IMPORTANT*]
|
|
This cluster cannot be the control cluster.
|
|
|Install with OLM, release channel `release-v1.7`
|
|
|Install with OLM, release channel `release-v1.8`
|
|
|===
|
|
|
|
Edge cases exist in which network restrictions prevent modern clusters from connecting to other clusters involved in the migration. For example, when migrating from an {product-title} 3.11 cluster on premises to a modern {product-title} cluster in the cloud, where the modern cluster cannot connect to the {product-title} 3.11 cluster.
|
|
|
|
With {mtc-short} v.1.7._z_, if one of the remote clusters is unable to communicate with the control cluster because of network restrictions, use the `crane tunnel-api` command.
|
|
|
|
With the stable {mtc-short} release, although you should always designate the most modern cluster as the control cluster, in this specific case it is possible to designate the legacy cluster as the control cluster and push workloads to the remote cluster.
|
|
|