diff --git a/installing/install_config/installing-customizing.adoc b/installing/install_config/installing-customizing.adoc index 45d5d8cf1ba2..1b380a79b52a 100644 --- a/installing/install_config/installing-customizing.adoc +++ b/installing/install_config/installing-customizing.adoc @@ -45,6 +45,7 @@ endif::openshift-webscale[] include::modules/installation-special-config-kmod.adoc[leveloffset=+1] include::modules/installation-special-config-storage.adoc[leveloffset=+1] include::modules/installation-special-config-raid.adoc[leveloffset=+1] +include::modules/installation-special-config-raid-intel-vroc.adoc[leveloffset=+1] include::modules/installation-special-config-chrony.adoc[leveloffset=+1] [role="_additional-resources"] diff --git a/modules/installation-special-config-raid-intel-vroc.adoc b/modules/installation-special-config-raid-intel-vroc.adoc new file mode 100644 index 000000000000..9a97695a2eaa --- /dev/null +++ b/modules/installation-special-config-raid-intel-vroc.adoc @@ -0,0 +1,79 @@ +// Module included in the following assemblies: +// +// * installing/install_config/installing-customizing.adoc + +:_mod-docs-content-type: PROCEDURE +[id="installation-special-config-raid-intel-vroc_{context}"] +== Configuring an Intel(R) Virtual RAID on CPU (VROC) data volume + +Intel(R) VROC is a type of hybrid RAID, where some of the maintenance is offloaded to the hardware, but appears as software RAID to the operating system. + +The following procedure configures an Intel(R) VROC-enabled RAID1. + +.Prerequisites + +* You have a system with Intel(R) Volume Management Device (VMD) enabled. + +.Procedure + +. Create the Intel(R) Matrix Storage Manager (IMSM) RAID container by running the following command: ++ +[source,terminal] +---- +$ mdadm -CR /dev/md/imsm0 -e \ + imsm -n2 /dev/nvme0n1 /dev/nvme1n1 <1> +---- +<1> The RAID device names. In this example, there are two devices listed. If you provide more than two device names, you must adjust the `-n` flag. For example, listing three devices would use the flag `-n3`. + +. Create the RAID1 storage inside the container: + +.. Create a dummy RAID0 volume in front of the real RAID1 volume by running the following command: ++ +[source,terminal] +---- +$ mdadm -CR /dev/md/dummy -l0 -n2 /dev/imsm0 -z10m --assume-clean +---- + +.. Create the real RAID1 array by running the following command: ++ +[source,terminal] +---- +$ mdadm -CR /dev/md/coreos -l1 -n2 /dev/imsm0 +---- + +.. Stop both RAID0 and RAID1 member arrays and delete the dummy RAID0 array with the following commands: ++ +[source,terminal] +---- +$ mdadm -S /dev/md/dummy \ + mdadm -S /dev/md/coreos \ + mdadm --kill-subarray=0 /dev/md/imsm0 +---- + +.. Restart the RAID1 arrays by running the following command: ++ +[source,terminal] +---- +$ mdadm -A /dev/md/coreos /dev/md/imsm0 +---- + +. Install {op-system} on the RAID1 device: + +.. Get the UUID of the IMSM container by running the following command: ++ +[source,terminal] +---- +$ mdadm --details --export /dev/md/imsm0 +---- + +.. Install {op-system} and include the `rd.md.uuid` kernel argument by running the following command: ++ +[source,terminal] +---- +$ coreos-installer install /dev/md/coreos \ + --append-karg rd.md.uuid= <1> + ... +---- +<1> The UUID of the IMSM container. ++ +Include any additional `coreos-installer` arguments you need to install {op-system}.