Dela via

Uppdatera din Azure Local version 23H2 via PowerShell

  • Artikel

Gäller för: Azure Local, version 23H2

Den här artikeln beskriver hur du tillämpar en lösningsuppdatering på din Azure Local via PowerShell.

Proceduren i den här artikeln gäller både system med en enskild nod och flera noder som kör den senaste versionen av Azure Local med orchestrator (Lifecycle Manager) installerad. Om systemet skapades via en ny distribution av Azure Local, version 23H2, installerades orchestrator automatiskt som en del av distributionen.

Viktigt!

Proceduren som beskrivs här gäller endast vid uppdatering från en version av Azure Local, version 23H2 till en annan högre version. Information om uppdateringar för äldre versioner finns i Uppdatera kluster för Azure Local, version 22H2.

Om lösningsuppdateringar

Uppdateringar av den lokala Azure-lösningen kan bestå av uppdateringar av plattforms-, tjänst- och lösningstillägg. Mer information om var och en av dessa typer av uppdateringar finns i Om uppdateringar för Azure Local, version 23H2.

När du tillämpar en lösningsuppdatering följer du stegen på hög nivå:

  1. Kontrollera att alla förutsättningar har slutförts.
  2. Anslut till din lokala Azure-instans via fjärr-PowerShell.
  3. Bekräfta aktuella installerade programvaruversioner och kontrollera att klustret är i god hälsa.
  4. Identifiera de uppdateringar som är tillgängliga och filtrera de uppdateringar som du kan använda i systemet.
  5. (Rekommenderas) Förinstallera uppdateringarna och utvärdera systemets uppdateringsberedskap.
  6. Installera uppdateringarna och spåra förloppet för uppdateringarna. Övervaka det detaljerade förloppet efter behov.
  7. Kontrollera vilken version av uppdateringarna som har installerats.

Hur mycket tid det tar att installera uppdateringarna varierar beroende på följande faktorer:

  • Innehållet i uppdateringen.
  • Läs in på systemet.
  • Antal datorer i systemet.
  • Typ av maskinvara som används.
  • Lösningstillägget har använts.

De ungefärliga tidsuppskattningarna för ett typiskt system med en eller flera noder sammanfattas i följande tabell:

System/tid Tid för hälsokontroll
hh:mm:ss		 Dags att installera uppdateringen
hh:mm:ss
En nod ~ 03:00 ~ 01:30
4 noder ~ 05:00 ~ 04:00

Viktigt!

Användning av verktyg från tredje part för att installera uppdateringar stöds inte.

Förutsättningar

Innan du börjar bör du kontrollera att:

  • Du har åtkomst till ett Azure Local version 23H2-system som kör 2311 eller senare. Systemet bör vara registrerat i Azure.
  • Du har åtkomst till en klient som kan ansluta till din Azure Local.
  • Du har åtkomst till lösningsuppdateringen via nätverket.

Ansluta till din Azure Local

Följ de här stegen på klienten för att ansluta till en av datorerna i Azure Local.

  1. Kör PowerShell som administratör på den klient som du använder för att ansluta till systemet.

  2. Öppna en powershell-fjärrsession på en dator på din Azure Local. Kör följande kommando och ange autentiseringsuppgifterna för datorn när du uppmanas att göra det:

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

    Kommentar

    Logga in med autentiseringsuppgifterna för ditt distributionsanvändarkonto. Det här är det konto som du skapade när du förberedde Active Directory- och som användes för att distribuera Azure Local.

    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

    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>

Steg 1: Bekräfta programvara och verifiera systemets hälsa

Innan du upptäcker uppdateringarna kontrollerar du att systemet kör Azure Local, version 23H2, programvaruversion 2311 eller senare.

  1. Kontrollera att du är ansluten till datorn med hjälp av distributionsanvändarkontot. Kör följande kommando:

    whoami

  2. För att säkerställa att systemet kör Azure Local, version 23H2, kör du följande kommando på en av datorerna i systemet:

    Get-SolutionUpdateEnvironment
    Expandera det här avsnittet om du vill se ett exempel på utdata. 
    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. Observera CurrentVersion på ditt system. Den aktuella versionen återspeglar den lösningsversion som systemet kör.

  4. Granska HealthState i systemet och kontrollera att systemet är i gott skick. Om HealthState är Failure, Erroreller Warning, se Felsöka beredskapskontroller innan du fortsätter.

Steg 2: Identifiera uppdateringarna

Följ de här stegen för att identifiera tillgängliga uppdateringar för systemet:

  1. Anslut till en dator på Azure Local med hjälp av distributionsanvändarkontot.

  2. Granska detaljer om uppdateringar som är Ready för att installera med hjälp av Get-SolutionUpdate.

    Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

    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

    Detta kan innehålla ett eller flera alternativ, inklusive poster för både fullständiga Solution uppdateringar (som även kan innehålla ett Solution Builder-tillägg) och fristående SBE uppdateringar.

    Om du inte ser någon förväntad uppdatering i listan tar du bort filtret från kommandot för att se om det visas i non-ready tillstånd:

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

    Mer information finns i Om uppdateringsfaser för mer information om uppdateringstillstånd.

  3. Välj den uppdatering som du vill installera och anteckna dess ResourceId. Granska informationen om uppdateringen för att bekräfta att du har valt önskad uppdatering att installera.

    $Update = Get-SolutionUpdate –Id <ResourceId>
$Update
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

    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}

    Kommentar

    Det är normalt att HealthState vara Unknown för en uppdatering som ännu inte har schemalagts eller förberetts.

  4. Du kan också granska versionerna av uppdateringspaketkomponenterna.

    $Update = Get-SolutionUpdate -Id <ResourceID>
$Update.ComponentVersions
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

    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>

Nu kan du gå vidare till Ladda ned och installera uppdateringarna.

Steg 3: Importera och återupptäcka uppdateringar

Det här är ett valfritt steg. Import av uppdateringar kan krävas i något av följande scenarier:

  • Uppdateringen som du vill installera rapporterar ett AdditionalContentRequiredtillstånd. Det kan krävas lite extra innehåll innan du kan schemalägga uppdateringen i AdditionalContentRequiredtillstånd. Mer information om det här tillståndet och uppdateringar av lösningstillägg finns i Uppdateringar av lösningstillägg på Azure Local version 23H2.

  • Den uppdatering som du vill installera visas inte eftersom supporten ger dig en privat version för att åtgärda ett problem som du upplever.

  • Uppdateringen visas som Ready, men eftersom systemet har begränsad nätverksanslutning vill du undvika onlinehämtningsfasen för uppdateringen av lösningstillägget.

Följ de här stegen för att importera och identifiera dina lösningsuppdateringar.

  1. Anslut till en dator på Azure Local med hjälp av distributionsanvändarkontot.

  2. Gå till nätverksresursen och hämta det uppdateringspaket som du använder. Kontrollera att uppdateringspaketet som du importerar innehåller följande filer:

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

    Om ett solution builder-tillägg ingår i uppdateringspaketet bör du även se följande filer:

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

  3. Ladda ned de filer som du tänker importera till en plats som din lokala Azure-instans kan komma åt. Om du importerar ett lösningstillägg laddar du alltid ned tre filer som matchar följande namngivningsmönster:

    Filnamnsmönster Exempel Beskrivning
    SBE_Discovery_<Tillverkare>.xml SBE_Discovery_Contoso.xml Ett identifieringsmanifest för lösningstillägg som möjliggör uppdateringsidentifiering.
    SBE_<Tillverkare>_<Familj>_<Version>.xml SBE_Contoso_GenA_4.1.2410.5.xml En fil med lösningstilläggsinventering och signerad programvarufaktura
    SBE_<Tillverkare>_<Familj>_<Version>.zip SBE_Contoso_GenA_4.1.2410.5.zip En fil med nyttolast för lösningstillägg

  4. Skapa en mapp för identifiering av uppdateringstjänsten på följande plats i systemets infrastrukturvolym.

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

  5. Kopiera uppdateringsfilerna till mappen som du skapade i föregående steg.

  6. Identifiera uppdateringspaketet manuellt med hjälp av uppdateringstjänsten. Kör följande kommando:

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

  7. Kontrollera att uppdateringstjänsten identifierar uppdateringspaketet och att det är tillgängligt för att börja förbereda och installera. Upprepa kommandot Get-SolutionUpdate för att återupptäcka uppdateringarna.

Du kan ladda ned uppdateringen och utföra en uppsättning kontroller för att verifiera klustrets uppdateringsberedskap utan att starta installationen.

  1. Om du vill ladda ned uppdateringarna utan att starta installationen kör du följande kommando:

    Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

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

  2. Övervaka uppdateringstillståndet för att spåra uppdateringsstatusen. Kör följande kommando:

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

    När uppdateringen startar utförs följande åtgärder:

    • Nedladdningen av uppdateringarna börjar. Beroende på storleken på nedladdningspaketet och nätverksbandbredden kan nedladdningen ta flera minuter.
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata när uppdateringarna laddas ned:

    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. När paketet har laddats ned utförs beredskapskontroller för att utvärdera systemets uppdateringsberedskap. Mer information om beredskapskontrollerna finns i Uppdatera faser. Under den här fasen visas tillståndet för uppdateringen som HealthChecking.

    Expandera det här avsnittet om du vill se ett exempel på utdata. 
    PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version         State             HealthState
-------         -----             --------------------- 
10.2408.2.7     HealthChecking    InProgress

  4. När beredskapskontrollerna är klara är systemet redo att installera uppdateringar. Uppdateringens State visas som ReadyToInstall. Om uppdateringens State visas som HealthCheckFailedläser du Felsöka beredskapskontroller innan du fortsätter.

Steg 5: Starta uppdateringen

Under installationen kan systemdatorerna startas om och du kan behöva upprätta den fjärranslutna PowerShell-sessionen igen för att övervaka uppdateringarna. Om du uppdaterar en enskild dator upplever Azure Local en stilleståndstid.

Starta en uppdatering genom att välja en enskild uppdatering och skicka den till Start-SolutionUpdate.

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

Kommentar

Om steg 4 hoppades över (och du inte gjorde ett liknande anrop till Start-SolutionUpdate -PrepareOnly) anropar Start-SolutionUpdate laddar först ned uppdateringarna och utför en uppsättning kontroller för att verifiera klustrets uppdateringsberedskap innan uppdateringsinstallationen startas.

Expandera det här avsnittet om du vill se ett exempel på utdata. 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Detta startar processen för att installera uppdateringen.

Tips

Spara $InstanceId eftersom du kan använda den senare för att Felsöka lösningsuppdateringar för Azure Local.

Steg 6: Spåra uppdateringsstatus

Microsoft rekommenderar att du spårar förloppet för klusteruppdatering i Azure-portalen när uppdateringen har startats. Portalen är ett bra alternativ för att spåra uppdateringsförloppet även när uppdateringen startas via PowerShell eftersom den inte är föremål för avbrott i statusrapportering.

Tips

  • Om du övervakar via PowerShell rekommenderar vi att du ansluter PowerShell-sessionen till den sista servern i klustret för att undvika att sessionen kopplas från tidigt. Sessionerna kopplas från när systemen startas om så att växling till övervakning från en redan uppdaterad server kan minimera frekvensen för frånkopplingar.
  • Vi rekommenderar att du spårar förloppet för klusteruppdatering i Azure-portalen för att undvika att behöva återansluta till PowerShell-sessioner efter en omstart av datorn.

Följ de här stegen för att spåra uppdateringsframsteg med Hjälp av PowerShell.

  1. Övervaka uppdateringstillståndet för att spåra uppdateringsstatusen. Kör följande kommando:

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

    Uppdateringen fortskrider genom flera faser enligt beskrivningen i Översikt av uppdateringsfaser.

    Med hjälp av kommandot ovan visar följande exempel hur du övervakar uppdateringen när den går igenom dessa faser med hjälp av egenskaperna State och UpdateStateProperties.

    • Nedladdningstillstånd

      Strax efter att Start-SolutionUpdate anropats börjar nedladdningen av uppdateringarna. Beroende på storleken på nedladdningspaketet och nätverksbandbredden kan nedladdningen ta flera minuter.

      Expandera det här avsnittet om du vill se ett exempel på utdata.

      Här är ett exempel på utdata när uppdateringarna laddas ned:

      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

    • Förbereder läge

      När uppdateringarna har laddats ned måste uppdateringarna förberedas. I förberedelsetillståndet bekräftas uppdateringsfilernas hashvärden och filer extraheras för att förbereda och mellanlagra uppdateringsfiler.

      Expandera det här avsnittet om du vill se ett exempel på utdata.

      Här är ett exempel på utdata när uppdateringarna laddas ned:

      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

    • Hälsokontrolltillstånd

      När uppdateringarna har förberetts utförs beredskapskontroller för att utvärdera uppdateringsberedskapen för klustret. Mer information om beredskapskontrollerna finns i Uppdatera faser.

      Under denna fas visas State av uppdateringen som HealthChecking. Om uppdateringens State visas som HealthCheckFailedläser du Felsöka beredskapskontroller innan du fortsätter.

      Expandera det här avsnittet om du vill se ett exempel på utdata.

      Här är ett exempel på utdata när uppdateringarna genomgår 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

    • Installationstillstånd När systemet är klart övergår uppdateringen till Installing. Under den här fasen visas State av uppdateringarna som Installing, och UpdateStateProperties visar hur stor andel av installationen som har slutförts.

      Expandera det här avsnittet om du vill se ett exempel på utdata.

      Här är ett exempel på utdata när uppdateringarna genomgår 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

När installationen är klar ändras tillståndet till Installed. Mer information om de olika tillstånden för uppdateringarna finns i Installationsframstatus och övervakning.

Steg 7: Återuppta uppdateringen (om det behövs)

Om du vill återuppta en tidigare misslyckad uppdateringskörning via PowerShell använder du följande kommando:

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

Om du vill återuppta en tidigare misslyckad uppdatering på grund av uppdateringsberedskapskontroller i ett Warning tillstånd använder du följande kommando:

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

Information om hur du felsöker andra problem med uppdateringskörning finns i Felsöka uppdateringar.

Steg 8: Verifiera installationen

När uppdateringarna har installerats kontrollerar du lösningsversionen av miljön och operativsystemversionen.

  1. När uppdateringen är i Installed tillstånd kontrollerar du miljölösningsversionen. Kör följande kommando:

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion
    Expandera det här avsnittet om du vill se ett exempel på utdata. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2408.2.7

  2. Kontrollera operativsystemversionen för att bekräfta att den matchar det recept som du har installerat. Kör följande kommando:

    cmd /c ver
    Expandera det här avsnittet om du vill se ett exempel på utdata.

    Här är ett exempel på utdata:

    PS C:\Users\lcmuser> cmd /c ver

Microsoft Windows [Version 10.0.25398.1189]
PS C:\Users\lcmuser>

Gå vidare