Skip to content

Commit 400e443

Browse files
mletaliemletalie
committed
SDN Migration
 rosa_release_notes/rosa-release-notes.adoc
1 parent f91c9e0 commit 400e443

File tree

6 files changed

+84
-6
lines changed

6 files changed

+84
-6
lines changed

‎_topic_maps/_topic_map_osd.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -869,6 +869,8 @@ Topics:
869869
File: about-ovn-kubernetes
870870
- Name: Migrating from the OpenShift SDN network plugin
871871
File: migrate-from-openshift-sdn-osd
872+
# - Name: Migrating from the OpenShift SDN network plugin
873+
# File: migrate-from-openshift-sdn
872874
- Name: OpenShift SDN network plugin
873875
Dir: ovn_kubernetes_network_provider
874876
Topics:

‎_topic_maps/_topic_map_rosa.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1129,6 +1129,8 @@ Topics:
11291129
File: about-ovn-kubernetes
11301130
- Name: Configuring an egress IP address
11311131
File: configuring-egress-ips-ovn
1132+
- Name: Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin
1133+
File: migrate-from-openshift-sdn
11321134
- Name: OpenShift SDN network plugin
11331135
Dir: ovn_kubernetes_network_provider
11341136
Topics:

‎modules/migrate-sdn-ovn.adoc

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
// Module included in the following assemblies:
2+
//networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
3+
4+
:_mod-docs-content-type: PROCEDURE
5+
[id="migrate-sdn-ovn-cli_{context}"]
6+
= Initiate migration using the ROSA CLI
7+
8+
[WARNING]
9+
====
10+
You can only initiate migration on clusters that are version 4.16.24 and above.
11+
====
12+
13+
To initiate the migration, run the following command:
14+
[source,terminal]
15+
----
16+
$ rosa edit cluster -c <cluster_id> <1>
17+
--network-type OVNKubernetes
18+
--ovn-internal-subnets <configuration> <2>
19+
----
20+
<1> Replace `<cluster_id>` with the ID of the cluster you want to migrate to the OVN-Kubernetes network plugin.
21+
<2> Optional: Users can create key-value pairs to configure internal subnets using any or all of the options `join, masquerade, transit` along with a single CIDR per option. For example, `--ovn-internal-subnets="join=0.0.0.0/24,transit=0.0.0.0/24,masquerade=0.0.0.0/24"`.
22+
23+
[IMPORTANT]
24+
====
25+
You cannot include the optional flag `--ovn-internal-subnets` in the command unless you define a value for the flag `--network-type`.
26+
====
27+
28+
:_mod-docs-content-type: PROCEDURE
29+
[id="verify-sdn-ovn_{context}"]
30+
= Verify migration status using the ROSA CLI
31+
32+
To check the status of the migration, run the following command:
33+
[source,terminal]
34+
----
35+
rosa describe cluster -c <cluster_id> <1>
36+
----
37+
<1> Replace `<cluster_id>` with the ID of the cluster to check the migration status.

‎networking/about-managed-networking.adoc

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,21 @@ The following are some of the most commonly used {openshift-networking} features
1616
+
1717
** xref:../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[OVN-Kubernetes network plugin], which is the default CNI plugin.
1818
** {OCP-short} SDN network plugin, which was deprecated in {OCP-short} 4.16 and removed in {OCP-short} 4.17.
19-
+
19+
20+
ifdef::openshift-rosa[]
21+
2022
[IMPORTANT]
2123
====
22-
Before upgrading {product-title} clusters that are configured with the OpenShift SDN network plugin to version 4.17, you must migrate to the OVN-Kubernetes network plugin. For more information, see _Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin_ in the _Additional resources_ section.
24+
Before upgrading {rosa-classic} clusters that are configured with the OpenShift SDN network plugin to version 4.17, you must migrate to the OVN-Kubernetes network plugin. For more information, see _Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin_ in the _Additional resources_ section.
2325
====
2426

27+
endif::openshift-rosa[]
2528
[discrete]
2629
[role="_additional-resources"]
2730
[id="additional-resources_{context}"]
2831
== Additional resources
2932

3033
* link:https://access.redhat.com/articles/7065170[{OCP-short} SDN CNI removal in OCP 4.17]
31-
32-
ifdef::openshift-dedicated[]
33-
* xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn-osd.adoc#migrate-from-openshift-sdn-osd[Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin]
34-
endif::openshift-dedicated[]
34+
ifdef::openshift-rosa[]
35+
* xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc#migrate-from-openshift-sdn[Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin]
36+
endif::openshift-rosa[]

‎networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
:_mod-docs-content-type: ASSEMBLY
2+
[id="migrate-from-openshift-sdn"]
3+
= Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin
4+
include::_attributes/common-attributes.adoc[]
5+
include::_attributes/attributes-openshift-dedicated.adoc[]
6+
:context: migrate-from-openshift-sdn
7+
8+
toc::[]
9+
10+
As a {rosa-classic-first} cluster administrator, you can initiate the migration from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin and verify the migration status using the ROSA CLI.
11+
12+
Some considerations before starting migration initiation are:
13+
14+
* The cluster version must be 4.16.24 and above.
15+
16+
* The migration process cannot be interrupted.
17+
18+
* Migrating back to the SDN network plugin is not possible.
19+
20+
* Cluster nodes will be rebooted during migration.
21+
22+
* There will be no impact to workloads that are resilient to node disruptions.
23+
24+
* Migration time can vary between several minutes and hours, depending on the cluster size and workload configurations.
25+
26+
include::modules/migrate-sdn-ovn.adoc[leveloffset=+1]
27+
28+
29+
30+

‎rosa_release_notes/rosa-release-notes.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,11 @@ endif::openshift-rosa-hcp[]
2424
ifdef::openshift-rosa[]
2525
* **{rosa-classic} cluster node limit update.** {rosa-classic} clusters versions 4.14.14 and greater can now scale to 249 worker nodes. This is an increase from the previous limit of 180 nodes. For more information, see xref:../rosa_planning/rosa-limits-scalability.adoc#rosa-limits-scalability[Limits and scalability].
2626
+
27+
// * **{product-title} SDN network plugin blocks future major upgrades**
28+
* **Initiate live migration from OpenShift SDN to OVN-Kubernetes.**
29+
As part of the {product-title} move to OVN-Kubernetes as the only supported network plugin starting with {product-title} 4.17, users can now initiate live migration from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin.
30+
If your cluster uses the OpenShift SDN network plugin, you cannot upgrade to future major versions of {product-title} without migrating to OVN-Kubernetes. For more information about migrating to OVN-Kubernetes, see xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc#migrate-from-openshift-sdn[Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin].
31+
2732
[IMPORTANT]
2833
====
2934
Egress lockdown is a Technology Preview feature.

0 commit comments

Comments
 (0)