title	description	weight
sds-node-configurator module	sds-node-configurator module: block device and LVM management	1

{{< alert level="warning" >}} Module functionality is guaranteed only when using stock kernels provided with supported distributions.

Module functionality when using other kernels or distributions is possible but not guaranteed. {{< /alert >}}

The sds-node-configurator module manages block devices and LVM on Kubernetes cluster nodes through Kubernetes custom resources. Main module capabilities:

• Automatic discovery of block devices and creation/update/deletion of corresponding BlockDevice resources.

  Warning. Manual creation and modification of BlockDevice resource is prohibited.

• Automatic discovery of LVM Volume Groups with LVM tag storage.deckhouse.io/enabled=true and thin pools on them on nodes, as well as management of corresponding LVMVolumeGroup resources. The module automatically creates an LVMVolumeGroup resource if it doesn't exist yet for the discovered LVM Volume Group.

• Scanning LVM Physical Volumes on nodes that are part of managed LVM Volume Groups. When underlying block devices are expanded, corresponding LVM Physical Volumes are automatically increased (performs pvresize).

  Warning. Reducing block device sizes is not supported.

• Creation/expansion/deletion of LVM Volume Groups on the node according to LVMVolumeGroup resource settings. To see examples, refer to Working with LVMVolumeGroup resources.

Documentation

• Working with resources: Practical examples of creating, modifying and deleting BlockDevice and LVMVolumeGroup resources.
• Custom Resources: Module CRD reference.
• Configuration: Module parameter configuration.
• Configuration scenarios: Typical disk subsystem configuration scenarios for various storage configurations.
• FAQ: Frequently asked questions and answers.