Installation VirtualBox

Wenn du Oracle VirtualBox als Virtualisierungsumgebung einsetzt, kannst du mit der folgenden Schritt-für-Schritt-Anleitung eine grundlegende OpenCCU-Installation durchführen.

• Ein Rechner mit installiertem VirtualBox (inkl. Extension Pack für USB-2.0-Unterstützung).
• Für die virtuelle Maschine: 2 CPU-Kerne, 2 GB Arbeitsspeicher und eine virtuelle Festplatte mit mindestens 6 GB (empfohlen: 8 GB).
• Ein unterstütztes USB- bzw. netzwerkbasiertes Funkmodul, z. B. HmIP-RFUSB, HB-RF-USB-2 oder HB-RF-ETH.

Hinweis: Für die Erstinstallation unter VirtualBox wird die *.ova verwendet. Die *-ova.zip ist nur für spätere WebUI-basierte Updates einer bereits installierten VM notwendig.

1. Download Lade die aktuelle *.ova unter Releases herunter.

2. Appliance importieren Öffne die grafische Oberfläche von VirtualBox und wähle „Appliance importieren“, um eine neue VM anzulegen.

3. Einstellungen prüfen/anpassen Im folgenden Dialog die vorgeschlagenen Einstellungen prüfen und bei Bedarf anpassen.

4. Virtuelle Festplatte im Medien-Manager öffnen Nach dem Import in den Manager für virtuelle Medien wechseln.

5. Festplattengröße anpassen Die beim Import angelegte virtuelle Festplatte der OpenCCU-VM auswählen, „Eigenschaften“ öffnen und die Kapazität per Schieberegler vergrößern (empfohlen 8 GB), damit /usr/local ausreichend Platz hat.

6. VM-Einstellungen optimieren Öffne „Ändern… / Einstellungen“ der neuen VM.

   • USB-Passthrough: Setze den USB-Controller auf USB 2.0 (OHCI + EHCI) oder höher. Falls du ein HmIP-RFUSB oder ein Funkmodul über HB-RF-USB/HB-RF-USB-2 verwendest, reiche das Gerät an die VM durch: Klicke rechts auf den USB-Stecker mit „+“ und wähle das entsprechende Gerät aus. Tipp: Unter Windows wird die USB-Platine nach Standby/Neustart manchmal nicht korrekt erkannt. Füge in diesem Fall zusätzlich den USB-Hub bzw. das FTDI-Gerät als Filter hinzu.

   • Paravirtualisierung: Stelle die Paravirtualisierung auf „KVM“, um Probleme mit einer ungenauen Zeitsynchronisation zu vermeiden.

7. Erster Start Starte die VM. In der virtuellen Konsole solltest du den Startvorgang sehen. Nach erfolgreichem Start meldet sich OpenCCU im Netzwerk. Rufe anschließend die WebUI unter http://openccu/ (oder über die per DHCP vergebene IP-Adresse) auf. Anschließend helfen die ersten Schritte nach der Installation bei der weiteren Einrichtung.

Updates erfolgen über die Updatefunktion der WebUI bzw. manuell mit dem *-ova.zip-Archiv.

Hinweise zur Deinstallation finden sich unter Deinstallation.