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.

Atualização do Windows IoT

A Windows virtual IoT box pode ocasionalmente precisar de uma atualização para funcionar corretamente.

Os processos a seguir abrangem a desinstalação e reinstalação da Windows virtual IoT box.

Desinstalar o Windows IoT

Antes de atualizar a Windows virtual IoT box, a versão anterior deve ser desinstalada primeiro.

Importante

Antes de desinstalar uma versão anterior da Windows virtual IoT box, verifique se há uma versão mais recente da Windows virtual IoT box disponível, em comparação com a versão atualmente instalada. Para fazer isso, navegue até a página Odoo Nightly Builds.

Na página Odoo Nightly Builds, navegue até Builds (stable version) ‣ windows/ para visualizar a data ao lado do arquivo odoo_(version).latest.exe; onde (version) é igual à versão do Odoo (por exemplo, 16.0, 17.0). A versão mais recente da Windows virtual IoT box pode ser baixada selecionando esse arquivo, ou está sempre disponível na página Odoo Download.

A desinstalação da Windows virtual IoT box é feita pelo gerenciador de programas do Windows.

Em qualquer versão do Windows, procure por programa para abrir a seção Programas ‣ Programas e recursos do Painel de controle. Em seguida, selecione Desinstalar ou alterar um programa. Em seguida, procure por Odoo e clique no menu … (três pontos) no programa Odoo.exe a ser desinstalado.

Confirme a desinstalação e siga as etapas de desinstalação pelo assistente de desinstalação do Odoo.

Fazer download e reinstalar

A versão mais recente da Windows virtual IoT box pode ser baixada na página Odoo Nightly Builds ou está sempre disponível na página Odoo Download.

Para fazer o download na página Odoo Nightly builds, navegue até Builds (stable version) ‣ windows/ e selecione o arquivo odoo_(version).latest.exe; onde (version) é igual à versão do Odoo (por exemplo, 16.0, 17.0).

Para fazer o download na página Odoo Download, localize a seção referente à versão do Odoo (por exemplo, 16.0, 17.0) e selecione o botão Download para Windows.

Em seguida, instale e configure o arquivo Odoo .exe baixado. Após a tela de instruções, clique em Próximo para iniciar a instalação e concorde com os TS.

Durante a próxima etapa da reinstalação, selecione Odoo IoT no menu suspenso Selecione o tipo de instalação.

Example

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

  • Odoo server

  • Odoo IoT

  • Nginx WebServer

  • Ghostscript interpreter

Verifique se há espaço suficiente no computador para a instalação e, em seguida, clique em Próximo.

Definir o destino e concluir a instalação

Para concluir a reinstalação, selecione a Pasta de destino e clique em Instalar.

Aviso

A escolha de C:\odoo como local de instalação permite que o servidor Nginx seja iniciado. O software da Windows virtual IoT box da Odoo não deve ser instalado em nenhum dos diretórios do usuário do Windows. Fazer isso não permite que o Nginx seja inicializado.

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

Em seguida, certifique-se de que a caixa Iniciar Odoo esteja marcada e clique em Finalizar. Após a instalação, o servidor Odoo é executado e abre automaticamente o endereço http://localhost:8069 em um navegador da web. A página da Web deve exibir a página inicial da IoT box.

Dica

Pode ser necessário reiniciar o programa Windows IoT se o navegador da web não exibir nada.

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.