diff --git a/modules/host-prefix-description.adoc b/modules/host-prefix-description.adoc index 4222044ffba..0dfe3666d10 100644 --- a/modules/host-prefix-description.adoc +++ b/modules/host-prefix-description.adoc @@ -25,3 +25,7 @@ Consider another example where you set the `clusterNetwork.cidr` parameter to `1 You can use the link:https://access.redhat.com/labs/ocpnc/[Red Hat OpenShift Network Calculator] to calculate the maximum number of nodes for your cluster. endif::openshift-enterprise,openshift-rosa,openshift-rosa-hcp,openshift-dedicated[] + +ifdef::openshift-enterprise[] +After cluster installation, you can increase the per-node pod subnet size by changing `hostPrefix` to a smaller prefix length. Decreasing the per-node subnet size is not supported. For more information, see "Increasing the cluster network host prefix". +endif::openshift-enterprise[] diff --git a/modules/nw-operator-cr.adoc b/modules/nw-operator-cr.adoc index 96d6143669b..9256ddbe052 100644 --- a/modules/nw-operator-cr.adoc +++ b/modules/nw-operator-cr.adoc @@ -49,7 +49,7 @@ The CNO configuration inherits the following fields during cluster installation ifdef::post-install-network-configuration,operator[] [NOTE] ==== -After cluster installation, you can only modify the `clusterNetwork` IP address range. The `serviceNetwork` range cannot be modified post-installation, either directly or by using the `ServiceCIDR` API. +After cluster installation, you can modify the `clusterNetwork` IP address CIDR range and increase the `hostPrefix` value to allocate a larger per-node pod subnet. You cannot decrease the per-node subnet size. The `serviceNetwork` range cannot be modified post-installation, either directly or by using the `ServiceCIDR` API. For more information about increasing `hostPrefix`, see "Increasing the cluster network host prefix". ==== endif::[] diff --git a/networking/configuring_network_settings/configuring-cluster-network-range.adoc b/networking/configuring_network_settings/configuring-cluster-network-range.adoc index 4d69a51cefe..31dfb1e6f41 100644 --- a/networking/configuring_network_settings/configuring-cluster-network-range.adoc +++ b/networking/configuring_network_settings/configuring-cluster-network-range.adoc @@ -14,7 +14,7 @@ For example, if you deployed a cluster and specified `10.128.0.0/19` as the clus The following limitations apply when modifying the cluster network IP address range: - The CIDR mask size specified must always be smaller than the currently configured CIDR mask size, because you can only increase IP space by adding more nodes to an installed cluster -- The host prefix cannot be modified +- This procedure does not change the `hostPrefix` value. To increase the per-node pod subnet size by changing `hostPrefix`, see xr3f:../../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix]. - Pods that are configured with an overridden default gateway must be recreated after the cluster network expands [IMPORTANT] @@ -30,4 +30,5 @@ include::modules/nw-cluster-network-range-edit.adoc[leveloffset=+1] * xref:../../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[OVN-Kubernetes network plugin] * link:https://access.redhat.com/labs/ocpnc/[Red Hat OpenShift Network Calculator] +* xr3f:../../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix] * xref:../../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[About the OVN-Kubernetes network plugin] diff --git a/networking/networking_operators/cluster-network-operator.adoc b/networking/networking_operators/cluster-network-operator.adoc index 95c64f6453c..190608a2823 100644 --- a/networking/networking_operators/cluster-network-operator.adoc +++ b/networking/networking_operators/cluster-network-operator.adoc @@ -28,5 +28,5 @@ include::modules/nw-operator-cr.adoc[leveloffset=+1] == Additional resources * xref:../../rest_api/operator_apis/network-operator-openshift-io-v1.adoc#network-operator-openshift-io-v1[`Network` API in the `operator.openshift.io` API group] * xref:../../networking/configuring_network_settings/configuring-cluster-network-range.adoc#nw-cluster-network-range-edit_configuring-cluster-network-range[Expanding the cluster network IP address range] - -* link:https://access.redhat.com/solutions/6969174[How to configure OVN to use kernel routing table] \ No newline at end of file +* xr3f:../../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix] +* link:https://access.redhat.com/solutions/6969174[How to configure OVN to use kernel routing table] diff --git a/networking/networking_overview/cidr-range-definitions.adoc b/networking/networking_overview/cidr-range-definitions.adoc index eb240bd6a33..6db54cb9bca 100644 --- a/networking/networking_overview/cidr-range-definitions.adoc +++ b/networking/networking_overview/cidr-range-definitions.adoc @@ -78,6 +78,7 @@ ifdef::openshift-enterprise[] .Additional resources * xref:../../networking/networking_operators/cluster-network-operator.adoc#nw-operator-cr_cluster-network-operator[Cluster Network Operator configuration] * xref:../../networking/configuring_network_settings/configuring-cluster-network-range.adoc#configuring-cluster-network-range[Configuring the cluster network range] +* xr3f:../../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix] endif::openshift-enterprise[] include::modules/host-prefix-description.adoc[leveloffset=+1] diff --git a/post_installation_configuration/post-install-network-configuration.adoc b/post_installation_configuration/post-install-network-configuration.adoc index ccb69553aec..119929d454b 100644 --- a/post_installation_configuration/post-install-network-configuration.adoc +++ b/post_installation_configuration/post-install-network-configuration.adoc @@ -24,6 +24,7 @@ For more information, see "Cluster Network Operator in {product-title}". * Configuring the cluster-wide proxy * Configuring ingress cluster traffic overview * Configuring the node port service range +* xr3f:../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix] * Configuring IPsec encryption * Create a network policy or configure multitenant isolation with network policies * Optimizing routing