1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-06 06:46:26 +01:00
Files
openshift-docs/modules/migration-compatibility-guidelines.adoc
Sebastian Kopacz e862c66735 OSDOCS4193:typo fix
2022-09-26 14:30:08 +00:00

49 lines
2.2 KiB
Plaintext

// Module included in the following assemblies:
//
// * migrating_from_ocp_3_to_4/installing-3-4.adoc
// * migrating_from_ocp_3_to_4/installing-restricted-3-4.adoc
// * migration_toolkit_for_containers/installing-mtc.adoc
// * migration_toolkit_for_containers/installing-mtc-restricted.adoc
:_content-type: CONCEPT
[id="migration-compatibility-guidelines_{context}"]
= Compatibility guidelines
You must install the {mtc-full} ({mtc-short}) 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.
[cols="1,2,2", options="header"]
.{mtc-short} compatibility: Migrating from a legacy platform
|===
||{product-title} 4.5 or earlier |{product-title} 4.6 or later
|Stable {mtc-short} version a|{mtc-short} {mtc-version}._z_
Legacy {mtc-version} operator: Install manually with the `operator.yml` file.
[IMPORTANT]
====
This cluster cannot be the control cluster.
====
|{mtc-short} {mtc-version}._z_
Install with OLM, release channel `release-v1.7`
|===
[NOTE]
====
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} {mtc-version}, 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.
====