mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
Merge pull request #18460 from openshift-cherrypick-robot/cherry-pick-18377-to-enterprise-4.3
[enterprise-4.3] OCP 4.2 to 4.2 migration
This commit is contained in:
Andrea Hoffer
@@ -1036,11 +1036,13 @@ Topics:
|
||||
File: planning-migration-3-to-4
|
||||
- Name: Migrating OpenShift Container Platform 3.7 to 4.2
|
||||
File: migrating-openshift-3-to-4
|
||||
- Name: Migrating OpenShift Container Platform 4.1 to 4.2
|
||||
- Name: Migrating OpenShift Container Platform 4.x to 4.x
|
||||
Dir: migrating-4-4
|
||||
Topics:
|
||||
- Name: Migrating OpenShift Container Platform 4.1 to 4.2
|
||||
File: migrating-openshift-4-to-4
|
||||
File: migrating-openshift-4_1-to-4
|
||||
- Name: Migrating between OpenShift Container Platform 4.2 clusters
|
||||
File: migrating-openshift-4_2-to-4
|
||||
---
|
||||
Name: CLI tools
|
||||
Dir: cli_reference
|
||||
|
||||
@@ -66,10 +66,10 @@ The CAM Operator installs the following:
|
||||
include::modules/migration-installing-cam-operator-ocp-3.adoc[leveloffset=+2]
|
||||
:ocp-3-to-4!:
|
||||
|
||||
:context: targetcluster3-4
|
||||
:targetcluster3-4:
|
||||
:context: targetcluster_4.2
|
||||
:targetcluster_4.2:
|
||||
include::modules/migration-installing-cam-operator-ocp-4.adoc[leveloffset=+2]
|
||||
:targetcluster3-4!:
|
||||
:targetcluster_4.2!:
|
||||
|
||||
:context: ocp-3-to-4
|
||||
:ocp-3-to-4:
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
[id="migrating-openshift-4-to-4"]
|
||||
[id="migrating-openshift-4_1-to-4"]
|
||||
= Migrating {product-title} 4.1 to 4.2
|
||||
include::modules/common-attributes.adoc[]
|
||||
|
||||
:context: ocp-4_1-4_2
|
||||
:ocp-4_1-4_2:
|
||||
|
||||
@@ -54,20 +54,23 @@ The CAM Operator installs the Migration controller, CAM web console, Restic, and
|
||||
|
||||
:ocp-4_1-4_2!:
|
||||
|
||||
:context: sourcecluster
|
||||
:sourcecluster:
|
||||
:context: sourcecluster-4_1-4_2
|
||||
:sourcecluster-4_1-4_2:
|
||||
include::modules/migration-installing-cam-operator-ocp-4.adoc[leveloffset=+2]
|
||||
:sourcecluster!:
|
||||
:sourcecluster-4_1-4_2!:
|
||||
|
||||
:context: targetcluster4-4
|
||||
:targetcluster4-4:
|
||||
:context: targetcluster_4_1-4_2
|
||||
:targetcluster_4_1-4_2:
|
||||
include::modules/migration-installing-cam-operator-ocp-4.adoc[leveloffset=+2]
|
||||
:targetcluster4-4!:
|
||||
:targetcluster_4_1-4_2!:
|
||||
|
||||
:context: sourcecluster-4_1-4_2
|
||||
:sourcecluster-4_1-4_2:
|
||||
include::modules/migration-configuring-cors-4.adoc[leveloffset=+2]
|
||||
:sourcecluster-4_1-4_2!:
|
||||
|
||||
:context: ocp-4_1-4_2
|
||||
:ocp-4_1-4_2:
|
||||
include::modules/migration-configuring-cors-4.adoc[leveloffset=+2]
|
||||
|
||||
== Migrating applications with the CAM web console
|
||||
|
||||
include::modules/migration-launching-cam.adoc[leveloffset=+2]
|
||||
71
migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
Normal file
71
migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
Normal file
@@ -0,0 +1,71 @@
|
||||
[id="migrating-openshift-4_2-to-4"]
|
||||
= Migrating between {product-title} 4.2 clusters
|
||||
|
||||
:context: ocp-4_2-4_2
|
||||
:ocp-4_2-4_2:
|
||||
|
||||
toc::[]
|
||||
|
||||
You can migrate application workloads between {product-title} 4.2 clusters with the Cluster Application Migration (CAM) tool. The CAM tool enables you to control the migration and to minimize application downtime.
|
||||
|
||||
The CAM tool's web console and API, based on Kubernetes custom resources, enable you to migrate stateful and stateless application workloads at the granularity of a namespace.
|
||||
|
||||
You can migrate data to a different storage class, for example, from Red Hat Gluster Storage or NFS storage to Red Hat Ceph Storage.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You must have xref:../../cli_reference/openshift_cli/administrator-cli-commands.html#policy[`cluster-admin` privileges] on all clusters.
|
||||
* You must have a replication repository that supports the S3 API and is accessible to the source and target clusters.
|
||||
|
||||
include::modules/migration-understanding-cam.adoc[leveloffset=+1]
|
||||
|
||||
== Deploying the Cluster Application Migration tool
|
||||
|
||||
Deploying the CAM tool involves the following steps:
|
||||
|
||||
. Installing the CAM Operator on all clusters
|
||||
+
|
||||
The CAM Operator installs the Migration controller, CAM web console, Restic, and Velero on the target cluster and Restic and Velero on the source cluster(s).
|
||||
|
||||
. Configuring cross-origin resource sharing on the source cluster(s) to enable communication with the CAM tool
|
||||
|
||||
:ocp-4_2-4_2!:
|
||||
|
||||
:context: sourcecluster-4_2-4_2
|
||||
:sourcecluster-4_2-4_2:
|
||||
include::modules/migration-installing-cam-operator-ocp-4.adoc[leveloffset=+2]
|
||||
:sourcecluster-4_2-4_2!:
|
||||
|
||||
:context: targetcluster-4_2-4_2
|
||||
:targetcluster-4_2-4_2:
|
||||
include::modules/migration-installing-cam-operator-ocp-4.adoc[leveloffset=+2]
|
||||
:targetcluster-4_2-4_2!:
|
||||
|
||||
:context: sourcecluster-4_2-4_2
|
||||
:sourcecluster-4_2-4_2:
|
||||
include::modules/migration-configuring-cors-4.adoc[leveloffset=+2]
|
||||
:sourcecluster-4_2-4_2!:
|
||||
|
||||
|
||||
:context: ocp-4_2-4_2
|
||||
:ocp-4_2-4_2:
|
||||
== Migrating applications with the CAM web console
|
||||
|
||||
include::modules/migration-launching-cam.adoc[leveloffset=+2]
|
||||
include::modules/migration-adding-cluster-to-cam.adoc[leveloffset=+2]
|
||||
include::modules/migration-adding-replication-repository-to-cam.adoc[leveloffset=+2]
|
||||
include::modules/migration-changing-migration-plan-limits.adoc[leveloffset=+2]
|
||||
include::modules/migration-creating-migration-plan-cam.adoc[leveloffset=+2]
|
||||
include::modules/migration-running-migration-plan-cam.adoc[leveloffset=+2]
|
||||
|
||||
== Troubleshooting a failed migration
|
||||
|
||||
You can view the migration custom resources (CRs) and download logs to troubleshoot a failed migration.
|
||||
|
||||
include::modules/migration-custom-resources.adoc[leveloffset=+2]
|
||||
include::modules/migration-viewing-migration-crs.adoc[leveloffset=+2]
|
||||
include::modules/migration-downloading-logs.adoc[leveloffset=+2]
|
||||
include::modules/migration-restic-timeout.adoc[leveloffset=+2]
|
||||
|
||||
include::modules/migration-known-issues.adoc[leveloffset=+1]
|
||||
:ocp-4_2-4_2!:
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-adding-cluster-to-cam_{context}']
|
||||
= Adding a cluster to the CAM web console
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-adding-replication-repository-to-cam_{context}']
|
||||
= Adding a replication repository to the CAM web console
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-changing-migration-plan-limits_{context}']
|
||||
= Changing migration plan limits for large migrations
|
||||
|
||||
|
||||
@@ -1,10 +1,19 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-configuring-cors-4_{context}']
|
||||
= Configuring cross-origin resource sharing on an {product-title} 4 source cluster
|
||||
ifdef::sourcecluster-4_1-4_2[]
|
||||
= Configuring cross-origin resource sharing on an {product-title} 4.1 source cluster
|
||||
|
||||
You must configure cross-origin resource sharing on an {product-title} 4 source cluster to enable communication between the source cluster's API server and the CAM tool.
|
||||
You must configure cross-origin resource sharing on an {product-title} 4.1 source cluster to enable communication between the source cluster's API server and the CAM tool.
|
||||
endif::[]
|
||||
ifdef::sourcecluster-4_2-4_2[]
|
||||
= Configuring cross-origin resource sharing on an {product-title} 4.2 source cluster
|
||||
|
||||
You must configure cross-origin resource sharing on an {product-title} 4.2 source cluster to enable communication between the source cluster's API server and the CAM tool.
|
||||
endif::[]
|
||||
|
||||
// If you are migrating to or from an {product-title} 4 cluster that does not have the CAM tool installed, you must configure cross-origin resource sharing so that the CAM tool can access the cluster's API server.
|
||||
|
||||
@@ -18,6 +27,7 @@ $ oc get -n openshift-migration route/migration -o go-template='(?i)//{{ .spec.h
|
||||
----
|
||||
|
||||
. Log in to the source cluster.
|
||||
ifdef::sourcecluster-4_1-4_2[]
|
||||
. Edit the OAuth server CR:
|
||||
+
|
||||
----
|
||||
@@ -36,6 +46,7 @@ spec:
|
||||
<1> Specify your CORS configuration value.
|
||||
|
||||
. Save the file to apply the changes.
|
||||
endif::[]
|
||||
|
||||
. Edit the Kubernetes API server CR:
|
||||
+
|
||||
@@ -43,6 +54,7 @@ spec:
|
||||
$ oc edit kubeapiserver.operator cluster
|
||||
----
|
||||
|
||||
ifdef::sourcecluster-4_1-4_2[]
|
||||
. Add the CORS configuration value to `corsAllowedOrigins` under `unsupportedConfigOverrides` in the `spec` stanza:
|
||||
+
|
||||
[source,yaml]
|
||||
@@ -53,6 +65,18 @@ spec:
|
||||
- (?i)//migration-openshift-migration\.apps\.cluster\.com(:|\z) <1>
|
||||
----
|
||||
<1> Specify your CORS configuration value.
|
||||
endif::[]
|
||||
ifdef::sourcecluster-4_2-4_2[]
|
||||
. Add the CORS configuration value to `additionalCORSAllowedOrigins` in the `spec` stanza:
|
||||
+
|
||||
[source,yaml]
|
||||
----
|
||||
spec:
|
||||
additionalCORSAllowedOrigins:
|
||||
- (?i)//migration-openshift-migration\.apps\.cluster\.com(:|\z) <1>
|
||||
----
|
||||
<1> Specify your CORS configuration value.
|
||||
endif::[]
|
||||
|
||||
. Save the file to apply the changes.
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-creating-migration-plan-cam_{context}']
|
||||
= Creating a migration plan in the CAM web console
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-custom-resources_{context}']
|
||||
= Understanding the migration custom resources
|
||||
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
// migration/migrating-openshift-3-to-4.adoc
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-downloading-logs_{context}']
|
||||
= Downloading migration logs
|
||||
|
||||
|
||||
@@ -1,17 +1,24 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id="installing-cam-operator-ocp-4_{context}"]
|
||||
ifdef::sourcecluster[]
|
||||
ifdef::sourcecluster-4_1-4_2[]
|
||||
= Installing the CAM Operator on an {product-title} 4.1 source cluster
|
||||
|
||||
You can install the CAM Operator on an {product-title} 4.1 source cluster with OLM.
|
||||
|
||||
The CAM Operator installs Velero and Restic.
|
||||
endif::[]
|
||||
ifdef::sourcecluster-4_2-4_2[]
|
||||
= Installing the CAM Operator on an {product-title} 4.2 source cluster
|
||||
|
||||
ifdef::targetcluster3-4,targetcluster4-4[]
|
||||
You can install the CAM Operator on an {product-title} 4.2 source cluster with OLM.
|
||||
|
||||
The CAM Operator installs Velero and Restic.
|
||||
endif::[]
|
||||
ifdef::targetcluster-4_2-4_2[]
|
||||
= Installing the CAM Operator on an {product-title} 4.2 target cluster
|
||||
|
||||
You can install the CAM Operator on an {product-title} 4.2 target cluster with OLM.
|
||||
@@ -43,7 +50,7 @@ The *Cluster Application Migration Operator* is listed in the *openshift-migrati
|
||||
. On the *Installed Operators* page:
|
||||
.. Under *Provided APIs*, click *View 12 more...*.
|
||||
.. Click *Create New* -> *MigrationController*.
|
||||
ifdef::sourcecluster[]
|
||||
ifdef::sourcecluster-4_1-4_2[]
|
||||
.. Update the `migration_controller` and `migration_ui` parameters and add the `deprecated_cors_configuration` parameter to the `spec` stanza:
|
||||
+
|
||||
[source,yaml]
|
||||
@@ -56,11 +63,23 @@ spec:
|
||||
deprecated_cors_configuration: true
|
||||
----
|
||||
endif::[]
|
||||
ifdef::sourcecluster-4_2-4_2[]
|
||||
.. Update the `migration_controller` and `migration_ui` parameters in the `spec` stanza:
|
||||
+
|
||||
[source,yaml]
|
||||
----
|
||||
spec:
|
||||
[...]
|
||||
migration_controller: false
|
||||
migration_ui: false
|
||||
[...]
|
||||
----
|
||||
endif::[]
|
||||
.. Click *Create*.
|
||||
|
||||
ifdef::sourcecluster[]
|
||||
ifdef::sourcecluster-4_1-4_2,sourcecluster-4_2-4_2[]
|
||||
. Click *Workloads* -> *Pods* to verify that the Restic and Velero Pods are running.
|
||||
endif::[]
|
||||
ifdef::targetcluster3-4,targetcluster4-4[]
|
||||
ifdef::targetcluster-4_2-4_2[]
|
||||
. Click *Workloads* -> *Pods* to verify that the Controller Manager, Migration UI, Restic, and Velero Pods are running.
|
||||
endif::[]
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-known-issues_{context}']
|
||||
= Known issues
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id="migration-launching-cam_{context}"]
|
||||
= Launching the CAM web console
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-restic-timeout_{context}']
|
||||
= Restic timeout error
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-running-migration-plan-cam_{context}']
|
||||
= Running a migration plan in the CAM web console
|
||||
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-understanding-cam_{context}']
|
||||
= Understanding the Cluster Application Migration tool
|
||||
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
// Module included in the following assemblies:
|
||||
// migration/migrating-openshift-3-to-4.adoc
|
||||
//
|
||||
// migration/migrating-3-4/migrating-openshift-3-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_1-to-4.adoc
|
||||
// migration/migrating-4-4/migrating-openshift-4_2-to-4.adoc
|
||||
[id='migration-viewing-migration-crs_{context}']
|
||||
= Viewing migration custom resources
|
||||
|
||||
|
||||
Reference in New Issue
Block a user