From ecd20d7c8a484868c40e2b759d89bafe6dc0c992 Mon Sep 17 00:00:00 2001
From: Konrad Bucheli <konrad.bucheli@psi.ch>
Date: Wed, 10 May 2023 11:02:32 +0200
Subject: [PATCH] add configuration guides

---
 _toc.yml                                | 16 +++++++++
 admin-guide/configuration.md            | 17 ++++++++++
 admin-guide/configuration/citrix_vda.md | 12 +++++++
 admin-guide/configuration/vgroot.md     | 45 +++++++++++++++++++++++++
 admin-guide/index.rst                   |  1 +
 5 files changed, 91 insertions(+)
 create mode 100644 admin-guide/configuration.md
 create mode 100644 admin-guide/configuration/citrix_vda.md
 create mode 100644 admin-guide/configuration/vgroot.md

diff --git a/_toc.yml b/_toc.yml
index 180c3b3f..b0f18dcd 100644
--- a/_toc.yml
+++ b/_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:
diff --git a/admin-guide/configuration.md b/admin-guide/configuration.md
new file mode 100644
index 00000000..cac7d24a
--- /dev/null
+++ b/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)
diff --git a/admin-guide/configuration/citrix_vda.md b/admin-guide/configuration/citrix_vda.md
new file mode 100644
index 00000000..ea8b64e4
--- /dev/null
+++ b/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}"
+```
diff --git a/admin-guide/configuration/vgroot.md b/admin-guide/configuration/vgroot.md
new file mode 100644
index 00000000..b01f7509
--- /dev/null
+++ b/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
+```
diff --git a/admin-guide/index.rst b/admin-guide/index.rst
index c92911c6..7fda0d18 100644
--- a/admin-guide/index.rst
+++ b/admin-guide/index.rst
@@ -12,6 +12,7 @@ Contents:
    :maxdepth: 2
 
    architecture
+   configuration
    guidelines
    deployment
    puppet