how to install RHEL on Virtualbox

_toc.yml

@@ -80,6 +80,7 @@ chapters:
           - file: admin-guide/deployment/sysdb_env
           - file: admin-guide/deployment/ipxe
           - file: admin-guide/deployment/kickstart
+          - file: admin-guide/deployment/virtualbox_vm
           - file: admin-guide/deployment/infrastructure
       - file: admin-guide/guidelines
       - file: admin-guide/puppet

admin-guide/deployment/virtualbox_vm.md

@@ -0,0 +1,28 @@
+# How to Install a Virtualbox VM
+
+This guides shows how to bootstrap a Virtualbox VM on your workstation with the normal RHEL network boot.
+
+For permanently running VMs please check out [how to order a VM][../order-vm).
+
+## Preparations
+
+- Install VirtualBox including the Extension Pack (admin privileges on the physical machine are required)
+
+- Create a new VM with
+  - 4096 MB memory (the installer needs 4 GB, after you might lower to 2 GB)
+  - 64 GB harddisk
+  - enable EFI
+  - Network Configuration:
+    - Attached to: Bridged Adapter
+    - Adapter Type: Paravirtualized Network (virtio-net)
+
+![system settings](virtualbox_vm/system.png)
+![network settings](virtualbox_vm/network.png)
+
+-  Request a virtual machine number in [ServiceNow](https://psi.service-now.com/psisp?id=psi_new_sc_cat_item&sys_id=86ea7da6db3467801e4f9247db961994) with
+  - Virtual Host Mac Address: copy from VM network adapter settings
+  - PSI Domain join: No (this is done automatically).
+
+- Prepare the node configuation in [sysdb with bob](sample)
+
+- Boot the VM over the network