extend partitioning documentation

admin-guide/deployment/partitioning.rst

@@ -1,6 +1,8 @@
 Partitioning
 ============
 
+Default Partitioning
+--------------------
 Partitions system are configured with a standard schema using LVM, so
 that they can be possibly changed afterwards.
 
@@ -34,10 +36,45 @@ For RHEL 8 it is:
        - ``lv_var_tmp`` of 2 Gb size for ``/var/log``;
        - ``lv_tmp`` of 2 Gb size for ``/tmp``.
 
-To increase these sizes, you might use :doc:`vgroot::path <../puppet/profiles/vgroot>` in Hiera.
+Partial Custom Partitioning
+---------------------------
 
-Custom Partitioning
--------------------
+To increase these sizes of the above listed default volumes, you might use :doc:`vgroot::path <../puppet/profiles/vgroot>` in Hiera::
+
+    vgroot::path:
+      lv_root: 50GB
+      lv_var: 30GB
+
+To add a new volume to the system disk (Volume Group ``vg_root``), you need to address the `Puppet LVM module<https://forge.puppet.com/modules/puppetlabs/lvm>`_ directly in Hiera::
+
+    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::
+
+    lvm::volume_groups:
+      vg_data:
+        physical_volumes:
+          - '/dev/sdb'
+        logical_volumes:
+          lv_usr_local:
+            mountpath: '/usr/local'
+            fs_type: 'xfs'
+
+
+
+Full Custom Partitioning
+------------------------
 It is possible to customize the partitioning by using the ``partitions`` attribute on sysdb.
 
 The ``partitions`` attribute can take two values:
@@ -48,4 +85,4 @@ The ``partitions`` attribute can take two values:
 If it is not possible to download the given URL the system fails-back to manual at installation time.
 Please also note that no check is done on the URL content. 
 
-Note that if you want to do add partitions outside of the on the system disk (while keeping above default partitioning for it), you might use Puppet and the `lvm Puppet module <https://forge.puppet.com/modules/puppetlabs/lvm>`_ instead to define the full LVM volume group.
+