Atualização (IoT)

Devido à complexidade da IoT box e da Windows IoT virtual, o termo “atualização” pode significar várias coisas diferentes.

Os drivers reais podem ser atualizados, o código principal da IoT box pode ser atualizado ou uma nova imagem pode ser atualizada (usando uma IoT box física).

Este documento explora as várias maneiras de atualizar as IoT boxes para garantir a operação tranquila dos processos e dispositivos de IoT box.

Flashing do cartão SD na IoT box

Importante

Esta atualização não se aplica à Windows IoT box (Odoo 16 e superior).

Para atualizar a Windows IoT, primeiro desinstale a versão anterior do programa Odoo para Windows e, em seguida, reinstale-o usando o pacote de instalação mais atualizado.

Para iniciar a instalação, navegue até o pacote de instalação do Odoo 16 (ou superior) para Enterprise ou Community - edição Windows, na página de download do Odoo <https://odoo.com/download>`_.

Em algumas circunstâncias, o cartão micro SD da IoT box pode precisar ser atualizado novamente com o software Etcher para se beneficiar da última atualização de imagem da IoT box do Odoo. Isso significa que o software da IoT box do Odoo pode precisar ser atualizado em casos de inclusão de novas IoT boxes ou quando a atualização de um manipulador ou da página inicial da IoT box não resolver os problemas.

Nota

  • Com frequência, é necessário refazer o flash a imagem da IoT box depois de atualizar a base de dados do Odoo para uma nova versão.

  • É necessário um computador com um leitor/adaptador de cartão micro SD para refazer o flash do cartão micro SD.

Primeiro, comece fazendo o download do Etcher. Ele é um utilitário gratuito e de código aberto, usado para gravar arquivos de imagem em unidades. Após a conclusão do download, instale e inicie o programa no computador.

Em seguida, faça o download da última imagem de IoT do Nightly, que será rotulada como iotbox-latest.zip. Essa imagem específica é compatível com todas as versões suportadas do Odoo.

Após a conclusão dessa etapa, insira o cartão micro SD da IoT box no computador ou no leitor. Abra o Etcher e selecione Flash do arquivo, localize e selecione a imagem iotbox-latest.zip e extraia-a. Em seguida, selecione a unidade na qual a imagem deve ser gravada.

Por fim, clique em Flash e aguarde a conclusão do processo.

Painel de controle do software Etcher da Balena.

Dica

O software Etcher da Balena também permite que o administrador faça flash do cartão SD a partir de um URL. Para fazer flash a partir de um URL, basta clicar em Flash do URL, em vez de Flash do arquivo.

Em seguida, digite o seguinte: http://nightly.odoo.com/master/iotbox/iotbox-latest.zip.

Uma visualização do software Etcher da Balena, com a opção de flash a partir de URL destacada.

Nota

Um software alternativo para fazer flash do cartão micro SD é o Raspberry Pi Imager.

Windows IoT update

Windows virtual IoT box may occasionally need an update to work properly.

The following processes cover the uninstallation and re-installation of the Windows virtual IoT box.

Desinstalar o Windows IoT

Prior to upgrading the Windows virtual IoT box, the previous version should be uninstalled first.

Importante

Before uninstalling a previous version of the Windows virtual IoT box, ensure that there is a newer version of Windows virtual IoT box available, compared to the version currently installed. To do so, navigate to the Odoo Nightly builds page.

On the Odoo Nightly builds page, navigate to Builds (stable version) ‣ windows/ to view the date next to the odoo_(version).latest.exe file; where (version) is equal to the version of Odoo (e.g. 16.0, 17.0). The latest version of the Windows virtual IoT box can be downloaded by selecting this file, or it is always available at the Odoo Download page.

Uninstalling the Windows virtual IoT box is done through the Windows program manager.

On any version of Windows, search for program to open the Programs ‣ Programs and Features section of the Control Panel. Then, select Uninstall or change a program. Next, search for Odoo, and click the … (three dot) menu on the Odoo.exe program to uninstall.

Confirm the uninstallation, and follow the steps to uninstall through the Odoo uninstall wizard.

Download and re-install

The latest version of the Windows virtual IoT box can be downloaded from the Odoo Nightly builds page or it is always available at the Odoo Download page.

To download from the Odoo Nightly builds page, navigate to Builds (stable version) ‣ windows/ to and select the odoo_(version).latest.exe file; where (version) is equal to the version of Odoo (e.g. 16.0, 17.0).

To download from the Odoo Download page, find the section for the version of Odoo (e.g. 16.0, 17.0), and select the Download button for Windows.

Next, install and setup the downloaded Odoo .exe file. After the instructions screen, click Next to start the installation, and agree to the TOS.

During the next step of the re-installation, select Odoo IoT from the Select the type of install drop-down menu.

Example

Para referência, os seguintes itens devem ser instalados:

  • Odoo server

  • Odoo IoT

  • Nginx WebServer

  • Ghostscript interpreter

Ensure there is enough space on the computer for the installation, then click Next.

Set the destination and complete the installation

To complete the re-installation, select the Destination Folder, and click Install.

Aviso

Choosing C:\odoo as the install location allows for the Nginx server to start. Odoo’s Windows virtual IoT box software should not be installed inside any of the Windows user’s directories. Doing so does not allow for Nginx to initialize.

A instalação pode demorar alguns minutos. Quando terminar, clique em Next para continuar.

Then, ensure that the Start Odoo box is checked, and click Finish. After installation, the Odoo server runs, and automatically opens http://localhost:8069 on a web browser. The webpage should display the IoT box homepage.

Dica

A restart of the Windows IoT program may be necessary if the web browser does not display anything.

Atualização da página inicial da IoT box

Em segundo plano, a IoT box utiliza uma versão do código Odoo para executar e se conectar ao banco de dados Odoo. Esse código pode precisar ser atualizado para que a IoT box funcione de forma eficaz. Essa operação deve ser realizada rotineiramente para garantir que o sistema IoT e seus processos permaneçam atualizados.

Acesse a página inicial da caixa IoT navegando até app Internet das Coisas ‣ IoT Boxes e clicando no endereço IP da IoT box. Em seguida, clique em Upgrade (ao lado do número da versão).

Se uma nova versão da imagem da IoT box estiver disponível, um botão Upgrade para _xx.xx_ será exibido na parte inferior da página. Clique nesse botão para atualizar a unidade e, nesse momento, a IoT box faz flash para a versão mais recente. Todas as configurações anteriores são então salvas.

Importante

Esse processo pode levar mais de 30 minutos. Não desligue ou desconecte a IoT box, pois isso a deixaria em um estado inconsistente. Isso significa que é preciso refazer o flash da IoT box com uma nova imagem.

Upgrade do software da IoT box na página inicial da IoT box.

Atualização do manipulador (driver)

É possível que haja instâncias em que os drivers ou interfaces precisam ser atualizadas para dispositivos individuais (ex.: balanças, ferramentas de medição, etc.). O código do manipulador da IoT (drivers e interfaces) pode ser modificado sincronizando-o com o código do manipulador configurado.

Isso pode ser útil em casos em que os dispositivos de IoT (ex.: balanças, ferramentas de medição, etc.) não estejam funcionando corretamente com a IoT box.

Tanto para a Windows IoT box (Odoo 16 e superior) quanto para a IoT box física, esse processo pode ser realizado manualmente na página inicial da IoT box. Acesse a página inicial da IoT box navegando até o app IoT ‣ IoT Boxes e clicando no endereço IP da IoT box.

Em seguida, clique em Lista de manipuladores e selecione Carregar manipuladores na parte inferior da página.

Lista de manipuladores em uma IoT box com o botão "Carregar manipuladores" destacado.

Importante

O código do manipulador é obtido do servidor configurado e precisa estar atualizado para ter as correções e os patches mais recentes.

Nota

Também é realizada automaticamente uma atualização do manipulado toda vez que a IoT box é reiniciada. A única exceção a esse processo é se a opção Atualização automática de drivers estiver desmarcada na visualização de formulário da IoT box no servidor Odoo. Essa configuração pode ser acessada em app IoT ‣ Selecionar a IoT box ‣ Atualização automática de drivers.