move topics

admin-guide/configuration/partitioning.md

@@ -1,10 +1,12 @@
-# Resize System Volumes
+# Partitioning
+
+## Resize System Volumes
 
 The size of the system volumes (inside volume group `vgroot`), are automatically set on a rather small size at the initial installation.
 
 Note that due to the limitations of XFS a volume can only be increased, not be shrunk.
 
-## Get Available Space and Volume Sizes
+### Get Available Space and Volume Sizes
 
 To check how much space is still available, use `pvs` and look for the volume group `vgroot`:
 ```
@@ -27,7 +29,7 @@ Then `lvs` gives the sizes of the volumes inside:
 [root@lxdev00 ~]# 
 ```
 
-## Extend System Volume
+### Extend System Volume
 
 This can be done in Hiera with the `vgroot::path` key where for each volume which should be increased a new minium size can be set:
 
@@ -43,3 +45,35 @@ This is then applied on the next puppet run, you may trigger one as `root`:
 ```
 puppet agent -t
 ```
+
+## Custom Partitioning
+
+To add a new volume to the system disk, you need to address the [lvm Puppet module](https://forge.puppet.com/modules/puppetlabs/lvm) directly in Hiera::
+
+```yaml
+lvm::volume_groups:
+  vg_root:
+    physical_volumes:
+      - /dev/nvme0n1p3
+    logical_volumes:
+      lv_data:
+        size: 3TB
+        fs_type: 'xfs'
+        mountpath: '/mnt/data'
+        size_is_minsize: true
+```
+
+Please note that you need also to list the partition on which `vg_root` is located.
+
+The same you can do to add partitions outside of the system disk, but here you need to define the full LVM volume group:
+
+```yaml
+lvm::volume_groups:
+  vg_data:
+    physical_volumes:
+      - '/dev/sdb'
+    logical_volumes:
+      lv_usr_local:
+        mountpath: '/usr/local'
+        fs_type: 'xfs'
+```