Руководство по устранению неполадок, связанных с Обновлением устройств для Центра Интернета вещей
В этом документе перечислены некоторые распространенные вопросы и проблемы, о которых сообщили пользователи Обновления устройств. Если возникла проблема, не приведенная в этом руководстве по устранению неполадок, ознакомьтесь с разделом Обращение в службу технической поддержки Майкрософт, чтобы задокументировать ее.
Импорт обновлений
Вопрос. У меня возникли проблемы при подключении экземпляра обновления устройства к экземпляру Центр Интернета вещей
Убедитесь, что маршруты сообщений Центра Интернета вещей настроены правильно, как описано в документации по ресурсам Обновления устройств.
Вопрос. Возникает ошибка, связанная с ролью (сообщение об ошибке в портал Azure или ошибка API 403)
Возможно, неправильно настроены разрешения на доступ. Убедитесь, что разрешения на доступ настроены правильно в соответствии с документацией по управлению доступом для Обновления устройств.
Вопрос. При импорте содержимого в службу обновления устройств возникает ошибка типа 500
Код ошибки в диапазоне 500 может указывать на ошибку в работе службы обновления устройств. Подождите 5 минут и повторите попытку. Если та же ошибка повторяется, следуйте инструкциям в разделе Обращение в службу технической поддержки Майкрософт, чтобы отправить запрос в службу поддержки Майкрософт.
Вопрос. Я хочу сохранить те же свойства совместимости (нацелить обновление на тот же тип устройства), но изменить поставщика или имя в манифесте импорта. Но при этом появляется сообщение об ошибке "Сбой: ошибка при импорте обновления из-за превышения лимита"
Один и тот же набор свойств совместимости не может использоваться с более чем одним сочетанием обновления поставщика и имени. Это позволяет службе обновления устройств определить, какие обновления должны быть доступны для развертывания на данном устройстве. Если необходимо обновить несколько компонентов или секций на одном устройстве, функция обновления прокси-сервера предоставляет эту возможность.
Вопрос. Я сталкиваюсь с сообщением об ошибке при импорте содержимого и хочу получить дополнительные сведения о нем
Дополнительную информацию о сообщениях об ошибках, связанных с импортом, см. в документации по кодам ошибок Обновления устройств.
Сбои устройств
Вопрос. Как убедиться, что устройство подключено к Обновлению устройств для Центра Интернета вещей?
Убедитесь, что ваше устройство подключено к службе "Обновление устройств", проверив, отображается ли оно в разделе устройств "Несгруппированные" в представлении соответствия на портале Azure.
Вопрос. Не удается обновить одно или несколько моих устройств
Существует множество возможных первопричин сбоя обновления устройства. Убедитесь, что устройство: 1) подключено к экземпляру Центра Интернета вещей, 2) подключено к экземпляру обновления устройства и 3) запущена служба оптимизации доставки (DO). Если для вашего устройства выполнены все три условия, следуйте инструкциям в разделе Обращение в службу технической поддержки Майкрософт, чтобы отправить запрос в службу поддержки Майкрософт.
Вопрос. Не удается запустить агент обновления устройства
Одной из наиболее распространенных причин сбоя при запуске агента обновления устройств является неправильный файл конфигурации (du-config.json). Обратитесь к документации по файлу конфигурации и убедитесь, что агент настроен правильно. Обратите внимание, что все значения в файле конфигурации должны использовать двойные кавычки.
Развертывание обновления
Вопрос. Обновление на устройствах развернуто, но состояние соответствия указывает на то, что версия обновления не соответствует последней. Что следует делать?
Обновление состояния соответствия устройства может занять до 5 минут. Подождите, а затем снова проверьте.
Вопрос. Состояние развертывания устройства отображается как несовместимое, что делать?
После подключения устройства к Центру Интернета вещей изготовитель и свойства модели могут быть изменены, что приводит к тому, что устройство будет считаться несовместимым с обновлением текущего развертывания.
Проверьте интерфейс ADU Core, чтобы узнать, какой производитель и модель устройства указывается службе "Обновление устройств", и убедитесь, что эти данные соответствуют изготовителю и модели, указанной в манифесте импорта развертываемого содержимого обновления. Вы можете изменить эти свойства для конкретного устройства с помощью файла конфигурации Обновления устройств.
Вопрос. Мое развертывание находится на стадии "Активно", но ни одно из устройств не переходит на стадию "Выполняется" при обновлении. Что следует делать?
Убедитесь, что для даты начала развертывания не задана дата в будущем. При создании развертывания для даты его начала по умолчанию устанавливается следующий день на тот случай, если вы захотите изменить ее. Вы можете дождаться даты начала развертывания или отменить текущее развертывание и создать новое с нужной датой начала.
Вопрос. Я пытаюсь сгруппировать свои устройства, но не вижу тег в раскрывающемся списке при создании группы
Убедитесь, что маршруты сообщений Центра Интернета вещей настроены правильно, как описано в документации по ресурсам Обновления устройств. После настройки маршрута вам потребуется пометить устройство еще раз.
Другой первопричиной может быть применение тега перед подключением устройства к службе "Обновление устройств для Центра Интернета вещей". Убедитесь, что устройство уже подключено к службе "Обновление устройств". Убедитесь, что ваше устройство подключено к службе "Обновление устройств для Центра Интернета вещей", проверив, отображается ли оно в разделе устройств "Несгруппированные" в представлении соответствия. Временно добавьте тег с другим значением, а затем снова добавьте нужный тег после подключения устройства.
Если вы используете Службу подготовки устройств к добавлению в Центр Интернета вещей (DPS), убедитесь, что вы помечаете свои устройства после их подготовки, а не в процессе создания устройства. Если вы уже пометили свое устройство на этапе создания устройства, вам придется временно пометить свое устройство другим значением после его подготовки, а затем снова добавить требуемый тег.
Вопрос. Мое развертывание успешно завершено, но некоторые устройства не удалось обновить
Это могло быть вызвано ошибкой на стороне клиента на отказавших устройствах. См. раздел "Сбои устройств" данного руководства по устранению неполадок.
Вопрос. При попытке инициировать развертывание в пользовательском интерфейсе возникла ошибка
Это могло быть вызвано ошибкой службы/пользовательского интерфейса или проблемой с разрешениями API. Следуйте инструкциям в разделе Обращение в службу технической поддержки Майкрософт, чтобы отправить запрос в службу поддержки Майкрософт.
Вопрос. Развертывание запущено, но оно не достигает конечного состояния
Это могло быть вызвано проблемой с производительностью службы, ошибкой службы или ошибкой клиента. Повторите попытку развертывания через 10 минут. Если возникла та же проблема, извлеките журналы устройства и ознакомьтесь с разделом "Сбои устройств" этого руководства по устранению неполадок. Если та же проблема повторяется, следуйте инструкциям в разделе Обращение в службу технической поддержки Майкрософт, чтобы отправить запрос в службу поддержки Майкрософт.
Вопрос. Я переношу агент уровня устройства на добавление агента в качестве удостоверения модуля на устройстве, и мое обновление отображается как "выполняется", даже если оно было применено к устройству
Это могло быть вызвано, если вы не удалили старый агент, который обменивался данными через двойник устройства. При подготовке агента Обновления устройств в качестве модуля (см. раздел практическое руководство) все связи между устройством и службой Обновления устройств происходят через модуль двойника, поэтому не забудьте пометить модуль двойника на устройстве при создании групп, и все подключения должны выполняться через модуль двойника.
Скачивание обновлений на устройства
Вопрос. Как возобновить скачивание после повторного подключения устройства по истечении определенного периода отсоединения?
Скачивание будет возобновлено при восстановлении подключения в течение 24-часового периода. Через 24 часа пользователь должен повторно инициировать скачивание.
Использование Подключенного кэша Майкрософт (MCC)
Вопрос. При попытке развернуть модуль MCC на устройстве IoT Edge возникла проблема
Дополнительные сведения о развертывании модулей Edge для устройств IoT Edge см. в документации по IoT Edge. Чтобы проверить, успешно ли работает модуль MCC на устройстве IoT Edge, перейдите по ссылке http://localhost:5100/Summary.
Вопрос. Одно из моих устройств Интернета вещей пытается скачать обновление через MCC, но завершается сбоем
Существует несколько проблем, которые могут привести к сбою устройства Интернета вещей при подключении к MCC. Чтобы диагностировать проблему, соберите журналы клиента DO и Nginx с неисправного устройства (инструкции по сбору журналов клиентов см. в разделе Обращение в службу технической поддержки Майкрософт).
Возможно, устройству не удастся извлечь содержимое из Интернета для передачи в свой модуль MCC, так как URL-адрес, который используется, не разрешен. Чтобы определить это, необходимо проверить переменные среды IoT Edge на портале Azure.
Устранение неполадок с отсутствующим экземпляром в портал Azure
Вопрос. Я не вижу экземпляр обновления устройства для Центр Интернета вещей при выборе значка шестеренки
Существует несколько возможных причин этой проблемы. Инструкции по устранению неполадок см. ниже.
Экземпляр обновления устройств должен быть связан с Центром Интернета вещей Azure в той же группе ресурсов и подписке. Если вы переместили экземпляр Обновления устройства или концентратор в другую группу ресурсов или подписку, экземпляр может не отображаться в портал Azure. Чтобы продолжить использовать обновление устройств для Центр Интернета вещей, необходимо выполнить одно из следующих действий:
- Возврат перемещенных элементов в исходную конфигурацию.
- Если центр Интернета вещей перемещен только из одной группы ресурсов в другую, измените экземпляр Обновления устройств с помощью нового идентификатора ресурса Центра Интернета вещей.
- Если вы переместили элементы из одной подписки в другую, убедитесь, что учетная запись Обновления устройств и Центр Интернета вещей находятся в одной подписке, а затем измените экземпляр Обновления устройства с помощью нового идентификатора ресурса Центра Интернета вещей.
Для доступа к функциям обновления устройств через центр Интернета вещей в портал Azure требуются по крайней мере разрешения уровня чтения для центра Интернета вещей и обновления устройств для Центр Интернета вещей учетной записи.
- Чтобы управлять разрешениями для Центр Интернета вещей:
- Выберите центр в портал Azure
- Выберите "Управление доступом (IAM) на панели навигации слева.
- Выберите "Добавить назначение ролей".
- Выберите роль по крайней мере с доступом на чтение и нажмите кнопку Далее.
- Рядом с полем "Участники" выберите +Select members (+Выбрать участников).
- Добавьте свою учетную запись во всплывающем окне справа и нажмите кнопку "Выбрать".
- Выберите "Проверить и назначить".
- Чтобы управлять разрешениями для обновления устройства для учетной записи Центр Интернета вещей, попросите владельца учетной записи выполнить следующие действия:
- Выберите учетную запись обновления устройства в портал Azure.
- Выберите "Управление доступом (IAM) на панели навигации слева.
- Выберите "Добавить назначение ролей".
- Выберите роль Читатель (или роль с эквивалентными разрешениями).
- Рядом с пунктом "Участники" выберите "+Выбрать участников".
- Добавьте свою учетную запись во всплывающем окне справа и нажмите кнопку "Выбрать".
- Выберите "Проверить и назначить".
Узнайте больше об управлении доступом на основе ролей для службы обновления устройств.
Обращение в службу технической поддержки Майкрософт
Если возникли проблемы, которые не удается устранить с помощью указанных выше сведений, можно отправить запрос в службу поддержки Майкрософт с помощью интерфейса портала Azure. В зависимости от категории, к которой относится неполадка, вам может быть предложено собрать и отправить дополнительные данные, чтобы помочь службе поддержки Майкрософт изучить проблему.
Инструкции по сбору каждого типа данных см. ниже.
GetDevice можно использовать для проверки дополнительных сведений в ответе полезных данных API.
Кроме того, следующие сведения могут оказаться полезными для уточнения первопричины проблемы:
- Какой тип устройства вы пытаетесь обновить (шлюз IoT Edge, другое)
- какой тип клиента Обновления устройств вы используете (на основе образа, на основе пакета, симулятор);
- какая ОС работает на устройстве;
- сведения об архитектуре устройства;
- было ли прежде успешно использовано Обновление устройств для обновления устройства.
Если у вас есть доступная выше информация, добавьте ее в описание проблемы.
Сбор журналов клиента
На устройстве Raspberry Pi можно найти два набора журналов:
/adu/logs/var/cache/do-client-lite/logДля упакованного клиента журналы находятся здесь:
/var/log/adu/var/cache/do-client-lite/logДля симулятора журналы находятся здесь:
/tmp/aduc-logs
Коды ошибок
При сообщении о проблемах, связанных с импортом обновления, сбоем устройства или развертыванием обновления, может быть предложено указать коды ошибок.
Коды ошибок можно получить, просмотрев интерфейс ADUCoreInterface. Сведения о том, как анализировать коды ошибок для самостоятельной диагностики и устранения неполадок, см. в документации по кодам ошибок обновления устройств.
Идентификатор трассировки
Вам может быть предложено указать идентификатор трассировки при сообщении о проблемах, связанных с импортом или развертыванием обновления.
Идентификатор трассировки для указанного действия пользователя можно найти в ответе API или в разделе "Журнал импорта" пользовательского интерфейса на портале Azure.
Сейчас идентификаторы трассировки для действий развертывания доступны только через ответ API.
Идентификатор развертывания
Вам может быть предложено указать идентификатор развертывания при сообщении о проблемах, связанных с развертыванием обновления.
Идентификатор развертывания создается пользователем при вызове API для инициации развертывания.
Сейчас идентификаторы развертывания для развертываний, инициированных из пользовательского интерфейса на портале Azure, создаются автоматически и не отображаются для пользователя.
Имя экземпляра Центра Интернета вещей
Вам может быть предложено указать имя экземпляра Центра Интернета вещей при сообщении о проблемах, связанных с ошибками устройств или развертыванием обновления.
Имя Центра Интернета вещей выбирает пользователь при первой подготовке.
Имя учетной записи Обновления устройств
Вам может быть предложено указать имя учетной записи Обновления устройств при сообщении о проблемах, связанных с импортом обновления, ошибками устройств или развертыванием обновления.
Имя учетной записи Обновления устройств выбирает пользователь при первой регистрации в службе. Дополнительные сведения можно найти в документации по ресурсам Обновления устройств.
Имя экземпляра Обновления устройств
Вам может быть предложено указать имя экземпляра Обновления устройств при сообщении о проблемах, связанных с импортом обновления, ошибками устройств или развертыванием обновления.
Имя экземпляра Обновления устройств выбирает пользователь при первой подготовке. Дополнительные сведения можно найти в документации по ресурсам Обновления устройств.
Идентификатор устройства
Вам может быть предложено указать идентификатор устройства при сообщении о проблемах, связанных с ошибками устройств или развертыванием обновления.
Идентификатор устройства определяется клиентом при первой подготовке устройства. Его также можно получить из двойника этого устройства.
Код обновления
Вам может быть предложено указать идентификатор обновления при сообщении о проблемах, связанных с развертыванием обновления.
Идентификатор обновления определяет клиент при запуске развертывания.
Журналы Nginx
Возможно, вам будет предложено предоставить журналы Nginx при сообщении о проблемах, связанных с Подключенным кэшем Майкрософт.
ADU-conf.txt
Возможно, вам будет предложено указать файл конфигурации Обновления устройств (adu-conf.txt) при сообщении о проблемах, связанных с развертыванием обновления.
Файл конфигурации является необязательным и создается пользователем согласно инструкций в документации по конфигурации Обновления устройств.
Импорт манифеста
Вам может быть предложено указать файл манифеста импорта при сообщении о проблемах, связанных с импортом или развертыванием обновления.
Манифест импорта — это файл, созданный клиентом при импорте содержимого обновления в службу Обновления устройств.