Resolver problemas da Cache Ligada da Microsoft para Empresas e Educação

• Aplica-se a:

  ✅ Windows 11, ✅ Supported Linux distributions, ✅ Microsoft Connected Cache for Enterprise

Este artigo contém instruções sobre como resolver problemas diferentes que possa encontrar ao utilizar a Cache Ligada. Estes problemas são categorizados pela tarefa na qual podem ser encontrados.

Problemas conhecidos

Esta secção descreve problemas conhecidos com a versão mais recente da Cache Ligada da Microsoft para Empresas e Educação. Consulte a página Notas de Versão para obter mais detalhes sobre as correções incluídas na versão mais recente.

O gráfico de monitorização de nós de cache na interface de utilizador portal do Azure apresenta informações incorretas

O script provisionmcconwsl.ps1 falha quando executado num computador anfitrião Windows 11 configurado para utilizar o idioma japonês

No script de instalação da Cache Ligada (provisionmcconwsl.ps1), o processamento de marcar é executado até que o valor do último código de execução (Último Resultado) da tarefa de instalação se torne 0 no processamento seguinte. No entanto, no SO japonês, o valor devolvido é nulo porque é apresentado "Último Resultado" e ocorre uma exceção.

Como solução temporária, o erro acima não ocorre ao alterar a definição de idioma do utilizador administrador local de japonês para inglês e, em seguida, ao executar o script.

Passos para obter um ID de subscrição do Azure

1. Inicie sessão no portal do Azure.
2. Selecione Subscrições. Se não vir Subscrições, escreva Subscrições na barra de pesquisa. À medida que começa a escrever, a lista filtra com base na sua entrada.
3. Se já tiver uma Subscrição do Azure, avance para o passo 5. Se não tiver uma Subscrição do Azure, selecione + Adicionar no canto superior esquerdo.
4. Selecione a subscrição Pay As You Go . Ser-lhe-á pedido para introduzir informações de card de crédito, mas não lhe será cobrada a utilização do serviço Cache Ligada da Microsoft.
5. Na página Subscrições , encontrará detalhes sobre a sua subscrição atual. Selecione o nome da subscrição.
6. Depois de selecionar o nome da subscrição, encontrará o ID da subscrição no separador Descrição geral . Selecione o ícone Copiar para a área de transferência junto ao ID da Subscrição para copiar o valor.

Resolver problemas de criação de recursos do Azure

A criação de recursos do Azure de Cache Ligada pode ser iniciada através da interface de utilizador portal do Azure ou do conjunto de comandos da CLI do Azure.

Se encontrar um erro durante a criação de recursos, marcar que tem as permissões necessárias para criar recursos do Azure na sua subscrição e preencheu todos os campos necessários durante o processo de criação de recursos.

Resolução de problemas de configuração do nó de cache

A configuração do nó cache ligada pode ser feita com a interface de utilizador portal do Azure ou o conjunto de comandos da CLI do Azure.

Se encontrar um erro de validação, marcar que preencheu todos os campos de configuração necessários.

Se a configuração não parecer estar a entrar em vigor, marcar que selecionou a opção Guardar na parte superior da página de configuração no portal do Azure interface de utilizador.

Se tiver alterado a configuração do proxy, terá de aprovisionar novamente o software de Cache Ligada no computador anfitrião para que a configuração do proxy entre em vigor.

Resolução de problemas de nós de cache criados durante a pré-visualização antecipada

Os nós de cache criados e implementados durante a pré-visualização antecipada da Cache Ligada da Microsoft para Empresas e Educação devem continuar a funcionar, mas já não podem ser geridos ou monitorizados remotamente através do serviço Azure de Cache Ligada.

Como tal, recomendamos vivamente que recrie os recursos existentes no Azure e, em seguida, reimplemente o software de Cache Ligada nos computadores anfitriões com o instalador específico do SO mais recente.

Resolver problemas de implementação do nó de cache no computador anfitrião do Windows

Recolher registos de instalação alojados no Windows

A implementação de um nó de Cache Ligada num computador anfitrião do Windows envolve a execução de uma série de scripts do PowerShell contidos no pacote de aprovisionamento do Windows. Estes scripts tentam escrever ficheiros de registo no diretório de instalação especificado no comando de aprovisionamento (C:\mccwsl01\InstallLogs por predefinição).

Existem três tipos de ficheiros de registo de instalação:

1. WSL_Mcc_Install_Transcript: este ficheiro de registo regista as linhas impressas na janela do PowerShell ao executar o script de instalação
2. WSL_Mcc_Install_FromRegisteredTask_Status: este ficheiro de registo regista a status de alto nível que é escrita durante a instalação das tarefas registadas
3. WSL_Mcc_Install_FromRegisteredTask_Transcript: este ficheiro de registo regista os status detalhados escritos durante a instalação das tarefas registadas

A Transcrição de Tarefas Registadas é normalmente a mais útil para diagnosticar o problema de instalação.

Recolher outros registos alojados no Windows

Assim que o nó de cache tiver sido instalado com êxito no computador anfitrião do Windows, irá escrever periodicamente ficheiros de registo no diretório de instalação (C:\mccwsl01\ por predefinição).

Pode esperar ver os seguintes tipos de ficheiros de registo:

1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: este ficheiro de registo regista a saída da tarefa agendada "MCC_Monitor_Task" que é responsável por garantir que a Cache Ligada continua em execução.
2. WSL_Mcc_UserUninstall_Transcript: este ficheiro de registo regista a saída do script "uninstallmcconwsl.ps1" que o utilizador pode executar para desinstalar o software MCC do computador anfitrião.
3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: este ficheiro de registo regista a saída da tarefa agendada "MCC_Uninstall_Task" responsável pela desinstalação do software MCC do computador anfitrião quando chamado pelo script "uninstallmcconwsl.ps1".

Falha na instalação do WSL2 com a mensagem "Não existe uma sessão de início de sessão especificada"

Se estiver a encontrar esta mensagem de falha ao tentar executar o comando wsl.exe --install --no-distribution do PowerShell no seu computador anfitrião Windows, verifique se tem sessão iniciada como administrador local e execute o comando a partir de uma janela elevada do PowerShell.

Atualizar o kernel WSL2

Se a instalação da Cache Ligada estiver a falhar devido a problemas relacionados com o WSL, tente executar wsl.exe --update para obter a versão mais recente do kernel do WSL.

Verificar se o contentor da Cache Ligada está em execução

Depois de o software de Cache Ligada ter sido implementado com êxito no computador anfitrião do Windows, pode marcar se o nó de cache estiver a ser executado corretamente ao fazer o seguinte no computador anfitrião do Windows:

1. Iniciar um processo do PowerShell como a conta especificada como a conta de runtime durante a instalação da Cache Ligada
2. Execute wsl -d Ubuntu-22.04-Mcc-Base para aceder à distribuição do Linux que aloja o contentor de Cache Ligada
3. Execute sudo iotedge list para mostrar que contentores estão em execução no runtime do IoT Edge

Se mostrar os contentores edgeAgent e edgeHub, mas não mostrar o MCC, pode ver a status do gestor de segurança do IoT Edge com sudo iotedge system logs -- -f.

Também pode reiniciar o runtime IoT Edge com sudo systemctl restart iotedge.

Verificar as tarefas agendadas da Cache Ligada

Assim que o contentor da Cache Ligada estiver em execução, é executada periodicamente uma tarefa agendada na conta de runtime da Cache Ligada para impedir que o WSL limpe o contentor da Cache Ligada.

Pode utilizar o Programador de Tarefas no computador anfitrião para marcar a status desta tarefa agendada.

1. Abrir o Programador de Tarefas no computador anfitrião
2. Navegue para a secção Tarefas Ativas e faça duplo clique no MCC_Monitor_Task
3. Selecione a tarefa agendada MCC_Monitor_Task
4. Selecione o separador Acionadores e confirme que o Estado está Ativado

Observação

Se a palavra-passe da conta de runtime for alterada, terá de atualizar o utilizador em todas as tarefas agendadas da Cache Ligada para que o nó cache ligada continue a funcionar corretamente.

Nó de cache implementado com êxito, mas não a servir pedidos

Se o nó de cache não estiver a responder a pedidos fora do localhost, poderá dever-se ao facto de as regras de reencaminhamento de portas do computador anfitrião não terem sido definidas corretamente durante a instalação da Cache Ligada.

Para marcar as regras de reencaminhamento de portas do computador anfitrião, utilize o seguinte comando do PowerShell.

netsh interface portproxy show v4tov4

Se não vir nenhuma regra de reencaminhamento de portas para a porta 80 a 0.0.0.0, pode executar o seguinte comando a partir de uma instância elevada do PowerShell para definir o reencaminhamento adequado para o WSL.

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

Pode obter o Endereço IP WSL do wslip.txt ficheiro que deve estar presente no diretório de instalação que especificou no comando de aprovisionamento da Cache Ligada ("c:\mccwsl01" por predefinição).

Resolver problemas de implementação de nós de cache no computador anfitrião do Linux

A implementação de um nó de Cache Ligada num computador anfitrião Linux envolve a execução de uma série de scripts Bash contidos no pacote de aprovisionamento do Linux.

Depois de o software de Cache Ligada ter sido implementado com êxito no computador anfitrião do Linux, pode marcar se o nó de cache estiver a ser executado corretamente ao fazer o seguinte no computador anfitrião Linux:

1. Execute sudo iotedge list para mostrar que contentores estão em execução no runtime do IoT Edge

Se mostrar os contentores edgeAgent e edgeHub, mas não mostrar o MCC, pode ver a status do gestor de segurança do IoT Edge com sudo iotedge system logs -- -f.

Também pode reiniciar o runtime IoT Edge com sudo systemctl restart iotedge.

A gerar o pacote de suporte de diagnóstico do nó de cache

Pode gerar um pacote de suporte com informações de diagnóstico detalhadas ao executar o collectMccDiagnostics.sh script incluído no pacote de instalação.

Para máquinas anfitriãs do Windows, terá de fazer o seguinte:

1. Iniciar um processo do PowerShell como a conta especificada como a conta de runtime durante a instalação da Cache Ligada

2. Altere o diretório para o diretório "MccScripts" no pacote de aprovisionamento da Cache Ligada extraído e verifique a presença de collectmccdiagnostics.sh

3. Executar wsl bash collectmccdiagnostics.sh para gerar o pacote de suporte de diagnóstico

4. Assim que o script estiver concluído, tenha em atenção a saída da consola que descreve a localização do pacote de suporte de diagnóstico

   Por exemplo, "Pacote zipado com êxito, envie o ficheiro criado em /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

5. Execute o wsl cp comando para copiar o pacote de suporte da localização na distribuição do Ubuntu para o SO anfitrião do Windows

   Por exemplo wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Para máquinas anfitriãs do Linux, terá de fazer o seguinte:

1. Altere o diretório para o diretório "MccScripts" no pacote de aprovisionamento da Cache Ligada extraído e verifique a presença de collectmccdiagnostics.sh

2. Executar collectmccdiagnostics.sh para gerar o pacote de suporte de diagnóstico

3. Assim que o script estiver concluído, tenha em atenção a saída da consola que descreve a localização do pacote de suporte de diagnóstico

   Por exemplo, "Pacote zipado com êxito, envie o ficheiro criado em /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz"

Resolução de problemas de monitorização de nós de cache

O status de nó de Cache Ligada e o desempenho podem ser monitorizados com a interface de utilizador portal do Azure.

Se os elementos visuais de monitorização básicos no separador Descrição geral estiverem a mostrar valores inesperados ou erróneos, atualize a janela do browser.

Se o problema persistir, marcar que configurou os filtros do nó Período de Tempo e Cache conforme pretendido.

Diagnosticar e Resolver

Também pode utilizar a funcionalidade Diagnosticar e resolver problemas fornecida pela interface de portal do Azure. Este separador no recurso do Azure da Cache Ligada da Microsoft orienta-o através de alguns pedidos para ajudar a restringir a solução ao seu problema.