kickstart VM

_toc.yml

@@ -50,6 +50,7 @@ chapters:
             sections:
               - file: admin-guide/deployment/rhel9/hardware_compatibility
           - file: admin-guide/deployment/basic_installation
+          - file: admin-guide/deployment/vm_installation
           - file: admin-guide/deployment/re_installation
           - file: admin-guide/deployment/console_installation
           - file: admin-guide/deployment/dmz_installation

admin-guide/deployment/basic_installation.md

@@ -57,7 +57,7 @@ bob node set-attr $FQDN puppet_role=role::server
 
 and **optional**:
 ```bash
-# static IP address (options: static, dhcp)
+# static IP address (options: static, dhcp), only for RHEL7 and RHEL8
 bob node set-attr $FQDN network=static
 
 # if you want to use hiera groups and sub-groups

admin-guide/deployment/vm_installation.md

@@ -0,0 +1,44 @@
+# VM Installation
+
+VMs provided by the PSI VMware infrastructure can use the normal [network installation procedure](basic_installation).
+But for the usual local VM setups with host NAT this will not work as the VM needs direct access to the outside network for this.
+Alternatively you an bring everything required for installation to your machine and then install it locally.
+
+## OS Installation Image
+
+The necessary installation images in the form of ISO files can be downloaded for
+
+- [RHEL8](http://repos.psi.ch/rhel8/iso/)
+- [RHEL9](http://repos.psi.ch/rhel9/iso/)
+
+## Kickstart Image
+
+Also for the Kickstart file you can download a ISO image.
+But before you are able to do so the new host needs to be introduced to Sysdb, for the minumun you need the hostname and your Sysdb environment:
+
+```
+FQDN=...
+ENV=...
+bob node add $FQDN $ENV local
+bob node set-attr $FQDN puppet_role=role::base
+```
+With this ready you can download the kickstart ISO image:
+
+```
+FQDN=...
+RHEL=8.10
+URL="http://sysdb.psi.ch/kickstart/v1/config?fqdn=$FQDN&instrepo=rhel-${RHEL}-x86_64-dvd&ks_template=rhel${RHEL%%.*}&format=iso"
+curl --remote-header-name --remote-name "$URL"
+```
+## Installation
+
+- add two CD-ROM drivers to the virual hardware
+- map the first CD-ROM drive to the OS ISO image
+- map the second CD-ROM drive to the kickstart ISO image
+- boot the VM into the OS ISO image
+
+So far this was reported to work with VirtualBox, but it should also work for other hypervisors.
+
+Feel free to provide us with guides or just screenshot sequences so we are able to extend this guide with more details how this is done on different hypervisors.
+
+