Aggiornare l'istanza locale di Azure, versione 23H2 tramite PowerShell

Si applica a: Locale di Azure, versione 23H2

Questo articolo descrive come applicare un aggiornamento della soluzione all'istanza locale di Azure tramite PowerShell.

La procedura descritta in questo articolo si applica sia ai sistemi a nodo singolo che a più nodi che eseguono la versione più recente di Azure Locale con l'agente di orchestrazione (Lifecycle Manager) installato. Se il sistema è stato creato tramite una nuova distribuzione di Azure Local, versione 23H2, l'agente di orchestrazione è stato installato automaticamente come parte della distribuzione.

Importante

La procedura descritta qui si applica solo quando si esegue l'aggiornamento da una versione locale di Azure, versione 23H2 a un'altra versione successiva. Per informazioni sugli aggiornamenti per le versioni precedenti, vedere Aggiornare i cluster per Azure Locale versione 22H2.

Informazioni sugli aggiornamenti della soluzione

Gli aggiornamenti della soluzione locale di Azure possono essere costituiti da aggiornamenti dell'estensione della piattaforma, del servizio e della soluzione. Per altre informazioni su ognuno di questi tipi di aggiornamenti, vedere Informazioni sugli aggiornamenti per Azure Local, versione 23H2.

Quando si applica un aggiornamento della soluzione, ecco i passaggi generali da eseguire:

1. Assicurarsi che tutti i prerequisiti siano completati.
2. Connettersi all'istanza locale di Azure tramite PowerShell remoto.
3. Verificare le versioni software installate correnti e verificare che il cluster sia integro.
4. Individuare gli aggiornamenti disponibili e filtrare quelli che è possibile applicare al sistema.
5. (Scelta consigliata) Prescarica gli aggiornamenti e valuta l'idoneità del sistema per gli aggiornamenti.
6. Installare gli aggiornamenti e tenere traccia dello stato di avanzamento degli aggiornamenti. Monitorare lo stato di avanzamento dettagliato in base alle esigenze.
7. Verificare la versione degli aggiornamenti installati.

Il tempo impiegato per installare gli aggiornamenti varia in base ai fattori seguenti:

• Contenuto dell'aggiornamento.
• Caricare nel sistema.
• Numero di computer nel sistema.
• Tipo di hardware usato.
• Estensione della soluzione usata.

Le stime temporali approssimative per un tipico sistema a nodo singolo o multinodo sono riepilogate nella tabella seguente:

Sistema/ora	Tempo per il controllo integrità hh:mm:ss	Tempo di installazione dell'aggiornamento hh:mm:ss
Nodo singolo	~ 03:00	~ 01:30
4 nodi	~ 05:00	~ 04:00

Importante

L'uso di strumenti di terze parti per installare gli aggiornamenti non è supportato.

Prerequisiti

Prima di iniziare, verificare che:

• Si ha accesso a un sistema locale di Azure, versione 23H2 che esegue 2311 o versione successiva. Il sistema deve essere registrato in Azure.
• È possibile accedere a un client in grado di connettersi all'istanza locale di Azure.
• È possibile accedere all'aggiornamento della soluzione in rete.

Connettersi all'istanza locale di Azure

Seguire questa procedura nel client per connettersi a uno dei computer nell'istanza locale di Azure.

1. Eseguire PowerShell come amministratore nel client usato per connettersi al sistema.

2. Aprire una sessione remota di PowerShell in un computer nell'istanza locale di Azure. Eseguire il comando seguente e specificare le credenziali del computer quando richiesto:

   $cred = Get-Credential
   Enter-PSSession -ComputerName "<Computer IP>" -Credential $cred 
   

   Nota

   Accedi usando le credenziali dell'account utente di distribuzione. Questo è l'account creato durante la preparazione di Active Directory e usato per distribuire Azure Locale.

   Espandere questa sezione per visualizzare un output di esempio.

   Ecco un output di esempio:

   PS C:\Users\Administrator> $cred = Get-Credential
    
   cmdlet Get-Credential at command pipeline position 1
   Supply values for the following parameters:
   Credential
   PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
   [100.100.100.10]: PS C:\Users\Administrator\Documents>
   

Passaggio 1: Confermare il software e verificare l'integrità del sistema

Prima di scoprire gli aggiornamenti, assicurati che il tuo sistema stia eseguendo Azure Local, versione 23H2, versione software 2311 o successiva.

1. Assicurarsi di essere connessi al computer usando l'account utente di distribuzione. Esegui questo comando:

   whoami
   

2. Per assicurarsi che il sistema esegua Azure Local, versione 23H2, eseguire il comando seguente in uno dei computer del sistema:

   Get-SolutionUpdateEnvironment
   

   Espandere questa sezione per visualizzare un output di esempio.

   PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment
   ResourceId : redmond 
   SbeFamily : GenA 
   HardwareModel : Contoso680 
   LastChecked : 10/2/2024 12:38:21 PM 
   PackageVersions : {Solution: 10.2408.0.29, Services: 10.2408.0.29, Platform: 1.0.0.0, SBE: 4.1.2409.1} 
   CurrentVersion : 10.2408.0.29 
   CurrentSbeVersion : 4.1.2409.1 
   LastUpdated : 
   State : UpdateAvailable 
   HealthState : Success 
   HealthCheckResult : {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Storage 
   Services Physical Disks Summary...} 
   HealthCheckDate : 10/2/2024 10:46:44 AM 
   AdditionalData : 
   

3. Prendere nota del CurrentVersion nel sistema. La versione corrente riflette la versione della soluzione in esecuzione nel sistema.

4. Rivedere il HealthState sul tuo sistema e verificare che il sistema sia in buone condizioni. Se HealthState è Failure, Erroro Warning, vedere Risolvere i problemi di verifica dell'idoneità prima di procedere.

Passaggio 2: Individuare gli aggiornamenti

Seguire questa procedura per individuare gli aggiornamenti disponibili per il sistema:

1. Connettersi a un computer in Locale di Azure usando l'account utente di distribuzione.

2. Esaminare i dettagli degli aggiornamenti Ready da installare usando Get-SolutionUpdate.

   Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType 
   

   Espandere questa sezione per visualizzare un output di esempio.

   Ecco un output di esempio:

   PS C:\Users\lcmuser> Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
   
   DisplayName           : 2024.10 Cumulative Update
   ResourceId            : redmond/Solution10.2408.2.7
   Version               : 10.2408.2.7
   State                 : Ready
   PackageType           : Solution
   
   DisplayName           : SBE_Contoso_GenA_4.1.2410.5
   ResourceId            : redmond/SBE4.1.2410.5
   Version               : 4.1.2410.5
   State                 : AdditionalContentRequired
   PackageType           : SBE
   

   È possibile elencare una o più opzioni, incluse le voci per gli aggiornamenti completi Solution (che possono includere anche un'estensione di Generatore soluzioni) e gli aggiornamenti autonomi SBE.

   Se non vedi un aggiornamento atteso elencato, rimuovi il filtro dal comando per verificare se è elencato nello stato non-ready.

   Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType 
   

   Per altre informazioni, vedere Informazioni sulle fasi di aggiornamento per informazioni dettagliate sugli stati di aggiornamento.

3. Selezionare l'aggiornamento da installare e prendere nota del relativo ResourceId. Esaminare i dettagli dell'aggiornamento per verificare di aver selezionato l'aggiornamento desiderato da installare.

   $Update = Get-SolutionUpdate –Id <ResourceId>
   $Update
   

   Espandere questa sezione per visualizzare un output di esempio.

   Ecco un output di esempio:

   PS C:\Users\lcmuser> $Update = Get-SolutionUpdate –Id redmond/Solution10.2408.2.7
   PS C:\Users\lcmuser> $Update
   ResourceId            : redmond/Solution10.2408.2.7
   InstalledDate         : 
   Description           :
   State                 : Ready
   KbLink                : https://learn.microsoft.com/en-us/azure-stack/hci/
   MinVersionRequired    : 10.2408.0.0
   MinSbeVersionRequired : 2.0.0.0
   PackagePath           : C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\Updates\Packages\Solution10.2408
                           .2.2
   PackageSizeInMb       : 1278
   DisplayName           : 2024.10 Cumulative Update
   Version               : 10.2408.2.7
   SbeVersion            : 4.1.2410.5
   Publisher             : Microsoft
   ReleaseLink           : https://learn.microsoft.com/en-us/azure-stack/hci/
   AvailabilityType      : Online
   PackageType           : Solution
   Prerequisites         : {}
   UpdateStateProperties : The update requires additional content distributed by the OEM.
   AdditionalProperties  : {SBEReleaseLink, SBENotifyMessage, SBEFamily, SBEPublisher...}
   ComponentVersions     : {Services: 10.2408.2.7, Platform: 10.2408.2.7, SBE: 4.1.2410.5}
   RebootRequired        : Unknown
   HealthState           : Unknown
   HealthCheckResult     : 
   HealthCheckDate       : 1/1/0001 12:00:00 AM
   BillOfMaterials       : {PlatformUpdate, ServicesUpdate}
   

   Nota

   È normale che HealthState sia Unknown per un aggiornamento che non è ancora stato pianificato o preparato.

4. Facoltativamente, esaminare le versioni dei componenti del pacchetto di aggiornamento.

   $Update = Get-SolutionUpdate -Id <ResourceID>
   $Update.ComponentVersions
   

   Espandere questa sezione per visualizzare un output di esempio.

   Ecco un output di esempio:

   PS C:\Users\lcmuser> $Update = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7
   
   PS C:\Users\lcmuser> $Update.ComponentVersions
   
   PackageType Version      LastUpdated
   ----------- -------      -----------
   Services    10.2408.2.7
   Platform    10.2408.2.7
   SBE         4.1.2410.5
   
   PS C:\Users\lcmuser>
   
   

È ora possibile passare a Scaricare e installare gli aggiornamenti.

Passaggio 3: Importare e ritrovare gli aggiornamenti

Questo è un passaggio facoltativo. L'importazione degli aggiornamenti potrebbe essere necessaria in uno degli scenari seguenti:

• L'aggiornamento che si desidera installare segnala uno stato AdditionalContentRequired. Prima di poter pianificare l'aggiornamento nello stato di AdditionalContentRequired, potrebbe essere necessario un contenuto aggiuntivo. Per informazioni dettagliate su questo stato e sugli aggiornamenti delle estensioni della soluzione, vedere aggiornamenti dell'estensione della soluzione in Azure Locale, versione 23H2.

• L'aggiornamento che si vuole installare non è elencato perché il supporto fornisce una versione privata per risolvere un problema riscontrato.

• L'aggiornamento viene elencato come Ready, ma poiché il sistema ha connettività di rete limitata, si vuole evitare la fase di download online dell'aggiornamento dell'estensione della soluzione.

Seguire questa procedura per importare e individuare gli aggiornamenti della soluzione.

1. Connettersi a un computer in Locale di Azure usando l'account utente di distribuzione.

2. Passare alla condivisione di rete e acquisire il pacchetto di aggiornamento usato. Verificare che il pacchetto di aggiornamento importato contenga i file seguenti:

   • SolutionUpdate.xml
   • SolutionUpdate.zip
   • AS_Update_10.2408.2.7.zip

   Se un'estensione del generatore di soluzioni fa parte del pacchetto di aggiornamento, verranno visualizzati anche i file seguenti:

   • SBE_Contoso_GenA_4.1.2410.5.xml
   • SBE_Contoso_GenA_4.1.2410.5.zip
   • SBE_Discovery_Contoso.xml

3. Scaricare i file che si intende importare in un percorso a cui l'istanza locale di Azure può accedere. Se stai importando un'estensione della soluzione, scarichi sempre tre file che corrispondono al seguente modello di denominazione:

   Modello del nome file	Esempio	Descrizione
   SBE_Discovery_<Manufacturer>.xml	SBE_Discovery_Contoso.xml	Manifesto di scoperta delle estensioni della soluzione che consente la scoperta degli aggiornamenti.
   SBE_<Produttore>_<Famiglia>_<Versione>.xml	SBE_Contoso_GenA_4.1.2410.5.xml	Un file con l'inventario delle estensioni della soluzione e un elenco firmato dei materiali software
   SBE_<Produttore>_<Famiglia>_<Versione>.zip	SBE_Contoso_GenA_4.1.2410.5.zip	Un file con carico di un'estensione di soluzione

4. Creare una cartella per l'individuazione da parte del servizio di aggiornamento nel percorso seguente nel volume dell'infrastruttura del sistema.

   New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory 
   

5. Copiare i file di aggiornamento nella cartella creata nel passaggio precedente.

6. Individuare manualmente il pacchetto di aggiornamento usando il servizio di aggiornamento. Esegui questo comando:

   Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import
   

7. Verificare che il servizio di aggiornamento rilevi il pacchetto di aggiornamento e che sia disponibile per avviare la preparazione e l'installazione. Ripetere il comando Get-SolutionUpdate per ritrovare gli aggiornamenti.

Passaggio 4: (Consigliato) Prescaricare e controllare l'idoneità degli aggiornamenti

È possibile scaricare l'aggiornamento ed eseguire un set di controlli per verificare l'idoneità degli aggiornamenti del cluster senza avviare l'installazione.

1. Per scaricare gli aggiornamenti senza avviare l'installazione, eseguire il comando seguente:

   Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
   

   Espandere questa sezione per visualizzare un output di esempio.

   Di seguito è riportato un esempio di output:

   PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate –PrepareOnly
   redmond/SBE4.1.2410.9/<GUID>
   

2. Per tenere traccia dello stato di avanzamento dell'aggiornamento, monitorare lo stato di aggiornamento. Esegui questo comando:

   Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState
   

   All'avvio dell'aggiornamento vengono eseguite le azioni seguenti:

   • Viene avviato il download degli aggiornamenti. A seconda delle dimensioni del pacchetto di download e della larghezza di banda di rete, il download potrebbe richiedere alcuni minuti.
   Espandere questa sezione per visualizzare un output di esempio.

   Ecco un output di esempio quando vengono scaricati gli aggiornamenti:

   PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | ft Version,State,HealthState
   
   Version              State          HealthState
   -------              -----          ---------------------
   10.2408.2.7          Downloading    InProgress
   

3. Una volta scaricato il pacchetto, vengono eseguiti controlli di conformità per valutare l'idoneità degli aggiornamenti del sistema. Per altre informazioni sui controlli di conformità, vedere Fasi di aggiornamento. Durante questa fase, lo stato dell'aggiornamento viene visualizzato come HealthChecking.

   Espandere questa sezione per visualizzare un output di esempio.

   PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState
   
   Version         State             HealthState
   -------         -----             --------------------- 
   10.2408.2.7     HealthChecking    InProgress
   

4. Al termine dei controlli di conformità, il sistema è pronto per installare gli aggiornamenti. Il State dell'aggiornamento viene visualizzato come ReadyToInstall. Se il State dell'aggiornamento viene visualizzato come HealthCheckFailed, vedere Risolvere i problemi di verifica dell'idoneità prima di procedere.

Passaggio 5: Avviare l'aggiornamento

Durante l'installazione, i computer di sistema potrebbero essere riavviati e potrebbe essere necessario stabilire di nuovo la sessione remota di PowerShell per monitorare gli aggiornamenti. Se si aggiorna una singola macchina, l'istanza locale di Azure subisce un'interruzione del servizio.

Avviare un aggiornamento selezionando un singolo aggiornamento e passandolo a Start-SolutionUpdate.

$InstanceId = Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Nota

Se è stato saltato il passaggio 4 (e non è stata effettuata una chiamata simile a Start-SolutionUpdate -PrepareOnly), chiamare Start-SolutionUpdate prima scarica gli aggiornamenti ed esegue un insieme di controlli per verificare la prontezza all'aggiornamento del cluster prima di iniziare l'installazione dell'aggiornamento.

Espandere questa sezione per visualizzare un output di esempio.

PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Verrà avviato il processo per installare l'aggiornamento.

Suggerimento

Salvare il $InstanceId perché è possibile usarlo in un secondo momento per Risolvere i problemi relativi agli aggiornamenti della soluzione per l'locale di Azure.

Passaggio 6: Tenere traccia dello stato di avanzamento dell'aggiornamento

Microsoft consiglia di tenere traccia dello stato di avanzamento dell'aggiornamento del cluster nel portale di Azure dopo l'avvio dell'aggiornamento. Il portale è un'ottima opzione per tenere traccia dello stato di avanzamento degli aggiornamenti anche quando l'aggiornamento viene avviato tramite PowerShell perché non è soggetto alle interruzioni nella segnalazione dello stato.

Suggerimento

• Se si esegue il monitoraggio tramite PowerShell, è consigliabile connettere la sessione di PowerShell all'ultimo server nel cluster per evitare la disconnessione anticipata della sessione. Le sessioni si disconnettono quando i sistemi vengono riavviati in modo che il passaggio al monitoraggio da un server già aggiornato possa ridurre al minimo la frequenza di disconnessione.
• È consigliabile tenere traccia dello stato di avanzamento dell'aggiornamento del cluster nel portale di Azure per evitare di dover riconnettersi alle sessioni di PowerShell dopo un riavvio del computer.

Seguire questa procedura per tenere traccia dello stato di avanzamento dell'aggiornamento tramite PowerShell.

1. Per tenere traccia dello stato di avanzamento dell'aggiornamento, monitorare lo stato di aggiornamento. Esegui questo comando:

   Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState
   

   L'aggiornamento passa attraverso diversi stati, come descritto nelle fasi di revisione dell'aggiornamento .

   Usando il comando precedente, gli esempi seguenti illustrano come monitorare l'aggiornamento man mano che procede in queste fasi usando le proprietà State e UpdateStateProperties.

   • Stato di download in corso

     Poco dopo la chiamata di Start-SolutionUpdate, viene avviato il download degli aggiornamenti. A seconda delle dimensioni del pacchetto di download e della larghezza di banda di rete, il download potrebbe richiedere alcuni minuti.

     Espandere questa sezione per visualizzare un output di esempio.

     Ecco un output di esempio quando vengono scaricati gli aggiornamenti:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,UpdateStateProperties,HealthState
     
     Version              State         HealthState
     -------              -----         ------------
     10.2408.2.7          Downloading   Unknown
     

   • Preparazione dello stato

     Dopo aver scaricato gli aggiornamenti, è necessario preparare gli aggiornamenti. Nello stato di preparazione, gli hash dei file di aggiornamento vengono confermati e i file vengono estratti per preparare e predisporre i file di aggiornamento.

     Espandere questa sezione per visualizzare un output di esempio.

     Ecco un output di esempio quando vengono scaricati gli aggiornamenti:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State       HealthState
     -------              -----       -----------
     10.2408.2.7          Preparing   Unknown
     

   • stato di controllo dell'integrità

     Dopo aver preparato gli aggiornamenti, vengono eseguiti controlli di idoneità per valutare l'idoneità degli aggiornamenti del cluster. Per altre informazioni sui controlli di conformità, vedere Fasi di aggiornamento.

     Durante questa fase, il State dell'aggiornamento viene visualizzato come HealthChecking. Se il State dell'aggiornamento viene visualizzato come HealthCheckFailed, vedere Risolvere i problemi di verifica dell'idoneità prima di procedere.

     Espandere questa sezione per visualizzare un output di esempio.

     Ecco un output di esempio quando gli aggiornamenti sono in fase di HealthChecking:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State           HealthState
     -------              -----           -----------
     10.2408.2.7          HealthChecking  Unknown
     

   • Stato di installazione Quando il sistema è pronto, l'aggiornamento passa a Installing. Durante questa fase, il State degli aggiornamenti viene visualizzato come Installing e UpdateStateProperties indica la percentuale di installazione completata.

     Espandere questa sezione per visualizzare un output di esempio.

     Ecco un output di esempio quando gli aggiornamenti sono in fase di Installing:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State       HealthState
     -------              -----       -----------
     10.2408.2.7          Installing   Unknown
     

Al termine dell'installazione, lo stato cambia in Installed. Per altre informazioni sui vari stati degli aggiornamenti, vedere Stato e monitoraggio dell'installazione.

Passaggio 7: Riprendere l'aggiornamento (se necessario)

Per riprendere l'esecuzione di un aggiornamento precedentemente non riuscito tramite PowerShell, usare il comando seguente:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Per riprendere un aggiornamento precedentemente non riuscito a causa dei controlli di conformità degli aggiornamenti in uno stato Warning, usare il comando seguente:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate -IgnoreWarnings    

Per risolvere altri problemi di esecuzione degli aggiornamenti, vedere Risolvere i problemi relativi agli aggiornamenti.

Passaggio 8: Verificare l'installazione

Dopo aver installato gli aggiornamenti, verificare la versione della soluzione dell'ambiente e la versione del sistema operativo.

1. Dopo che l'aggiornamento è in Installed stato, controllare la versione della soluzione dell'ambiente. Esegui questo comando:

   Get-SolutionUpdateEnvironment | ft State, CurrentVersion
   

   Espandere questa sezione per visualizzare un output di esempio.

   PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion
   
   State               CurrentVersion
   -----               --------------
   AppliedSuccessfully 10.2408.2.7
   
   

2. Controllare la versione del sistema operativo per verificare che corrisponda alla ricetta installata. Esegui questo comando:

   cmd /c ver
   

   Espandere questa sezione per visualizzare un output di esempio.

   Di seguito è riportato un output di esempio:

   PS C:\Users\lcmuser> cmd /c ver
   
   Microsoft Windows [Version 10.0.25398.1189]
   PS C:\Users\lcmuser>
   

Passaggio successivo

• Se si verificano problemi durante il processo di aggiornamento, vedere Risolvere i problemi relativi agli aggiornamenti.

• Altre informazioni su come Update versione 22H2 quando l'agente di orchestrazione non è installato.