Merge pull request #44188 from jldohmann/BZ2066913

Author: adellape

modules/installation-special-config-raid.adoc

@@ -7,6 +7,18 @@
 
 You can enable software RAID partitioning to provide an external data volume. {product-title} supports RAID 0, RAID 1, RAID 4, RAID 5, RAID 6, and RAID 10 for data protection and fault tolerance. See "About disk mirroring" for more details.
 
+.Prerequisites
+
+* You have downloaded the {product-title} installation program on your installation node.
+* You have installed Butane on your installation node.
++
+[NOTE]
+====
+Butane is a command-line utility that {product-title} uses to provide convenient, short-hand syntax for writing machine configs, as well as for performing additional validation of machine configs. For more information, see the _Creating machine configs with Butane_ section.
+====
+
+.Procedure
+
 . Create a Butane config that configures a data volume by using software RAID.
 
 * To configure a data volume with RAID 1 on the same disks that are used for a mirrored boot disk, create a `$HOME/clusterconfig/raid1-storage.bu` file, for example:
@@ -87,19 +99,14 @@ storage:
       with_mount_unit: true
 ----
 
-. Run Butane to create a RAID manifest from the Butane config you created in the previous step, for example:
-+
-[source,terminal]
-----
-$ butane $HOME/clusterconfig/<butane_file> -o ./<manifest_name>.yaml <1>
-----
-<1> Replace `<butane_file>` and `<manifest_name>` with the file names from the previous step. For example, `raid1-alt-storage.bu` and `raid1-alt-storage.yaml` for secondary disks.
-
-. Apply the manifest to your cluster by running the following command:
+. Create a RAID manifest from the Butane config you created in the previous step and save it to the `<installation_directory>/openshift` directory. For example, to create a manifest for the compute nodes, run the following command:
 +
 [source,terminal]
 ----
-$ oc create -f <manifest_name>.yaml
+$ butane $HOME/clusterconfig/<butane_config>.bu -o <installation_directory>/openshift/<manifest_name>.yaml <1>
 ----
+<1> Replace `<butane_config>` and `<manifest_name>` with the file names from the previous step. For example, `raid1-alt-storage.bu` and `raid1-alt-storage.yaml` for secondary disks.
 
 . Save the Butane config in case you need to update the manifest in the future.
+
+. Continue with the remainder of the {product-title} installation.