Corrigir problemas no Windows Admin Center

Se você acabou de criar uma nova conta do Azure e ainda não entrou na conta em seu computador de gateway, poderá ter problemas ao registrar seu gateway de Windows Admin Center no Azure.

Para atenuar esse problema, entre em sua conta do Azure em outra guia ou janela do navegador e registre o gateway de Windows Admin Center com o Azure.

Ao implantar Serviço de Kubernetes do Azure no Azure Stack HCI por meio de Windows Admin Center, somente o usuário que configurou o host do AKS pode criar clusters do Kubernetes.

Para contornar esse problema, copie a pasta wssd do perfil do usuário que configurou o host do AKS para o perfil do usuário que criará os novos clusters do Kubernetes.

Você está enfrentando problemas de implantação ou deseja redefinir sua implantação.

Feche todas as instâncias de Windows Admin Center conectadas a Serviço de Kubernetes do Azure no Azure Stack HCI antes de executar Uninstall-AksHci de uma janela administrativa do PowerShell.

Você pode receber um erro em qualquer um dos assistentes sobre uma configuração errada.

Executar operações de limpeza de cluster. Essas operações podem envolver a remoção do arquivo C:\Program Files\AksHci\mocctl.exe .

Há inconsistências em nomes de campo de rede que aparecem no fluxo de implantação do cluster de host e no fluxo de implantação do cluster de carga de trabalho.

N/D

Você receberá esse erro se tiver desabilitado pop-ups. O Google Chrome bloqueia pop-ups por padrão e, portanto, o pop-up de entrada do Azure é bloqueado e causa o erro da entidade de serviço.

Habilitar pop-ups.

Ao alternar de DHCP para IP estático, Windows Admin Center exibiu um erro que dizia que o cliente WinRM não pode processar a solicitação. Esse erro também ocorreu fora do Windows Admin Center. O WinRM foi quebrado quando endereços IP estáticos foram usados e os servidores não estavam registrando um SPN (Nome da Entidade de Serviço) ao migrar para endereços IP estáticos.

Para resolve esse problema, use o comando SetSPN para criar o SPN. Em um prompt de comando no gateway de Windows Admin Center, execute o seguinte comando:

Setspn /Q WSMAN/<FQDN on the Azure Stack HCI Server> 

Em seguida, se qualquer um dos servidores no ambiente retornar a mensagem No Such SPN Found, faça logon nesse servidor e execute os seguintes comandos:

Setspn /S WSMAN/<server name> <server name> 
Setspn /S WSMAN/<FQDN of server> <server name> 

Por fim, no gateway de Windows Admin Center, execute o seguinte para garantir que ele obtenha novas informações de servidor do controlador de domínio:

Klist purge 

Se você receber uma mensagem de notificação de atualização incorreta "Versão nula do módulo do AksHci PowerShell instalada com êxito", a operação de atualização será bem-sucedida mesmo que a notificação seja enganosa.

Você pode ignorar essa mensagem com segurança.

Na Fase 2.1: Componente de Etapa Básica, você pode encontrar este erro: "Falha ao conectar-se ao servidor remoto *** com a seguinte mensagem de erro: o acesso foi negado. Para obter mais informações, consulte o tópico about_Remote_Troubleshooting Ajuda" ao tentar usar suas credenciais para seus nós de servidor.

Verifique se a conta/credenciais adicionadas é uma conta administrativa no computador. Em seguida, verifique se o PSRemoting está habilitado e se os hosts remotos são confiáveis. Você pode fazer isso com os seguintes comandos do PowerShell:

Enable-PSRemoting -Force 
winrm quickconfig 

Se você ainda estiver encontrando problemas, consulte este guia de solução de problemas.

Windows Admin Center atualmente não tem um processo para desligar um cluster do Azure Arc.

Para excluir agentes do Arc em um cluster que foi destruído, navegue até o grupo de recursos do cluster no portal do Azure e exclua manualmente o conteúdo do Arc. Para excluir agentes do Arc em um cluster que ainda está em execução, execute o seguinte comando:

az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest

Após uma atualização bem-sucedida, a atualização Windows Admin Center dashboard ainda mostra a versão anterior.

Atualize o navegador para corrigir esse problema.

Quando você implanta o AKS Arc usando Windows Admin Center e a implantação trava por um longo período, você pode estar tendo o CredSSP (Provedor de Suporte de Segurança de Credencial) ou problemas de conectividade.

Experimente as seguintes etapas para solucionar problemas de implantação:

1. No computador que executa Windows Admin Center, execute o seguinte comando em uma janela do PowerShell:

      Enter-PSSession <servername>
   

2. Se esse comando for bem-sucedido, você poderá se conectar ao servidor e não haverá nenhum problema de conectividade.

3. Se você estiver tendo problemas de CredSSP, execute este comando para testar a confiança entre o computador de gateway e o computador de destino:

      Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
   

   Você também pode executar o seguinte comando para testar a confiança no acesso ao gateway local:

      Enter-PSSession -computer localhost -credential (Get-Credential)
   

Para obter dicas adicionais de solução de problemas do CredSSP, consulte Solucionar problemas de CredSSP.

Às vezes, devido a problemas de rede, Windows Admin Center atinge o tempo limite durante uma conexão do Arc.

Use o comando do PowerShell Enable-AksHciArcConnection para conectar o cluster de carga de trabalho do AKS ao Azure Arc enquanto trabalhamos ativamente para melhorar a experiência do usuário.

Na fase 2.1: Validação do sistema, você pode receber um erro: "O item 'Install-Module' não foi reconhecido como o nome de um cmdlet, função, arquivo de script ou programa executável".

Verifique a ortografia do nome. Se o caminho estiver incluído, verifique se o caminho está correto. Em seguida, tente novamente ao instalar. Conclua os comandos do PowerShell nos nós nos quais você está tentando implantar. Execute o seguinte comando para resolve o problema (verifique se a versão do PowerShell é pelo menos 5.1):

Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck

Em seguida, execute estes comandos se encontrar erros do primeiro comando:

Get-PSRepository
Register-PSRepository -Default

Não é possível conectar Windows Admin Center ao Azure porque você não pode criar e usar automaticamente uma ID de Azure App no gateway.

Crie uma ID de Azure App e atribua as permissões corretas no portal. Em seguida, selecione Usar existente no gateway. Para obter mais informações, visite conectando seu gateway ao Azure.

Se você tiver clusters de carga de trabalho com o Kubernetes versão 1.19.9 instalado e usar Windows Admin Center para atualizá-los para o Kubernetes versão 1.19.11, a página de atualização do Kubernetes continuará mostrando que a atualização ainda está em processo. No entanto, se você executar Get-AksHciCluster, a saída mostrará que a atualização foi concluída e, se você abrir Windows Admin Center em uma nova guia, o cluster será atualizado para 1.19.11 na lista de clusters do Kubernetes.

Você pode ignorar esse problema conforme o processo de atualização foi concluído.

Quando você relata problemas com Windows Admin Center, é uma boa ideia anexar logs para ajudar a equipe de desenvolvimento a diagnosticar seu problema. Os erros em Windows Admin Center geralmente vêm em uma das duas formas:

• Eventos que aparecem no visualizador de eventos no computador executando Windows Admin Center
• Problemas do JavaScript que surgem no console do navegador

Para coletar logs para Windows Admin Center, use o Get-SMEUILogs.ps1 script fornecido no pacote de visualização pública.

Para usar o script, execute este comando na pasta em que o script está armazenado:

./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt

O comando tem os seguintes parâmetros:

• -ComputerNames: uma lista de computadores dos quais você deseja coletar logs.
• -Destination: o computador ao qual você deseja agregar os logs.
• -HoursAgo: a hora de início da coleta de logs, expressa em horas antes da hora em que você executa o script.
• -NoCredentialPrompt: um comutador para desativar o prompt de credenciais e usar as credenciais padrão em seu ambiente atual.

Se você tiver dificuldades para executar esse script, poderá executar o seguinte comando para exibir o texto da Ajuda:

GetHelp .\Get-SMEUILogs.ps1 -Examples

Ao executar uma atualização no Windows Admin Center, ocorreu o seguinte erro:

Error occurred while fetching platform upgrade information. RemoteException: No match was found for the specified search criteria and module name 'AksHci'. Try Get-PSRepository to see all available registered module repositories.

Essa mensagem de erro normalmente ocorre quando o AKS no Azure Stack HCI é implantado em um ambiente que tem um proxy configurado. Atualmente, Windows Admin Center não tem suporte para instalar módulos em um ambiente de proxy.

Para resolve esse erro, configure o AKS no Azure Stack HCI usando o comando proxy do PowerShell.

A implantação do cluster de host do AKS falha em verificações do sistema com um erro de serviço WinRM.

Tente aplicar as soluções sugeridas na solução de problemas manual.

Se você tiver várias versões dos módulos do PowerShell instaladas (por exemplo, 0.2.26, 0.2.27 e 0.2.28), Windows Admin Center poderá não usar a versão mais recente (ou a necessária).

Verifique se você tem apenas um módulo do PowerShell instalado. Você deve desinstalar todas as versões do PowerShell não utilizados dos módulos do PowerShell e deixar apenas uma instalada. Mais informações sobre qual versão Windows Admin Center é compatível com qual versão do PowerShell pode ser encontrada nas notas de versão do AKS no Azure Stack HCI.

Esse erro aparece ao implantar por meio de Windows Admin Center. O provedor de pacotes requer as PackageManagement marcas e Provider . Você deve marcar se o pacote especificado tiver um erro de marca ao tentar uma implantação por meio de Windows Admin Center.

Esse erro vem do PowerShell e afirma que há problemas de conectividade com a Internet. O PowerShell está tentando instalar o pacote de pré-requisitos e não consegue instalá-lo.

Verifique se o servidor ou cluster de failover tem conectividade com a Internet e inicie uma nova instalação.

No Estágio 2.1: Validação do Sistema, pode haver um erro quando você atinge a instalação: No match was found for the specified search criteria for the provider 'NuGet'. The package provider requires 'PackageManagement' and 'Provider' tags. Please check if the specified package has the tags. conclua os comandos do PowerShell nos nós nos quais você está tentando implantar. Você precisará instalar manualmente o NuGet usando o seguinte comando do PowerShell:

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

Depois de executar esse comando, feche todas as janelas do PowerShell abertas e tente novamente no Windows Admin Center.

Na fase 2.1: Validação do sistema, você pode encontrar este erro: 'Não é possível localizar o repositório 'PSGallery'.

Use Get-PSRepository para ver todos os repositórios disponíveis.' ao clicar em instalar. Conclua os comandos do PowerShell nos nós nos quais você está tentando implantar. Cancele o registro e registre novamente o PSRepository em uma janela administrativa do PowerShell. Feche todas as janelas do PowerShell posteriormente.

Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default

Em seguida, desinstale e reinstale o PowerShellGet em uma janela administrativa do PowerShell. Feche todas as janelas do PowerShell posteriormente.

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

Depois disso, volte para Windows Admin Center e tente novamente.

Se você instalar Windows Admin Center com uma conta e tentar usá-la com outra, receberá erros.

Para que o CredSSP funcione com êxito no assistente de Criação de Cluster, Windows Admin Center deve ser instalado e usado pela mesma conta.

Esse erro aparece ao mover do PowerShell para o Windows Admin Center para criar um cluster de carga de trabalho habilitado para Arc.

Você pode ignorar com segurança esse erro. Ele faz parte da etapa de validação e o cluster já foi criado.

Reiniciar os nós de cluster do Azure Stack HCI que hospedam o cluster de gerenciamento e os clusters de carga de trabalho pode fazer com que os clusters de carga de trabalho desapareçam do Windows Admin Center dashboard.

Para contornar esse problema, pause e escorra os nós antes de planejar reiniciá-los. Às vezes, os clusters de carga de trabalho podem demorar mais para aparecer no dashboard.

Windows Admin Center não implantará Serviço de Kubernetes do Azure em um ambiente com clusters de computação e armazenamento separados, pois espera que os recursos de computação e armazenamento sejam fornecidos pelo mesmo cluster. Na maioria dos casos, ele não encontrará CSVs expostos pelo cluster de computação e se recusará a continuar com a implantação.

Próximas etapas

• Visão geral de solução de problemas
• Problemas e erros de instalação
• Atualizar problemas conhecidos

Se você continuar tendo problemas ao usar o AKS Arc, poderá arquivar bugs por meio do GitHub.