Tornevall Networks

← Back to docs

VirtualBox Manager

Language: SV | EN | SV

VirtualBox Manager

VirtualBox Manager är ett webbaserat GUI i Tools för att hantera VirtualBox-värdar via VirtualBox WebService SOAP API.

  • Tools ansluter mot en konfigurerad vboxwebsrv-endpoint över HTTP eller HTTPS.
  • Sparad host och port ska peka på reverse proxyn framför vboxwebsrv.
  • Sparat användarnamn och lösenord används som API-inloggning mot VirtualBox WebService.
  • De uppgifterna kommer från själva VirtualBox-värden (till exempel användaren vboxapi som skapas av en install-vbox-proxy.sh-liknande installation). Det är alltså inte samma sak som ditt vanliga Tools-konto.

Route: /admin/virtualbox

Åtkomst

  • Kräver inloggning
  • Kräver behörighet: virtualbox.manage

Funktioner

  • Registrera en eller flera VirtualBox WebService-endpoints (host, port, API-användarnamn, API-lösenord)
  • Få varje server i ett eget segment
  • Expandera servern och se VM-lista i en minimalistisk förstavy
  • Starta, stoppa, starta om och radera VM
  • Köra de flesta operationer via AJAX (utan full postback vid normal användning)
  • Ändra grundläggande VM-inställningar direkt i panelen:
    • Minne (MB)
    • Antal CPU
    • VRAM (MB)
    • Primär boot-enhet
  • Skapa nya VM direkt i serverkortet med standardvärden:
    • Nätverksläge: bridged (standard)
    • Minne: 1024 MB (standard)
    • Disk: 25 GB (standard)
    • Valfri installations-ISO

Så lägger du till en server

  1. Gå till /admin/virtualbox
  2. Fyll i:
    • Label
    • Host (till exempel http://10.1.1.56)
    • Port (standard 8443 för den reverse-proxade vboxwebsrv-endpointen)
    • API-användarnamn från VirtualBox-värden (till exempel vboxapi)
    • API-lösenord för samma VirtualBox WebService-användare
  3. Spara
  4. Klicka på Test connection

Om host och inloggning stämmer laddas VM-listan direkt i serverkortet.

Krav för endpointen

  • En reverse proxy eller direkt lyssnare måste exponera målets vboxwebsrv-endpoint.
  • Referensinstallationen via install-vbox-proxy.sh exponerar som standard vanlig http://HOST:8443. Använd https:// bara om du själv har lagt TLS-terminering framför proxyn.
  • Om host-fältet saknar http:// eller https:// antar Tools http://.
  • Sparad port läggs till efter hosten om host-fältet inte redan innehåller en explicit port.
  • PHP på Tools-sidan måste ha SOAP-tillägget aktiverat, eftersom Tools nu pratar med VirtualBox via SOAP i stället för att shella ut till VBoxManage.
  • Tools läser nu först in de faktiska metodnamnen från WSDL:n och prioriterar VirtualBox-stil som IWebsessionManager_logon, IWebsessionManager_logoff och IWebsessionManager_getSessionObject innan generiska gissningar används.
  • Om själva VirtualBox-WSDL:n går att nå men PHP SOAP fallerar med ett Parsing WSDL- / Couldn't bind to service-liknande fel försöker Tools nu automatiskt igen mot samma endpoint via flera non-WSDL SOAP-klientkandidater i stället för att stoppa direkt.
  • Om WSDL-klienten når servern men login fallerar med ett namespace-/metodfel som Method 'ns1:logon' not implemented: method name or namespace not recognized testar Tools nu samma login mot båda kända VirtualBox-SOAP-URI:erna:
    • http://www.virtualbox.org/
    • http://www.virtualbox.org/Service
  • Om login fortfarande misslyckas visar admin-diagnostiken nu faktisk endpoint, WSDL-URL, vald SOAP-mod, vald SOAP-URI, tillgängliga WSDL-funktioner och hela loginförsökskedjan i raw-debug-payloaden.

Nytt flöde för att skapa VM

Varje serversegment har nu en sektion för Create new VM.

Obligatoriskt:

  • VM-namn

Valfritt (förifyllda standardvärden):

  • OS-typ (Other_64 som standard)
  • Minne (1024)
  • Diskstorlek i GB (25)
  • Antal CPU (1)
  • Nätverksläge (bridged som standard)
  • Bridge-adapter (Auto väljer första hittade bridged-adapter)
  • Installations-ISO (valfritt)

Flödet är medvetet fokuserat på praktisk VM-provisionering utan beroende av unattended/autoinstall.

Kontroll av installations-ISO

  • Tools läser nu in serverregistrerade DVD-medier från VirtualBox och visar dem som valbara ISO-sökvägar i VM-formuläret.
  • ISO-attach är valfritt; utan ISO skapas VM som disk-only och kan kompletteras senare.
  • Om ISO-uppläsning misslyckas för en server går det ändå att skapa VM med manuell ISO-sökväg.

Noteringar om VM-åtgärder

  • Start: startar VM i headless-läge
  • Stop: skickar ACPI power button
  • Restart: skickar reset
  • Delete: unregisterar VM och tar bort tillhörande filer/diskar (unregistervm --delete)

Var försiktig med delete.

Säkerhet

  • Serverlösenord lagras krypterat i Tools-databasen.
  • VM-åtgärder körs server-side i Tools via VirtualBox WebService SOAP API.
  • Endast användare med virtualbox.manage får åtkomst till panelen.

Nuvarande scope

Den här releasen är en praktisk MVP med professionell gruppering och operativ kontroll.

Möjliga senare steg:

  • Mer detaljerad delegering per server/VM
  • Djupare editor för storage/nätverk
  • Bättre liveuppdatering och hantering av längre operationer