I den här artikeln beskrivs kända problem med Windows Admin Center för AKS Arc. Du kan också granska uppgraderings- och installationsproblem och fel.
Problem uppstod vid registrering av Windows Admin Center-gatewayen med Azure
Om du precis har skapat ett nytt Azure-konto och inte har loggat in på kontot på din gatewaydator kan det uppstå problem med att registrera din Windows Admin Center-gateway med Azure.
Du kan åtgärda det här problemet genom att logga in på ditt Azure-konto på en annan webbläsarflik eller ett annat fönster och sedan registrera Windows Admin Center-gatewayen med Azure.
Endast den användare som konfigurerar AKS-värden kan skapa kluster
När du distribuerar Azure Kubernetes Service på Azure Local via Windows Admin Center kan endast den användare som konfigurerar AKS-värden skapa Kubernetes-kluster.
Du kan undvika det här problemet genom att kopiera mappen wssd från profilen för den användare som konfigurerade AKS-värden till profilen för den användare som ska skapa de nya Kubernetes-klustren.
Återställa från en misslyckad AKS i Azure Local-distribution
Du har problem med distributionen eller vill återställa distributionen.
Stäng alla Windows Admin Center-instanser som är anslutna till Azure Kubernetes Service på Azure Local innan du kör Uninstall-AksHci från ett administrativt PowerShell-fönster.
Guiden Konfigurera eller Skapa kluster visar ett fel om en felaktig konfiguration
Du kan få ett fel i någon av guiderna om en felaktig konfiguration.
Utför åtgärder för klusterrensning. Dessa åtgärder kan innebära att ta bort filen C:\Program\AksHci\mocctl.exe .
Namn på nätverksfält är inkonsekventa i Administrationscenter för Windows
Det finns inkonsekvenser i nätverksfältnamnen som visas i distributionsflödet för värdkluster och distributionsflödet för arbetsbelastningskluster.
Ej tillämpligt
I Windows Administrationscenter visas meddelandet "fel uppstod när tjänstens huvudnamn skapades" när en AKS-värd installerades på Azure Local
Du får det här felet om du har inaktiverat popup-fönster. Google Chrome blockerar popup-fönster som standard, och därför blockeras popup-fönstret Azure-inloggning och orsakar felet tjänstens huvudnamn.
Aktivera popup-fönster.
Ett WinRM-fel visas när du skapar ett nytt arbetsbelastningskluster
När du växlade från DHCP till statisk IP visade Windows Administrationscenter ett fel som sa att WinRM-klienten inte kan bearbeta begäran. Det här felet inträffade också utanför Administrationscenter för Windows. WinRM bröts när statiska IP-adresser användes och servrarna registrerade inte ett SPN (Service Principal Name) när de flyttade till statiska IP-adresser.
Lös problemet genom att använda kommandot SetSPN för att skapa SPN. Kör följande kommando från en kommandotolk på Windows Admin Center-gatewayen:
Setspn /Q WSMAN/<FQDN on the Azure Local machine>
Om någon av datorerna i miljön returnerar meddelandet No Such SPN Found
loggar du sedan in på datorn och kör följande kommandon:
Setspn /S WSMAN/<machine name> <machine name>
Setspn /S WSMAN/<FQDN of machine> <machine name>
Slutligen kör du följande på Windows Admin Center-gatewayen för att se till att den hämtar ny datorinformation från domänkontrollanten:
Klist purge
Felaktigt uppgraderingsmeddelande i Windows Administrationscenter
Om du får ett felaktigt meddelande om att uppgraderingsmeddelandet "AksHci PowerShell-modulversionen är null" har installerats lyckas uppgraderingsåtgärden även om meddelandet är missvisande.
Du kan ignorera det här meddelandet på ett säkert sätt.
Åtkomst nekas
I steg 2.1: Grundläggande stegkomponent kan det här felet uppstå: "Det gick inte att ansluta till fjärrservern *** med följande felmeddelande: Åtkomst nekas. Mer information finns i avsnittet about_Remote_Troubleshooting Hjälp" när du försöker använda dina autentiseringsuppgifter för servernoderna.
Kontrollera att kontot/autentiseringsuppgifterna som lagts till är ett administrativt konto på datorn. Kontrollera sedan att PSRemoting är aktiverat och att fjärrvärdar är betrodda. Du kan göra detta med följande PowerShell-kommandon:
Enable-PSRemoting -Force
winrm quickconfig
Om du fortfarande stöter på problem kan du läsa den här felsökningsguiden.
Windows Admin Center har ingen Arc off-boarding-upplevelse
Windows Admin Center har för närvarande ingen process för att ta bort ett kluster från Azure Arc.
Om du vill ta bort Arc-agenter i ett kluster som har förstörts går du till resursgruppen för klustret i Azure Portal och tar bort Arc-innehållet manuellt. Om du vill ta bort Arc-agenter i ett kluster som fortfarande är igång bör du köra följande kommando:
az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest
Kommentar
Om du använder Azure Portal för att ta bort den Arc-aktiverade Kubernetes-resursen tas alla associerade konfigurationsresurser bort, men agenterna som körs i klustret tas inte bort. Bästa praxis är att ta bort Kubernetes-resursen med hjälp az connectedk8s delete
av i stället för Azure Portal.
Uppdateringsinstrumentpanelen för Windows Admin Center uppdateras inte efter lyckade uppdateringar
Efter en lyckad uppgradering visar Windows Admin Center uppdateringsinstrumentpanelen fortfarande den tidigare versionen.
Uppdatera webbläsaren för att åtgärda problemet.
Felsöka Problem med CredSSP
När du distribuerar AKS Arc med Hjälp av Windows Administrationscenter och distributionen låser sig under en längre period kanske du har problem med credential Security Support Provider (CredSSP) eller anslutningsproblem.
Prova följande steg för att felsöka distributionen:
Kör följande kommando i ett PowerShell-fönster på datorn som kör Windows Admin Center:
Enter-PSSession <servername>
Om det här kommandot lyckas kan du ansluta till servern och det finns inget anslutningsproblem.
Om du har problem med CredSSP kör du det här kommandot för att testa förtroendet mellan gatewaydatorn och måldatorn:
Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
Du kan också köra följande kommando för att testa förtroendet för åtkomst till den lokala gatewayen:
Enter-PSSession -computer localhost -credential (Get-Credential)
Ytterligare felsökningstips för CredSSP finns i Felsöka CredSSP.
Ett timeout-fel visas när du försöker ansluta ett AKS-arbetsbelastningskluster till Azure Arc via Administrationscenter för Windows
Ibland, på grund av nätverksproblem, överskrider Windows Admin Center tidsgränsen under en Arc-anslutning.
Använd PowerShell-kommandot Enable-AksHciArcConnection för att ansluta AKS-arbetsbelastningsklustret till Azure Arc medan vi aktivt arbetar med att förbättra användarupplevelsen.
"Install-Module" kändes inte igen
I steg 2.1: Systemverifiering kan du få ett fel: "Objektet "Install-Module" identifierades inte som namnet på en cmdlet, funktion, skriptfil eller ett körbart program.
Kontrollera stavningen av namnet. Om sökvägen ingår kontrollerar du att sökvägen är korrekt. Försök sedan igen när du installerar. Slutför PowerShell-kommandona på de noder som du försöker distribuera till. Kör följande kommando för att lösa problemet (se till att din PowerShell-version är minst 5.1):
Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck
Kör sedan dessa kommandon om du stöter på några fel från det första kommandot:
Get-PSRepository
Register-PSRepository -Default
Det går inte att ansluta Windows Admin Center till Azure när du skapar ett nytt Azure App-ID
Det går inte att ansluta Windows Admin Center till Azure eftersom du inte automatiskt kan skapa och använda ett Azure App-ID på gatewayen.
Skapa ett Azure App-ID och tilldela det rätt behörigheter på portalen. Välj sedan Använd befintlig i gatewayen. Mer information finns i ansluta din gateway till Azure.
När du uppdaterar Kubernetes-versionen visar uppdateringssidan att uppdateringen fortfarande bearbetas när uppdateringen har slutförts
Om du har arbetsbelastningskluster med Kubernetes version 1.19.9 installerat och sedan använder Windows Admin Center för att uppdatera dem till Kubernetes version 1.19.11 fortsätter Kubernetes-uppdateringssidan att visa att uppdateringen fortfarande pågår. Men om du kör Get-AksHciCluster visar utdata att uppdateringen är klar, och om du öppnar Windows Admin Center på en ny flik uppdateras klustret till 1.19.11 i Kubernetes-klusterlistan .
Du kan ignorera det här problemet när uppdateringsprocessen slutfördes.
Skapa Loggar för Administrationscenter för Windows
När du rapporterar problem med Windows Admin Center är det en bra idé att bifoga loggar som hjälper utvecklingsteamet att diagnostisera problemet. Fel i Windows Admin Center finns vanligtvis i ett av två formulär:
- Händelser som visas i loggboken på datorn som kör Administrationscenter för Windows
- JavaScript-problem som uppstår i webbläsarkonsolen
Om du vill samla in loggar för Windows Admin Center använder du skriptet Get-SMEUILogs.ps1
som finns i det offentliga förhandsversionspaketet.
Om du vill använda skriptet kör du det här kommandot i mappen där skriptet lagras:
./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt
Kommandot har följande parametrar:
-ComputerNames
: En lista över datorer som du vill samla in loggar från.-Destination
: Den dator som du vill aggregera loggarna till.-HoursAgo
: Starttiden för insamling av loggar, uttryckt i timmar före den tid du kör skriptet.-NoCredentialPrompt
: En växel för att inaktivera autentiseringsuppgifterna och använda standardautentiseringsuppgifterna i den aktuella miljön.
Om du har problem med att köra det här skriptet kan du köra följande kommando för att visa hjälptexten:
GetHelp .\Get-SMEUILogs.ps1 -Examples
Körning av en uppgradering resulterar i felet: "Fel uppstod när plattformsuppgraderingsinformation hämtades"
När du körde en uppgradering i Windows Admin Center inträffade följande fel:
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.
Det här felmeddelandet inträffar vanligtvis när AKS på Azure Local distribueras i en miljö som har en konfigurerad proxy. För närvarande har Windows Administrationscenter inte stöd för att installera moduler i en proxymiljö.
Lös det här felet genom att konfigurera AKS på Azure Local med hjälp av powershell-proxykommandot.
Distribution: Det gick inte att ansluta till fjärrservern localhost
Distributionen av AKS-värdkluster misslyckas vid systemkontroller med ett WinRM-tjänstfel.
Prova att tillämpa de lösningar som föreslås i manuell felsökning.
När flera versioner av PowerShell-moduler installeras väljer Inte Windows Administrationscenter den senaste versionen
Om du har flera versioner av PowerShell-modulerna installerade (till exempel 0.2.26, 0.2.27 och 0.2.28), kanske Windows Admin Center inte använder den senaste versionen (eller den som krävs).
Kontrollera att du bara har en PowerShell-modul installerad. Du bör avinstallera alla oanvända PowerShell-versioner av PowerShell-modulerna och lämna bara en installerad. Mer information om vilken Version av Windows Admin Center som är kompatibel med vilken PowerShell-version finns i viktig information om AKS på Azure Local ..
Under distributionen visas felet "Ingen matchning hittades för de angivna sökvillkoren för providern **NuGet**"
Det här felet visas när du distribuerar via Windows Administrationscenter. Paketprovidern kräver taggarna PackageManagement
och Provider
. Du bör kontrollera om det angivna paketet har ett taggfel när du försöker distribuera via Windows Administrationscenter.
Det här felet kommer från PowerShell och anger att det finns problem med internetanslutningen. PowerShell försöker installera kravpaketet och kan inte installera det.
Kontrollera att servern eller redundansklustret har internetanslutning och starta sedan en ny installation.
I steg 2.1: Systemverifiering kan det uppstå ett fel när du kör installationen: 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.
Slutför PowerShell-kommandona på de noder som du försöker distribuera till. Du måste installera NuGet manuellt med följande PowerShell-kommando:
Install-PackageProvider -Name NuGet -Scope CurrentUser -Force
När du har kört kommandot stänger du alla öppna PowerShell-fönster och försöker igen i Administrationscenter för Windows.
Det går inte att hitta lagringsplatsen PSGallery
I steg 2.1: Systemverifiering kan det här felet uppstå: "Det går inte att hitta lagringsplatsen PSGallery".
Använd Get-PSRepository för att se alla tillgängliga lagringsplatser." när du klickar på Installera. Slutför PowerShell-kommandona på de noder som du försöker distribuera till. Avregistrera och registrera PSRepository igen i ett administrativt PowerShell-fönster. Stäng alla PowerShell-fönster efteråt.
Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default
Avinstallera och installera sedan om PowerShellGet i ett administrativt PowerShell-fönster. Stäng alla PowerShell-fönster efteråt.
Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force
Därefter går du tillbaka till Administrationscenter för Windows och försöker igen.
Ett fel uppstår vid försök att använda Administrationscenter för Windows
Om du installerar Windows Admin Center med ett konto och försöker använda det med ett annat får du fel.
För att CredSSP ska fungera i guiden Skapa kluster måste Windows Administrationscenter installeras och användas av samma konto.
Felet "Det går inte att indexera till en null-matris" visas när du skapar ett Arc-aktiverat arbetsbelastningskluster
Det här felet visas när du flyttar från PowerShell till Windows Admin Center för att skapa ett Arc-aktiverat arbetsbelastningskluster.
Du kan ignorera det här felet på ett säkert sätt. Det är en del av valideringssteget och klustret har redan skapats.
Omstart av lokala Azure-noder orsakar tidsfel
Om du startar om de lokala Azure-klusternoderna som är värdar för hanteringsklustret och arbetsbelastningskluster kan arbetsbelastningskluster försvinna från instrumentpanelen i Windows Administrationscenter.
Du kan kringgå det här problemet genom att pausa och tömma noderna innan du planerar att starta om dem. Ibland kan det ta längre tid för arbetsbelastningskluster att visas på instrumentpanelen.
Det går inte att distribuera AKS till en miljö som har separata lagrings- och beräkningskluster
Windows Admin Center distribuerar inte Azure Kubernetes Service till en miljö med separata lagrings- och beräkningskluster eftersom det förväntar sig att beräknings- och lagringsresurserna tillhandahålls av samma kluster. I de flesta fall hittar den inte CSV:er som exponeras av beräkningsklustret och vägrar att fortsätta med distributionen.
Nästa steg
Om du fortsätter att stöta på problem när du använder AKS Arc kan du skicka buggar via GitHub.