Bijwerken

Manieren om bij te werken

Open System → Updates in de webinterface van Phaeton. Je kunt op twee manieren bijwerken, en beide installeren alleen releases die door Phaeton zijn ondertekend.

• Release repository update: kies Check for updates, kies een Version en kies Install selected release and restart. Phaeton gebruikt zijn ingebouwde openbare updatekanaal; voor openbare releases is geen toegangstoken nodig.
• Local package update: download het .phaeton-update-pakket voor het platform van je apparaat van de downloadsite van Phaeton, kies Choose update package, selecteer het bestand en kies Upload package and restart. Gebruik dit als het apparaat geen internet heeft.
• Stel alleen een privérepository in op aanwijzing van je installateur of support.

Downloads van Phaeton

Voordat je bijwerkt

• Maak een back-up van de gegevensmap; zie Back-up en herstel.
• Stop het laden. Tijdens de herstart van Phaeton werkt de laadbesturing niet.
• Lees de releasenotities op de pagina Updates. Wat is er nieuw bevat de notities van recente versies.
• Bewaar het pakket van je huidige versie totdat de nieuwe versie na de herstart haar controles heeft doorstaan.

Back-up en herstel

Instellingen voor updates

De instellingen voor updates staan onder Settings → System → Maintenance, bij Advanced.

• Enable remote updater zet de automatische controles en automatische updates aan of uit. Standaard staat hij aan. Check for updates op de pagina Updates werkt hoe dan ook.
• Staat Auto check remote repository aan, dan zoekt Phaeton elke Check interval (h) naar een nieuwe release, standaard eens per dag. Phaeton installeert die alleen zelf als Auto update aan staat; standaard staat dat uit.
• Include prereleases biedt ook testversies aan. Laat dit uit op een installatie waarop je vertrouwt.
• Laat Repository URL leeg voor het ingebouwde openbare updatekanaal. Vul het alleen in voor een privé releasebron op GitHub of GitLab, en vul Access token (for private repos) alleen in als die repository er een nodig heeft.
• Phaeton stuurt het token alleen via HTTPS naar de server van die repository, en bij GitHub naar de GitHub-API, nooit naar een server waar een download naar doorverwijst. Wijzig je de repository, dan wordt een opgeslagen token gewist, tenzij je het opnieuw invult.

Handmatig bijwerken met een ondertekend pakket

• De pagina Updates accepteert alleen het officiële .phaeton-update-pakket voor het platform van je apparaat. Het bevat de release en de ondertekende controlegetallen. Een los .tar.gz-archief wordt geweigerd.
• Voor de installatie controleert Phaeton de handtekening van de release, het controlegetal van het pakket en het platform. Een pakket dat een controle niet doorstaat, wordt niet geïnstalleerd.
• Een pakket dat ouder is dan de geïnstalleerde versie wordt pas geïnstalleerd na een tweede bevestiging waarin beide versies staan. Tot je bevestigt, wordt er niets geïnstalleerd. Dezelfde bevestiging verschijnt bij een pakket zonder versienummer, zoals een previewversie. Dezelfde versie opnieuw installeren vraagt geen extra bevestiging.

Wat een update bewaart

Een update vervangt het programma en de webinterface en bewaart alles in de gegevensmap:

• config.yaml met je instellingen, en config-web.json met de kopie van het beheerdersaccount.
• state.json met de opgeslagen bedrijfsstatus.
• De logbestanden phaeton.<date>.log.
• De licentiebestanden.

Bijwerken via VRM Control Panel

Via de GX of VRM Control Panel kan de verbinding verlopen of een foutmelding 502 Bad Gateway geven terwijl de installatie doorloopt. Een verlopen verbinding of proxyfout alleen betekent niet dat de update is mislukt.

Phaeton behandelt een verloren antwoord als onbevestigd. Het wacht tot twee minuten tot de nieuwe versie klaar is en laadt dan de pagina opnieuw. Zolang het wacht, blijven de installatieknoppen uitgeschakeld, zodat er geen tweede verzoek kan starten. Na de herstart moet je misschien opnieuw inloggen.

Kan de herstart niet worden bevestigd, laad de pagina dan opnieuw en controleer de geïnstalleerde versie op de pagina Updates voordat je opnieuw bijwerkt.

Als een update mislukt

• Mislukt de installatie, dan houdt Phaeton de versie die draait. Kan Phaeton de vorige webinterface niet terugzetten, dan noemt de foutmelding de back-upmap die het heeft bewaard en de map die terug moet. Bewaar die back-up totdat het probleem is opgelost; een latere update overschrijft hem niet.
• Kan de nieuwe versie niet starten, dan blijft de draaiende versie actief en schrijft deze de reden in het log. Een geaccepteerde upload alleen betekent niet dat de herstart is gelukt.
• Start de nieuwe versie op een GX niet binnen ongeveer drie minuten goed op, dan gaat Phaeton zelf terug naar de vorige versie. Het log noemt dan de update die is teruggedraaid. Automatische updates slaan die release over; met de hand kun je hem nog wel installeren.
• Meldt Phaeton dat een eerdere update nog wordt gecontroleerd, wacht dan een paar minuten en probeer het opnieuw.

Updates mislukken