Geavanceerde installatie

Kies een methode

• De installatie met een USB-stick is de aanbevolen manier voor een GX met 32-bits Venus OS, zoals de Cerbo GX, Ekrano GX of Venus GX. Zie de installatiepagina en Installeren met een USB-stick.
• Gebruik de SSH-installer als je geen USB-stick kunt gebruiken, liever met een terminal werkt, of de GX 64-bits Venus OS draait, zoals een nieuwere Cerbo GX of een Raspberry Pi 5. De GX heeft dan internet nodig.
• Gebruik de handmatige GX-installatie als je het pakket zelf wilt controleren en kopiëren.
• Installeer op een andere Linux-computer als Phaeton niet op de GX moet draaien. De GX kan het laden in Auto dan pas overnemen nadat je Phaeton met de GX hebt gekoppeld, wat Venus OS 3.80 of nieuwer vereist, en VRM Control Panel is niet beschikbaar.

Installeren via SSH

De installatiepagina leidt je stap voor stap: daar zie je hoe je het toegangsniveau van de GX, een tijdelijk rootwachtwoord en SSH on LAN instelt, en zie je hoe je verbinding maakt vanaf Windows, macOS of Linux. Je hebt een computer in hetzelfde lokale netwerk als de GX nodig, internet op de GX, en Settings → General → Modification checks → Modifications enabled moet aanstaan. Remote Console via VRM geeft je computer geen SSH-verbinding met de GX.

Ben je verbonden en begint de prompt met root@, plak dan deze opdracht en houd de terminal open tot hij klaar is:

(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")

Is phaeton.virtunet.io niet bereikbaar, download dezelfde installer dan rechtstreeks van de downloadservice:

(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")

Wat de installer doet

• Controleert of het apparaat Venus OS draait op ARMv7 of ARM64, en kiest het bijbehorende pakket.
• Controleert of de benodigde hulpmiddelen er zijn, of wijzigingen zijn toegestaan, of webpoort 8088 vrij is en of er minstens 64 MiB vrije ruimte in /tmp en 32 MiB in /data is.
• Downloadt de nieuwste stabiele versie, controleert de handtekening en checksum, en stopt als een van beide niet klopt.
• Installeert Phaeton in /data/phaeton, schrijft het opstartscript run.sh en voegt een gemarkeerd blok toe aan /data/rc.local, met behoud van je andere opstartopdrachten.
• Start Phaeton, wacht op de webinterface en toont het adres en de SHA-256-vingerafdruk van het certificaat. Het laden start hij niet.

Een nieuwe installatie verbindt via MQTT met de GX en is te openen via VRM Control Panel.

Na het installeren

• Open het adres dat de installer toont, meestal https://GX-IP:8088/, en vergelijk de certificaatvingerafdruk in je browser met de uitvoer van de installer voordat je een wachtwoord invult.
• Kies je beheerdersnaam en wachtwoord; een setupcode is niet nodig. Ga verder met Eerste setup. Was de setup al gedaan, log dan in met je bestaande Phaeton-account.
• Je Phaeton-login staat los van het rootwachtwoord van de GX en van je account op het licentieportaal.
• Werkt de setup, dan kun je SSH on LAN weer uitzetten. Laat Modifications enabled aanstaan, zodat Phaeton na een herstart start. Een firmware-update van Venus OS wist het tijdelijke rootwachtwoord.
• Werk Phaeton later bij via System → Updates. De installer opnieuw uitvoeren terwijl Phaeton draait, verandert niets.

Als de SSH-installatie mislukt

• Connection refused, timed out of permission denied: zie Hulp bij verbinding op de installatiepagina.
• Download mislukt: controleer de internetverbinding van de GX en voer de opdracht opnieuw uit.
• Er bestaat een uitgeschakeld opstartbestand: zet Modifications enabled aan, hernoem /data/rc.local.disabled terug naar /data/rc.local en voer de installer opnieuw uit. Bestaan beide bestanden, voeg hun opdrachten dan samen met hulp van je installateur in plaats van een ervan te overschrijven.
• Te weinig vrije ruimte, of webpoort 8088 al in gebruik: maak ruimte vrij, of stop het programma dat de poort gebruikt, en probeer het opnieuw.
• Er is al een andere installer actief: wacht tot die klaar is. Is een installatie onderbroken, dan noemt de melding de vergrendeling die je mag verwijderen zodra er geen installer meer draait.
• De webinterface werd niet beschikbaar: de installatie is niet klaar. Lees het nieuwste logbestand, /data/phaeton/phaeton.YYYY-MM-DD.log, los op wat daarin staat, en start /data/phaeton/run.sh alleen als Phaeton niet draait.
• Phaeton draait al: de installer heeft niets vervangen. Gebruik System → Updates.

Een melding dat de bestanden zijn geïnstalleerd, betekent niet dat de laadpaal klaar is. Controleer de pagina Charging en de laadpaalverbinding apart.

Handmatige GX-installatie

Installeer een pakket met de hand als je het zelf wilt controleren. De SSH-installer doet dezelfde stappen en richt het opstarten veilig in, dus gebruik die als het kan. Gebruik de handmatige stappen alleen voor een nieuwe installatie; werk een bestaande bij via System → Updates.

Pakket downloaden en controleren

Download via de downloadservice het pakket voor je GX: phaeton-VERSION-armv7-unknown-linux-gnueabihf.tar.gz voor 32-bits Venus OS, dat de meeste GX-apparaten draaien, of phaeton-VERSION-aarch64-unknown-linux-gnu.tar.gz voor 64-bits Venus OS, zoals op een nieuwere Cerbo GX of een Raspberry Pi 5. Op de GX toont uname -m welk pakket je nodig hebt: armv7l of aarch64. Download ook SHA256SUMS, SHA256SUMS.sig en de ondertekeningssleutel release-signing-public.pem. Bewaar een kopie van de sleutel en controleer latere versies met die kopie. Bij een eerste installatie komt de sleutel van dezelfde dienst als het pakket: hij laat een beschadigde download zien, maar kan de dienst zelf niet bewijzen.

Controleer op een computer met OpenSSL eerst de handtekening en daarna de checksum. De eerste opdracht toont Verified OK, de tweede OK voor het pakket; stop als een van beide mislukt.

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

Kopiëren en starten

Kopieer het pakket naar de GX en log erop in:

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

Pak het pakket uit op de 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

Bereid de installatie vóór de eerste start voor zoals de installers dat doen, zodat hij via MQTT met de GX verbindt en een VRM Control Panel-route krijgt:

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

Maak het opstartscript. Het hervat ook de veiligheidscontrole van een update vanuit de app die door een herstart is onderbroken:

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

Start Phaeton één keer om het te controleren, open https://GX-IP:8088/ en stop het weer met Ctrl+C:

/data/phaeton/run.sh

Automatisch starten

Maak een kopie van /data/rc.local en zet daarna de regel /data/phaeton/run.sh & vóór de regel exit 0, of aan het eind als die regel er niet is. Behoud alle andere opdrachten en vervang niet het hele bestand. Een nieuw bestand begint met #!/bin/sh op de eerste regel. Maak het bestand uitvoerbaar met chmod +x /data/rc.local, laat Modifications enabled aanstaan en herstart de GX.

Installeren op andere Linux-systemen

Phaeton draait ook op een Linux-computer die altijd aanstaat in hetzelfde lokale netwerk als de GX, zoals een Raspberry Pi. Download het pakket voor je platform via de downloadservice en controleer het zoals beschreven bij Handmatige GX-installatie.

Installeer het programma:

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

Start het, open daarna https://HOST-IP:8088/ en volg Eerste setup:

phaeton

Phaeton bewaart zijn instellingen, licentie en logs in ~/.local/share/phaeton van de gebruiker die het draait. Wil je een andere map, geef die dan op bij het starten:

PHAETON_DATA_DIR=/path/to/phaeton-data phaeton

• Wil je Phaeton automatisch laten starten, voeg het dan toe aan de servicebeheerder van je systeem, onder dezelfde gebruiker of met dezelfde gegevensmap, zodat het zijn instellingen en licentie houdt.
• Verbind Phaeton met de GX door het te koppelen, wat Venus OS 3.80 of nieuwer vereist, of met Legacy Modbus; zie Victron GX koppelen.
• Bij Legacy Modbus verbindt de GX met de EVCS-Modbuspoort van Phaeton, standaard 502. Linux staat poorten onder 1024 alleen toe voor programma's met extra rechten. Geef Phaeton die rechten in je servicebeheer.
• VRM Control Panel werkt niet voor Phaeton op een andere computer; open Phaeton op het lokale netwerk.
• Werk bij door het nieuwere pakket op dezelfde manier te installeren en Phaeton te herstarten. System → Updates vervangt het programmabestand waarmee Phaeton draait en zet de nieuwe versie ernaast klaar, dus dat werkt alleen als de gebruiker die Phaeton draait in die map mag schrijven. Installeer Phaeton in een map van die gebruiker als je via de webinterface wilt bijwerken.
• Houd de computer, de GX en de laadpaal in een vertrouwd lokaal netwerk; zie Beveiliging.