Guia de Resolução de Problemas da Atualização de Dispositivos para Hub IoT

Artigo
05/24/2023

Este documento lista algumas perguntas comuns e problemas que os utilizadores da Atualização de Dispositivos comunicaram. Se encontrar um problema que não aparece neste guia de resolução de problemas, consulte a secção Contactar Suporte da Microsoft para documentar a sua situação.

Importar atualizações

P: Estou a ter problemas ao ligar a minha instância da Atualização de Dispositivos à minha instância de Hub IoT

Certifique-se de que as rotas Hub IoT mensagens estão configuradas corretamente, de acordo com a documentação dos recursos da Atualização de Dispositivos.

Pode não ter permissões de acesso configuradas corretamente. Certifique-se de que configurou as permissões de acesso corretamente de acordo com a documentação do controlo de acesso da Atualização de Dispositivos .

P: Estou a deparar-me com um erro de 500 tipos ao importar conteúdo para o serviço de Atualização de Dispositivos

Um código de erro no intervalo 500 pode indicar um problema com o serviço Atualização de Dispositivos. Aguarde 5 minutos e tente novamente. Se o mesmo erro persistir, siga as instruções na secção Contacting Suporte da Microsoft (Contactar Suporte da Microsoft) para enviar um pedido de suporte à Microsoft.

P: Quero manter as mesmas propriedades de compatibilidade (direcionar a minha atualização para o mesmo tipo de dispositivo), mas alterar o Fornecedor ou o Nome no manifesto de importação. Mas recebo um erro "Falha: erro ao importar a atualização devido ao limite excedido" quando o faço

Não é possível utilizar o mesmo conjunto exato de propriedades de compatibilidade com mais do que uma combinação Fornecedor de Atualizações e Nome. Isto permite ao serviço Atualização de Dispositivos determinar com certeza quais as atualizações que devem estar disponíveis para implementação num determinado dispositivo. Se precisar de atualizar vários componentes ou partições num único dispositivo, a funcionalidade de atualizações de proxy fornece essa capacidade.

P: Estou a deparar-me com uma mensagem de erro ao importar conteúdo e gostaria de saber mais sobre o mesmo

Veja a documentação Códigos de Erro de Atualização de Dispositivos para obter informações mais detalhadas sobre as mensagens de erro relacionadas com a importação.

Falhas do dispositivo

P: Como posso garantir que o meu dispositivo está ligado à Atualização de Dispositivos para Hub IoT?

Pode verificar se o dispositivo está ligado à Atualização de Dispositivos ao verificar se aparece na secção "Dispositivos sem grupo" na vista de conformidade do portal do Azure.

P: Um ou mais dos meus dispositivos não estão a atualizar

Existem muitas causas possíveis para uma falha na atualização do dispositivo. Confirme que o dispositivo está: 1) ligado à instância Hub IoT, 2) ligado à instância de Atualização de Dispositivos e 3) que o serviço de Otimização da Entrega (DO) está em execução. Se os três forem verdadeiros para o seu dispositivo, siga as instruções na secção Contactar Suporte da Microsoft para enviar um pedido de suporte à Microsoft.

P: O meu agente de Atualização de Dispositivos está a falhar ao iniciar

Um dos motivos mais comuns para uma falha na start-up do agente de Atualização de Dispositivos é um ficheiro de configuração com formato incorreto (du-config.json). Veja a documentação do ficheiro de configuração e certifique-se de que o agente está configurado corretamente. Tenha em atenção que todos os valores no ficheiro de configuração têm de utilizar aspas duplas.

Implementar uma atualização

P: Implementei uma atualização para os meus dispositivos, mas o estado de conformidade indica que não está na atualização mais recente. O que devo fazer?

O estado de conformidade do dispositivo pode demorar até 5 minutos a ser atualizado. Aguarde e, em seguida, verifique novamente.

P: O estado de implementação do meu dispositivo mostra incompatíveis, o que devo fazer?

As propriedades do fabricante e do modelo de um dispositivo de destino podem ter sido alteradas depois de ligar o dispositivo ao Hub IoT, fazendo com que o dispositivo seja agora considerado incompatível com o conteúdo de atualização da implementação atual.

Verifique a Interface Principal do ADU para ver que fabricante e modelo o seu dispositivo está a reportar ao serviço de Atualização de Dispositivos e certifique-se de que corresponde ao fabricante e ao modelo que especificou no manifesto de importação do conteúdo de atualização que está a ser implementado. Pode alterar estas propriedades para um determinado dispositivo com o ficheiro de configuração da Atualização de Dispositivos.

P: Vejo que a minha implementação está na fase "Ativa", mas nenhum dos meus dispositivos está "em curso" com a atualização. O que devo fazer?

Certifique-se de que a data de início da implementação não está definida no futuro. Quando cria uma nova implementação, a data de início da implementação é predefinida para o dia seguinte como uma salvaguarda, a menos que a altere explicitamente. Pode esperar pela data de início da implementação ou cancelar a implementação em curso e criar uma nova com a data de início desejada.

P: Estou a tentar agrupar os meus dispositivos, mas não vejo a etiqueta no menu pendente ao criar um grupo

Certifique-se de que configurou corretamente as rotas de mensagens no seu Hub IoT de acordo com a documentação dos recursos da Atualização de Dispositivos. Terá de etiquetar novamente o seu dispositivo depois de configurar a rota.

Outra causa raiz pode ser ter aplicado a etiqueta antes de ligar o dispositivo à Atualização de Dispositivos durante Hub IoT. Certifique-se de que o dispositivo já está ligado à Atualização de Dispositivos. Pode verificar se o dispositivo está ligado à Atualização de Dispositivos durante Hub IoT ao verificar se aparece em dispositivos "Desagrupar" na vista de conformidade. Adicione temporariamente uma etiqueta de um valor diferente e, em seguida, adicione novamente a etiqueta pretendida assim que o dispositivo estiver ligado.

Se estiver a utilizar o Serviço Aprovisionamento de Dispositivos (DPS), certifique-se de que identifica os seus dispositivos depois de serem aprovisionados e não durante o processo de criação do Dispositivo. Se já tiver marcado o seu dispositivo durante o passo De criação do dispositivo, terá de etiquetar temporariamente o seu dispositivo com um valor diferente depois de este ser aprovisionado e, em seguida, adicionar novamente a etiqueta pretendida.

P: A minha implementação foi concluída com êxito, mas alguns dispositivos não conseguiram atualizar

Isto pode ter sido causado por um erro do lado do cliente nos dispositivos com falhas. Veja a secção Falhas do Dispositivo deste guia de resolução de problemas.

P: Deparei-me com um erro na UX ao tentar iniciar uma implementação

Isto pode ter sido causado por um erro de serviço/UX ou por um problema de permissões da API. Siga as instruções na secção Contactar Suporte da Microsoft para enviar um pedido de suporte à Microsoft.

P: Iniciei uma implementação, mas não está a atingir um estado final

Isto pode ter sido causado por um problema de desempenho do serviço, um erro de serviço ou um erro do cliente. Repita a implementação após 10 minutos. Se encontrar o mesmo problema, solicite os registos do dispositivo e veja a secção Falhas do Dispositivo deste guia de resolução de problemas. Se o mesmo problema persistir, siga as instruções na secção Contactar Suporte da Microsoft para apresentar um pedido de suporte à Microsoft.

P: Migro de um agente ao nível do dispositivo para adicionar o agente como uma identidade do Módulo no dispositivo e a minha atualização é apresentada como "em curso", apesar de ter sido aplicada ao dispositivo

Isto pode ter sido causado se não tiver removido o agente mais antigo que estava a comunicar através do Dispositivo Duplo. Quando aprovisiona o agente de Atualização de Dispositivos como um Módulo (veja como) todas as comunicações entre o dispositivo e o serviço Atualização de Dispositivos ocorrem através do Módulo Duplo, por isso lembre-se de etiquetar o Módulo Duplo do dispositivo ao criar grupos e todas as comunicações têm de ocorrer através do módulo duplo.

Transferir atualizações para dispositivos

P: Como devo proceder para retomar uma transferência quando um dispositivo voltar a ligar após um período de desconexão?

A transferência será retomada automaticlmente quando a conectividade for restaurada num período de 24 horas. Após 24 horas, a transferência terá de ser reiniciada pelo utilizador.

Utilizar a Cache Ligada da Microsoft (MCC)

P: Estou a deparar-me com um problema ao tentar implementar o módulo MCC no meu dispositivo IoT Edge

Veja a documentação IoT Edge para implementar módulos do Edge em dispositivos IoT Edge. Pode verificar se o módulo MCC está a ser executado com êxito no seu dispositivo IoT Edge ao navegar parahttp://localhost:5100/Summary.

P: Um dos meus dispositivos IoT está a tentar transferir uma atualização através do MCC, mas está a falhar

Existem vários problemas que podem estar a fazer com que um dispositivo IoT falhe na ligação ao MCC. Para diagnosticar o problema, recolha os registos do cliente DO e do Nginx do dispositivo com falha (consulte a secção Contactar Suporte da Microsoft para obter instruções sobre a recolha de registos de cliente).

O seu dispositivo pode não conseguir extrair conteúdo da Internet para passar para o módulo MCC porque o URL que está a utilizar não é permitido. Para determinar se sim, terá de verificar as variáveis de ambiente IoT Edge no portal do Azure.

Resolver problemas de uma instância em falta no portal do Azure

P: Não vejo uma instância da Atualização de Dispositivos para Hub IoT quando seleciono o ícone de "engrenagem"

Existem algumas causas possíveis para este problema. Veja abaixo os passos de resolução de problemas.

Uma instância de Atualização de Dispositivos tem de ser associada a um hub IoT do Azure no mesmo grupo de recursos e subscrição. Se tiver movido a instância da Atualização de Dispositivos ou o hub para um grupo de recursos ou subscrição diferente, poderá não ver a instância no portal do Azure. Terá de efetuar um dos seguintes passos para continuar a utilizar a Atualização de Dispositivos para Hub IoT:

Devolva os itens movidos para a configuração original.
Se apenas tiver movido o hub IoT de um grupo de recursos para outro, modifique a instância de Atualização de Dispositivos com o novo resourceId do hub IoT.
Se tiver movido os itens de uma subscrição para outra, certifique-se de que a conta de Atualização de Dispositivos e o hub IoT estão na mesma subscrição e, em seguida, modifique a instância da Atualização de Dispositivos com o novo resourceId do hub IoT.

São necessárias, pelo menos, permissões ao nível da leitura para o hub IoT e a Atualização de Dispositivos para Hub IoT conta para aceder à funcionalidade Atualização de Dispositivos através da experiência do hub IoT no portal do Azure.

Para gerir permissões para a sua Hub IoT:
- Selecione o hub no portal do Azure
- Selecione "Controlo de acesso (IAM) na barra de navegação do lado esquerdo.
- Selecione "Adicionar atribuição de função".
- Selecione uma função com, pelo menos, Acesso de leitura e selecione Seguinte.
- Junto a "Membros", selecione "+Selecionar membros".
- Adicione a sua conta na lista de opções à direita e selecione o botão "Selecionar".
- Selecione "Rever + atribuir".
Para gerir as permissões da Atualização de Dispositivos para Hub IoT conta, peça ao proprietário da conta para efetuar estes passos:
- Selecione a sua conta de Atualização de Dispositivos na portal do Azure.
- Selecione "Controlo de acesso (IAM) na barra de navegação do lado esquerdo.
- Selecione "Adicionar atribuição de função".
- Selecione a função Leitor (ou uma com permissões equivalentes).
- Junto a "Membros", selecione "+Selecionar membros".
- Adicione a sua conta na lista de opções à direita e selecione o botão "Selecionar".
- Selecione "Rever + atribuir".

Saiba mais sobre o controlo de acesso baseado em funções para o serviço Atualização de Dispositivos.

Contactar o Suporte da Microsoft

Se se deparar com problemas que não podem ser resolvidos com as FAQs acima, pode apresentar um pedido de suporte com Suporte da Microsoft através da interface de portal do Azure. Consoante a categoria a que indica que o problema pertence, poderá ser-lhe pedido para recolher e partilhar dados adicionais para ajudar Suporte da Microsoft investigar o problema.

Veja abaixo para obter instruções sobre como recolher cada tipo de dados.

Pode utilizar getDevice para verificar se existem informações adicionais na resposta do payload da API.

Além disso, as seguintes informações podem ser úteis para restringir a causa do problema:

Que tipo de dispositivo está a tentar atualizar (IoT Edge Gateway, outro)
Que tipo de cliente de Atualização de Dispositivos está a utilizar (Baseado em imagens, Baseado em Pacotes, Simulador)
Qual é o SO que o seu dispositivo está a executar
Detalhes sobre a arquitetura do seu dispositivo
Se utilizou a Atualização de Dispositivos com êxito para atualizar um dispositivo antes

Se tiver alguma das informações acima disponíveis, inclua-a na descrição do problema.

Recolher registos de cliente

No Dispositivo Raspberry Pi, encontram-se dois conjuntos de registos aqui:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
Para o cliente empacotado, os registos encontram-se aqui:
```
/var/log/adu
```
```
/var/cache/do-client-lite/log
```
Para o Simulador, os registos encontram-se aqui:
```
/tmp/aduc-logs
```

Códigos de erro

Poderá ser-lhe pedido para fornecer códigos de erro ao comunicar um problema relacionado com a importação de uma atualização, uma falha do dispositivo ou a implementação de uma atualização.

Os códigos de erro podem ser obtidos ao observar a interface ADUCoreInterface . Veja a documentação códigos de erro da Atualização de Dispositivos para obter informações sobre como analisar códigos de erro para autodiagnóstico e resolução de problemas.

ID de Rastreio

Poderá ser-lhe pedido para fornecer um ID de rastreio ao comunicar um problema relacionado com a importação ou implementação de uma atualização.

O ID de rastreio de uma determinada ação de utilizador pode ser encontrado na resposta da API ou na secção Histórico de Importações da interface de utilizador portal do Azure.

Atualmente, os IDs de rastreio para ações de implementação só estão acessíveis através da resposta da API.

ID de Implementação

Poderá ser-lhe pedido para fornecer um ID de implementação ao comunicar um problema relacionado com a implementação de uma atualização.

O ID de implementação é criado pelo utilizador ao chamar a API para iniciar uma implementação.

Atualmente, os IDs de implementação para implementações iniciadas a partir do portal do Azure interface de utilizador são gerados automaticamente e não são apresentados ao utilizador.

Hub IoT nome da instância

Poderá ser-lhe pedido para indicar o nome da sua instância Hub IoT ao comunicar um problema relacionado com falhas do dispositivo ou ao implementar uma atualização.

O nome Hub IoT é escolhido pelo utilizador quando aprovisionado pela primeira vez.

Nome da conta de Atualização de Dispositivo

Poderá ser-lhe pedido para indicar o nome da conta de Atualização de Dispositivos ao comunicar um problema relacionado com a importação de uma atualização, falhas do dispositivo ou implementação de uma atualização.

O nome da conta de Atualização de Dispositivo é escolhido pelo utilizador quando se inscreve pela primeira vez no serviço. Pode encontrar mais informações na documentação de recursos da Atualização de Dispositivos .

Nome da instância da Atualização de Dispositivo

Poderá ser-lhe pedido para indicar o nome da instância da Atualização de Dispositivos ao comunicar um problema relacionado com a importação de uma atualização, falhas do dispositivo ou implementação de uma atualização.

O nome da instância da Atualização de Dispositivos é escolhido pelo utilizador quando aprovisionado pela primeira vez. Pode encontrar mais informações na documentação de recursos da Atualização de Dispositivos .

ID do Dispositivo

Poderá ser-lhe pedido para fornecer um ID de dispositivo ao comunicar um problema relacionado com falhas do dispositivo ou ao implementar uma atualização.

O ID do dispositivo é definido pelo cliente quando o dispositivo é aprovisionado pela primeira vez. Também pode ser obtido a partir do Dispositivo Duplo do dispositivo.

Atualizar ID

Poderá ser-lhe pedido para fornecer um ID de atualização ao comunicar um problema relacionado com a implementação de uma atualização.

O ID de atualização é definido pelo cliente ao iniciar uma implementação.

Registos do Nginx

Poderá ser-lhe pedido para fornecer registos Nginx ao comunicar um problema relacionado com a Cache Ligada da Microsoft.

ADU-conf.txt

Poderá ser-lhe pedido que forneça o ficheiro de configuração da Atualização de Dispositivos ("adu-conf.txt") ao comunicar um problema relacionado com a implementação de uma atualização.

O ficheiro de configuração é opcional e criado pelo utilizador ao seguir as instruções na documentação de configuração da Atualização de Dispositivos .

Importar manifesto

Poderá ser-lhe pedido para fornecer o ficheiro de manifesto de importação ao comunicar um problema relacionado com a importação ou implementação de uma atualização.

O manifesto de importação é um ficheiro criado pelo cliente ao importar conteúdo de atualização para o serviço Atualização de Dispositivos.

Passos seguintes

Saiba mais sobre os códigos de erro da Atualização de Dispositivos