add configuration guides

_toc.yml

@@ -21,6 +21,22 @@ parts:
   - caption: Admin Guide
     chapters:
       - file: admin-guide/index
+      - file: admin-guide/architecture
+      - file: admin-guide/configuration
+        sections:
+          - file: admin-guide/configuration/vgroot
+          - file: admin-guide/configuration/citrix_vda
+      - file: admin-guide/guidelines
+      - file: admin-guide/deployment
+      - file: admin-guide/puppet
+      - file: admin-guide/selinux
+      - file: admin-guide/kerberos
+      - file: admin-guide/software
+      - file: admin-guide/mgmt-tools
+      - file: admin-guide/operations
+      - file: admin-guide/third-party
+      - file: admin-guide/troubleshooting
+      - file: admin-guide/more
 
   - caption: Infrastructure Guide
     chapters:

admin-guide/configuration.md

@@ -0,0 +1,17 @@
+---
+title: Configuration Guides
+description: Sysadmin Configuration Guides for Red Hat Enterprise Linux at PSI
+lead: ""
+date: 2023-05-09T10:48:23+00:00
+lastmod: 2023-05-09T10:48:23+00:00
+draft: false
+images: []
+toc: true
+---
+
+# Configuration Guides
+
+Here starts a so far small collections of configuration guides for sysadmins of RHEL installations using Puppet and Hiera.
+
+- [Resize System Volumes (volume group `vg_root`)](configuration/vgroot)
+- [Install Citrix VDA](configuration/citrix_vda)

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
+```

admin-guide/index.rst

@@ -12,6 +12,7 @@ Contents:
    :maxdepth: 2
 
    architecture
+   configuration
    guidelines
    deployment
    puppet