Installeren met een USB-stick

Wat de USB-installer doet

De installatiepagina toont de stappen: download de installer, kopieer hem naar een USB-stick, herstart de GX met de stick erin en rond de setup af in je browser. Dit hoofdstuk legt uit wat er op de GX gebeurt en wat je doet als er iets misgaat.

Bij het opstarten vindt Venus OS de installer op de stick en voert hem uit. De installer:

• Controleert of de GX Venus OS draait op een ondersteunde processor, of Settings → General → Modification checks → Modifications enabled aanstaat en of de GX genoeg vrije opslag heeft. De GX-menu's staan hier in het Engels.
• Controleert de handtekening en checksum van het Phaeton-pakket, en stopt als een van beide niet klopt.
• Stopt een draaiende Phaeton en maakt een back-up van de bestaande installatie voordat hij bestanden vervangt.
• Installeert Phaeton in /data/phaeton en voegt een eigen opstartregel toe aan /data/rc.local, met behoud van andere opstartopdrachten.
• Start Phaeton en controleert of de webinterface antwoordt.
• Schrijft het resultaat naar de stick, en werpt de stick uit als de installatie is gelukt.

De GX heeft geen internet nodig, en je hebt geen SSH, rootwachtwoord of setupcode nodig. Een nieuwe installatie verbindt via MQTT met de GX en is vóór de setup al te openen via VRM Control Panel, zodra de GX online is.

Geef de installatie vijf minuten en wacht tot de USB-activiteit stopt voordat je de stick verwijdert. Trek geen actieve stick uit en onderbreek de voeding van de GX niet. Vijf minuten wachten alleen bewijst niet dat verwijderen veilig is; twijfel je, laat de stick dan zitten en neem contact op met support. Je kunt de setup in de browser afronden terwijl de stick erin zit.

Voor welke GX-apparaten

• GX-apparaten met 32-bits Venus OS, zoals de Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX en EasySolar-II GX, en Venus OS op een Raspberry Pi 2, 3 of 4. De installer controleert of het apparaat 32-bits Venus OS draait en stopt anders met een melding.
• Nieuwere Cerbo GX-apparaten en de Raspberry Pi 5 draaien 64-bits Venus OS. De USB-installer stopt daar met een melding; gebruik dan de SSH-installatie.
• Een andere Linux-computer kan de USB-installer niet gebruiken; zie Installeren op andere Linux-systemen.
• De USB-installer installeert en werkt de eerste Phaeton-installatie op de GX bij, in /data/phaeton, die opent op poort 8088. Laadpalen die je hebt toegevoegd onder System → Chargers on this GX houden hun eigen software; werk die op die pagina bij.
• Alleen het bestand venus-data-phaeton-VERSION-armv7.tgz werkt vanaf een stick. Een .phaeton-update-bestand werkt Phaeton bij op de pagina Updates, en de gewone .tar.gz-pakketten zijn voor de geavanceerde installatie. Oudere versies hebben soms geen USB-installer.
• Je hebt fysieke toegang tot de GX en een herstart nodig, een aparte FAT32-stick met een MBR-partitietabel en minstens 256 MB vrij, en vrije opslag op de GX voor de nieuwe versie plus een back-up van de bestaande installatie.

Bestanden op de stick

Haal na een installatiepoging de stick eruit en open hem op je computer. Je vindt:

• venus-data-phaeton-VERSION-armv7.tgz: de installer. Laat hem ongeopend, met de oorspronkelijke naam, op het hoofdniveau van de stick. Zet maar één installer op de stick.
• PHAETON-RESULT.html: het resultaat van de laatste poging. Het toont het lokale adres van Phaeton en de SHA-256-vingerafdruk van het certificaat, die je met je browser vergelijkt voordat je inlogt. Het bevat geen wachtwoord of setupcode.
• PHAETON-<GX-identity>.log: een log voor elke GX waarop de stick is gebruikt. Het vermeldt de installatiestappen met UTC-tijden en OK of FAIL, zonder configuratie, wachtwoorden of licentiegegevens. Een latere poging op dezelfde GX vult hetzelfde log aan.
• vrmlogger-backlog.sqlite3: Venus OS kan dit aanmaken voor de eigen VRM-logging. Phaeton heeft het niet nodig; bewaar het als de GX VRM-gegevens heeft die nog niet zijn geüpload.

De tijden in het log komen van de klok van de GX, die op een GX zonder internet verkeerd kan staan.

Verwijderen of opnieuw gebruiken

• Haal de stick eruit zodra de installatie klaar is en de USB-activiteit is gestopt. Een stick die erin blijft, installeert zijn Phaeton-versie bij elke herstart van de GX opnieuw, ook over een nieuwere versie die je later hebt geïnstalleerd.
• Om te herstellen of opnieuw te installeren, plaats je de stick en herstart je de GX. De installer installeert de versie op de stick, ook een oudere, en behoudt configuratie, identiteit, licentie en opgeslagen status. Start de nieuwe versie niet, dan zet hij de vorige bestanden terug.
• Werk Phaeton bij via System → Updates, online of met een .phaeton-update-bestand, zonder de GX te herstarten. Wil je toch met een stick bijwerken, vervang de installer erop dan door een nieuw gedownloade.
• Je kunt dezelfde stick op meerdere GX-apparaten gebruiken. Elke GX schrijft een eigen log; het resultaatbestand toont altijd de laatste poging.
• Wil je Phaeton verwijderen, haal dan eerst de stick eruit en volg daarna Phaeton verwijderen.

Herstel

Opent Phaeton na vijf minuten niet, of wil je weten wat er gebeurde? Wacht tot de USB-activiteit stopt, haal de stick eruit en open PHAETON-RESULT.html en het log van deze GX op je computer. De resultaatpagina toont de melding in het Engels en het Nederlands. In het log staat bij een mislukte stap FAIL met de reden. Een geslaagde poging eindigt met een END-regel en het begin van het uitwerpen van de stick; elk ander log dat op een START-regel eindigt, is onderbroken.

Wat het resultaat meldt

• Phaeton is gestart. Rond de setup af in je browser: De installatie is gelukt. Open het adres op de resultaatpagina, vergelijk de certificaatvingerafdruk en volg Eerste setup.
• Phaeton is geïnstalleerd en gestart: Een bestaande installatie is bijgewerkt, met behoud van configuratie, identiteit en licentie. Open Phaeton en kijk bij Settings of er meldingen zijn.
• Phaeton is gestart in configuratieherstel: Phaeton draait met veilige instellingen en laden blijft uit. Open Settings, herstel wat Phaeton meldt en sla op; Phaeton herstart vanzelf.
• Installatie bezig: De poging is niet afgerond. Wacht tot de USB-activiteit stopt. Blijft de melding staan, herstart de GX dan met de stick erin om het opnieuw te proberen, en lees het log.
• Dit USB-pakket past niet bij de GX-architectuur: De GX draait 64-bits Venus OS, zoals een nieuwere Cerbo GX of een Raspberry Pi 5. Gebruik de SSH-installatie.
• Dit is geen Venus OS, of de GX mist installatiehulpmiddelen of flock: Gebruik de SSH-installatie, of neem contact op met support.
• Schakel wijzigingen in: Zet Settings → General → Modification checks → Modifications enabled aan en herstart met de stick.
• Onvoldoende GX-opslag: Maak opslag vrij via de GX-instellingen en probeer het opnieuw. Verwijder geen Phaeton-gegevens om ruimte te maken.
• Phaeton-opslag is niet schrijfbaar, of de Phaeton-map is een symlink: Neem contact op met support.
• Het archief kon niet worden gelezen: Download de installer opnieuw en kopieer hem naar een andere schrijfbare FAT32-stick.
• Handtekening of checksum onjuist: Download een nieuwe installer via de installatiepagina. Er is niets gestart. Probeer deze controle nooit te omzeilen.
• Een andere installer houdt de installatie vast: Er loopt een andere installatie of die is halverwege gestopt. Herstart de GX en probeer het opnieuw; neem bij herhaling contact op met support. De USB-installer verwijdert nooit de vergrendeling van een SSH-installatie.
• Schrijven van de installatie mislukt: Je bestaande gegevens blijven behouden. Herstart met dezelfde stick om verder te gaan. Is de stick defect, kopieer dan dezelfde ongeopende installer naar een nieuwe FAT32-stick, koppel de oude los en probeer het opnieuw.
• Phaeton is niet door de startcontrole gekomen: Phaeton is niet gestart, en de installer kon nog niet terugzetten wat er eerder stond: het log toont FAIL rollback.restore, de back-up blijft op de GX en het terugzetten wordt opnieuw geprobeerd als de GX herstart. Een ander programma op poort 8088 kan de oorzaak zijn. Herstart de GX om het opnieuw te proberen; gebeurt het weer, neem dan contact op met support en stuur het resultaat en het log mee.
• De update kon niet starten: De nieuwe versie is niet gestart, en de installer heeft teruggezet wat er eerder stond. Na een update draait de vorige installatie weer, dus open Phaeton zoals voorheen. Na een eerste installatie is Phaeton niet geïnstalleerd. Een ander programma op poort 8088 kan de oorzaak zijn. Herstart de GX met de stick om het opnieuw te proberen; gebeurt het weer, neem dan contact op met support en stuur het resultaat en het log mee.

Geen resultaat op de stick

Staat er geen PHAETON-RESULT.html op de stick, of nog het resultaat van een andere GX, dan heeft de installer op deze GX niet gedraaid. Controleer of:

• Je de GX hebt herstart met de stick erin. De installer draait alleen tijdens het opstarten van de GX.
• Het bestand de ongeopende .tgz is, met de oorspronkelijke naam, op het hoofdniveau van de stick en niet in een map. Safari op macOS kan downloads uitpakken; zet de optie Open veilige bestanden na downloaden uit en download opnieuw.
• De stick FAT32 is met een MBR-partitietabel, schrijfbaar en niet beveiligd tegen schrijven.
• Er maar één Phaeton-installer op de stick staat, en er geen andere USB-stick of geheugenkaart is aangesloten.
• De stick in een USB-poort met data zit, niet in de voedingspoort voor een GX Touch.
• Settings → General → Modification checks → Modifications enabled aanstaat.

Nog steeds niets? Probeer een andere stick en download de installer opnieuw. Op een stick waarop de GX niet kan schrijven, komt geen resultaat, ook niet als de installatie is gelukt. Probeer dus ook https://GX-IP:8088/ in je browser.

Voordat je het opnieuw probeert

• Verwijder op je computer het oude PHAETON-RESULT.html en eventuele tijdelijke .phaeton-result-bestanden van de stick, zodat je een oud resultaat niet voor een nieuw aanziet. Bewaar de installer.
• Een onderbroken update, bijvoorbeeld door een stroomstoring, wordt bij de volgende poging eerst hersteld, ook met een andere stick.
• Meldt het resultaat Bestaande Phaeton behouden, dan staat er een oude installer op de stick. Download de huidige om bij te werken.
• Zet de GX nooit terug naar de fabrieksinstellingen en verwijder nooit de configuratie- of licentiebestanden van Phaeton om te herstellen. Neem contact op met support en stuur het resultaat en het log mee; ze bevatten geen geheimen.
• Een geslaagde installatie bewijst niet dat de laadpaal verbonden en ingesteld is. Controleer de pagina Charging en de laadpaalverbinding voordat je op het laden vertrouwt.

Volgende stappen

Installeren op Victron GXEerste setupOpenen via VRM Control Panel