===== Kurzreferenz =====

^Aktion ^Erläuterung ^
|Maschine aus einem Template importieren|<WRAP>
Syntax: \\
<code>
vboxmanage import  //Template-Pfad// --vsys 0 --vmname //Name// --vsys 0 --unit 6 --disk //Pfad zur neuen Festplatte//
</code>

Beispiel: 
<code>
vboxmanage import  templates/debian/empty.ova --vsys 0 --vmname test-debian --vsys 0 --unit 6 --disk maschinen/test-debian/disk1.vmdk
</code>

Beispiel:
<code>
vboxmanage createvm --name somelinux --ostype Linux_64 --register --basefolder /maschinen/somelinux
</code>
</WRAP> |
|Neue VM erstellen|<WRAP>
Syntax: 
<code>
vboxmanage createvm --name //Name//
</code>

Mann kann weitere Parameter angeben, wie zum Beispiel: \\
  * <code>--register</code> -> macht die Maschine gegenüber virtualbox bekannt; der Schritt muss sonst im Nachhinein manuell gemacht werden
  * <code>--ostype</code> -> definiert den Betriebssystemtyp, muss sonst im Nachgand definiert werden -> eine Liste bekommt man mit "virtualbox list ostypes"
  * <code>--basefolder</code> -> definiert wo die Dateien der VM abgelegt werden sollen (ist in der Regel nicht notwendig, dann landet es an der Standard-Stelle)

Beispiel: 
<code>
vboxmanage createvm --name somelinux --ostype Linux_64 --register --basefolder /maschinen/somelinux
</code>

</WRAP> |
|Festplatte erstellen |<WRAP>
\\
Syntax: \\
<code>
vboxmanage createmedium disk --filename //Pfad zur Festplatte// --size //Größe in Megabyte//
</code>

Beispiel:
<code>
vboxmanage createmedium disk --filename /maschinen/pclinuxos/pclinuxos/pclinuxos.vmdk --size 20000
</code>
</WRAP> |
|Storagecontroller hinzufügen|<WRAP>
Syntax:
<code>
vboxmanage storagectl //vmname// --name //beliebiger_name// --add //controler-typ// 
</code>
Beispiel:
<code>
vboxmanage storagectl somelinuxos --name sata1 --add sata 
</code>
</WRAP>|
|DVD hinzufügen/Massenspeicher hinzufügen| <WRAP>Voraussetzung: Es wurde zuvor ein Storagecontroller der VM hinzugefügt. \\ \\
Syntax:
<code>
vboxmanage storageattach //VM-Name//  --storagectl //Storage-Kontroller// --port //Portnummer am Kontroller// --type //Medium-Typ// --medium //Pfad zum Medium//
</code>
Beispiel:
<code>
vboxmanage storageattach debian-test  --storagectl sata1 --port 1 --type dvddrive --medium /somewhere/templates/isos/debian-8.1.iso
</code>

</WRAP> |

==== Troubleshooting =====

^Problem ^Lösung ^
|VLAN funktioniert nicht - Hostsystem Windows | Sieht so aus als würde Windows die Tags wegfiltern. \\ \\ Keine Lösung bekannt|
|Linux bleibt mein booten stehen - <code>exception Emask 0x0 SAc 0x0 SErr 0x0 action 0x6frozen</code> |Syntax: <code> VBoxManage storagectl <vmname> --name <storage controller name> --hostiocache on </code>  \\ \\ Beispiel: <code>VBoxManage storagectl test101 --name sata1 --hostiocache on</code>|
|VM lässt sich nicht mehr (vollständig - Stopp-Kommando hängt) beenden|Syntax: <code> vboxmanage startvm <vmname> --type emergencystop </code>\\ Beispiel: <code>VBoxManage startvm test101 --type emergencystop</code>|
|Imortiereren einer VM schlägt fehl: <code>
Progress object failure: NS_ERROR_CALL_FAILED
VBoxManage: error: Appliance import failed
VBoxManage: error: Code NS_ERROR_CALL_FAILED (0x800706BE) 
- Call to remote object failed (extended info not available)
VBoxManage: error: Context: "RTEXITCODE handleImportAppliance(HandlerArg*)" 
at line 877 of file VBoxManageAppliance.cpp
</code>  | Die Endung der Festplattendatei ist falsch. \\ \\ Beispiel: <code>
vboxmanage import  /somewhere/templates/devuan_basic.ova  --vsys 0 --vmname test5 --vsys 0 --unit 8 --disk /maschinen/test5/disk.vmdk
</code>  \\  In obigem Beispiel hat die Festplattendatei die Endung .disc, die aber ungültig ist.  \\ \\ Korrekt: <code>
vboxmanage import  /somewhere/templates/devuan_basic.ova  --vsys 0 --vmname test5 --vsys 0 --unit 8 --disk /maschinen/test5/disk.vmdk
</code> |
|<code>error: Cannot import until the license agreement listed above is accepted.</code>|Die folgende Option hinzufügen<code>--vsys 0 --eula accept</code> |
|VBoxManage: error: Invalid parameter|Es kann sein das nicht der Parameter falsch ist (es wird eventuell wird der Wert als falsch angezeigt), es kann sein das nicht -- angeben wurde oder irgend ein Parameter davor oder dahinter ist falsch oder der VMName ist falsch|