Installation per USB-Stick

Was das USB-Installationsprogramm tut

Die Installationsseite zeigt die Schritte: Laden Sie das Installationsprogramm herunter, kopieren Sie es auf einen USB-Stick, starten Sie den GX mit eingestecktem Stick neu und schließen Sie die Einrichtung im Browser ab. Dieses Kapitel erklärt, was auf dem GX passiert und was Sie tun, wenn etwas schiefgeht.

Beim Start findet Venus OS das Installationsprogramm auf dem Stick und führt es aus. Das Installationsprogramm:

• Prüft, ob der GX Venus OS auf einem unterstützten Prozessor ausführt, ob Settings → General → Modification checks → Modifications enabled eingeschaltet ist und ob der GX genug freien Speicher hat.
• Prüft Signatur und Prüfsumme des Phaeton-Pakets und bricht ab, wenn eine davon nicht stimmt.
• Stoppt ein laufendes Phaeton und sichert die bestehende Installation, bevor es Dateien ersetzt.
• Installiert Phaeton in /data/phaeton und ergänzt /data/rc.local um eine eigene Startzeile; andere Startbefehle bleiben erhalten.
• Startet Phaeton und prüft, ob die Weboberfläche antwortet.
• Schreibt das Ergebnis auf den Stick und wirft den Stick aus, wenn die Installation erfolgreich war.

Der GX braucht keine Internetverbindung, und Sie brauchen weder SSH noch ein Root-Passwort oder einen Einrichtungscode. Eine neue Installation verbindet sich per MQTT mit dem GX und lässt sich schon vor der Einrichtung über das VRM Control Panel öffnen, sobald der GX online ist.

Planen Sie fünf Minuten ein und warten Sie, bis der USB-Stick nicht mehr arbeitet, bevor Sie ihn abziehen. Ziehen Sie keinen aktiven Stick ab und unterbrechen Sie nicht die Stromversorgung des GX. Fünf Minuten allein beweisen nicht, dass Sie den Stick sicher abziehen können; sind Sie unsicher, lassen Sie ihn stecken und wenden Sie sich an den Support. Die Einrichtung im Browser können Sie auch mit eingestecktem Stick abschließen.

Geeignete GX-Geräte

• GX-Geräte mit 32-Bit-Venus-OS, etwa der Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX und EasySolar-II GX, sowie Venus OS auf einem Raspberry Pi 2, 3 oder 4. Das Installationsprogramm prüft, ob das Gerät mit 32-Bit-Venus-OS läuft, und bricht sonst mit einer Meldung ab.
• Neuere Cerbo GX und der Raspberry Pi 5 laufen mit 64-Bit-Venus-OS. Dort bricht das USB-Installationsprogramm mit einer Meldung ab; nutzen Sie dann die SSH-Installation.
• Ein anderer Linux-Computer kann das USB-Installationsprogramm nicht nutzen; siehe Installation auf anderen Linux-Systemen.
• Das USB-Installationsprogramm installiert und aktualisiert die erste Phaeton-Installation auf dem GX, in /data/phaeton, erreichbar über Port 8088. Wallboxen, die Sie unter System → Chargers on this GX hinzugefügt haben, behalten ihre eigene Software; aktualisieren Sie diese auf jener Seite.
• Nur die Datei namens venus-data-phaeton-VERSION-armv7.tgz funktioniert von einem Stick. Eine .phaeton-update-Datei aktualisiert Phaeton auf seiner Seite Updates, und die normalen .tar.gz-Pakete sind für die erweiterte Installation gedacht. Ältere Versionen haben eventuell kein USB-Installationsprogramm.
• Sie brauchen physischen Zugang zum GX und einen Neustart, einen eigenen FAT32-Stick mit MBR-Partitionstabelle und mindestens 256 MB freiem Speicher sowie freien Speicher auf dem GX für die neue Version und eine Sicherung der bestehenden Installation.

Dateien auf dem Stick

Ziehen Sie nach einem Installationsversuch den Stick ab und öffnen Sie ihn an Ihrem Computer. Sie finden:

• venus-data-phaeton-VERSION-armv7.tgz: das Installationsprogramm. Lassen Sie es ungeöffnet, mit seinem ursprünglichen Namen, auf der obersten Ebene des Sticks. Lassen Sie nur ein Installationsprogramm auf dem Stick.
• PHAETON-RESULT.html: das Ergebnis des letzten Versuchs. Es zeigt die lokale Adresse von Phaeton und den SHA-256-Fingerabdruck seines Zertifikats, den Sie mit Ihrem Browser vergleichen, bevor Sie sich anmelden. Es enthält kein Passwort und keinen Einrichtungscode.
• PHAETON-<GX-identity>.log: ein Protokoll für jeden GX, an dem der Stick verwendet wurde. Es listet die Schritte des Installationsprogramms mit UTC-Zeiten und OK oder FAIL auf, ohne Konfiguration, Passwörter oder Lizenzdaten. Ein späterer Versuch am selben GX ergänzt dasselbe Protokoll.
• vrmlogger-backlog.sqlite3: Diese Datei legt Venus OS eventuell für seine eigene VRM-Protokollierung an. Phaeton braucht sie nicht; bewahren Sie sie auf, wenn der GX VRM-Daten hat, die noch nicht hochgeladen wurden.

Die Zeiten im Protokoll stammen von der Uhr des GX, die auf einem GX ohne Internet falsch gehen kann.

Entfernen oder erneut ausführen

• Ziehen Sie den Stick ab, sobald die Installation fertig ist und der Stick nicht mehr arbeitet. Ein Stick, der stecken bleibt, installiert seine Phaeton-Version bei jedem Neustart des GX erneut, auch über eine neuere Version, die Sie später installiert haben.
• Zum Reparieren oder Neuinstallieren stecken Sie den Stick ein und starten den GX neu. Das Installationsprogramm installiert die Version auf dem Stick, auch eine ältere, und behält Konfiguration, Identität, Lizenz und gespeicherten Zustand. Startet die neue Version nicht, stellt es die vorherigen Dateien wieder her.
• Zum Aktualisieren nutzen Sie System → Updates in Phaeton, online oder mit einer .phaeton-update-Datei, ohne den GX neu zu starten. Möchten Sie stattdessen per Stick aktualisieren, ersetzen Sie das Installationsprogramm darauf durch ein neu heruntergeladenes.
• Sie können denselben Stick an mehreren GX-Geräten verwenden. Jeder GX schreibt sein eigenes Protokoll; die Ergebnisdatei zeigt immer den letzten Versuch.
• Um Phaeton zu deinstallieren, ziehen Sie zuerst den Stick ab und folgen dann Phaeton deinstallieren.

Wiederherstellung

Öffnet sich Phaeton nach fünf Minuten nicht oder möchten Sie wissen, was passiert ist, dann warten Sie, bis der Stick nicht mehr arbeitet, ziehen Sie ihn ab und öffnen Sie PHAETON-RESULT.html und das Protokoll dieses GX an Ihrem Computer. Die Ergebnisseite zeigt ihre Meldung auf Englisch und Niederländisch. Im Protokoll ist ein fehlgeschlagener Schritt mit FAIL und dem Grund markiert. Ein erfolgreicher Versuch endet mit einer END-Zeile und dem Beginn des USB-Auswerfens; jedes andere Protokoll, das mit einer START-Zeile endet, wurde unterbrochen.

Was das Ergebnis meldet

• Phaeton started. Finish setup in your browser: Die Installation hat funktioniert. Öffnen Sie die Adresse auf der Ergebnisseite, vergleichen Sie den Fingerabdruck des Zertifikats und folgen Sie der Ersteinrichtung.
• Phaeton was installed and started: Eine bestehende Installation wurde aktualisiert; Konfiguration, Identität und Lizenz sind erhalten geblieben. Öffnen Sie Phaeton und prüfen Sie unter Settings, ob es Hinweise gibt.
• Phaeton started in configuration recovery: Phaeton läuft mit sicheren Einstellungen, und das Laden bleibt ausgeschaltet. Öffnen Sie Settings, korrigieren Sie, was gemeldet wird, und speichern Sie; Phaeton startet von selbst neu.
• Installation in progress: Der Versuch ist nicht abgeschlossen. Warten Sie, bis der Stick nicht mehr arbeitet. Bleibt die Meldung bestehen, starten Sie den GX mit eingestecktem Stick neu, um es erneut zu versuchen, und lesen Sie das Protokoll.
• This USB package does not match the GX architecture: Der GX läuft mit 64-Bit-Venus-OS, wie ein neuerer Cerbo GX oder ein Raspberry Pi 5. Nutzen Sie die SSH-Installation.
• This is not Venus OS, or the GX lacks installer tools or flock: Nutzen Sie die SSH-Installation oder wenden Sie sich an den Support.
• Enable modifications: Schalten Sie Settings → General → Modification checks → Modifications enabled ein und starten Sie dann mit dem Stick neu.
• Not enough GX storage: Geben Sie über die Einstellungen des GX Speicher frei und versuchen Sie es erneut. Löschen Sie keine Phaeton-Daten, um Platz zu schaffen.
• Phaeton storage is not writable, or the Phaeton directory is a symlink: Wenden Sie sich an den Support.
• The archive could not be read: Laden Sie das Installationsprogramm erneut herunter und kopieren Sie es auf einen anderen beschreibbaren FAT32-Stick.
• Signature or checksum failed: Laden Sie ein neues Installationsprogramm von der Installationsseite herunter. Es wurde nichts gestartet. Versuchen Sie nie, diese Prüfung zu umgehen.
• Another installer owns the installation lock: Eine andere Installation läuft oder ist mittendrin stehen geblieben. Starten Sie den GX neu und versuchen Sie es erneut; bleibt das Problem bestehen, wenden Sie sich an den Support. Das USB-Installationsprogramm entfernt nie die Sperre einer SSH-Installation.
• Installation write failed: Ihre bestehenden Daten bleiben erhalten. Starten Sie mit demselben Stick neu, um fortzufahren. Ist der Stick fehlerhaft, kopieren Sie dasselbe ungeöffnete Installationsprogramm auf einen neuen FAT32-Stick, trennen Sie den alten und versuchen Sie es erneut.
• Phaeton did not pass the startup check: Phaeton ist nicht gestartet, und das Installationsprogramm konnte den vorherigen Stand noch nicht wiederherstellen: Das Protokoll zeigt FAIL rollback.restore, die Sicherung bleibt auf dem GX, und die Wiederherstellung wird beim nächsten Neustart des GX erneut versucht. Ein anderes Programm auf Port 8088 kann die Ursache sein. Starten Sie den GX neu, um es erneut zu versuchen; tritt der Fehler wieder auf, wenden Sie sich mit dem Ergebnis und dem Protokoll an den Support.
• The update could not start: Die neue Version ist nicht gestartet, und das Installationsprogramm hat den vorherigen Stand wiederhergestellt. Nach einem Update läuft wieder die vorherige Installation; öffnen Sie Phaeton also wie bisher. Nach einer Erstinstallation ist Phaeton nicht installiert. Ein anderes Programm auf Port 8088 kann die Ursache sein. Starten Sie den GX mit dem Stick neu, um es erneut zu versuchen; tritt der Fehler wieder auf, wenden Sie sich mit dem Ergebnis und dem Protokoll an den Support.

Kein Ergebnis auf dem Stick

Enthält der Stick keine PHAETON-RESULT.html oder zeigt er noch das Ergebnis eines anderen GX, ist das Installationsprogramm auf diesem GX nicht gelaufen. Prüfen Sie Folgendes:

• Sie haben den GX mit eingestecktem Stick neu gestartet. Das Installationsprogramm läuft nur, während der GX startet.
• Die Datei ist die ungeöffnete .tgz mit ihrem ursprünglichen Namen, auf der obersten Ebene des Sticks und nicht in einem Ordner. Safari unter macOS kann Downloads entpacken; schalten Sie dort die Option „Sichere Dateien nach dem Laden öffnen“ aus und laden Sie die Datei erneut herunter.
• Der Stick ist mit FAT32 und MBR-Partitionstabelle formatiert, beschreibbar und nicht schreibgeschützt.
• Auf dem Stick ist nur ein Phaeton-Installationsprogramm, und es ist kein anderer USB-Stick und keine Speicherkarte angeschlossen.
• Der Stick steckt in einem USB-Datenanschluss, nicht im reinen Stromanschluss für ein GX Touch.
• Settings → General → Modification checks → Modifications enabled ist eingeschaltet.

Immer noch nichts? Versuchen Sie einen anderen Stick und laden Sie das Installationsprogramm erneut herunter. Auf einen Stick, auf den der GX nicht schreiben kann, kommt kein Ergebnis, auch wenn die Installation funktioniert hat; versuchen Sie deshalb auch https://GX-IP:8088/ im Browser.

Bevor Sie es erneut versuchen

• Löschen Sie an Ihrem Computer die alte PHAETON-RESULT.html und eventuelle temporäre .phaeton-result-Dateien vom Stick, damit Sie ein altes Ergebnis nicht für ein neues halten. Behalten Sie das Installationsprogramm.
• Ein unterbrochenes Update, zum Beispiel durch einen Stromausfall, wird beim nächsten Versuch zuerst wiederhergestellt, auch mit einem anderen Stick.
• Meldet das Ergebnis Existing Phaeton preserved, ist auf dem Stick ein altes Installationsprogramm. Laden Sie das aktuelle herunter, um zu aktualisieren.
• Setzen Sie den GX zur Wiederherstellung nie auf Werkseinstellungen zurück und löschen Sie nie die Konfigurations- oder Lizenzdateien von Phaeton. Wenden Sie sich an den Support und senden Sie das Ergebnis und das Protokoll mit; sie enthalten keine Geheimnisse.
• Eine erfolgreiche Installation beweist nicht, dass die Wallbox verbunden und konfiguriert ist. Prüfen Sie die Seite Charging und die Verbindung zur Wallbox, bevor Sie sich auf das Laden verlassen.

Nächste Schritte

Installation auf dem Victron GXErsteinrichtungVRM Control Panel verwenden