Condividi tramite

Convalidare lo stato del sistema dell'hub di Azure Stack

  • Articolo

In qualità di operatore dell'hub di Azure Stack, è essenziale determinare l'integrità e lo stato del sistema su richiesta. Lo strumento di convalida dell'hub di Azure Stack (Test-AzureStack) è un cmdlet di PowerShell che consente di eseguire una serie di test nel sistema per identificare gli errori, se presenti. In genere verrà chiesto di eseguire questo strumento tramite l'endpoint con privilegi (PEP) quando si contatta il supporto clienti Microsoft (supporto tecnico Microsoft) con un problema. Con le informazioni sullo stato e l'integrità del sistema, il Supporto tecnico Microsoft può raccogliere e analizzare i log dettagliati, concentrarsi sull'area in cui si è verificato l'errore e collaborare con l'utente per risolvere il problema.

Esecuzione dello strumento di convalida e accesso ai risultati

È possibile usare pep per eseguire lo strumento di convalida. L'esecuzione dello strumento può richiedere qualche minuto. L'intervallo di tempo dipende dal numero di macchine virtuali nel sistema. Ogni test restituisce uno stato PASS/FAIL nella finestra di PowerShell.

Ecco uno schema del processo di test per la convalida end-to-end:

  1. Stabilire l'attendibilità. In un sistema integrato eseguire il comando seguente da una sessione di Windows PowerShell con privilegi elevati per aggiungere pep come host attendibile nella macchina virtuale con protezione avanzata in esecuzione nell'host del ciclo di vita hardware o nella workstation con accesso con privilegi.

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

    Se si esegue Azure Stack Development Kit (ASDK), accedere all'host del kit di sviluppo.

  2. Accedere all'endpoint con privilegi. Eseguire i comandi seguenti per stabilire una sessione dell'endpoint con privilegi:

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

    Suggerimento

    Per accedere a PEP in un computer host di Azure Stack Development Kit (ASDK), usare AzS-ERCS01 per -ComputerName.

  3. Nell'endpoint con privilegi eseguire:

    Test-AzureStack

    Per altre informazioni, vedere Considerazioni sui parametri ed esempi di casi d'uso.

  4. Se un report di test ha esito negativo, eseguire Get-AzureStackLog. Per istruzioni su un sistema integrato, vedere come eseguire Get-AzureStackLog nei sistemi integrati dell'hub di Azure Stack.

    Il cmdlet raccoglie i log generati da Test-AzureStack. È consigliabile non raccogliere i log e contattare il Supporto tecnico Microsoft se invece i test restituiscono WARN.

  5. Se si esegue lo strumento di convalida come indicato dal Supporto tecnico Microsoft, il rappresentante del Supporto tecnico richiederà i log raccolti per proseguire con la risoluzione del problema.

Test disponibili

Lo strumento di convalida consente di eseguire una serie di test a livello di sistema e scenari cloud di base che forniscono informazioni dettagliate sullo stato corrente, consentendo di risolvere i problemi nel sistema.

Test dell'infrastruttura cloud

Questi test a basso impatto funzionano a livello di infrastruttura e forniscono informazioni su vari componenti e funzioni di sistema. Attualmente, i test sono raggruppati nelle categorie seguenti:

Categoria di test Argomento per -Include e -Ignore
Riepilogo ACS dell'hub di Azure Stack AzsAcsSummary
Stato del piano di azione dell'hub di Azure Stack AzsActionPlanStatus
Integrità dell'agente dell'hub di Azure Stack AzsAgentHealth
Riepilogo dell'anteprima di Azure Stack AKS Arc AzsAksArcPreviewSummary
Riepilogo di Active Directory dell'hub di Azure Stack AzsAdSummary
Riepilogo degli avvisi dell'hub di Azure Stack AzsAlertSummary
Riepilogo dell'arresto anomalo dell'applicazione dell'hub di Azure Stack AzsApplicationCrashSummary
Riepilogo dell'accessibilità della condivisione di backup dell'hub di Azure Stack AzsBackupShareAccessibility
Riepilogo del piano di controllo dell'hub di Azure Stack AzsControlPlane
Convalida DCB dell'hub di Azure Stack AzsDCBValidation
Riepilogo di Azure Stack Hub Defender AzsDefenderSummary
Stato del provisioning ECE dell'hub di Azure Stack AzsEceProvisioningStatus
Riepilogo dei certificati esterni dell'hub di Azure Stack AzsExternalCertificates
Riepilogo della configurazione gpu dell'hub di Azure Stack AzsGpuConfigurationSummary
Abilitare Monitoraggio hardware dell'hub di Azure Stack AzsGpuConfigurationSummary
Riepilogo del firmware dell'infrastruttura di hosting dell'hub di Azure Stack AzsHostingInfraFWSummary
Riepilogo dell'infrastruttura di hosting dell'hub di Azure Stack AzsHostingInfraSummary
Utilizzo dell'infrastruttura di hosting dell'hub di Azure Stack AzsHostingInfraUtilization
Connettività del provider di identità dell'hub di Azure Stack AzsIdentityProviderConnectivity
Stato del provider di identità dell'hub di Azure Stack AzsIdentityProviderStatus
Capacità dell'infrastruttura dell'hub di Azure Stack AzsInfraCapacity
Convalida dei file dell'infrastruttura dell'hub di Azure Stack AzsInfraFileValidation
Prestazioni dell'infrastruttura dell'hub di Azure Stack AzsInfraPerformance
Riepilogo del ruolo dell'infrastruttura dell'hub di Azure Stack AzsInfraRoleSummary
Memoria di aggiornamento dell'infrastruttura dell'hub di Azure Stack AzsInfraUpdateMemory
Riepilogo dell'aggiornamento dell'infrastruttura dell'hub di Azure Stack AzsInfraUpdateSummary
Convalida NCImos dell'hub di Azure Stack AzsNCImosValidation
Infrastruttura di rete dell'hub di Azure Stack AzsNetworkInfra
Hardware OEM dell'hub di Azure Stack AzsOemHardware
Prerequisiti per l'aggiornamento OEM dell'hub di Azure Stack AzsOemUpdatePrereqs
Riepilogo dell'API e del portale dell'hub di Azure Stack AzsPortalAPISummary
Stato operativo RDMA dell'hub di Azure Stack AzsRdmaOperationalStatus
Stato di autenticazione del provider di risorse dell'hub di Azure Stack AzsResourceProviderAuthStatus
Eventi delle macchine virtuali dell'unità di scala dell'hub di Azure Stack AzsScaleUnitEvents
Risorse delle macchine virtuali dell'unità di scala dell'hub di Azure Stack AzsScaleUnitResources
Scenari dell'hub di Azure Stack AzsScenarios
Riepilogo dei ruoli di Service Fabric dell'hub di Azure Stack AzsSFRoleSummary
Diagnostica SQL dell'hub di Azure Stack AzsSQLDiagnostics
Riepilogo SQL dell'hub di Azure Stack AzsSQLSummary
Riepilogo di BMC stamp dell'hub di Azure Stack AzsStampBMCSummary
Piano dati di archiviazione dell'hub di Azure Stack AzsStorageDataPlane
Riepilogo dei servizi di archiviazione dell'hub di Azure Stack AzsStorageSvcsSummary
Riepilogo dell'archivio SQL dell'hub di Azure Stack AzsStoreSummary
Riepilogo dell'utilizzo dell'hub di Azure Stack AzsUsage
Riepilogo del bridge di utilizzo dell'hub di Azure Stack AzsUsageBridgeSummary
Riepilogo del posizionamento della macchina virtuale dell'hub di Azure Stack AzsVmPlacement

Test dello scenario cloud

Oltre ai test dell'infrastruttura nella sezione precedente, è anche possibile eseguire test dello scenario cloud per controllare le funzionalità nei componenti dell'infrastruttura. Per eseguire questi test sono necessarie credenziali di amministratore cloud perché implicano la distribuzione delle risorse.

Nota

Attualmente non è possibile eseguire test dello scenario cloud usando le credenziali di Active Directory Federated Services (AD FS).

Gli scenari cloud seguenti vengono testati dallo strumento di convalida:

  • Creazione del gruppo di risorse
  • Creazione del piano
  • Creazione dell'offerta
  • Creazione di un account di archiviazione
  • Creazione di macchine virtuali
  • Operazione di archiviazione BLOB
  • Operazione di archiviazione code
  • Operazione di archiviazione tabelle

Considerazioni relative ai parametri

  • Il parametro List può essere usato per visualizzare tutte le categorie di test disponibili.

  • I parametri Include e Ignore possono essere usati per includere o escludere categorie di test. Per altre informazioni su questi argomenti, vedere la sezione seguente.

    Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity

    Test-AzureStack -Ignore AzsInfraPerformance

  • Una macchina virtuale tenant viene distribuita come parte dei test dello scenario cloud. È possibile usare DoNotDeployTenantVm per disabilitare questa distribuzione di macchine virtuali.

  • È necessario specificare il parametro ServiceAdminCredential per eseguire test dello scenario cloud, come descritto nella sezione Esempi di casi d'uso.

  • BackupSharePath e BackupShareCredential vengono usati durante il test delle impostazioni di backup dell'infrastruttura, come illustrato nella sezione Esempi di casi d'uso.

  • DetailedResults può essere usato per ottenere informazioni di superamento/esito negativo/avviso per ogni test, nonché per l'esecuzione complessiva. Se non specificato, Test-AzureStack restituisce $true se non sono presenti errori e $false in caso di errori.

  • TimeoutSeconds può essere usato per impostare un tempo specifico per il completamento di ogni gruppo.

  • Lo strumento di convalida supporta anche parametri di PowerShell comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per altre informazioni, vedere Informazioni sui parametri comuni.

Esempi di casi di utilizzo

Eseguire la convalida senza scenari cloud

Eseguire lo strumento di convalida senza il parametro ServiceAdminCredential per ignorare l'esecuzione di test dello scenario cloud:

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

Eseguire la convalida con scenari cloud

Per impostazione predefinita, fornire lo strumento di convalida con il parametro ServiceAdminCredentials esegue i test dello scenario cloud:

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

Se si desidera eseguire SOLO scenari cloud senza eseguire il resto dei test, è possibile usare il parametro Include per eseguire questa operazione:

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

Il nome utente amministratore cloud deve essere digitato nel formato UPN: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID). Quando richiesto, digitare la password per l'account amministratore cloud.

Gruppi

Per migliorare l'esperienza dell'operatore, è stato abilitato un parametro Group per eseguire più categorie di test contemporaneamente. Attualmente sono definiti tre gruppi: Default, UpdateReadiness e SecretRotationReadiness.

  • Impostazione predefinita: considerata un'esecuzione standard di Test-AzureStack. Questo gruppo viene eseguito per impostazione predefinita se non sono selezionati altri gruppi.

  • UpdateReadiness: verifica se l'istanza dell'hub di Azure Stack può essere aggiornata. Quando viene eseguito il gruppo UpdateReadiness , gli avvisi vengono visualizzati come errori nell'output della console e devono essere considerati come blocchi per l'aggiornamento. Le categorie seguenti fanno parte del gruppo UpdateReadiness :

    • AzsInfraFileValidation
    • AzsActionPlanStatus
    • AzsStampBMCSummary

  • SecretRotationReadiness: verifica se l'istanza dell'hub di Azure Stack si trova in uno stato in cui è possibile eseguire la rotazione dei segreti. Quando viene eseguito il gruppo SecretRotationReadiness , gli avvisi vengono visualizzati come errori nell'output della console e devono essere considerati come blocchi per la rotazione dei segreti. Le categorie seguenti fanno parte del gruppo SecretRotationReadiness:

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

Esempio di parametro group

L'esempio seguente esegue Test-AzureStack per testare l'idoneità del sistema prima di installare un aggiornamento o un hotfix usando Group. Prima di avviare l'installazione di un aggiornamento o di un hotfix, eseguire Test-AzureStack per controllare lo stato dell'hub di Azure Stack:

Test-AzureStack -Group UpdateReadiness

Eseguire lo strumento di convalida per testare le impostazioni di backup dell'infrastruttura

Prima di configurare il backup dell'infrastruttura, è possibile testare il percorso e le credenziali della condivisione di backup usando il test AzsBackupShareAccessibility :

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

Dopo aver configurato il backup, è possibile eseguire AzsBackupShareAccessibility per verificare che la condivisione sia accessibile da ERCS:

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

Per testare le nuove credenziali con la condivisione di backup configurata, eseguire:

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

Eseguire lo strumento di convalida per testare l'infrastruttura di rete

Questo test controlla la connettività dell'infrastruttura di rete ignorando la rete SDN (Software Defined Network) dell'hub di Azure Stack. Illustra la connettività da un indirizzo VIP pubblico ai server d'inoltro DNS, ai server NTP e agli endpoint di autenticazione configurati. Ciò include la connettività ad Azure quando si usa Microsoft Entra ID come provider di identità o il server federato quando si usa AD FS come provider di identità.

Includere il parametro di debug per ottenere un output dettagliato del comando:

Test-AzureStack -Include AzsNetworkInfra -Debug

Passaggi successivi

Per altre informazioni sugli strumenti di diagnostica dell'hub di Azure Stack e sulla registrazione dei problemi, vedere Raccolta di log di diagnostica dell'hub di Azure Stack.

Per altre informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi dell'hub di Microsoft Azure Stack.