Merge pull request #58263 from ShaunaDiaz/OCPBUGS11249

OSDOCS-5662: add prereq for VG capacity

Author: jab-rh

microshift_install/microshift-install-rpm.adoc

@@ -11,6 +11,7 @@ You can install {product-title} from an RPM package on a machine with {op-system
 include::snippets/microshift-tech-preview-snip.adoc[leveloffset=+1]
 
 include::modules/microshift-install-system-requirements.adoc[leveloffset=+1]
+include::modules/microshift-install-rpm-before.adoc[leveloffset=+1]
 include::modules/microshift-install-rpm-preparing.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
@@ -24,7 +25,7 @@ include::modules/microshift-install-rpm-preparing.adoc[leveloffset=+1]
 
 * For more information about resizing your existing LVs to free up capacity in your VGs, refer to link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/configuring_and_managing_logical_volumes/index#managing-lvm-volume-groups_configuring-and-managing-logical-volumes[Managing LVM Volume Groups].
 
-include::modules/microshift-installing-from-rpm.adoc[leveloffset=+1]
+include::modules/microshift-install-rpms.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources

modules/microshift-install-rpm-before.adoc

@@ -0,0 +1,11 @@
+// Module included in the following assemblies:
+//
+// microshift/microshift-install-rpm.adoc
+
+:_content-type: CONCEPT
+[id="microshift-install-rpm-before_{context}"]
+= Before installing {product-title} from an RPM package
+
+{product-title} uses the logical volume manager storage (LVMS) Container Storage Interface (CSI) plugin for providing storage to persistent volumes (PVs). LVMS relies on the Linux logical volume manager (LVM) to dynamically manage the backing logical volumes (LVs) for PVs. For this reason, your machine must have an LVM volume group (VG) with unused space in which LVMS can create the LVs for your workload's PVs.
+
+To configure a volume group (VG) that allows LVMS to create the LVs for your workload's PVs, lower the *Desired Size* of your root volume during the installation of {op-system}. Lowering the size of your root volume allows unallocated space on the disk for additional LVs created by LVMS at runtime.

modules/microshift-install-rpm-preparing.adoc

@@ -6,30 +6,27 @@
 [id="microshift-install-rpm-preparing_{context}"]
 = Preparing to install {product-title} from an RPM package
 
-Before installing {product-title} from an RPM package, you must configure your {op-system} machine to have a logical volume manager (LVM) volume group (VG) with sufficient capacity for the persistent volumes (PVs) of your workload.
-
-{product-title} uses the logical volume manager storage (LVMS) Container Storage Interface (CSI) provider for storing PVs. LVMS relies on Linux's LVM to dynamically manage the backing storage for PVs. For this reason, your machine must have an LVM VG with unused space in which LVMS can create the LVM logical volumes (LVs) for your workload's PVs.
-
-To configure a volume group (VG) that allows LVMS to create the LVs for your workload's PVs, adjust your root volume's size during the installation of {op-system}. Adjusting your root volume's size provides free space for additional LVs created by LVMS at runtime.
+Configure your {op-system} machine to have a logical volume manager (LVM) volume group (VG) with sufficient capacity for the persistent volumes (PVs) of your workload.
 
 .Prerequisites
 
 * The system requirements for installing {product-title} have been met.
 * You have root user access to your machine.
+* You have configured your LVM VG with the capacity needed for the PVs of your workload.
 
 .Procedure
 
-. In the graphical installer under *Storage Configuration*, select *Custom* -> *Done* to open the dialog for configuring partitions and volumes.
+. In the graphical installer under *Installation Destination* in the *Storage Configuration* subsection, select *Custom* -> *Done* to open the dialog for configuring partitions and volumes. The Manual Partitioning window is displayed.
 
-. Under *New Red Hat Enterprise Linux 9.x Installation*, select *Click here to create them automatically*.
+. Under *New Red Hat Enterprise Linux {op-system-version-major}.x Installation*, select *Click here to create them automatically*.
 
 . Select the root partition, */*, reduce *Desired Capacity* so that the VG has sufficient capacity for your PVs, and then click *Update Settings*.
 
 . Complete your installation.
 +
 [NOTE]
 ====
-For more options on partition configuration, see the guide linked in the Additional information section for Configuring Manual Partitioning.
+For more options on partition configuration, read the guide linked in the Additional information section for Configuring Manual Partitioning.
 ====
 
 . As a root user, verify the VG capacity available on your system by running the following command: