Skip to content

Commit c1347d5

Browse files
committed
OSDOCS-12623-update: Added extra parameters to the Ansible migration playbook doc
1 parent 6cff240 commit c1347d5

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

modules/nw-ovn-kubernetes-ansible-migration.adoc

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,12 @@ As a cluster administrator, you can use an Ansible collection, `network.offline_
1616

1717
* `playbooks/playbook-migration.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the migration process.
1818
* `playbooks/playbook-rollback.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the rollback process.
19+
20+
[IMPORTANT]
21+
====
22+
If your cluster uses static routes or routing policies in the host network, ensure that you set the `routingViaHost` parameter to `true` and the `ipForwarding` parameter to `Global` in the `gatewayConfig` section of the `playbooks/playbook-migration.yml` file.
23+
====
24+
1925
endif::rollback[]
2026

2127
ifdef::rollback[]
@@ -109,6 +115,10 @@ ifndef::rollback[]
109115
migration_egress_ip: false
110116
migration_egress_firewall: false
111117
migration_multicast: false
118+
migration_routing_via_host: true
119+
migration_ip_forwarding: Global
120+
migration_cidr: "10.240.0.0/14"
121+
migration_prefix: 23
112122
migration_mtu: 1400
113123
migration_geneve_port: 6081
114124
migration_ipv4_subnet: "100.64.0.0/16"
@@ -117,6 +127,9 @@ ifndef::rollback[]
117127
+
118128
`migration_interface_name`:: If you use an `NodeNetworkConfigurationPolicy` (NNCP) resource on a primary interface, specify the interface name in the `migration-playbook.yml` file so that the NNCP resource gets deleted on the primary interface during the migration process.
119129
`migration_disable_auto_migration`:: Disables the auto-migration of OpenShift SDN CNI plug-in features to the OVN-Kubernetes plugin. If you disable auto-migration of features, you must also set the `migration_egress_ip`, `migration_egress_firewall`, and `migration_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`.
130+
`migration_routing_via_host`:: A value of `true` sets local gateway mode and a value of `false` sets shared gateway mode for nodes in your cluster. The default value is `false`. In local gateway mode, traffic is routed through the host network stack. In shared gateway mode, traffic is not routed through the host network stack.
131+
`migration_ip_forwarding`:: Set IP forwarding to `Global` alongside the local gateway mode if you need the host network of the node to act as a router for traffic not related to OVN-Kubernetes.
132+
`migration_cidr`:: Specifies a Classless Inter-Domain Routing (CIDR) IP address block for your cluster. You cannot use any CIDR block that overlaps with the `100.64.0.0/16` CIDR block because the OVN-Kubernetes network provider uses this block internally. Ensure that you specify a prefix value, which is the slice of the CIDR block apportioned to each node in your cluster.
120133
`migration_mtu`:: Optional parameter that sets a specific maximum transmission unit (MTU) to your cluster network after the migration process.
121134
`migration_geneve_port`:: Optional parameter that sets a Geneve port for OVN-Kubernetes. The default port is `6081`.
122135
`migration_ipv4_subnet`:: Optional parameter that sets an IPv4 address range for internal use by OVN-Kubernetes. The default value for the parameter is `100.64.0.0/16`.

0 commit comments

Comments
 (0)