OCPBUGS-43762: adds day 2 operation for masquerade to docs

Author: JoeAldinger

modules/nw-ovn-k-day-2-masq-subnet.adoc

@@ -0,0 +1,42 @@
+// Module included in the following assemblies:
+//
+// * networking/ovn_kubernetes_network_provider/configure-ovn-kubernetes-subnets.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="nw-ovn-k-day-2-masq-subnet_{context}"]
+= Configuring the OVN-Kubernetes masquerade subnet as a Day 2 operation
+
+You can change the masquerade subnet used by OVN-Kubernetes as a Day 2 operation in order to avoid conflicts with any existing subnets that are already in use in your environment.
+
+.Prerequisites
+
+* Install the OpenShift CLI (`oc`).
+* Log in to the cluster as a user with `cluster-admin` privileges.
+
+.Procedure
+
+. Change your cluster's masquerade subnet:
+
+** For dualstack clusters using IPv6, run the following command:
++
+[source,terminal]
+----
+$ oc patch networks.operator.openshift.io cluster --type=merge -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"ipv4":{"internalMasqueradeSubnet": "<ipv4_masquerade_subnet>"},"ipv6":{"internalMasqueradeSubnet": "<ipv6_masquerade_subnet>"}}}}}}'
+----
++
+where:
+
+`ipv4_masquerade_subnet`:: Specifies an IP address to be used as the IPv4 masquerade subnet. This range cannot overlap with any other subnets used by {product-title} or on the host itself. The default value for IPv4 is `169.254.169.0/29`.
+
+`ipv6_masquerade_subnet`:: Specifies an IP address to be used as the IPv6 masquerade subnet. This range cannot overlap with any other subnets used by {product-title} or on the host itself. The default value for IPv6 is `fd69::/125`.
+
+** For clusters using IPv4, run the following command:
++
+[source,terminal]
+----
+$ oc patch networks.operator.openshift.io cluster --type=merge -p '{"spec":{"defaultNetwork":{"ovnKubernetesConfig":{"gatewayConfig":{"ipv4":{"internalMasqueradeSubnet": "<ipv4_masquerade_subnet>"}}}}}}'
+----
++
+where:
+
+`ipv4_masquerade_subnet`:: Specifies an IP address to be used as the IPv4 masquerade subnet. This range cannot overlap with any other subnets used by {product-title} or on the host itself. The default value for IPv4 is `169.254.169.0/29`.

…w-ovn-kuberentes-change-join-subnet.adoc …w-ovn-kubernetes-change-join-subnet.adocmodules/nw-ovn-kuberentes-change-join-subnet.adoc renamed to modules/nw-ovn-kubernetes-change-join-subnet.adoc modules/nw-ovn-kuberentes-change-join-subnet.adoc renamed to modules/nw-ovn-kubernetes-change-join-subnet.adoc

@@ -9,5 +9,9 @@ toc::[]
 [role="_abstract"]
 As a cluster administrator, you can change the IP address ranges that the OVN-Kubernetes network plugin uses for the join and transit subnets.
 
-include::modules/nw-ovn-kuberentes-change-join-subnet.adoc[leveloffset=+1]
-include::modules/nw-ovn-kuberentes-change-transit-subnet.adoc[leveloffset=+1]
+include::modules/nw-ovn-kubernetes-change-join-subnet.adoc[leveloffset=+1]
+
+//day 2 operation for changing masquerade subnet in ovn-k
+include::modules/nw-ovn-k-day-2-masq-subnet.adoc[leveloffset=+1]
+
+include::modules/nw-ovn-kubernetes-change-transit-subnet.adoc[leveloffset=+1]