From 8e2a9b3412d85991199474a5c72c609b092aff29 Mon Sep 17 00:00:00 2001
From: Shubha Narayanan <snarayan@snarayan-thinkpadp1gen4i.remote.csb>
Date: Fri, 3 Jan 2025 13:24:24 +0530
Subject: [PATCH] Multiple NICs configuration

---
 ...er-provisioned-network-customizations.adoc |  8 ++
 .../installation-vsphere-multiple-nics.adoc   | 80 +++++++++++++++++++
 modules/nw-network-config.adoc                |  1 +
 3 files changed, 89 insertions(+)
 create mode 100644 modules/installation-vsphere-multiple-nics.adoc

diff --git a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc
index 63e66f6453..e403cc378a 100644
--- a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc
+++ b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc
@@ -58,6 +58,14 @@ include::modules/ipi-install-modifying-install-config-for-dual-stack-network.ado
 
 include::modules/configuring-vsphere-regions-zones.adoc[leveloffset=+2]
 
+// Specifying multiple NICS
+include::modules/installation-vsphere-multiple-nics.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../../installing/installing_vsphere/installation-config-parameters-vsphere.adoc#installation-configuration-parameters-network_installation-config-parameters-vsphere[Network configuration parameters]
+
 // Network configuration phases
 include::modules/nw-network-config.adoc[leveloffset=+1]
 
diff --git a/modules/installation-vsphere-multiple-nics.adoc b/modules/installation-vsphere-multiple-nics.adoc
new file mode 100644
index 0000000000..a81afbc718
--- /dev/null
+++ b/modules/installation-vsphere-multiple-nics.adoc
@@ -0,0 +1,80 @@
+// Module included in the following assemblies:
+//
+// * installing/installing-vsphere-installer-provisioned-network-customizations.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="installation-vsphere-multiple-nics_{context}"]
+= Configuring multiple NICs
+
+For scenarios requiring multiple network interface controller (NIC), you can configure multiple network adapters per node. 
+
+:FeatureName: Configuring multiple NICs
+include::snippets/technology-preview.adoc[]
+
+.Procedure
+
+. Specify the network adapter names in the networks section of `platform.vsphere.failureDomains[*].topology` as shown in the following `install-config.yaml` file:
++
+[source,yaml]
+----
+platform:
+  vsphere:
+    vcenters:
+      ...
+    failureDomains:
+    - name: <failure_domain_name>
+      region: <default_region_name>
+      zone: <default_zone_name>
+      server: <fully_qualified_domain_name>
+      topology:
+        datacenter: <data_center>
+        computeCluster: "/<data_center>/host/<cluster>"
+        networks: # <1>
+        - <VM_network1_name>
+        - <VM_network2_name>
+        - ...
+        - <VM_network10_name>
+----
+<1> Specifies the list of network adapters. You can specify up to 10 network adapters.
+
+. Specify at least one of the following configurations in the `install-config.yaml` file:
+
+** `networking.machineNetwork`
++
+.Example configuration
++
+[source,yaml]
+----
+networking:
+  ...
+  machineNetwork:
+  - cidr: 10.0.0.0/16
+  ...
+----
++
+[NOTE]
+====
+The `networking.machineNetwork.cidr` field must correspond to an address on the first adapter defined in `topology.networks`.
+====
+
+** Add a `nodeNetworking` object to the `install-config.yaml` file and specify internal and external network subnet CIDR implementations for the object.
++
+.Example configuration
++
+[source,yaml]
+----
+platform:
+  vsphere:
+    nodeNetworking:
+     external:
+       networkSubnetCidr:
+       - <machine_network_cidr_ipv4>
+       - <machine_network_cidr_ipv6>
+     internal:
+       networkSubnetCidr:
+       - <machine_network_cidr_ipv4>
+       - <machine_network_cidr_ipv6>
+    failureDomains:
+    - name: <failure_domain_name>
+      region: <default_region_name>
+----
\ No newline at end of file
diff --git a/modules/nw-network-config.adoc b/modules/nw-network-config.adoc
index e50b1cef9c..b639dd365a 100644
--- a/modules/nw-network-config.adoc
+++ b/modules/nw-network-config.adoc
@@ -24,6 +24,7 @@ Phase 1:: You can customize the following network-related fields in the `install
 * `networking.clusterNetwork`
 * `networking.serviceNetwork`
 * `networking.machineNetwork`
+* `nodeNetworking`
 +
 For more information, see "Installation configuration parameters".
 +