Поделиться через

Устранение неполадок с подключенным кэшем Майкрософт для предприятий и образовательных учреждений

В этой статье содержатся инструкции по устранению различных проблем, которые могут возникнуть при использовании подключенного кэша. Эти проблемы классифицируются по задаче, в которой они могут возникнуть.

Известные проблемы

В этом разделе описаны известные проблемы с последним выпуском Microsoft Connected Cache for Enterprise and Education. Дополнительные сведения об исправлениях, включенных в последний выпуск, см. на странице Заметки о выпуске.

Диаграмма мониторинга узлов кэша в пользовательском интерфейсе портал Azure отображает неверные сведения

Сбой provisionmcconwsl.ps1 скрипта при выполнении на хост-компьютере Windows 11, настроенном для использования японского языка

В сценарии установки подключенного кэша (provisionmcconwsl.ps1) обработка проверка выполняется до тех пор, пока значение последнего кода выполнения (последний результат) задачи установки не станет равным 0 в следующей обработке. Однако в японской ОС возвращаемое значение равно NULL, так как отображается "Последний результат" и возникает исключение.

В качестве временного обходного решения описанная выше ошибка не возникает, изменяя языковой параметр пользователя локального администратора с японского на английский, а затем выполняя скрипт.

Действия по получению идентификатора подписки Azure

  1. Войдите в портал Azure.
  2. Выберите Подписки. Если вы не видите подписки, введите Подписки в строке поиска. Когда вы начнете вводить текст, список фильтруется на основе ваших входных данных.
  3. Если у вас уже есть подписка Azure, перейдите к шагу 5. Если у вас нет подписки Azure, выберите + Добавить в левом верхнем углу.
  4. Выберите подписку с оплатой по мере использования . Вам будет предложено ввести сведения о кредите карта, но плата за использование службы подключенного кэша Майкрософт не будет взиматься.
  5. На странице Подписки вы найдете сведения о текущей подписке. Выберите имя подписки.
  6. Выбрав имя подписки, вы найдете идентификатор подписки на вкладке Обзор . Щелкните значок Копировать в буфер обмена рядом с идентификатором подписки, чтобы скопировать значение.

Устранение неполадок с созданием ресурсов Azure

Создание ресурсов Azure подключенного кэша можно инициировать с помощью пользовательского интерфейса портал Azure или набора команд Azure CLI.

Если во время создания ресурса возникает ошибка, проверка, что у вас есть необходимые разрешения на создание ресурсов Azure в рамках подписки и заполнены все необходимые поля в процессе создания ресурса.

Устранение неполадок с конфигурацией узла кэша

Настройку узла подключенного кэша можно выполнить с помощью портал Azure пользовательского интерфейса или набора команд Azure CLI.

Если возникает ошибка проверки, проверка, что вы заполнили все необходимые поля конфигурации.

Если конфигурация не действует, проверка, что вы выбрали параметр Сохранить в верхней части страницы конфигурации в пользовательском интерфейсе портал Azure.

Если конфигурация прокси-сервера изменена, необходимо повторно подготовить программное обеспечение подключенного кэша на хост-компьютере, чтобы конфигурация прокси-сервера влалась в силу.

Устранение неполадок узлов кэша, созданных во время ранней предварительной версии

Узлы кэша, созданные и развернутые во время ранней предварительной версии Microsoft Connected Cache for Enterprise and Education , должны продолжать функционировать, но больше не могут управляться или отслеживаться удаленно с помощью службы Azure Connected Cache.

Поэтому настоятельно рекомендуется повторно создать существующие ресурсы в Azure , а затем повторно развернуть программное обеспечение подключенного кэша на хост-компьютерах с помощью установщика последней версии ос.

Устранение неполадок с развертыванием узла кэша на хост-компьютере Windows

Сбор журналов установки, размещенных в Windows

Развертывание узла подключенного кэша на хост-компьютере Windows включает выполнение ряда сценариев PowerShell, содержащихся в пакете подготовки Windows. Эти скрипты пытаются записать файлы журнала в каталог установки, указанный в команде подготовки (C:\mccwsl01\InstallLogs по умолчанию).

Существует три типа файлов журнала установки:

  1. WSL_Mcc_Install_Transcript: этот файл журнала записывает строки, напечатанные в окне PowerShell при выполнении сценария установки.
  2. WSL_Mcc_Install_FromRegisteredTask_Status: этот файл журнала записывает состояние высокого уровня, записанное во время установки зарегистрированных задач.
  3. WSL_Mcc_Install_FromRegisteredTask_Transcript: этот файл журнала записывает подробное состояние, записанное во время установки зарегистрированных задач.

Расшифровка зарегистрированной задачи обычно является наиболее полезной для диагностики проблемы установки.

Сбор других журналов, размещенных в Windows

После успешной установки узла кэша на хост-компьютере Windows он будет периодически записывать файлы журнала в каталог установки (C:\mccwsl01\ по умолчанию).

Вы можете увидеть следующие типы файлов журналов:

  1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript. Этот файл журнала записывает выходные данные запланированной задачи "MCC_Monitor_Task", которая отвечает за продолжение работы подключенного кэша.
  2. WSL_Mcc_UserUninstall_Transcript. Этот файл журнала записывает выходные данные сценария "uninstallmcconwsl.ps1", который пользователь может запустить для удаления программного обеспечения MCC с хост-компьютера.
  3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript. Этот файл журнала записывает выходные данные запланированной задачи "MCC_Uninstall_Task", которая отвечает за удаление программного обеспечения MCC с главного компьютера при вызове скриптом "uninstallmcconwsl.ps1".

Не удается установить WSL2 с сообщением "Указанный сеанс входа не существует"

Если вы столкнулись с этим сообщением об ошибке при попытке выполнить команду wsl.exe --install --no-distribution PowerShell на хост-компьютере Windows, убедитесь, что вы вошли в систему от имени локального администратора и выполнили команду в окне PowerShell с повышенными привилегиями.

Обновление ядра WSL2

Если установка подключенного кэша завершается сбоем из-за проблем, связанных с WSL, попробуйте запустить wsl.exe --update , чтобы получить последнюю версию ядра WSL.

Проверка того, запущен ли контейнер подключенного кэша

После успешного развертывания программного обеспечения подключенного кэша на хост-компьютере Windows можно проверка, правильно ли работает узел кэша, выполнив следующие действия на хост-компьютере Windows:

  1. Запуск процесса PowerShell в качестве учетной записи, указанной в качестве учетной записи среды выполнения во время установки подключенного кэша.
  2. Запустите wsl -d Ubuntu-22.04-Mcc-Base для доступа к дистрибутиву Linux, в котором размещен контейнер подключенного кэша.
  3. Запускsudo iotedge list, чтобы показать, какие контейнеры выполняются в среде выполнения IoT Edge.

Если в нем отображаются контейнеры edgeAgent и edgeHub, но не отображается MCC, можно просмотреть состояние IoT Edge диспетчера безопасности с помощью sudo iotedge system logs -- -f.

Вы также можете перезагрузить среду выполнения IoT Edge с помощью sudo systemctl restart iotedge.

Проверка запланированных задач подключенного кэша

После запуска контейнера Подключенного кэша запланированная задача периодически выполняется в учетной записи среды выполнения подключенного кэша, чтобы не допустил WSL очистки контейнера подключенного кэша.

Планировщик задач можно использовать на хост-компьютере, чтобы проверка состояние этой запланированной задачи.

  1. Открытие планировщика задач на хост-компьютере
  2. Перейдите в раздел Активные задачи и дважды щелкните MCC_Monitor_Task
  3. Выберите MCC_Monitor_Task запланированной задачи
  4. Перейдите на вкладку Триггеры и убедитесь, что состояние включено.

Примечание.

Если пароль учетной записи среды выполнения меняется, необходимо обновить пользователя во всех запланированных задачах подключенного кэша, чтобы узел Подключенный кэш продолжал правильно работать.

Узел кэша успешно развернут, но не обслуживает запросы

Если узел кэша не отвечает на запросы за пределами localhost, это может быть связано с тем, что правила переадресации портов на хост-компьютере неправильно заданы во время установки подключенного кэша. Так как WSL 2 по умолчанию использует виртуализированный адаптер Ethernet, правила переадресации портов необходимы, чтобы трафик достигал экземпляра WSL 2 из локальной сети. Дополнительные сведения см. в статье Доступ к сетевым приложениям с помощью WSL.

Чтобы проверка правила переадресации портов на хост-компьютере, используйте следующую команду PowerShell.

netsh interface portproxy show v4tov4

Если правила переадресации портов для порта 80 на 0.0.0.0 не отображаются, можно выполнить следующую команду из экземпляра PowerShell с повышенными привилегиями, чтобы задать правильную пересылку в WSL.

netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL IP Address>

IP-адрес WSL можно получить из wslip.txt файла, который должен присутствовать в каталоге установки, указанном в команде подготовки подключенного кэша (по умолчанию "c:\mccwsl01").

Устранение неполадок с развертыванием узла кэша на хост-компьютере Linux

Развертывание узла подключенного кэша на хост-компьютере Linux включает выполнение ряда скриптов Bash, содержащихся в пакете подготовки Linux.

После успешного развертывания программного обеспечения подключенного кэша на хост-компьютере Linux можно проверка, правильно ли работает узел кэша, выполнив следующие действия на хост-компьютере Linux:

  1. Запускsudo iotedge list, чтобы показать, какие контейнеры выполняются в среде выполнения IoT Edge.

Если в нем отображаются контейнеры edgeAgent и edgeHub, но не отображается MCC, можно просмотреть состояние IoT Edge диспетчера безопасности с помощью sudo iotedge system logs -- -f.

Вы также можете перезагрузить среду выполнения IoT Edge с помощью sudo systemctl restart iotedge.

Создание пакета поддержки диагностики узла кэша

Вы можете создать пакет поддержки с подробными диагностическими сведениями, выполнив скрипт, collectMccDiagnostics.sh включенный в пакет установки.

Для ведущих компьютеров Windows необходимо выполнить следующие действия.

  1. Запуск процесса PowerShell в качестве учетной записи, указанной в качестве учетной записи среды выполнения во время установки подключенного кэша.

  2. Измените каталог на каталог "MccScripts" в извлеченном пакете подготовки подключенного кэша и проверьте наличие collectmccdiagnostics.sh

  3. Запуск wsl bash collectmccdiagnostics.sh для создания пакета поддержки диагностики

  4. После завершения скрипта обратите внимание на выходные данные консоли, описывающие расположение пакета поддержки диагностики.

    Например, "Успешно zippped package, please send file created at /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

  5. Выполните команду , wsl cp чтобы скопировать пакет поддержки из расположения в дистрибутиве Ubuntu в ос узла Windows.

    Например wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Для хост-компьютеров Linux необходимо выполнить следующие действия.

  1. Измените каталог на каталог "MccScripts" в извлеченном пакете подготовки подключенного кэша и проверьте наличие collectmccdiagnostics.sh

  2. Запуск collectmccdiagnostics.sh для создания пакета поддержки диагностики

  3. После завершения скрипта обратите внимание на выходные данные консоли, описывающие расположение пакета поддержки диагностики.

    Например, "Успешно zippped package, please send file created at /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

Устранение неполадок с мониторингом узла кэша

Состояние и производительность узла подключенного кэша можно отслеживать с помощью пользовательского интерфейса портал Azure.

Если в основных визуальных элементах мониторинга на вкладке Обзор отображаются непредвиденные или ошибочные значения, обновите окно браузера.

Если проблема не исчезнет, проверка, что вы настроили фильтры узлов области времени и кэша.

Диагностика и решение

Вы также можете использовать функции диагностики и решения проблем, предоставляемые интерфейсом портал Azure. На этой вкладке в ресурсе Microsoft Connected Cache Azure вы запустите несколько запросов, которые помогут сузить решение проблемы.