Risolvere i problemi relativi all'interfaccia di amministrazione Windows

Questo articolo descrive i problemi noti relativi a Windows Admin Center per AKS Arc. È anche possibile esaminare i problemi di aggiornamento e installazione e gli errori.

Si sono verificati 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 di 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 di Windows Admin Center con Azure.

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

Quando si distribuisce servizio Azure Kubernetes in Locale di Azure 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 nel profilo dell'utente che creerà i nuovi cluster Kubernetes.

Ripristino da un servizio Azure Kubernetes non riuscito nella distribuzione locale di Azure

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

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

La creazione guidata del programma di installazione o del cluster visualizza un errore relativo a una configurazione errata

È possibile che venga visualizzato un errore in una delle due procedure guidate relative a una configurazione errata.

Eseguire operazioni di pulizia del cluster. Queste operazioni potrebbero comportare la rimozione del file C:\Programmi\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 "si è verificato un errore durante la creazione dell'entità servizio" durante l'installazione di un host del servizio Azure Kubernetes in Locale di Azure

Questo errore verrà visualizzato se sono stati disabilitati i popup. Google Chrome blocca i popup per impostazione predefinita e pertanto 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 visualizza un errore che indica che il client WinRM non è in grado di elaborare la richiesta. Questo errore si è verificato anche all'esterno di Windows Admin Center. WinRM si è interrotto quando sono stati usati indirizzi IP statici e i server non registravano un nome dell'entità servizio (SPN) quando si passava a indirizzi IP statici.

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

Setspn /Q WSMAN/<FQDN on the Azure Local machine> 

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

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

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

Klist purge 

Notifica di aggiornamento non corretta in Windows Admin Center

Se viene visualizzato un messaggio di notifica di aggiornamento non corretto "Installazione corretta della versione del modulo powerShell AksHci null", l'operazione di aggiornamento ha esito positivo anche se la notifica è fuorviante.

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

È possibile ignorare questo messaggio in modo sicuro.

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: Accesso negato. Per altre informazioni, vedere l'argomento della Guida di 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 che 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-onboarding Arc

Windows Admin Center non dispone attualmente di un processo per discosnettere un cluster da Azure Arc.

Per eliminare gli agenti Arc in un cluster che è stato eliminato definitivamente, passare al gruppo di risorse del cluster nel portale di Azure ed eliminare manualmente il contenuto arc. Per eliminare gli agenti Arc in un cluster ancora in esecuzione, è necessario eseguire il comando seguente:

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

Nota

Se si usa il 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 invece del portale di Azure.

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

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

Aggiornare il browser per risolvere il problema.

Risolvere i problemi di CredSSP

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

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 senza problemi 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 si verifica il 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 riconosciuto

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

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 in cui si sta tentando di eseguire la distribuzione. Eseguire il comando seguente per risolvere il problema (assicurarsi 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 connettere Windows Admin Center ad Azure durante la creazione di un nuovo ID di app Azure

Impossibile connettere 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, vedere Connessione del gateway ad Azure.

Quando si aggiorna la versione di Kubernetes, la pagina di aggiornamento mostra che l'aggiornamento è ancora in fase di elaborazione 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 indicare 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 alla versione 1.19.11 nell'elenco dei cluster Kubernetes.

È possibile ignorare questo problema al termine del processo di aggiornamento.

Creare log di Windows Admin Center

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

  • Eventi visualizzati nel visualizzatore eventi nel computer che esegue Windows Admin Center
  • Problemi javaScript che si verificano 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 è archiviato lo script:

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

Il comando ha i parametri seguenti:

  • -ComputerNames: elenco di computer da cui si desidera raccogliere i log.
  • -Destination: 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 problemi durante l'esecuzione di questo script, è possibile eseguire il comando seguente per visualizzare il testo della Guida:

GetHelp .\Get-SMEUILogs.ps1 -Examples





L'esecuzione di un aggiornamento genera l'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 Locale di Azure viene distribuito in un ambiente con un proxy configurato. Attualmente Windows Admin Center non supporta l'installazione di moduli in un ambiente proxy.

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

Distribuzione: connessione a localhost del server remoto non riuscita

La distribuzione del cluster host del servizio Azure Kubernetes non riesce nei controlli di sistema con un errore del servizio WinRM.

Provare ad applicare le soluzioni suggerite nella risoluzione dei problemi manuale.

La connessione a localhost 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. È consigliabile disinstallare tutte le versioni di PowerShell inutilizzate dei moduli di PowerShell e lasciare installata una sola versione. Altre informazioni sulla versione di Windows Admin Center compatibile con la versione di PowerShell sono disponibili nelle note sulla versione locale del servizio Azure Kubernetes.

Durante la distribuzione viene visualizzato l'errore "Non è stata trovata alcuna 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 . È consigliabile verificare se il pacchetto specificato presenta 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 può 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 in 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 in cui si sta tentando di eseguire la distribuzione. Annullare la registrazione e registrare nuovamente PSRepository in una finestra amministrativa di PowerShell. Chiudere tutte le finestre di PowerShell in un secondo momento.

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

Disinstallare e reinstallare Quindi PowerShellGet in una finestra amministrativa di PowerShell. Chiudere tutte le finestre di PowerShell in un secondo momento.

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

Al termine, tornare a Windows Admin Center e riprovare.

Si verifica un errore quando si tenta di usare Windows Admin Center

Se installi Windows Admin Center con un account e prova a usarlo con un altro, riceverai errori.

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

Quando si crea un cluster di carico di lavoro abilitato per Arc, viene visualizzato l'errore 'Cannot index into a null array' (Impossibile indicizzare in una matrice Null)

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 locali di Azure causa un problema di intervallo

Il riavvio dei nodi del cluster locale di Azure 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 di 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: la connessione a localhost 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, in quanto prevede che le risorse di calcolo e di archiviazione vengano fornite dallo stesso cluster. Nella maggior parte dei casi, non troverà volumi condivisi cluster esposti dal cluster di calcolo e rifiuterà di continuare con la distribuzione.

Passaggi successivi

Se si continuano a verificarsi problemi quando si usa Il servizio Azure Kubernetes Arc, è possibile segnalare bug tramite GitHub.