manual.md

@@ -2,18 +2,17 @@ Die Kommandos ```deployclass``` und ```deployvm``` stellen Klassensätze bzw. ei
 
 # deployclass
 
-**Usage:** ```/home/administrator/bin/deployclass <class> [<template>]```
-deploy VMs using ```<template>``` (or Ubuntu), if omitted.
+**Aufruf:** ```/home/administrator/bin/deployclass <class> [<template>]```
+instanziiere VMs mit der Vorlage ```<template>``` (oder Ubuntu, wenn nichts angegeben).
 
-**Prerequisites:** Project ```<class>``` must exist on cloudstack. This project must have an ssh key.
-Admin users (account "administrator") will be given password GebTTMMJJJJ using each student's birthday
-DNS will be updated to have <student-name>.vm.hhs.karlsruhe.de pointing to the vm's IP.
-Note that the first sshkey in the project will be used.
+**Voraussetzungen:** Projekt ```<class>``` muss in cloudstack bereits existieren. Dieses Projekt muss auf der Cloudstack-Webseite unter "Instances" einen SSH-Schlüssel hinterlegt haben.
+Admin-Benutzer (Account "administrator") werden auf jeder VM mit dem Passwort GebTTMMJJJJ mit dem Geburtstag jedes Schülers angelegt. Die DNS-Einträge werden so aktualisiert, dass ```<schüler-name>.vm.hhs.karlsruhe.de``` auf die IP der VM zeigt.
+Beachte: der erste SSH-Schlüssel des Projekts wird verwendet, falls dort mehrere hinterlegt sein sollten. Dies ist nur der Zugang für Lehrkräfte, falls Schüler sich aussperren. VM-seitig können natürlich weitere SSH-Keys mit Putty und ggf. puttygen oder ssh-keygen hinterlegt werden.
 
 # deployvm
-**Usage:** ```/home/administrator/bin/deployvm <project> <distro> <name> <pwd>```
-The ```<project>``` must exist on cloudstack. The ```<distro>``` parameter does a substring search on the available template names 
+**Aufruf:** ```/home/administrator/bin/deployvm <project> <distro> <name> <pwd>```
+Das ```<project>``` muss auf cloudstack bereits existieren. Der ```<distro>``` Parameter wird gegen die verfügbaren Templates gematcht. Eine Liste der verfügbaren Templates kann ausgegeben werden mit 
 
-(cf. ```cmk list templates templatefilter=executable | jq '.template[].name'```).
+```cmk list templates templatefilter=executable | jq '.template[].name'```.
 
-```<name>``` is the VM's name which will be in the DNS records with ```<name>.vm.hhs.karlsruhe.de```. Adminuser can be configured in the script and is currently "administrator".
+```<name>``` ist der Name der VM. Dieser wird in den DNS-Einträgen abgespeichert unter ```<name>.vm.hhs.karlsruhe.de```. Der Adminuser kann nur im Skript konfiguriert werden. Derzeit lautet dieser "administrator".
\ No newline at end of file