Een update installeren

Zodra er een nieuwe release is, toont Aurono een banner op het Dashboard:

Aurono Start v0.1.34 is available, you’re on v0.1.33.

Aurono downloadt of installeert nooit iets uit zichzelf. Het meldt dat er een update is en geeft je precies het commando dat je moet uitvoeren. Jij bepaalt wanneer je update, en tot die tijd verandert er niets.

Deze pagina loopt dat van begin tot eind met je door.

Het belangrijkste om te snappen

Het commando moet draaien op de machine waarop Aurono draait, en dat is niet altijd de machine waarop je het dashboard bekijkt.

De meeste mensen draaien Aurono op een Raspberry Pi en openen het dashboard in een browser op hun laptop of telefoon. In die opstelling levert het commando plakken in een terminal op de laptop niets op. Je hebt een terminal op de Pi nodig, en daarvoor is de SSH-stap hieronder bedoeld.

Draait Aurono op dezelfde Mac waarop je dit leest, ga dan direct naar Aurono op je Mac. SSH is dan niet nodig.

Wat een update verandert

Het installatieprogramma kun je opnieuw draaien en het gaat bewust behoedzaam te werk. Het vervangt de programmacode en laat de rest met rust:

Blijft staan	Wordt vervangen
Je database: strategieën, handelsgeschiedenis, versies, audit trail	De programmacode van Aurono
Je configuratie, inclusief je exchange-API-sleutels	De webinterface
Je licentieactivatie	Meegeleverde dependencies
Je access key, zodat browsers gekoppeld blijven

Je hoeft vooraf niets handmatig veilig te stellen. Los van updates maakt Aurono elke nacht om 03:30 lokale tijd een back-up van de database.

Het geheel duurt een paar minuten, grotendeels wachten. Aurono herstart zichzelf aan het eind, dus je strategieën liggen even stil en pakken daarna hun normale schema weer op.

Stap 1: Kopieer het commando

Klik in de banner op Show instructions. Er verschijnt een blok met commando’s met rechts een knop Copy. Klik op Copy.

Je vindt het blok ook altijd terug onder Settings → System, waar het uitgeklapt staat. Is er niets te doen, dan staat daar Update status: Up to date.

Het commando wordt opgebouwd voor het platform waarop Aurono daadwerkelijk draait en bevat het versienummer. Kopieer het dus elke keer opnieuw in plaats van een ouder exemplaar te hergebruiken.

Stap 2: Open een terminal op de Aurono-machine

Kies wat bij jouw opstelling past.

A. Aurono op een Raspberry Pi zonder monitor

Dit is de gebruikelijke Aurono-opstelling. Je opent een terminal op je gewone computer en maakt van daaruit verbinding met de Pi.

Op een Mac: druk op ⌘+Space, typ Terminal en druk op Enter.

Op Windows: druk op de Windows-toets, typ powershell en druk op Enter. Windows 10 en 11 hebben de SSH-client al aan boord, je hoeft dus niets te installeren.

Maak vervolgens in dat venster verbinding met de Pi:

ssh <gebruikersnaam>@<hostnaam>.local

Vervang <gebruikersnaam> en <hostnaam> door wat je hebt ingesteld bij het flashen van de SD-kaart. Heb je de hostnaam niet aangepast, dan is die raspberrypi. Op een Aurono Device is het aurono, dus dan wordt het ssh aurono@aurono.local, met het wachtwoord uit je device-mail.

Je wordt om het wachtwoord van dat account gevraagd. Terwijl je typt verschijnt er niets op het scherm, ook geen puntjes. Dat hoort zo. Typ het en druk op Enter.

De allereerste keer krijg je een vraag over de authenticiteit van de host die eindigt op (yes/no). Typ yes en druk op Enter.

Werkt .local niet, gebruik dan het IP-adres van de Pi: ssh aurono@192.168.1.42, met je eigen adres. Dat adres vind je in de beheerpagina van je router, meestal onder een kopje als “aangesloten apparaten” of “DHCP leases”. Op Windows komt dit vaker voor dan op macOS.

B. Aurono op een Raspberry Pi met een monitor

Druk op de Pi op Ctrl+Alt+T, of open Terminal via het menu van de Pi. SSH is niet nodig, je zit al op de juiste machine.

C. Aurono op je Mac

Druk op ⌘+Space, typ Terminal en druk op Enter. SSH is niet nodig.

Stap 3: Plakken en uitvoeren

Plak in het terminalvenster met ⌘+V op een Mac, of Ctrl+V in PowerShell op Windows. In de meeste terminals plakt rechtsklikken ook.

Het commando beslaat meerdere regels, en die regels beginnen te draaien zodra ze geplakt zijn. De laatste regel start meestal niet vanzelf, dus druk na het plakken één keer op Enter om die te starten.

Op een Pi begint de laatste regel met sudo, dus je wordt opnieuw om je wachtwoord gevraagd. Ook hier zie je niets terwijl je typt.

Wat het commando doet, op volgorde:

Het archief van de release en het bijbehorende checksum-bestand downloaden
De checksum controleren, en stoppen als het bestand niet overeenkomt met wat er is gepubliceerd
Het archief uitpakken
Het installatieprogramma draaien, dat de code vervangt en Aurono herstart

Laat het venster open tot het klaar is. Als laatste verschijnt een bevestigingsregel Updated Aurono Start from v… to v…, gevolgd door het adres waar het dashboard te vinden is.

Stap 4: Controleer of het gelukt is

Herlaad het dashboard in je browser. Twee dingen moeten kloppen:

De update-banner is weg
Onder Settings → System staat het nieuwe versienummer naast Aurono Start

Je strategieën pakken het op bij hun eerstvolgende geplande evaluatie. Je hoeft niets opnieuw aan te zetten, en ook je licentie of je browserkoppeling niet opnieuw in te voeren.

Als er iets misgaat

De checksum-stap mislukte. De download kwam niet overeen met de gepubliceerde vingerafdruk, dus het commando is gestopt voordat er iets werd uitgepakt. Dat is het vangnet dat zijn werk doet. Draai het commando opnieuw: meestal was het een afgebroken download. Mislukt het een tweede keer, pak het bestand dan niet uit en neem contact op.

ssh: Could not resolve hostname. Je netwerk vertaalt .local-namen niet. Gebruik in plaats daarvan het IP-adres van de Pi uit de beheerpagina van je router.

Permission denied. Verkeerde gebruikersnaam of verkeerd wachtwoord voor het Pi-account. Dit is het account dat je hebt aangemaakt bij het flashen van de SD-kaart, niet je access key voor het Aurono-dashboard. Die twee staan los van elkaar.

Het dashboard laadt daarna niet. Geef het een minuut, want de service herstart aan het eind van de installatie. Op een Pi kun je kijken hoe het ervoor staat met sudo systemctl status aurono, en herstarten met sudo systemctl restart aurono.

De banner staat er na het updaten nog. De controle bewaart zijn uitkomst tot een uur lang. Herlaad de pagina, en staat de banner er dan nog, controleer dan het versienummer onder Settings → System.

Moet ik wel updaten?

Nee. Aurono blijft de versie draaien die je hebt, en een update gebeurt alleen als je het commando zelf uitvoert.

Sluit je de banner met de ✕, dan is die voor die versie weg zolang je browsersessie duurt. De volgende keer dat je het dashboard opent staat de banner er weer, tot je update of hem opnieuw wegklikt.

Goed om te weten: releasenotes beschrijven soms aanpassingen in het handelsgedrag. Updates & Changelog laat per release zien wat er is veranderd, zodat je kunt inschatten of een update uitmaakt voor de manier waarop jij belegt.