Bijwerken (IoT)

Vanwege de complexiteit van de IoT box en virtuele Windows IoT box, kan de term ‘updaten’ verschillende dingen betekenen.

De eigenlijke stuurprogramma’s kunnen worden bijgewerkt, de kerncode op de IoT box kan worden bijgewerkt of er kan een nieuwe image worden geflasht (met behulp van een fysieke IoT box).

Dit document onderzoekt de verschillende manieren om IoT boxen bij te werken om een soepele werking van IoT boxprocessen en -apparaten te garanderen.

De SD-kaart flashen op IoT box

Belangrijk

Deze update is niet van toepassing op de Windows IoT box (Odoo 16 en hoger).

Om het Windows IoT bij te werken, verwijder je eerst de vorige versie van het Odoo Windows programma en installeer je het daarna opnieuw met het meest actuele installatiepakket.

Om de installatie te beginnen, navigeer je naar het Odoo 16 (of hoger) installatiepakket voor Enterprise of Community - Windows editie, op Odoo’s downloadpagina.

In sommige gevallen moet de micro SD-kaart van de IoT box opnieuw worden geflasht met Etcher software om te kunnen profiteren van de nieuwste IoT image-update van Odoo. Dit betekent dat de Odoo IoT boxsoftware mogelijk moet worden bijgewerkt in geval van een nieuwe IoT box of wanneer een update van een handler of een update van de IoT boxstartpagina problemen niet oplost.

Notitie

  • Het is vaak nodig om de image van de IoT box opnieuw te flashen na het upgraden van de Odoo database naar een nieuwe versie.

  • Een computer met een micro SD-kaartlezer/adapter is vereist om de micro SD-kaart opnieuw te flashen.

Begin eerst met het downloaden van Etcher. Het is een gratis, open-source hulpprogramma dat wordt gebruikt voor het branden van afbeeldingsbestanden op schijven. Nadat het downloaden is voltooid, installeer je het programma en start je het op de computer.

Download dan de nieuwste IoT image van nacht, die gelabeld wordt als iotbox-latest.zip. Deze image is compatibel met alle ondersteunde versies van Odoo.

Nadat deze stap is voltooid, plaats je de micro SD-kaart van de IoT box in de computer of lezer. Open Etcher en selecteer Flash from file, zoek en selecteer dan de iotbox-latest.zip image en pak deze uit. Selecteer vervolgens de schijf waarop de image gebrand moet worden.

Klik ten slotte op Flash en wacht tot het proces is voltooid.

Balena's Etcher softwaredashboard.

Tip

Met Balena’s Etcher software kan de beheerder de SD kaart ook flashen vanaf een URL. Om te flashen vanaf een URL klik je gewoon op Flash from URL, in plaats van op Flash from file.

Voer dan het volgende in: http://nightly.odoo.com/master/iotbox/iotbox-latest.zip.

Een weergave van Balena's Etcher software, met de optie flash van URL gemarkeerd.

Notitie

Een alternatieve software voor het flashen van de micro SD-kaart is Raspberry Pi Imager.

Windows IoT-update

Windows virtual IoT box heeft mogelijk af en toe een update nodig om goed te kunnen werken.

De volgende processen hebben betrekking op de deïnstallatie en herinstallatie van de virtuele Windows IoT box.

Windows IoT verwijderen

Voordat je de Windows virtuele IoT box kunt upgraden, moet je eerst de vorige versie verwijderen.

Belangrijk

Voordat je een vorige versie van de Windows virtuele IoT box verwijdert, moet je ervoor zorgen dat er een nieuwere versie van de Windows virtuele IoT box beschikbaar is, vergeleken met de versie die momenteel is geïnstalleerd. Navigeer hiervoor naar de Odoo Nightly builds pagina.

Navigeer op de Odoo Nightly builds pagina naar Builds (stable version) ‣ windows/ om de datum naast het odoo_(version).latest.exe bestand te zien; waarbij (version) gelijk is aan de versie van Odoo (bijv. 16.0, 17.0). De laatste versie van de Windows virtuele IoT box kun je downloaden door dit bestand te selecteren, of het is altijd beschikbaar op de Odoo Download pagina.

Het verwijderen van de Windows virtuele IoT box gaat via het Windows programmabeheer.

Op elke versie van Windows zoek je naar programma om de :menuselectie:`Programma's --> Programma's en onderdelen` sectie van het Configuratiescherm te openen. Selecteer vervolgens Een programma verwijderen of wijzigen. Zoek vervolgens naar Odoo en klik op het … (drie puntjes) menu op het Odoo.exe programma om het te verwijderen.

Bevestig de deïnstallatie en volg de stappen om de installatie ongedaan te maken via de Odoo uninstall wizard.

Downloaden en opnieuw installeren

De laatste versie van de Windows virtuele IoT box kan worden gedownload van de Odoo Nightly builds pagina of is altijd beschikbaar op de Odoo Download pagina.

Om te downloaden van de Odoo Nightly builds pagina, navigeer je naar Builds (stable version) ‣ windows/ en selecteer je het odoo_(version).latest.exe bestand; waarbij (version) gelijk is aan de versie van Odoo (bijv. 16.0, 17.0).

Om te downloaden van de Odoo Download pagina, zoek je de sectie voor de versie van Odoo (bijv. 16.0, 17.0) en selecteer je de Download knop voor Windows.

Installeer en installeer vervolgens het gedownloade Odoo .exe bestand. Klik na het instructiescherm op Next om de installatie te starten en ga akkoord met de TOS.

Selecteer tijdens de volgende stap van de herinstallatie Odoo IoT uit het Selecteer het type installatie uitklapmenu.

Example

Ter referentie moet het volgende worden geïnstalleerd:

  • Odoo server

  • Odoo IoT

  • Nginx WebServer

  • Ghostscript-interpreter

Controleer of er voldoende ruimte op de computer is voor de installatie en klik dan op Next.

Stel de bestemming in en voltooi de installatie

Om de herinstallatie te voltooien, selecteer je de Bestemmingsmap en klik je op Install.

Waarschuwing

Door C:odoo te kiezen als installatielocatie kan de Nginx server starten. Odoo’s Windows virtuele IoT box software mag niet geïnstalleerd worden in een van de Windows gebruikersmappen. Hierdoor kan Nginx niet worden geïnitialiseerd.

De installatie kan een paar minuten duren. Klik op Next als je klaar bent om verder te gaan.

Zorg er dan voor dat het Start Odoo vakje is aangevinkt en klik op Finish. Na de installatie start de Odoo server en opent automatisch http://localhost:8069 in een webbrowser. De webpagina zou de IoT box homepage moeten tonen.

Tip

Een herstart van het Windows IoT-programma kan nodig zijn als de webbrowser niets weergeeft.

Update van de startpagina van de IoT box

Op de achtergrond gebruikt de IoT box een versie van Odoo-code om te draaien en verbinding te maken met de Odoo-database. Deze code moet mogelijk worden bijgewerkt om de IoT box effectief te laten werken. Deze handeling moet routinematig worden uitgevoerd om ervoor te zorgen dat het IoT systeem en de bijbehorende processen up-to-date blijven.

Ga naar de IoT box homepage door te navigeren naar IoT app ‣ IoT Boxes, en klik op de IP address van de IoT box. Klik vervolgens op Update (naast het versienummer).

Als er een nieuwe versie van de IoT boximage beschikbaar is, verschijnt er onderaan de pagina een Upgrade naar _xx.xx_ knop. Klik op deze knop om het apparaat te upgraden, waarna de IoT box zichzelf flasht naar de nieuwere versie. Alle vorige configuraties worden dan opgeslagen.

Belangrijk

Dit proces kan meer dan 30 minuten duren. Schakel niet de IoT box uit of trek de stekker uit het stopcontact, want dan is deze in een inconsistente staat. Dit betekent dat de IoT box opnieuw moet worden ge geflasht met een nieuwe image.

IoT box software-upgrade op de IoT Box Home Page.

Handler (stuurprogramma) bijwerken

Er kunnen gevallen zijn waarin stuurprogramma’s of interfaces moeten worden bijgewerkt voor individuele apparaten (bijv. weegschalen, meetinstrumenten, enz.). De code van de IoT-handler (stuurprogramma’s en interfaces) kan worden aangepast door ze te synchroniseren met de code van de geconfigureerde server-handler.

Dit kan handig zijn in gevallen waarin IoT apparaten (zoals weegschalen, meetinstrumenten, enz.) niet goed werken met de IoT box.

Voor zowel de Windows IoT (Odoo 16 en hoger) als de fysieke IoT box kan dit proces handmatig worden uitgevoerd vanaf de IoT box startpagina. Ga naar de IoT box homepage door te navigeren naar IoT app ‣ IoT Boxes, en klik op de IP address van de IoT box.

Klik vervolgens op Handlers list en selecteer Load Handlers onderaan de pagina.

Lijst met handlers in een IoT-vak met de knop Handlers laden gemarkeerd.

Belangrijk

De code van de Handler wordt opgehaald van de geconfigureerde server en moet up-to-date zijn om de laatste fixes en patches te hebben.

Notitie

Telkens wanneer de IoT box opnieuw wordt opgestart, wordt ook automatisch een handler-update uitgevoerd. De enige uitzondering op dit proces is als Automatische stuurprogramma-update is uitgeschakeld in de formulierweergave van de IoT box op de Odoo-server. Deze instelling kun je bereiken door naar IoT App ‣ Selecteer het IoT-vak ‣ Automatische stuurprogramma-update te gaan.