Compartilhar via

Migrar dispositivos e grupos da Visualização Pública para a Atualização de Visualização Pública

  • Artigo

Conforme o serviço da Atualização de Dispositivo para Hub IoT lança novas versões, é recomendável atualizar os dispositivos para os recursos e melhorias de segurança mais recentes. Este artigo fornece informações sobre como migrar da Versão Prévia pública para a versão atual da PPR (Atualização de Versão Prévia Pública). Este artigo também explica o comportamento do grupo e da UX nessas versões. Você poderá ignorar esta página se não tiver dispositivos, grupos e implantações que usam a versão de Visualização Pública.

Você terá que atualizar o agente DU em execução em seus dispositivos para migrar com êxito. Você também terá que criar novos grupos de dispositivos para implantar e gerenciar atualizações. Observe que, como há alterações importantes na versão da PPR, é recomendável que você siga as instruções com atenção para evitar erros.

Atualizar o agente da atualização de dispositivo

Para a versão da Atualização de Visualização Pública, o agente da Atualização de Dispositivo precisa ser atualizado manualmente, conforme descrito abaixo. Não há suporte para a atualização do agente por meio de uma implantação da Atualização de Dispositivo devido a alterações importantes na versão da Visualização Pública e PPR.

  1. Para exibir dispositivos usando agentes mais antigos (versões 0.7.0/0.6.0) e grupos criados antes de 03/02/2022, navegue até o portal de visualização pública, que pode ser acessado por meio do banner.

    Captura de tela da faixa.

  2. Crie um novo dispositivo IoT/IoT Edge no portal do Azure. Copie a cadeia de conexão primária do dispositivo da exibição do dispositivo para usar mais tarde. Para obter mais detalhes, confira a seção Adicionar dispositivo ao Hub IoT.

  3. Em seguida, entre com a SSH em seu dispositivo e remova todos os agentes de Atualização de Dispositivo antigos.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Remover o arquivo de configuração antigo

    sudo rm -f /etc/adu/adu-conf.txt

  5. Instalar o novo agente

    sudo apt-get install deviceupdate-agent

    Opcionalmente, você pode obter o ativo .deb do GitHub e instalar o agente

    sudo apt install <file>.deb

    Tentar atualizar o agente da Atualização de Dispositivo sem remover o agente e os arquivos de configuração antigos resultará no erro mostrado abaixo.

    Captura de tela do erro de atualização.

  6. Insira a cadeia de conexão primária (ou módulo, dependendo de como você provisionou o dispositivo com a Atualização de Dispositivo) de dispositivo do dispositivo da IoT no arquivo de configuração executando o comando abaixo.

    sudo nano /etc/adu/du-config.json

  7. Adicione modelo, fabricante, nome do agente, tipo de conexão e outros detalhes no arquivo de configuração

  8. Exclua o dispositivo IoT/IoT Edge do portal de visualização pública.

Observação

Tentar atualizar o agente por meio de uma implantação de DU fará com que o dispositivo não seja mais gerenciável pela Atualização de Dispositivo. O dispositivo terá que ser provisionado novamente para ser gerenciado por meio da Atualização de Dispositivo.

Migrar grupos para Atualização de Visualização Pública

  1. Se os dispositivos estão usando as versões 0.6.0 ou 0.7.0 do agente de Atualização de Dispositivo, atualize para a versão mais recente do agente 0.8.0 seguindo as etapas acima.

  2. Exclua os grupos existentes no portal de visualização pública navegando por meio do banner.

  3. Adicione a marca de grupo ao dispositivo gêmeo para os dispositivos atualizados. Para obter mais detalhes, confira a seção Adicionar uma marca ao seu dispositivo.

  4. Recrie os grupos no portal da PPR indo para 'Adicionar Grupos' e selecionando a marcação de grupos correspondentes na listagem suspensa.

  5. Observe que um grupo com o mesmo nome não poderá ser criado no portal da PPR se o grupo no portal de visualização pública não for excluído.

Comportamento de grupo e implantação entre versões

  • Os grupos criados no portal da versão de Atualização de Visualização Pública permitirão apenas a adição de dispositivos com o Agente de Atualização de Dispositivo mais recente (0.8.0). Dispositivos com agentes mais antigos (0.7.0/0.6.0) não podem ser adicionados a esses grupos.

  • Todos os dispositivos novos que usam o agente mais recente serão adicionados automaticamente a um Grupo DeviceClass Padrão na guia "Grupos e Implantações". Se uma marca de grupo for adicionada às propriedades do dispositivo, o dispositivo será adicionado a esse grupo se existir um grupo para essa marca.

  • Para o dispositivo que usa o agente mais recente, se uma marca de grupo for adicionada às propriedades do dispositivo, mas o grupo correspondente ainda não tiver sido criado, o dispositivo não ficará visível na guia "Grupos e Implantações".

  • Os dispositivos que usam os agentes mais antigos aparecerão como desagrupados no portal antigo se a marca de grupo não for adicionada.

Próximas etapas

Entender o arquivo de configuração do agente de Atualização de Dispositivo

Você pode usar os seguintes tutoriais para uma demonstração simples da Atualização de Dispositivo para Hub IoT: