Risolvere i problemi in Windows Admin Center

Questo articolo descrive i problemi noti relativi all'Windows Admin Center per L'arco del servizio Azure Kubernetes. È anche possibile esaminare i problemi di aggiornamento e installazione e gli errori.

Problemi durante la registrazione del gateway di Windows Admin Center con Azure

Se è stato appena creato un nuovo account Azure e non è stato eseguito l'accesso all'account nel computer gateway, è possibile che si verifichino problemi con la registrazione del gateway Windows Admin Center con Azure.

Per attenuare questo problema, accedere all'account Azure in un'altra scheda o finestra del browser e quindi registrare il gateway Windows Admin Center con Azure.

Solo l'utente che ha configurato l'host del servizio Azure Kubernetes può creare cluster

Quando si distribuiscono servizio Azure Kubernetes in Azure Stack HCI tramite Windows Admin Center, solo l'utente che ha configurato l'host del servizio Azure Kubernetes può creare cluster Kubernetes.

Per risolvere questo problema, copiare la cartella wssd dal profilo dell'utente che ha configurato l'host del servizio Azure Kubernetes al profilo dell'utente che creerà i nuovi cluster Kubernetes.

Ripristino da un servizio Azure Kubernetes non riuscito nella distribuzione di Azure Stack HCI

Si verificano problemi di distribuzione o si desidera reimpostare la distribuzione.

Chiudere tutte le istanze di Windows Admin Center connesse a servizio Azure Kubernetes in Azure Stack HCI prima di eseguire Disinstalla-AksHci da una finestra amministrativa di PowerShell.

La procedura guidata Configurazione o Creazione cluster visualizza un errore relativo a una configurazione errata

È possibile che venga visualizzato un errore in una procedura guidata relativa a una configurazione errata.

Eseguire operazioni di pulizia del cluster. Queste operazioni potrebbero comportare la rimozione del file C:\Program Files\AksHci\mocctl.exe .

I nomi dei campi di rete non sono coerenti in Windows Admin Center

Esistono incoerenze nei nomi dei campi di rete visualizzati nel flusso di distribuzione del cluster host e nel flusso di distribuzione del cluster del carico di lavoro.

N/D

In Windows Admin Center viene visualizzato il messaggio "errore durante la creazione dell'entità servizio" durante l'installazione di un host del servizio Azure Kubernetes in Azure Stack HCI

Verrà visualizzato questo errore se si dispone di popup disabilitati. Google Chrome blocca i popup per impostazione predefinita e quindi il popup di accesso di Azure viene bloccato e causa l'errore dell'entità servizio.

Abilitare i popup.

Viene visualizzato un errore WinRM durante la creazione di un nuovo cluster del carico di lavoro

Quando si passa da DHCP a IP statico, Windows Admin Center visualizzato un errore che indica che il client WinRM non può elaborare la richiesta. Questo errore si è verificato anche all'esterno di Windows Admin Center. WinRM si è interrotta quando sono stati usati indirizzi IP statici e i server non registravano un nome dell'entità servizio (SPN) quando si passa agli indirizzi IP statici.

Per risolvere questo problema, usare il comando SetSPN per creare il nome SPN. Da un prompt dei comandi nel gateway Windows Admin Center eseguire il comando seguente:

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

Successivamente, se uno dei server nell'ambiente restituisce il messaggio No Such SPN Found, quindi accedere a tale server ed eseguire i comandi seguenti:

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

Infine, nel gateway Windows Admin Center eseguire quanto segue per assicurarsi di ottenere nuove informazioni sul server dal controller di dominio:

Klist purge 

Notifica di aggiornamento non corretta in Windows Admin Center

Se viene visualizzato un messaggio di notifica di aggiornamento errato "È stato installato correttamente AksHci PowerShell module null", l'operazione di aggiornamento ha esito positivo anche se la notifica è fuorviante.

Il dashboard di aggiornamento WAC non viene aggiornato dopo l'esito positivo degli aggiornamenti.

È possibile ignorare in modo sicuro questo messaggio.

Accesso negato

Nella fase 2.1: Componente passaggio di base, è possibile che si verifichi questo errore: "Connessione al server remoto ** non riuscita con il messaggio di errore seguente: l'accesso viene negato. Per altre informazioni, vedere l'argomento della Guida about_Remote_Troubleshooting" quando si tenta di usare le credenziali per i nodi del server.

Assicurarsi che l'account o le credenziali aggiunte sia un account amministrativo nel computer. Verificare quindi che PSRemoting sia abilitato e gli host remoti siano attendibili. È possibile eseguire questa operazione con i comandi di PowerShell seguenti:

Enable-PSRemoting -Force 
winrm quickconfig 

Se si verificano ancora problemi, vedere questa guida alla risoluzione dei problemi.

Windows Admin Center non ha un'esperienza di off-boarding Arc

Windows Admin Center attualmente non dispone di un processo per l'off-board di un cluster da Azure Arc.

Per eliminare gli agenti Arc in un cluster eliminato, passare al gruppo di risorse del cluster nella portale di Azure e eliminare manualmente il contenuto Arc. Per eliminare gli agenti Arc in un cluster ancora in esecuzione e in esecuzione, è necessario eseguire il comando seguente:

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

Nota

Se si usa la portale di Azure per eliminare la risorsa Kubernetes abilitata per Arc, rimuove tutte le risorse di configurazione associate, ma non rimuove gli agenti in esecuzione nel cluster. La procedura consigliata consiste nell'eliminare la risorsa Kubernetes usando az connectedk8s delete anziché la portale di Azure.

Windows Admin Center dashboard di aggiornamento non viene aggiornato dopo l'esito positivo degli aggiornamenti

Dopo un aggiornamento riuscito, il dashboard di aggiornamento Windows Admin Center mostra ancora la versione precedente. Nomi di campi di rete incoerenti nel portale WAC.

Aggiornare il browser per risolvere questo problema.

Risolvere i problemi di CredSSP

Quando si distribuisce AKS Arc usando Windows Admin Center e la distribuzione si blocca per un periodo esteso, potrebbe verificarsi un provider di supporto per la sicurezza delle credenziali (CredSSP) o problemi di connettività.

Provare i passaggi seguenti per risolvere i problemi di distribuzione:

  1. Nel computer che esegue Windows Admin Center eseguire il comando seguente in una finestra di PowerShell:

       Enter-PSSession <servername>
    
  2. Se questo comando ha esito positivo, è possibile connettersi al server e non esiste alcun problema di connettività.

  3. Se si verificano problemi di CredSSP, eseguire questo comando per testare l'attendibilità tra il computer gateway e il computer di destinazione:

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

    È anche possibile eseguire il comando seguente per testare l'attendibilità nell'accesso al gateway locale:

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

Per altri suggerimenti per la risoluzione dei problemi di CredSSP, vedere Risolvere i problemi di CredSSP.

Viene visualizzato un errore di timeout quando si tenta di connettere un cluster del carico di lavoro del servizio Azure Kubernetes ad Azure Arc tramite Windows Admin Center

A volte, a causa di problemi di rete, Windows Admin Center timeout durante una connessione Arc.

Usare il comando PowerShell Enable-AksHciArcConnection per connettere il cluster del carico di lavoro del servizio Azure Kubernetes ad Azure Arc mentre si lavora attivamente per migliorare l'esperienza utente.

'Install-Module' non è stato riconosciuto

Nella fase 2.1: Convalida del sistema potrebbe verificarsi un errore: "L'elemento 'Install-Module' non è stato riconosciuto come nome di un cmdlet, di una funzione, di un file di script o di un programma runnable".

Controllare l'ortografia del nome. Se il percorso è incluso, assicurarsi che il percorso sia corretto. Riprovare quindi quando si installa. Completare i comandi di PowerShell nei nodi a cui si sta tentando di eseguire la distribuzione. Eseguire il comando seguente per risolvere il problema (verificare che la versione di PowerShell sia almeno 5.1):

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

Eseguire quindi questi comandi se si verificano errori dal primo comando:

Get-PSRepository
Register-PSRepository -Default

Impossibile connettersi Windows Admin Center ad Azure durante la creazione di un nuovo ID di app Azure

Impossibile connettersi Windows Admin Center ad Azure perché non è possibile creare e usare automaticamente un ID app Azure nel gateway.

Creare un ID app Azure e assegnargli le autorizzazioni appropriate nel portale. Selezionare quindi Usa esistente nel gateway. Per altre informazioni, visitare la connessione del gateway ad Azure.

Quando si aggiorna la versione di Kubernetes, la pagina di aggiornamento mostra che l'aggiornamento viene ancora elaborato al termine dell'aggiornamento

Se sono installati cluster di carico di lavoro con Kubernetes versione 1.19.9 e quindi usare Windows Admin Center per aggiornarli alla versione 1.19.11 di Kubernetes, la pagina di aggiornamento di Kubernetes continua a mostrare che l'aggiornamento è ancora in corso. Tuttavia, se si esegue Get-AksHciCluster, l'output mostra che l'aggiornamento è stato completato e, se si apre Windows Admin Center in una nuova scheda, il cluster viene aggiornato a 1.19.11 nell'elenco cluster Kubernetes.

È possibile ignorare questo problema durante il completamento del processo di aggiornamento.

Creare log di Windows Admin Center

Quando si segnalano problemi con Windows Admin Center, è consigliabile collegare i log per aiutare il team di sviluppo a diagnosticare il problema. Gli errori in Windows Admin Center in genere vengono inclusi in una delle due forme:

  • Eventi visualizzati nel visualizzatore eventi nel computer che esegue Windows Admin Center
  • Problemi JavaScript che si trovano nella console del browser

Per raccogliere i log per Windows Admin Center, usare lo Get-SMEUILogs.ps1 script fornito nel pacchetto di anteprima pubblica.

Per usare lo script, eseguire questo comando nella cartella in cui viene archiviato lo script:

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

Il comando include i parametri seguenti:

  • -ComputerNames: elenco di computer da cui si desidera raccogliere i log.
  • -Destination: il computer a cui si desidera aggregare i log.
  • -HoursAgo: ora di inizio per la raccolta dei log, espressa in ore prima dell'esecuzione dello script.
  • -NoCredentialPrompt: opzione per disattivare il prompt delle credenziali e usare le credenziali predefinite nell'ambiente corrente.

Se si verificano difficoltà a eseguire questo script, è possibile eseguire il comando seguente per visualizzare il testo della Guida:

GetHelp .\Get-SMEUILogs.ps1 -Examples





L'esecuzione di un aggiornamento genera un errore: 'Errore durante il recupero delle informazioni sull'aggiornamento della piattaforma'

Quando si esegue un aggiornamento in Windows Admin Center, si è verificato l'errore seguente:

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.

Questo messaggio di errore si verifica in genere quando il servizio Azure Kubernetes in Azure Stack HCI viene distribuito in un ambiente con un proxy configurato. Attualmente, Windows Admin Center non dispone del supporto per installare i moduli in un ambiente proxy.

Per risolvere questo errore, configurare il servizio Azure Kubernetes in Azure Stack HCI usando il comando proxy di PowerShell.

Distribuzione: connessione al server locale del server remoto non riuscita

La distribuzione del cluster host del servizio Azure Kubernetes ha esito negativo nei controlli di sistema con un errore del servizio WinRM.

Provare a applicare le soluzioni suggerite nella risoluzione dei problemi manuali.

La connessione al server locale del server remoto non è riuscita.

Quando vengono installate più versioni dei moduli di PowerShell, Windows Admin Center non sceglie la versione più recente

Se sono installate più versioni dei moduli di PowerShell, ad esempio 0.2.26, 0.2.27 e 0.2.28, Windows Admin Center potrebbe non usare la versione più recente (o quella necessaria).

Assicurarsi di avere installato un solo modulo di PowerShell. È necessario disinstallare tutte le versioni di PowerShell inutilizzate dei moduli di PowerShell e lasciare installata una sola. Altre informazioni su quale versione Windows Admin Center è compatibile con la versione di PowerShell disponibile nel servizio Azure Kubernetes nelle note sulla versione di Azure Stack HCI.

Durante la distribuzione viene visualizzato l'errore "Nessuna corrispondenza per i criteri di ricerca specificati per il provider **NuGet**"

Questo errore viene visualizzato durante la distribuzione tramite Windows Admin Center. Il provider di pacchetti richiede i PackageManagement tag e Provider . È necessario verificare se il pacchetto specificato ha un errore di tag durante il tentativo di distribuzione tramite Windows Admin Center.

Questo errore proviene da PowerShell e indica che sono presenti problemi di connettività Internet. PowerShell sta tentando di installare il pacchetto dei prerequisiti e non è in grado di installarlo.

Verificare che il server o il cluster di failover disponga della connettività Internet e quindi avviare una nuova installazione.

Nella fase 2.1: Convalida del sistema potrebbe verificarsi un errore durante l'installazione: 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. Completare i comandi di PowerShell nei nodi a cui si sta tentando di eseguire la distribuzione. Sarà necessario installare manualmente NuGet usando il comando di PowerShell seguente:

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

Dopo aver eseguito questo comando, chiudere tutte le finestre di PowerShell aperte e riprovare in Windows Admin Center.

Impossibile trovare il repository 'PSGallery'

Nella fase 2.1: Convalida del sistema potrebbe verificarsi questo errore: 'Impossibile trovare il repository 'PSGallery'.

Usare Get-PSRepository per visualizzare tutti i repository disponibili. Completare i comandi di PowerShell nei nodi a cui si sta tentando di eseguire la distribuzione. Annullare la registrazione e registrare nuovamente psRepository in una finestra di PowerShell amministrativa. Chiudere tutte le finestre di PowerShell in seguito.

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

Disinstallare e reinstallare PowerShellGet in una finestra di PowerShell amministrativa. Chiudere tutte le finestre di PowerShell in seguito.

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

Dopo questo, tornare a Windows Admin Center e riprovare.

Errore si verifica quando si tenta di usare Windows Admin Center

Se si installa Windows Admin Center con un account e si prova a usarlo con un altro, si otterranno errori.

Affinché CredSSP funzioni correttamente nella Creazione guidata cluster, Windows Admin Center deve essere installato e usato dallo stesso account.

L'errore 'Impossibile indicizzare in una matrice Null' viene visualizzato quando si crea un cluster di carico di lavoro abilitato per Arc

Questo errore viene visualizzato quando si passa da PowerShell a Windows Admin Center per creare un cluster di carico di lavoro abilitato per Arc.

È possibile ignorare questo errore. Fa parte del passaggio di convalida e il cluster è già stato creato.

Il riavvio dei nodi HCI di Azure Stack causa un problema di intervallo

Il riavvio dei nodi del cluster HCI di Azure Stack che ospita il cluster di gestione e i cluster del carico di lavoro possono causare la scomparsa dei cluster del carico di lavoro dal dashboard Windows Admin Center.

Per risolvere questo problema, sospendere e svuotare i nodi prima di pianificare il riavvio. In alcuni casi, i cluster del carico di lavoro potrebbero richiedere più tempo per essere visualizzati nel dashboard.

Distribuzione: connessione al server locale del server remoto non riuscita.

Impossibile distribuire il servizio Azure Kubernetes in un ambiente con cluster di archiviazione e calcolo separati

Windows Admin Center non distribuirà servizio Azure Kubernetes in un ambiente con cluster di archiviazione e calcolo separati perché prevede che le risorse di calcolo e di archiviazione vengano fornite dallo stesso cluster. Nella maggior parte dei casi, non troverà le unità csv esposte dal cluster di calcolo e rifiuterà di continuare con la distribuzione.

Passaggi successivi

Se si continuano a verificarsi problemi quando si usa AKS Arc, è possibile segnalare bug tramite GitHub.