You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/lvms-creating-logical-volume-manager-cluster.adoc
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -59,6 +59,7 @@ spec:
59
59
paths:
60
60
- /dev/disk/by-path/pci-0000:87:00.0-nvme-1
61
61
- /dev/disk/by-path/pci-0000:88:00.0-nvme-1
62
+
- /dev/md/md-var
62
63
optionalPaths:
63
64
- /dev/disk/by-path/pci-0000:89:00.0-nvme-1
64
65
- /dev/disk/by-path/pci-0000:90:00.0-nvme-1
@@ -82,7 +83,7 @@ When configuring multiple device classes, you must specify the device path for e
82
83
<2> Set `fstype` to `ext4` or `xfs`. By default, it is set to `xfs` if the setting is not specified.
83
84
<3> Mandatory: The `LVMCluster` resource must contain a single default storage class. Set `default: false` for secondary device storage classes.
84
85
If you are updating the `LVMCluster` resource from a previous version, you must specify a single default device class.
85
-
<4> Optional. To control or restrict the volume group to your preferred devices, you can manually specify the local paths of the devices in the `deviceSelector` section of the `LVMCluster` YAML. The `paths` section refers to devices the `LVMCluster` adds, which means those paths must exist. The `optionalPaths` section refers to devices the `LVMCluster` might add. You must specify at least one of `paths` or `optionalPaths` when specifying the `deviceSelector` section. If you specify `paths`, it is not mandatory to specify `optionalPaths`. If you specify `optionalPaths`, it is not mandatory to specify `paths` but at least one optional path must be present on the node. If you do not specify any paths, then the `LVMCluster` adds the unused devices on the node. After a device is added to the `LVMCluster`, it cannot be removed.
86
+
<4> Optional. To control or restrict the volume group to your preferred devices, you can manually specify the local paths of the devices in the `deviceSelector` section of the `LVMCluster` YAML. The `paths` section refers to devices the `LVMCluster` adds, which means those paths must exist. The `optionalPaths` section refers to devices the `LVMCluster` might add. You must specify at least one of `paths` or `optionalPaths` when specifying the `deviceSelector` section. If you specify `paths`, it is not mandatory to specify `optionalPaths`. If you specify `optionalPaths`, it is not mandatory to specify `paths` but at least one optional path must be present on the node. If you do not specify any paths, then the `LVMCluster` adds the unused devices on the node. You can also add the path to the RAID arrays to integrate the RAID arrays with {lvms}. After a device is added to the `LVMCluster`, it cannot be removed.
86
87
<5> Optional: To force wipe the selected disks, set `forceWipeDevicesAndDestroyAllData` to true. This parameter is set to `false` by default.
87
88
<6> Optional: To control what worker nodes the `LVMCluster` CR is applied to, specify a set of node selector labels.
88
89
The specified labels must be present on the node in order for the `LVMCluster` to be scheduled on that node.
= Integrating software RAID arrays with LVM Storage
8
+
9
+
You can create the Redundant Array of Independent Disks (RAID) array by using the `mdadm` utility, and integrate the RAID array with {lvms}. Logical Volume Manager (LVM) does not support creating a software RAID.
10
+
11
+
You can integrate the RAID array with {lvms} while creating the `LVMCluster` custom resource (CR).
12
+
13
+
.Prerequisites
14
+
15
+
* You created a software RAID during the {product-title} installation.
16
+
+
17
+
[IMPORTANT]
18
+
====
19
+
You can only create the RAID array during the installation of {product-title}.
20
+
====
21
+
22
+
* You have installed {lvms}.
23
+
24
+
.Procedure
25
+
26
+
. Open the `LVMCluster` CR YAML file.
27
+
+
28
+
[NOTE]
29
+
====
30
+
If you have created the `LVMCluster` CR, edit the existing `LVMCluster` CR YAML file.
31
+
====
32
+
33
+
. Add the path to the RAID array in the `deviceSelector` field of the `LVMCluster` CR YAML file.
34
+
+
35
+
.Example of RAID array paths in deviceSelector field
36
+
[source,yaml]
37
+
----
38
+
apiVersion: lvm.topolvm.io/v1alpha1
39
+
kind: LVMCluster
40
+
metadata:
41
+
name: my-lvmcluster
42
+
spec:
43
+
storage:
44
+
deviceClasses:
45
+
# ...
46
+
deviceSelector: <1>
47
+
paths:
48
+
- /dev/md/md-var <2>
49
+
- /dev/md0 <3>
50
+
optionalPaths:
51
+
# ...
52
+
----
53
+
<1> Contains the paths to the devices that are used to create the LVM volume group. You can specify the device paths in the `paths` field, the `optionalPaths` field, or both. You cannot remove or replace a device after adding it to the LVM volume group.
54
+
<2> Example of a path to the RAID array that was created by using the `mdadm` utility. In this example, `md-var` is the RAID array.
55
+
<3> In this device path example, `md0` is the RAID array
56
+
57
+
. Save the `LVMCluster` CR YAML file.
58
+
59
+
[NOTE]
60
+
====
61
+
If you do not add the path to the RAID array in the `deviceSelector` field, the {lvms} Operator does not recognize the RAID array.
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
19
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
50
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
* xref:../../../installing/install_config/installing-customizing.adoc#installation-special-config-raid_installing-customizing[Configuring a RAID-enabled data volume]
81
+
* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/managing_storage_devices/managing-raid_managing-storage-devices#creating-a-software-raid-on-an-installed-system_managing-raid[Creating a software RAID on an installed system]
82
+
* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/managing_storage_devices/managing-raid_managing-storage-devices#replacing-a-failed-disk-in-raid_managing-raid[Replacing a failed disk in RAID]
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
118
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
0 commit comments