mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
119 lines
4.1 KiB
Plaintext
119 lines
4.1 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * installing/install_config/installing-customizing.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="installation-special-config-raid_{context}"]
|
|
== Configuring a RAID-enabled data volume
|
|
|
|
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.
|
|
|
|
[NOTE]
|
|
====
|
|
{product-title} {product-version} does not support software RAIDs on the installation drive.
|
|
====
|
|
|
|
.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:
|
|
+
|
|
.RAID 1 on mirrored boot disk
|
|
[source,yaml,subs="attributes+"]
|
|
----
|
|
variant: openshift
|
|
version: {product-version}.0
|
|
metadata:
|
|
name: raid1-storage
|
|
labels:
|
|
machineconfiguration.openshift.io/role: worker
|
|
boot_device:
|
|
mirror:
|
|
devices:
|
|
- /dev/disk/by-id/scsi-3600508b400105e210000900000490000
|
|
- /dev/disk/by-id/scsi-SSEAGATE_ST373453LW_3HW1RHM6
|
|
storage:
|
|
disks:
|
|
- device: /dev/disk/by-id/scsi-3600508b400105e210000900000490000
|
|
partitions:
|
|
- label: root-1
|
|
size_mib: 25000 <1>
|
|
- label: var-1
|
|
- device: /dev/disk/by-id/scsi-SSEAGATE_ST373453LW_3HW1RHM6
|
|
partitions:
|
|
- label: root-2
|
|
size_mib: 25000 <1>
|
|
- label: var-2
|
|
raid:
|
|
- name: md-var
|
|
level: raid1
|
|
devices:
|
|
- /dev/disk/by-partlabel/var-1
|
|
- /dev/disk/by-partlabel/var-2
|
|
filesystems:
|
|
- device: /dev/md/md-var
|
|
path: /var
|
|
format: xfs
|
|
wipe_filesystem: true
|
|
with_mount_unit: true
|
|
----
|
|
<1> When adding a data partition to the boot disk, a minimum value of 25000 mebibytes is recommended. If no value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
|
|
|
|
* To configure a data volume with RAID 1 on secondary disks, create a `$HOME/clusterconfig/raid1-alt-storage.bu` file, for example:
|
|
+
|
|
.RAID 1 on secondary disks
|
|
[source,yaml,subs="attributes+"]
|
|
----
|
|
variant: openshift
|
|
version: {product-version}.0
|
|
metadata:
|
|
name: raid1-alt-storage
|
|
labels:
|
|
machineconfiguration.openshift.io/role: worker
|
|
storage:
|
|
disks:
|
|
- device: /dev/sdc
|
|
wipe_table: true
|
|
partitions:
|
|
- label: data-1
|
|
- device: /dev/sdd
|
|
wipe_table: true
|
|
partitions:
|
|
- label: data-2
|
|
raid:
|
|
- name: md-var-lib-containers
|
|
level: raid1
|
|
devices:
|
|
- /dev/disk/by-partlabel/data-1
|
|
- /dev/disk/by-partlabel/data-2
|
|
filesystems:
|
|
- device: /dev/md/md-var-lib-containers
|
|
path: /var/lib/containers
|
|
format: xfs
|
|
wipe_filesystem: true
|
|
with_mount_unit: true
|
|
----
|
|
|
|
. 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]
|
|
----
|
|
$ 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.
|