Skip to content

osdocs-21632:updates existing docs for hostPrefix #118396

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JoeAldinger wants to merge 1 commit into
base: main
Choose a base branch
from
Open

osdocs-21632:updates existing docs for hostPrefix #118396

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions modules/host-prefix-description.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
2 changes: 1 addition & 1 deletion modules/nw-operator-cr.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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::[]

Expand Down
3 changes: 2 additions & 1 deletion networking/configuring_network_settings/configuring-cluster-network-range.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand All @@ -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]

@ocpdocs-vale-bot ocpdocs-vale-bot Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

* xref:../../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[About the OVN-Kubernetes network plugin]
4 changes: 2 additions & 2 deletions networking/networking_operators/cluster-network-operator.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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]
* xr3f:../../networking/configuring_network_settings/increasing-cluster-network-hostprefix.adoc#increasing-cluster-network-hostprefix[Increasing the cluster network host prefix]

@ocpdocs-vale-bot ocpdocs-vale-bot Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

* link:https://access.redhat.com/solutions/6969174[How to configure OVN to use kernel routing table]
1 change: 1 addition & 0 deletions networking/networking_overview/cidr-range-definitions.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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]

@ocpdocs-vale-bot ocpdocs-vale-bot Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

endif::openshift-enterprise[]

include::modules/host-prefix-description.adoc[leveloffset=+1]
Expand Down
1 change: 1 addition & 0 deletions post_installation_configuration/post-install-network-configuration.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down