Verifiera Azure Stack Hub-systemtillstånd

  • Artikel

Som Azure Stack Hub-operatör är det viktigt att kunna fastställa systemets hälsotillstånd och status på begäran. Valideringsverktyget för Azure Stack Hub (Test-AzureStack)) är en PowerShell-cmdlet som gör att du kan köra en serie tester på systemet för att identifiera eventuella fel. Du uppmanas vanligtvis att köra det här verktyget via den privilegierade slutpunkten (PEP) när du kontaktar Microsofts kundtjänst (Microsoft Support) med ett problem. Med systemomfattande hälso- och statusinformation till hands kan Microsoft Support samla in och analysera detaljerade loggar, fokusera på området där felet inträffade och arbeta med dig för att åtgärda problemet.

Köra verifieringsverktyget och få åtkomst till resultat

Du kan använda PEP för att köra valideringsverktyget. Det kan ta en stund att köra verktyget. Hur lång tid det tar beror på antalet virtuella datorer i systemet. Varje test returnerar statusen PASS/FAIL i PowerShell-fönstret.

Här är en översikt över valideringstestningsprocessen från slutpunkt till slutpunkt:

  1. Upprätta förtroendet. I ett integrerat system kör du följande kommando från en upphöjd Windows PowerShell session för att lägga till PEP som en betrodd värd på den härdade virtuella datorn som körs på maskinvarulivscykelvärden eller arbetsstationen för privilegierad åtkomst.

    winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'

    Om du kör Azure Stack Development Kit (ASDK) loggar du in på development kit-värden.

  2. Få åtkomst till PEP. Kör följande kommandon för att upprätta en PEP-session:

    Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred

    Tips

    Om du vill komma åt PEP på en ASDK-värddator (Azure Stack Development Kit) använder du AzS-ERCS01 för -ComputerName.

  3. När du är i PEP, kör:

    Test-AzureStack

    Mer information finns i Parameteröverväganden och Exempel på användningsfall.

  4. Om några tester rapporterar FAIL kör du Get-AzureStackLog. Anvisningar om ett integrerat system finns i så här kör du Get-AzureStackLog på integrerade Azure Stack Hub-system.

    Cmdleten samlar in loggar som genererats av Test-AzureStack. Vi rekommenderar att du inte samlar in loggar och kontaktar Microsoft Support i stället om testrapporten WARN.

  5. Om du uppmanas att köra valideringsverktyget av Microsoft Support begär den Microsoft Support representanten loggarna som du har samlat in för att fortsätta felsöka problemet.

Tester som är tillgängliga

Med valideringsverktyget kan du köra en serie tester på systemnivå och grundläggande molnscenarier som ger dig insikt i det aktuella tillståndet, så att du kan åtgärda problem i systemet.

Molninfrastrukturtester

Dessa tester med låg påverkan fungerar på infrastrukturnivå och ger dig information om olika systemkomponenter och funktioner. För närvarande grupperas testerna i följande kategorier:

Testkategori Argument för -Include och -Ignore
Azure Stack Hub ACS-sammanfattning AzsAcsSummary
Åtgärdsplanstatus för Azure Stack Hub AzsActionPlanStatus
Azure Stack Hub Agent Health AzsAgentHealth
Sammanfattning av förhandsversionen av Azure Stack AKS Arc AzsAksArcPreviewSummary
Sammanfattning av Azure Stack Hub Active Directory AzsAdSummary
Aviseringssammanfattning för Azure Stack Hub AzsAlertSummary
Sammanfattning av programkrasch i Azure Stack Hub AzsApplicationCrashSummary
Tillgänglighetssammanfattning för Azure Stack Hub Backup-resurs AzsBackupShareAccessibility
Översikt över Kontrollplan för Azure Stack Hub AzsControlPlane
Azure Stack Hub DCB-validering AzsDCBValidation
Sammanfattning av Azure Stack Hub Defender AzsDefenderSummary
Azure Stack Hub ECE-etableringsstatus AzsEceProvisioningStatus
Sammanfattning av externa Certifikat för Azure Stack Hub AzsExternalCertificates
Översikt över GPU-konfiguration för Azure Stack Hub AzsGpuConfigurationSummary
Aktivera Azure Stack Hub Hardware Monitor AzsGpuConfigurationSummary
Sammanfattning av inbyggd programvara för Azure Stack Hub-värdinfrastruktur AzsHostingInfraFWSummary
Sammanfattning av Azure Stack Hub-värdinfrastruktur AzsHostingInfraSummary
Användning av Azure Stack Hub-värdinfrastruktur AzsHostingInfraUtilization
Azure Stack Hub-identitetsprovideranslutning AzsIdentityProviderConnectivity
Identitetsproviderstatus för Azure Stack Hub AzsIdentityProviderStatus
Infrastrukturkapacitet för Azure Stack Hub AzsInfraCapacity
Filvalidering för Azure Stack Hub-infrastruktur AzsInfraFileValidation
Prestanda för Azure Stack Hub-infrastruktur AzsInfraPerformance
Rollsammanfattning för Azure Stack Hub-infrastruktur AzsInfraRoleSummary
Uppdateringsminne för Azure Stack Hub-infrastruktur AzsInfraUpdateMemory
Sammanfattning av uppdatering av infrastruktur i Azure Stack Hub AzsInfraUpdateSummary
Azure Stack Hub NCImos-validering AzsNCImosValidation
Nätverksfras för Azure Stack Hub AzsNetworkInfra
Oem-maskinvara för Azure Stack Hub AzsOemHardware
Krav för OEM-uppdatering för Azure Stack Hub AzsOemUpdatePrereqs
Sammanfattning av Azure Stack Hub-portalen och API:et AzsPortalAPISummary
Rdma-driftstatus för Azure Stack Hub AzsRdmaOperationalStatus
Autentiseringsstatus för Azure Stack Hub-resursprovider AzsResourceProviderAuthStatus
Vm-händelser för Azure Stack Hub Scale Unit AzsScaleUnitEvents
Vm-resurser för Azure Stack Hub-skalningsenhet AzsScaleUnitResources
Azure Stack Hub-scenarier AzsScenarios
Rollsammanfattning för Azure Stack Hub Service Fabric AzsSFRoleSummary
Sql-diagnostik för Azure Stack Hub AzsSQLDiagnostics
Sql-sammanfattning för Azure Stack Hub AzsSQLSummary
Azure Stack Hub Stamp BMC Summary AzsStampBMCSummary
Azure Stack Hub Storage-dataplan AzsStorageDataPlane
Sammanfattning av Azure Stack Hub Storage Services AzsStorageSvcsSummary
Sammanfattning av Azure Stack Hub SQL Store AzsStoreSummary
Användningssammanfattning för Azure Stack Hub AzsUsage
Sammanfattning av Azure Stack Hub Usage Bridge AzsUsageBridgeSummary
Sammanfattning av placering av virtuell Azure Stack Hub-dator AzsVmPlacement

Molnscenariotester

Förutom infrastrukturtesterna i föregående avsnitt kan du även köra molnscenariotester för att kontrollera funktionerna i infrastrukturkomponenterna. Autentiseringsuppgifter för molnadministratör krävs för att köra dessa tester eftersom de omfattar resursdistribution.

Anteckning

För närvarande kan du inte köra molnscenariotester med autentiseringsuppgifter för Active Directory Federated Services (AD FS).

Följande molnscenarier testas av valideringsverktyget:

  • Skapa resursgrupp
  • Skapa plan
  • Skapa erbjudande
  • Skapa lagringskonto
  • Skapa virtuell dator (VM)
  • Bloblagringsåtgärd
  • Kölagringsåtgärd
  • Tabelllagringsåtgärd

Parameteröverväganden

  • Parameterlistan kan användas för att visa alla tillgängliga testkategorier.

  • Parametrarna Include och Ignore kan användas för att inkludera eller exkludera testkategorier. Mer information om dessa argument finns i följande avsnitt.

    Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity

    Test-AzureStack -Ignore AzsInfraPerformance

  • En virtuell klientdator distribueras som en del av molnscenariotesterna. Du kan använda DoNotDeployTenantVm för att inaktivera den här VM-distributionen.

  • Du måste ange parametern ServiceAdminCredential för att köra molnscenariotester enligt beskrivningen i avsnittet Användningsfallsexempel .

  • BackupSharePath och BackupShareCredential används när du testar säkerhetskopieringsinställningarna för infrastrukturen, som du ser i avsnittet Användningsfallsexempel .

  • DetailedResults kan användas för att hämta information om pass/fail/warning för varje test samt den övergripande körningen. När det inte anges returnerar Test-AzureStack$true om det inte finns några fel och $false om det uppstår fel.

  • TimeoutSeconds kan användas för att ange en specifik tid för varje grupp att slutföras.

  • Valideringsverktyget stöder också vanliga PowerShell-parametrar: Utförlig, Felsökning, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable och OutVariable. Mer information finns i Om vanliga parametrar.

Användningsfallsexempel

Köra validering utan molnscenarier

Kör valideringsverktyget utan parametern ServiceAdminCredential för att hoppa över körning av molnscenariotester:

New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack

Köra validering med molnscenarier

Om du anger verifieringsverktyget med parametern ServiceAdminCredentials körs molnscenariotesterna som standard:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"

Om du bara vill köra molnscenarier utan att köra resten av testerna kan du använda parametern Include för att göra det:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios

Molnadministratörens användarnamn måste skrivas i UPN-format: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID). När du uppmanas till det skriver du lösenordet till molnadministratörskontot.

Grupper

För att förbättra operatorupplevelsen har en gruppparameter aktiverats för att köra flera testkategorier samtidigt. För närvarande finns det tre grupper definierade: Standard, UpdateReadiness och SecretRotationReadiness.

  • Standard: Anses vara en standardkörning av Test-AzureStack. Den här gruppen körs som standard om inga andra grupper har valts.

  • UpdateReadiness: En kontroll för att se om Azure Stack Hub-instansen kan uppdateras. När gruppen UpdateReadiness körs visas varningar som fel i konsolens utdata, och de bör betraktas som blockerare för uppdateringen. Följande kategorier ingår i gruppen UpdateReadiness :

    • AzsInfraFileValidation
    • AzsActionPlanStatus
    • AzsStampBMCSummary

  • SecretRotationReadiness: En kontroll för att se om Azure Stack Hub-instansen är i ett tillstånd där hemlig rotation kan köras. När gruppen SecretRotationReadiness körs visas varningar som fel i konsolens utdata och de bör betraktas som blockerare för hemlig rotation. Följande kategorier ingår i gruppen SecretRotationReadiness:

    • AzsAcsSummary
    • AzsDefenderSummary
    • AzsHostingInfraSummary
    • AzsInfraCapacity
    • AzsInfraRoleSummary
    • AzsPortalAPISummary
    • AzsSFRoleSummary
    • AzsStorageSvcsSummary
    • AzsStoreSummary

Exempel på gruppparameter

I följande exempel körs Test-AzureStack för att testa systemberedskap innan du installerar en uppdatering eller snabbkorrigering med hjälp av Grupp. Innan du startar installationen av en uppdatering eller snabbkorrigering kör du Test-AzureStack för att kontrollera statusen för din Azure Stack Hub:

Test-AzureStack -Group UpdateReadiness

Kör valideringsverktyget för att testa säkerhetskopieringsinställningarna för infrastrukturen

Innan du konfigurerar säkerhetskopiering av infrastrukturen kan du testa sökvägen och autentiseringsuppgifterna för säkerhetskopieringsresursen med hjälp av testet AzsBackupShareAccessibility :

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred

När du har konfigurerat säkerhetskopieringen kan du köra AzsBackupShareAccessibility för att verifiera att resursen är tillgänglig från ERCS:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility

Om du vill testa nya autentiseringsuppgifter med den konfigurerade säkerhetskopieringsresursen kör du:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"

Kör valideringsverktyget för att testa nätverksinfrastrukturen

Det här testet kontrollerar anslutningen för nätverksinfrastrukturen som kringgår det programvarudefinierade nätverket (SDN) för Azure Stack Hub. Den visar anslutningen från en offentlig VIP till konfigurerade DNS-vidarebefordrare, NTP-servrar och autentiseringsslutpunkter. Detta inkluderar anslutning till Azure när du använder Microsoft Entra ID som identitetsprovider eller federerad server när du använder AD FS som identitetsprovider.

Inkludera felsökningsparametern för att få detaljerade utdata från kommandot:

Test-AzureStack -Include AzsNetworkInfra -Debug

Nästa steg

Mer information om diagnostikverktyg för Azure Stack Hub och problemloggning finns i Azure Stack Hub Diagnostic log collection (Azure Stack Hub Diagnostic log collection).

Mer information om felsökning finns i Felsökning av Microsoft Azure Stack Hub.