diff --git a/modules/ipi-install-modifying-install-config-for-dual-stack-network.adoc b/modules/ipi-install-modifying-install-config-for-dual-stack-network.adoc index 0f2f01cc2aaa..c04192c7aeeb 100644 --- a/modules/ipi-install-modifying-install-config-for-dual-stack-network.adoc +++ b/modules/ipi-install-modifying-install-config-for-dual-stack-network.adoc @@ -8,6 +8,11 @@ For dual-stack networking in {product-title} clusters, you can configure IPv4 and IPv6 address endpoints for cluster nodes. To configure IPv4 and IPv6 address endpoints for cluster nodes, edit the `machineNetwork`, `clusterNetwork`, and `serviceNetwork` configuration settings in the `install-config.yaml` file. Each setting must have two CIDR entries each. Ensure the first CIDR entry is the IPv4 setting and the second CIDR entry is the IPv6 setting. +[IMPORTANT] +==== +If you specified an NMState configuration in the `networkConfig` section of your your `install-config.yaml` file , ensure you add `wait-ip: ipv4` and `wait-ip: ipv6` to the NMSate YAML file to resolve an issue that prevents your cluster from deploying on a dual-stack network. +==== + [source,yaml] ---- machineNetwork: @@ -25,10 +30,10 @@ serviceNetwork: [IMPORTANT] ==== -The API VIP IP address and the Ingress VIP address must be of the primary IP address family when using dual-stack networking. Currently, Red Hat does not support dual-stack VIPs or dual-stack networking with IPv6 as the primary IP address family. However, Red Hat does support dual-stack networking with IPv4 as the primary IP address family. Therefore, the IPv4 entries must go *before* the IPv6 entries. +The API and Ingress virtual IP (VIP) addresses must be of the primary IP address family when using dual-stack networking. Currently, Red Hat does not support dual-stack VIPs or dual-stack networking with IPv6 as the primary IP address family. However, Red Hat does support dual-stack networking with IPv4 as the primary IP address family. Therefore, the IPv4 entries must go *before* the IPv6 entries. ==== -To provide an interface to the cluster for applications that use IPv4 and IPv6 addresses, configure IPv4 and IPv6 virtual IP (VIP) address endpoints for the Ingress VIP and API VIP services. To configure IPv4 and IPv6 address endpoints, edit the `apiVIPs` and `ingressVIPs` configuration settings in the `install-config.yaml` file . The `apiVIPs` and `ingressVIPs` configuration settings use a list format. The order of the list indicates the primary and secondary VIP address for each service. +To provide an interface to the cluster for applications that use IPv4 and IPv6 addresses, configure IPv4 and IPv6 VIP address endpoints for the Ingress VIP and API VIP services. To configure IPv4 and IPv6 address endpoints, edit the `apiVIPs` and `ingressVIPs` configuration settings in the `install-config.yaml` file . The `apiVIPs` and `ingressVIPs` configuration settings use a list format. The order of the list indicates the primary and secondary VIP address for each service. [source,yaml] ----