make it nicer :-)

admin-guide/order-vm.md

@@ -1,24 +1,19 @@
 # Howto Order a VM
 This guide explains the necessary steps how to order a VM until this process is implemented in ServiceNow.
 
-According to Peter Hüssers latest information (12.09.2023) everybody that does not belong the these groups need to pay for a VM
-(latest definition see: smb://fs03/AITvirtualization/SLA/wer_bezahlt.docx):
-1.     VMs, die auf einem Cluster laufen die von einem Kunden bezahlt wurden Aktuell (2023) sind dies die Cluster: cpt*, gfa*, gls, catia-3d
-2.     AIT und gemaess einem Statement von Allenspach der gesamte Logbereich
-3.     AWI: War ja frueher Bestandteil von AIT
-4.     VMs, welche vor der Einfuehrung des Verrechnungswesens existiert haben.
+## Costs
 
-For all other VM requests an SLA document needs to be created according to this template: smb://fs03/AITvirtualization/SLA/Template/SLA_V2.dotx
+You need to pay for the VM except:
 
-The SLA document should be placed in smb://fs03/AITvirtualization/SLA/Linux
+1.     VMs running on an already paid ESX-Cluster (for 2023 this is cpt*, gfa*, gls, catia-3d)
+2.     AIT
+3.     AWI
+4.     LOG
 
-```{info}
-Access to the smb://fs03/AITvirtualization share is/can be granted by Peter Hüsser.
-```
+A SLA document[^2] will be prepared which shows the annual costs.
 
-The important information for the SLA is the PSP the costs will be carged on.
-
-Beside the SLA this is the additional information needed to setup the VM:
+## VM information
+Information needed to setup the VM:
 - Contact person
 - Hostname of virtual server
 - OS (Linux / Windows)
@@ -26,10 +21,21 @@ Beside the SLA this is the additional information needed to setup the VM:
 - Number of CPUs
 - Memory [GB]
 - Diskspace [GB]
+- **PSP** if you need an SLA
 
-To install Linux afterwards following sysdb entries are needed:
-- hiera group (facility)
-- role
+To install Linux afterwards following information is required for Sysdb:
 - MAC address
+- Sysdb environment (facility)
+- Puppet role
+- Puppet group (if not `default`)
 
 Also a hiera configuration file needs be created to set the local admin (if different from the default admin for the hiera group
+
+[^1]: according to Peter Hüsser (12.09.2023), latest definition see: smb://fs03/AITvirtualization/SLA/wer_bezahlt.docx
+[^2]: SLA document to be prepared with template smb://fs03/AITvirtualization/SLA/Template/SLA_V2.dotx and then to be placed in smb://fs03/AITvirtualization/SLA/Linux
+
+
+```{info}
+Access to the smb://fs03/AITvirtualization share is/can be granted by Peter Hüsser.
+
+```