¶ Installation unter Windows mit VirtualBox
¶ 1. Einleitung
Diese Anleitung beschreibt die Installation und den ersten Start der 3D-MES-Appliance.
3D-MES wird als vorkonfigurierte virtuelle Maschine (Appliance) bereitgestellt und kann mit VirtualBox auf einem lokalen System betrieben werden.
Eine native Installation unter Windows ist nicht möglich.
Die Appliance enthält alle notwendigen Komponenten und erfordert keine manuelle Installation von Docker, Datenbanken oder weiteren Abhängigkeiten.
Nach dem Import und dem ersten Start führt ein Einrichtungsdialog durch die grundlegende Konfiguration.
Diese Anleitung richtet sich an Anwender ohne tiefgehende Linux- oder Docker-Kenntnisse.
¶ 2. Voraussetzungen
¶ Unterstützte Betriebssysteme
- Windows 10 oder Windows 11
- Linux (mit grafischer Oberfläche)
- macOS (Intel oder Apple Silicon*)
* Auf Apple-Silicon-Systemen wird VirtualBox ab Version 7 benötigt.
¶ Empfohlene Hardware
- Mindestens 8 GB RAM
- Mindestens 20 GB freier Speicherplatz
- Internetverbindung für Download und Updates
¶ 3. VirtualBox installieren
-
Öffnen Sie die Website:
https://www.virtualbox.org -
Laden Sie VirtualBox (Version 7.x) für Ihr Betriebssystem herunter.
-
Installieren Sie VirtualBox mit den Standard-Einstellungen.
-
Laden Sie zusätzlich das VirtualBox Extension Pack (gleiche Version) herunter und installieren Sie es per Doppelklick.
¶ 4. 3D-MES Appliance herunterladen
-
Laden Sie die Datei
VirtualBox Image
herunter. -
Die Dateigröße beträgt ca. 3 GB.
Der Download kann je nach Internetverbindung einige Minuten dauern.
¶ 5. Appliance in VirtualBox importieren
-
Starten Sie VirtualBox.
-
Wählen Sie im Menü:
Datei → Appliance importieren
-
Wählen Sie die heruntergeladene
.ova-Datei aus. -
Beim Import:
- Aktivieren Sie „Neue MAC-Adressen für alle Netzwerkadapter generieren“
- Weitere Änderungen sind nicht erforderlich
- Starten Sie den Importvorgang und warten Sie, bis dieser abgeschlossen ist.
¶ 6. Virtuelle Maschine starten
-
Wählen Sie die importierte 3D-MES-VM in VirtualBox aus.
-
Klicken Sie auf Starten.
¶ ⚠️ Wichtiger Hinweis zum ersten Start
Der erste Start der virtuellen Maschine kann 10 Minuten dauern.
In dieser Zeit werden:
- interne Dienste gestartet
- Datenbanken initialisiert
- Systemkomponenten vorbereitet
Währenddessen kann:
- ein blinkender Fortschrittsbalken angezeigt werden
- der Eindruck entstehen, dass das System „hängt“
❗ Die VM in dieser Phase nicht abbrechen oder neu starten.
Dieses Verhalten ist normal.
¶ 7. Ersteinrichtung (First Boot)
Nach dem ersten erfolgreichen Start erscheint automatisch ein Einrichtungsdialog im VM-Fenster.
Dieser führt Sie durch folgende Schritte:
- Vergabe eines Admin-Benutzernamens
- Vergabe eines Admin-Passworts
- Optionale Angabe einer E-Mail-Adresse
- Optionale Angabe einer Server-IP für ein SSL-Zertifikat (HTTPS)
❗ Num Lock kann in VirtualBox dazu führen, dass Tastatureingaben in der VM falsch interpretiert werden, insbesondere bei Passwort-Eingaben im Boot- oder Setup-Dialog.
Deshalb muss Num deaktiviert werden.
Die Konfiguration wird gespeichert und das System startet anschließend automatisch neu.
¶ 8. IP-Adresse der virtuellen Maschine ermitteln
⚠️ Wichtig:
Die virtuelle Maschine erhält eine eigene IP-Adresse im lokalen Netzwerk.
Diese ist nicht identisch mit der IP-Adresse Ihres Windows-PCs.
Nach dem Neustart wird die IP-Adresse direkt im VM-Fenster angezeigt.
Alternativ kann sie über die Konsole ermittelt werden:
user: mes
password: mes
gebe ein:
hostname -I
Das System wurde eingerichtet und ist unter der IP deines Servers erreichbar.
z.B.
Für die Kamera und NFC Nutzung verwende immer https://