Merge pull request #50698 from ousleyp/cnv-13983

CNV-13983: bare metal requirements

Author: ousleyp

installing/installing_bare_metal/preparing-to-install-on-bare-metal.adoc

@@ -12,6 +12,15 @@ toc::[]
 * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
 * You have read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
 
+include::modules/virt-planning-bare-metal-cluster-for-ocp-virt.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../virt/install/preparing-cluster-for-virt.adoc#preparing-cluster-for-virt[Preparing your cluster for {VirtProductName}]
+* xref:../../networking/hardware_networks/about-sriov.adoc#about-sriov[About Single Root I/O Virtualization (SR-IOV) hardware networks]
+* xref:../../virt/virtual_machines/vm_networking/virt-configuring-sriov-device-for-vms.adoc#virt-configuring-sriov-device-for-vms[Configuring an SR-IOV network device for virtual machines]
+
 [id="choosing-a-method-to-install-ocp-on-bare-metal"]
 == Choosing a method to install {product-title} on bare metal
 

installing/installing_bare_metal_ipi/ipi-install-prerequisites.adoc

@@ -20,9 +20,24 @@ ifndef::openshift-origin[. One provisioner node with {op-system-base-full} 8.x i
 Before starting an installer-provisioned installation of {product-title}, ensure the hardware environment meets the following requirements.
 
 include::modules/ipi-install-node-requirements.adoc[leveloffset=+1]
+
+include::modules/virt-planning-bare-metal-cluster-for-ocp-virt.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../virt/install/preparing-cluster-for-virt.adoc#preparing-cluster-for-virt[Preparing your cluster for {VirtProductName}]
+* xref:../../networking/hardware_networks/about-sriov.adoc#about-sriov[About Single Root I/O Virtualization (SR-IOV) hardware networks]
+* xref:../../virt/virtual_machines/vm_networking/virt-configuring-sriov-device-for-vms.adoc#virt-configuring-sriov-device-for-vms[Configuring an SR-IOV network device for virtual machines]
+
 include::modules/ipi-install-firmware-requirements-for-installing-with-virtual-media.adoc[leveloffset=+1]
+
 include::modules/ipi-install-network-requirements.adoc[leveloffset=+1]
+
 include::modules/ipi-install-configuring-nodes.adoc[leveloffset=+1]
+
 include::modules/ipi-install-out-of-band-management.adoc[leveloffset=+1]
+
 include::modules/ipi-install-required-data-for-installation.adoc[leveloffset=+1]
+
 include::modules/ipi-install-validation-checklist-for-nodes.adoc[leveloffset=+1]

modules/virt-planning-bare-metal-cluster-for-ocp-virt.adoc

@@ -0,0 +1,21 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_bare_metal/preparing-to-install-on-bare-metal.adoc
+// * installing/installing_bare_metal_ipi/ipi-install-prerequisites.adoc
+
+:_content-type: REFERENCE
+[id="virt-planning-bare-metal-cluster-for-ocp-virt_{context}"]
+= Planning a bare metal cluster for {VirtProductName}
+
+If you will use {VirtProductName}, it is important to be aware of several requirements before you install your bare metal cluster.
+
+* If you want to use live migration features, you must have multiple worker nodes _at the time of cluster installation_. This is because live migration requires the cluster-level high availability (HA) flag to be set to true. The HA flag is set when a cluster is installed and cannot be changed afterwards. If there are fewer than two worker nodes defined when you install your cluster, the HA flag is set to false for the life of the cluster.
++
+[NOTE]
+====
+You can install {VirtProductName} on a single-node cluster, but single-node OpenShift does not support high availability.
+====
+
+* Live migration requires shared storage. Storage for {VirtProductName} must support and use the ReadWriteMany (RWX) access mode.
+
+* If you plan to use Single Root I/O Virtualization (SR-IOV), ensure that your network interface controllers (NICs) are supported by {product-title}.