Erweiterte Installation

Methode wählen

• Die Installation per USB-Stick ist der empfohlene Weg für einen GX mit 32-Bit-Venus-OS, etwa den Cerbo GX, Ekrano GX oder Venus GX. Siehe die Installationsseite und Installation per USB-Stick.
• Nutzen Sie das SSH-Installationsprogramm, wenn Sie keinen USB-Stick verwenden können, lieber mit einem Terminal arbeiten oder Ihr GX mit 64-Bit-Venus-OS läuft, etwa ein neuerer Cerbo GX oder ein Raspberry Pi 5. Der GX braucht dafür Internet.
• Nutzen Sie die manuelle GX-Installation, wenn Sie das Paket selbst prüfen und kopieren möchten.
• Installieren Sie auf einem anderen Linux-Computer, wenn Phaeton nicht auf dem GX laufen soll. Der GX kann das Laden in Auto dann erst übernehmen, nachdem Sie Phaeton mit ihm gekoppelt haben, was Venus OS 3.80 oder neuer erfordert, und das VRM Control Panel ist nicht verfügbar.

Installation per SSH

Die Installationsseite führt Sie Schritt für Schritt: Sie zeigt, wie Sie die Zugriffsebene des GX, ein vorübergehendes Root-Passwort und SSH on LAN einstellen und wie Sie sich von Windows, macOS oder Linux aus verbinden. Sie brauchen einen Computer im selben lokalen Netzwerk wie der GX und Internet am GX, und Settings → General → Modification checks → Modifications enabled muss eingeschaltet sein. Die Remote Console über VRM gibt Ihrem Computer keine SSH-Verbindung zum GX.

Sobald Sie verbunden sind und die Eingabeaufforderung mit root@ beginnt, fügen Sie diesen Befehl ein und lassen Sie das Terminal geöffnet, bis er fertig ist:

(installer=$(mktemp) && trap 'rm -f "$installer"' EXIT && curl -fL --connect-timeout 15 --max-time 120 https://phaeton.virtunet.io/install/gx.sh -o "$installer" && sh "$installer")

Ist phaeton.virtunet.io nicht erreichbar, laden Sie dasselbe Installationsprogramm direkt vom Download-Dienst herunter:

(installer=$(mktemp) && trap 'rm -f "$installer"' EXIT && curl -fL --connect-timeout 15 --max-time 120 https://downloads.phaeton.virtunet.io/install/gx.sh -o "$installer" && sh "$installer")

Was das Installationsprogramm tut

• Prüft, ob das Gerät Venus OS auf ARMv7 oder ARM64 ausführt, und wählt das passende Paket.
• Prüft, ob die benötigten Werkzeuge vorhanden sind, ob Modifikationen erlaubt sind, ob der Webport 8088 frei ist und ob mindestens 64 MiB freier Speicher in /tmp und 32 MiB in /data vorhanden sind.
• Lädt die neueste stabile Version herunter, prüft Signatur und Prüfsumme und bricht ab, wenn eine davon nicht stimmt.
• Installiert Phaeton in /data/phaeton, schreibt sein Startskript run.sh und ergänzt /data/rc.local um einen markierten Block; Ihre anderen Startbefehle bleiben erhalten.
• Startet Phaeton, wartet auf die Weboberfläche und gibt ihre Adresse und den SHA-256-Fingerabdruck des Zertifikats aus. Das Laden startet es nicht.

Eine neue Installation verbindet sich per MQTT mit dem GX und lässt sich über das VRM Control Panel öffnen; siehe VRM Control Panel verwenden.

Nach der Installation

• Öffnen Sie die Adresse, die das Installationsprogramm ausgibt, normalerweise https://GX-IP:8088/, und vergleichen Sie den Fingerabdruck des Zertifikats im Browser mit der Ausgabe des Installationsprogramms, bevor Sie ein Passwort eingeben.
• Wählen Sie Benutzernamen und Passwort für Ihr Administratorkonto; ein Einrichtungscode ist nicht nötig. Fahren Sie mit der Ersteinrichtung fort. Wurde die Einrichtung schon abgeschlossen, melden Sie sich mit Ihrem bestehenden Phaeton-Konto an.
• Ihre Phaeton-Anmeldung ist unabhängig vom Root-Passwort des GX und von Ihrem Konto im Lizenzportal.
• Sobald die Einrichtung funktioniert, können Sie SSH on LAN wieder ausschalten. Lassen Sie Modifications enabled eingeschaltet, damit Phaeton nach einem Neustart startet. Ein Firmware-Update von Venus OS setzt das vorübergehende Root-Passwort zurück.
• Aktualisieren Sie Phaeton später über System → Updates. Ein erneuter Aufruf des Installationsprogramms, während Phaeton läuft, ändert nichts.

Wenn die SSH-Installation fehlschlägt

• Connection refused, timed out oder permission denied: siehe Hilfe zur Verbindung auf der Installationsseite.
• Download fehlgeschlagen: Prüfen Sie die Internetverbindung des GX und führen Sie den Befehl erneut aus.
• Eine deaktivierte Startdatei ist vorhanden: Schalten Sie Modifications enabled ein, benennen Sie /data/rc.local.disabled wieder in /data/rc.local um und führen Sie das Installationsprogramm erneut aus. Gibt es beide Dateien, führen Sie deren Befehle mit Hilfe Ihres Installateurs zusammen, statt eine davon zu überschreiben.
• Zu wenig freier Speicher oder Webport 8088 bereits belegt: Geben Sie Speicher frei oder beenden Sie das Programm, das den Port nutzt, und versuchen Sie es erneut.
• Ein anderes Installationsprogramm ist aktiv: Warten Sie, bis es fertig ist. Wurde eine Installation unterbrochen, nennt die Meldung die Sperre, die Sie entfernen können, sobald kein Installationsprogramm mehr läuft.
• Die Weboberfläche ist nicht bereit geworden: Die Installation ist nicht abgeschlossen. Lesen Sie die neueste Protokolldatei, /data/phaeton/phaeton.YYYY-MM-DD.log, beheben Sie, was dort gemeldet wird, und starten Sie /data/phaeton/run.sh nur, wenn Phaeton nicht läuft.
• Phaeton läuft bereits: Das Installationsprogramm hat nichts ersetzt. Nutzen Sie System → Updates.

Eine Meldung, dass die Dateien installiert wurden, bedeutet nicht, dass die Wallbox bereit ist. Prüfen Sie die Seite Charging und die Verbindung zur Wallbox gesondert.

Manuelle GX-Installation

Installieren Sie ein Paket von Hand, wenn Sie es selbst prüfen möchten. Das SSH-Installationsprogramm führt dieselben Schritte aus und richtet den Autostart sicher ein; nutzen Sie es deshalb, wenn möglich. Verwenden Sie die manuellen Schritte nur für eine neue Installation; aktualisieren Sie eine bestehende über System → Updates.

Paket herunterladen und prüfen

Laden Sie vom Download-Dienst das Paket für Ihren GX herunter: phaeton-VERSION-armv7-unknown-linux-gnueabihf.tar.gz für 32-Bit-Venus-OS, mit dem die meisten GX-Geräte laufen, oder phaeton-VERSION-aarch64-unknown-linux-gnu.tar.gz für 64-Bit-Venus-OS, etwa auf einem neueren Cerbo GX oder einem Raspberry Pi 5. Auf dem GX zeigt uname -m, welches Paket Sie brauchen: armv7l oder aarch64. Laden Sie außerdem SHA256SUMS, SHA256SUMS.sig und den Signaturschlüssel release-signing-public.pem herunter. Bei einer Erstinstallation stammt der Schlüssel vom selben Dienst wie das Paket; er macht also einen beschädigten Download erkennbar, kann aber die Echtheit des Dienstes selbst nicht belegen. Bewahren Sie diese Kopie auf und prüfen Sie spätere Versionen damit.

Prüfen Sie auf einem Computer mit OpenSSL zuerst die Signatur und dann die Prüfsumme. Der erste Befehl gibt Verified OK aus, der zweite OK für das Paket; brechen Sie ab, wenn einer davon fehlschlägt.

openssl dgst -sha256 -sigopt rsa_padding_mode:pss -sigopt rsa_pss_saltlen:digest -verify release-signing-public.pem -signature SHA256SUMS.sig SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS

Kopieren und starten

Kopieren Sie das Paket auf den GX und melden Sie sich dort an:

scp phaeton-VERSION-armv7-unknown-linux-gnueabihf.tar.gz root@GX-IP:/data/
ssh root@GX-IP

Entpacken Sie das Paket auf dem GX:

mkdir -p /data/phaeton
tar -xzf /data/phaeton-VERSION-armv7-unknown-linux-gnueabihf.tar.gz -C /data/phaeton
chmod +x /data/phaeton/phaeton
rm /data/phaeton-VERSION-armv7-unknown-linux-gnueabihf.tar.gz

Bereiten Sie die Installation vor dem ersten Start so vor, wie es die Installationsprogramme tun, damit sie sich per MQTT mit dem GX verbindet und ihren Zugang über das VRM Control Panel erhält:

PHAETON_DATA_DIR=/data/phaeton /data/phaeton/phaeton --init-instance default 8088

Legen Sie das Startskript an. Es setzt außerdem die Sicherheitsprüfung eines Updates aus der Weboberfläche fort, das ein Neustart unterbrochen hat:

cat >/data/phaeton/run.sh <<'EOF'
#!/bin/sh
set -e
export PHAETON_DATA_DIR=/data/phaeton
export RUST_LOG=info
cd /data/phaeton
if [ -f update-pending.json ] && [ -f update-watchdog.sh ]; then
  PHAETON_INSTALL_DIR=/data/phaeton sh /data/phaeton/update-watchdog.sh </dev/null >/dev/null 2>&1 &
fi
exec /data/phaeton/phaeton
EOF
chmod +x /data/phaeton/run.sh

Starten Sie Phaeton einmal zur Kontrolle, öffnen Sie https://GX-IP:8088/ und beenden Sie es wieder mit Strg+C:

/data/phaeton/run.sh

Autostart beim Hochfahren

Legen Sie eine Kopie von /data/rc.local an und fügen Sie dann die Zeile /data/phaeton/run.sh & vor der Zeile exit 0 ein, oder am Ende, wenn es diese Zeile nicht gibt. Behalten Sie alle anderen Befehle und ersetzen Sie nicht die ganze Datei. Eine neue Datei braucht #!/bin/sh als erste Zeile. Machen Sie die Datei mit chmod +x /data/rc.local ausführbar, lassen Sie Modifications enabled eingeschaltet und starten Sie den GX neu.

Installation auf anderen Linux-Systemen

Phaeton läuft auch auf einem dauerhaft eingeschalteten Linux-Computer im selben lokalen Netzwerk wie der GX, etwa einem Raspberry Pi. Laden Sie das Paket für Ihre Plattform vom Download-Dienst herunter und prüfen Sie es wie unter Manuelle GX-Installation beschrieben.

Installieren Sie das Programm:

mkdir -p phaeton-extract
tar -xzf phaeton-VERSION-PLATFORM.tar.gz -C phaeton-extract
sudo install -m 0755 phaeton-extract/phaeton /usr/local/bin/phaeton

Starten Sie es, öffnen Sie dann https://HOST-IP:8088/ und folgen Sie der Ersteinrichtung:

phaeton

Phaeton speichert seine Einstellungen, Lizenz und Protokolle in ~/.local/share/phaeton des Benutzers, der es ausführt. Für einen anderen Ordner geben Sie diesen beim Start von Phaeton an:

PHAETON_DATA_DIR=/path/to/phaeton-data phaeton

• Um Phaeton beim Hochfahren zu starten, tragen Sie es in die Dienstverwaltung Ihres Systems ein, ausgeführt vom selben Benutzer oder mit demselben Datenordner, damit es seine Einstellungen und Lizenz behält.
• Verbinden Sie Phaeton mit dem GX, indem Sie es koppeln, was Venus OS 3.80 oder neuer erfordert, oder über Legacy Modbus; siehe Victron-GX-Integration.
• Mit Legacy Modbus verbindet sich der GX mit dem EVCS-Modbus-Port von Phaeton, standardmäßig 502. Linux erlaubt nur privilegierten Programmen Ports unter 1024; geben Sie Phaeton diese Berechtigung in Ihrer Dienstverwaltung.
• Das VRM Control Panel funktioniert nicht für Phaeton auf einem anderen Computer; öffnen Sie Phaeton im lokalen Netzwerk.
• Zum Aktualisieren installieren Sie das neuere Paket auf dieselbe Weise und starten Phaeton neu. System → Updates ersetzt die Programmdatei, aus der Phaeton läuft, und bereitet die neue Version daneben vor; das funktioniert also nur, wenn der Benutzer, der Phaeton ausführt, in diesen Ordner schreiben darf. Installieren Sie Phaeton in einem Ordner, der diesem Benutzer gehört, wenn Sie über die Weboberfläche aktualisieren möchten.
• Halten Sie Computer, GX und Wallbox in einem vertrauenswürdigen lokalen Netzwerk; siehe Sicherheit.