In dit artikel worden bekende problemen met Windows Admin Center voor AKS Arc beschreven. U kunt ook upgrade- en installatieproblemen en -fouten bekijken.
Er zijn problemen opgetreden bij het registreren van de Windows Admin Center-gateway bij Azure
Als u zojuist een nieuw Azure-account hebt gemaakt en u zich nog niet hebt aangemeld bij het account op uw gatewaycomputer, kunnen er problemen optreden met het registreren van uw Windows Admin Center-gateway bij Azure.
Om dit probleem te verhelpen, meldt u zich aan bij uw Azure-account in een ander browsertabblad of -venster en registreert u vervolgens de Windows Admin Center-gateway bij Azure.
Alleen de gebruiker die de AKS-host heeft ingesteld, kan clusters maken
Bij het implementeren van Azure Kubernetes Service op Azure Stack HCI via Windows Admin Center, kan alleen de gebruiker die de AKS-host heeft ingesteld Kubernetes-clusters maken.
U kunt dit probleem omzeilen door de map wssd van het profiel van de gebruiker die de AKS-host heeft ingesteld, te kopiëren naar het profiel van de gebruiker die de nieuwe Kubernetes-clusters gaat maken.
Herstellen van een mislukte AKS-implementatie in Azure Stack HCI
U ondervindt implementatieproblemen of u wilt uw implementatie opnieuw instellen.
Sluit alle Windows Admin Center exemplaren die zijn verbonden met Azure Kubernetes Service in Azure Stack HCI voordat u Uninstall-AksHci uitvoert vanuit een PowerShell-beheervenster.
De wizard Setup of Cluster maken geeft een fout weer over een verkeerde configuratie
Mogelijk ontvangt u in een van beide wizards een foutmelding over een verkeerde configuratie.
Clusteropschoonbewerkingen uitvoeren. Deze bewerkingen kunnen betrekking hebben op het verwijderen van het Files\AksHci\mocctl.exe-bestand C:\Program .
Netwerkveldnamen zijn inconsistent in Windows Admin Center
Er zijn inconsistenties in de netwerkveldnamen die worden weergegeven in de implementatiestroom van het hostcluster en de implementatiestroom van het workloadcluster.
N.v.t.
Op Windows Admin Center wordt het bericht 'er is een fout opgetreden tijdens het maken van een service-principal' weergegeven tijdens het installeren van een AKS-host in Azure Stack HCI
U krijgt deze fout als u pop-ups hebt uitgeschakeld. Google Chrome blokkeert pop-ups standaard. Daarom wordt het aanmeldingspop-upvenster van Azure geblokkeerd en wordt de service-principalfout veroorzaakt.
Pop-ups inschakelen.
Er wordt een WinRM-fout weergegeven bij het maken van een nieuw workloadcluster
Bij het overschakelen van DHCP naar statisch IP-adres, Windows Admin Center een fout weergegeven die aangeeft dat de WinRM-client de aanvraag niet kan verwerken. Deze fout is ook buiten Windows Admin Center opgetreden. WinRM is verbroken bij het gebruik van statische IP-adressen en de servers registreerden geen Service Principal Name (SPN) bij het verplaatsen naar statische IP-adressen.
U kunt dit probleem oplossen met de opdracht SetSPN om de SPN te maken. Voer de volgende opdracht uit vanaf een opdrachtprompt op de Windows Admin Center gateway:
Setspn /Q WSMAN/<FQDN on the Azure Stack HCI Server>
Als vervolgens een van de servers in de omgeving het bericht No Such SPN Found
retourneert, meldt u zich aan bij die server en voert u de volgende opdrachten uit:
Setspn /S WSMAN/<server name> <server name>
Setspn /S WSMAN/<FQDN of server> <server name>
Voer ten slotte op de Windows Admin Center gateway het volgende uit om ervoor te zorgen dat nieuwe servergegevens van de domeincontroller worden opgehaald:
Klist purge
Onjuiste upgrademelding in Windows Admin Center
Als u een onjuist upgrademeldingsbericht 'AksHci PowerShell-moduleversie null is geïnstalleerd' ontvangt, is de upgradebewerking geslaagd, zelfs als de melding misleidend is.
U kunt dit bericht veilig negeren.
Toegang is geweigerd.
In fase 2.1: Basisstaponderdeel kan deze fout optreden: 'Verbinding maken met externe server *** is mislukt met het volgende foutbericht: Toegang is geweigerd. Zie voor meer informatie het about_Remote_Troubleshooting Help-onderwerp' bij het gebruik van uw referenties voor uw serverknooppunt(en).
Zorg ervoor dat het toegevoegde account/de referenties een beheerdersaccount op de computer zijn. Controleer vervolgens of PSRemoting is ingeschakeld en of externe hosts worden vertrouwd. U kunt dit doen met de volgende PowerShell-opdrachten:
Enable-PSRemoting -Force
winrm quickconfig
Als u nog steeds problemen ondervindt, raadpleegt u deze handleiding voor probleemoplossing.
Windows Admin Center heeft geen arc-offboarding-ervaring
Windows Admin Center heeft momenteel geen proces om een cluster van Azure Arc te off-boarden.
Als u Arc-agents wilt verwijderen in een cluster dat is vernietigd, gaat u naar de resourcegroep van het cluster in de Azure Portal en verwijdert u de Arc-inhoud handmatig. Als u Arc-agents wilt verwijderen in een cluster dat nog actief is, moet u de volgende opdracht uitvoeren:
az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest
Notitie
Als u de Azure Portal gebruikt om de Kubernetes-resource met Arc te verwijderen, worden alle bijbehorende configuratieresources verwijderd, maar niet de agents die op het cluster worden uitgevoerd. Het beste is om de Kubernetes-resource te verwijderen in az connectedk8s delete
plaats van de Azure Portal.
Windows Admin Center updatedashboard wordt niet vernieuwd na geslaagde updates
Na een geslaagde upgrade wordt in het Windows Admin Center updatedashboard nog steeds de vorige versie weergegeven.
Vernieuw de browser om dit probleem op te lossen.
Problemen met CredSSP oplossen
Wanneer u AKS Arc implementeert met behulp van Windows Admin Center en de implementatie gedurende een langere periode vastloopt, ondervindt u mogelijk CredSSP (Credential Security Support Provider) of verbindingsproblemen.
Voer de volgende stappen uit om problemen met uw implementatie op te lossen:
Voer de volgende opdracht uit in een PowerShell-venster op de computer waarop Windows Admin Center wordt uitgevoerd:
Enter-PSSession <servername>
Als deze opdracht slaagt, kunt u verbinding maken met de server en is er geen verbindingsprobleem.
Als u CredSSP-problemen ondervindt, voert u deze opdracht uit om het vertrouwen tussen de gatewaycomputer en de doelcomputer te testen:
Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
U kunt ook de volgende opdracht uitvoeren om de vertrouwensrelatie bij toegang tot de lokale gateway te testen:
Enter-PSSession -computer localhost -credential (Get-Credential)
Zie Problemen met CredSSP oplossen voor aanvullende tips voor het oplossen van problemen met CredSSP.
Er wordt een time-outfout weergegeven bij het verbinden van een AKS-workloadcluster met Azure Arc via Windows Admin Center
Soms, vanwege netwerkproblemen, Windows Admin Center een time-out tijdens een Arc-verbinding.
Gebruik de PowerShell-opdracht Enable-AksHciArcConnection om het AKS-workloadcluster te verbinden met Azure Arc terwijl we actief werken aan het verbeteren van de gebruikerservaring.
'Install-Module' is niet herkend
In fase 2.1: Systeemvalidatie krijgt u mogelijk een fout: 'Het item 'Install-Module' is niet herkend als de naam van een cmdlet, functie, scriptbestand of uitvoerbaar programma.'
Controleer de spelling van de naam. Als het pad is opgenomen, controleert u of het pad juist is. Probeer het vervolgens opnieuw wanneer u installeert. Voer de PowerShell-opdrachten uit op de knooppunten waarnaar u probeert te implementeren. Voer de volgende opdracht uit om het probleem op te lossen (zorg ervoor dat uw PowerShell-versie ten minste 5.1 is):
Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck
Voer vervolgens deze opdrachten uit als er fouten optreden in de eerste opdracht:
Get-PSRepository
Register-PSRepository -Default
Kan Windows Admin Center niet verbinden met Azure bij het maken van een nieuwe Azure-app-id
Kan Windows Admin Center geen verbinding maken met Azure omdat u niet automatisch een Azure-app-id op de gateway kunt maken en gebruiken.
Maak een Azure-app-id en wijs deze de juiste machtigingen toe in de portal. Selecteer vervolgens Bestaande gebruiken in de gateway. Ga naar Uw gateway verbinden met Azure voor meer informatie.
Wanneer u de Kubernetes-versie bijwerkt, wordt op de updatepagina weergegeven dat de update nog steeds wordt verwerkt wanneer de update is voltooid
Als u workloadclusters met Kubernetes-versie 1.19.9 hebt geïnstalleerd en vervolgens Windows Admin Center gebruikt om ze bij te werken naar Kubernetes versie 1.19.11, blijft de pagina Kubernetes-update weergeven dat de update nog steeds wordt uitgevoerd. Als u Get-AksHciCluster uitvoert, ziet u echter dat de update is voltooid. Als u Windows Admin Center opent op een nieuw tabblad, wordt het cluster bijgewerkt naar 1.19.11 in de lijst Met Kubernetes-clusters.
U kunt dit probleem negeren terwijl het updateproces is voltooid.
Logboeken voor Windows Admin Center maken
Wanneer u problemen met Windows Admin Center rapporteert, is het een goed idee om logboeken toe te voegen om het ontwikkelteam te helpen bij het vaststellen van uw probleem. Fouten in Windows Admin Center komen over het algemeen in een van de volgende twee vormen voor:
- Gebeurtenissen die worden weergegeven in de logboeken op de computer waarop Windows Admin Center
- JavaScript-problemen die zich voordoen in de browserconsole
Als u logboeken voor Windows Admin Center wilt verzamelen, gebruikt u het Get-SMEUILogs.ps1
script dat is opgegeven in het openbare preview-pakket.
Als u het script wilt gebruiken, voert u deze opdracht uit in de map waarin het script is opgeslagen:
./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt
De opdracht heeft de volgende parameters:
-
-ComputerNames
: Een lijst met computers waarvan u logboeken wilt verzamelen. -
-Destination
: de computer waarop u de logboeken wilt samenvoegen. -
-HoursAgo
: de begintijd voor het verzamelen van logboeken, uitgedrukt in uren vóór het tijdstip waarop u het script uitvoert. -
-NoCredentialPrompt
: Een schakeloptie om de prompt voor referenties uit te schakelen en de standaardreferenties in uw huidige omgeving te gebruiken.
Als u problemen ondervindt bij het uitvoeren van dit script, kunt u de volgende opdracht uitvoeren om de Help-tekst weer te geven:
GetHelp .\Get-SMEUILogs.ps1 -Examples
Het uitvoeren van een upgrade resulteert in de fout: 'Er is een fout opgetreden tijdens het ophalen van upgradegegevens van het platform'
Bij het uitvoeren van een upgrade in Windows Admin Center is de volgende fout opgetreden:
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.
Dit foutbericht treedt meestal op wanneer AKS in Azure Stack HCI is geïmplementeerd in een omgeving waarin een proxy is geconfigureerd. Op dit moment biedt Windows Admin Center geen ondersteuning voor het installeren van modules in een proxyomgeving.
U kunt deze fout oplossen door AKS in Azure Stack HCI in te stellen met behulp van de PowerShell-proxyopdracht.
Implementatie: verbinding maken met localhost van externe server is mislukt
De implementatie van het AKS-hostcluster mislukt bij systeemcontroles met een WinRM-servicefout.
Probeer de oplossingen toe te passen die worden voorgesteld in handmatige probleemoplossing.
Wanneer er meerdere versies van PowerShell-modules zijn geïnstalleerd, kiest Windows Admin Center niet de nieuwste versie
Als u meerdere versies van de PowerShell-modules hebt geïnstalleerd (bijvoorbeeld 0.2.26, 0.2.27 en 0.2.28), gebruikt Windows Admin Center mogelijk niet de nieuwste versie (of de versie die nodig is).
Zorg ervoor dat u slechts één PowerShell-module hebt geïnstalleerd. Verwijder alle ongebruikte PowerShell-versies van de PowerShell-modules en laat er slechts één geïnstalleerd. Meer informatie over welke Windows Admin Center versie compatibel is met welke PowerShell-versie vindt u in de opmerkingen bij de release van AKS in Azure Stack HCI.
Tijdens de implementatie wordt de fout 'Er is geen overeenkomst gevonden voor de opgegeven zoekcriteria voor de provider **NuGet**' weergegeven
Deze fout wordt weergegeven bij het implementeren via Windows Admin Center. Voor de pakketprovider zijn de PackageManagement
tags en Provider
vereist. Controleer of het opgegeven pakket een tagfout heeft bij het uitvoeren van een implementatie via Windows Admin Center.
Deze fout is afkomstig van PowerShell en geeft aan dat er problemen zijn met de internetverbinding. PowerShell probeert het pakket met vereisten te installeren en kan het niet installeren.
Controleer of de server of het failovercluster verbinding heeft met internet en start vervolgens een nieuwe installatie.
In fase 2.1: Systeemvalidatie kan er een fout optreden wanneer u op installeren klikt: 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.
Voltooi de PowerShell-opdrachten op de knooppunten waarnaar u probeert te implementeren. U moet de NuGet handmatig installeren met behulp van de volgende PowerShell-opdracht:
Install-PackageProvider -Name NuGet -Scope CurrentUser -Force
Nadat u deze opdracht hebt uitgevoerd, sluit u alle geopende PowerShell-vensters en probeert u het opnieuw in Windows Admin Center.
Kan opslagplaats 'PSGallery' niet vinden
In fase 2.1: Systeemvalidatie kan deze fout optreden: 'Kan opslagplaats PSGallery niet vinden'.
Gebruik Get-PSRepository om alle beschikbare opslagplaatsen te zien.' wanneer u op Installeren klikt. Voer de PowerShell-opdrachten uit op de knooppunten waarnaar u probeert te implementeren. De registratie van het PSRepository ongedaan maken en opnieuw registreren in een PowerShell-venster met beheerdersrechten. Sluit daarna alle PowerShell-vensters.
Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default
Verwijder vervolgens PowerShellGet en installeer deze opnieuw in een PowerShell-venster met beheerdersrechten. Sluit daarna alle PowerShell-vensters.
Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force
Ga hierna terug naar Windows Admin Center en probeer het opnieuw.
Er treedt een fout op bij het gebruik van Windows Admin Center
Als u Windows Admin Center met het ene account installeert en dit probeert te gebruiken met een ander account, krijgt u fouten.
CredSSP werkt alleen goed in de wizard Cluster maken als Windows Admin Center door hetzelfde account worden geïnstalleerd en gebruikt.
De fout 'Kan niet indexeren in een null-matrix' wordt weergegeven bij het maken van een workloadcluster met Arc
Deze fout treedt op wanneer u overstapt van PowerShell naar Windows Admin Center om een workloadcluster met Arc te maken.
U kunt deze fout veilig negeren. Het maakt deel uit van de validatiestap en het cluster is al gemaakt.
Het opnieuw opstarten van Azure Stack HCI-knooppunten veroorzaakt een timingprobleem
Het opnieuw starten van de Azure Stack HCI-clusterknooppunten die als host fungeren voor het beheercluster en workloadclusters, kan ertoe leiden dat de workloadclusters van het Windows Admin Center dashboard verdwijnen.
U kunt dit probleem omzeilen door de knooppunten te onderbreken en leeg te maken voordat u ze opnieuw wilt starten. Soms kan het langer duren voordat de workloadclusters in het dashboard worden weergegeven.
Kan AKS niet implementeren in een omgeving met afzonderlijke opslag- en rekenclusters
Windows Admin Center implementeert Azure Kubernetes Service niet in een omgeving met afzonderlijke opslag- en rekenclusters, omdat wordt verwacht dat de reken- en opslagresources door hetzelfde cluster worden geleverd. In de meeste gevallen worden CSV's die door het rekencluster worden weergegeven, niet gevonden en wordt geweigerd om door te gaan met de implementatie.
Volgende stappen
Als u problemen blijft ondervinden wanneer u AKS Arc gebruikt, kunt u fouten melden via GitHub.