add configuration guides

admin-guide/configuration/citrix_vda.md

@@ -0,0 +1,12 @@
+# Citrix VDA Installation
+
+There is a [installation guide](https://docs.citrix.com/en-us/linux-virtual-delivery-agent/current-release/installation-overview/manual-installation-overview/redhat.html) by Citrix to install the Citrix VDA manually on Red Hat systems.
+
+The following Hiera settings will bring the system into a state suitable as requested in the installation guide:
+```
+# Citrix VDA specialities
+hostname::short: true
+networking::hostname_on_lo: true
+aaa::sssd_cache_creds: false
+aaa::default_krb_cache: "FILE:/tmp/krb5cc_%{literal('%')}{uid}"
+```

admin-guide/configuration/vgroot.md

@@ -0,0 +1,45 @@
+# 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
+
+To check how much space is still available, use `pvs` and look for the volume group `vgroot`:
+```
+[root@lxdev00 ~]# pvs
+  PV         VG      Fmt  Attr PSize   PFree 
+  /dev/sda2  vg_root lvm2 a--  <62.94g <5.19g
+[root@lxdev00 ~]# 
+```
+
+Then `lvs` gives the sizes of the volumes inside:
+```
+[root@lxdev00 ~]# lvs
+  LV         VG      Attr       LSize   Pool Origin Data%  Meta%  Move Log Cpy%Sync Convert
+  lv_home    vg_root -wi-ao---- <31.44g                                                    
+  lv_openafs vg_root -wi-ao----   2.00g                                                    
+  lv_root    vg_root -wi-ao----  12.31g                                                    
+  lv_tmp     vg_root -wi-ao----   2.00g                                                    
+  lv_var     vg_root -wi-ao----   8.00g                                                    
+  lv_var_log vg_root -wi-ao----   2.00g                                                    
+[root@lxdev00 ~]# 
+```
+
+## Extend System Volume
+
+This can be done in Hiera with the `vgroot::path` key where for each volume which should be bigger a minium size can be set:
+
+```
+vgroot::path:
+    lv_root: 15GB
+    lv_var_log: 3GB
+
+```
+
+This is then applied on the next puppet run, you may trigger one as `root`:
+
+```
+puppet agent -t
+```