Partager via

Mettre à jour votre instance Azure Local, version 23H2 via PowerShell

  • Article

S’applique à : Azure Local 2311.2 et versions ultérieures

Cet article explique comment appliquer une mise à jour de solution à votre instance Azure Local via PowerShell.

La procédure décrite dans cet article s’applique aux systèmes à nœud unique et à plusieurs nœuds qui exécutent la dernière version d’Azure Local avec l’orchestrateur (Lifecycle Manager) installé. Si votre système a été créé via un nouveau déploiement d’Azure Local, version 23H2, l’orchestrateur a été installé automatiquement dans le cadre du déploiement.

Important

La procédure décrite ici s’applique lors de la mise à jour de votre version locale Azure existante vers une version plus récente. Pour plus d’informations sur les mises à jour des versions antérieures, consultez Mettre à jour les clusters pour Azure Stack HCI, version 22H2.

À propos des mises à jour de solution

Les mises à jour de la solution locale Azure peuvent être constituées de mises à jour de plateforme, de service et d’extension de solution. Pour plus d’informations sur chacun de ces types de mises à jour, consultez À propos des mises à jour pour Azure Local version 23H2.

Lorsque vous appliquez une mise à jour de solution, voici les étapes générales que vous effectuez :

  1. Vérifiez que toutes les conditions préalables sont remplies.
  2. Connectez-vous à votre instance locale Azure via PowerShell à distance.
  3. Vérifiez les versions logicielles actuellement installées et vérifiez l’intégrité de votre cluster.
  4. Découvrez les mises à jour disponibles et filtrez celles que vous pouvez appliquer à votre système.
  5. (Recommandé) Téléchargez à l’avance les mises à jour et évaluez la disponibilité de mise à jour de votre système.
  6. Installez les mises à jour et suivez la progression de l’installation. Surveillez la progression détaillée si nécessaire.
  7. Vérifiez la version des mises à jour installées.

Le temps nécessaire à l’installation des mises à jour varie selon les facteurs suivants :

  • Contenu de la mise à jour.
  • Chargez votre système.
  • Nombre d’ordinateurs dans votre système.
  • Type de matériel utilisé.
  • Extension de solution utilisée.

Les estimations de temps approximatives pour un système à nœud unique ou à plusieurs nœuds sont résumées dans le tableau suivant :

Système/Heure Heure du contrôle d’intégrité
hh :mm :ss		 Heure d’installation de la mise à jour
hh :mm :ss
Nœud unique ~ 03:00 ~ 01:30
4 nœuds ~ 05:00 vers 04:00

Important

L’utilisation d’outils tiers pour installer les mises à jour n’est pas prise en charge.

Prérequis

Avant de commencer, assurez-vous que :

  • Vous avez accès à un système Azure Local, version 23H2, qui exécute la version 2311 ou supérieure. Le système doit être inscrit dans Azure.
  • Vous avez accès à un client qui peut vous connecter à votre local Azure.
  • Vous avez accès à la mise à jour de la solution via le réseau.

Se connecter à votre local Azure

Suivez ces étapes sur votre client pour vous connecter à l’une des machines de votre instance Azure Local.

  1. Exécutez PowerShell en tant qu’administrateur sur le client que vous utilisez pour vous connecter à votre système.

  2. Ouvrez une session PowerShell distante sur une machine sur votre instance Azure Local. Exécutez la commande suivante et fournissez les informations d’identification de votre machine lorsque vous y êtes invité :

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

    Remarque

    Connectez-vous avec les informations d’identification de votre compte utilisateur de déploiement. C’est le compte que vous avez créé lors de la préparation de Active Directory et utilisé pour déployer Azure Local.

    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

    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>

Étape 1 : Identifiez le logiciel et vérifier l’intégrité du système

Avant de découvrir les mises à jour, assurez-vous que votre système exécute Azure Local, version 23H2, en version logicielle 2311 ou ultérieure.

  1. Vérifiez que vous êtes connecté à l’ordinateur à l’aide du compte d’utilisateur de déploiement. Exécutez la commande suivante :

    whoami

  2. Pour vérifier que le système exécute Azure Local, version 23H2, exécutez la commande suivante sur l’une des machines de votre système :

    Get-SolutionUpdateEnvironment
    Développez cette section pour afficher un exemple de sortie. 
    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. Notez le CurrentVersion sur votre système. La version actuelle reflète la version de la solution que votre système exécute.

  4. Examinez le HealthState sur votre système et vérifiez que votre système est en bonne santé. Si le HealthState est Failure, Error ou Warning, veuillez consulter la section Résoudre les problèmes de vérifications de préparation avant de continuer.

Étape 2 : Découvrir les mises à jour

Voici la marche à suivre pour découvrir les mises à jour disponibles pour votre système :

  1. Connectez-vous à un ordinateur sur votre local Azure à l’aide du compte d’utilisateur de déploiement.

  2. Examinez les détails des mises à jour qui sont Ready à installer en utilisant Get-SolutionUpdate.

    Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

    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

    Cela peut répertorier une ou plusieurs options, y compris les entrées pour les mises à jour complètes Solution (qui peuvent également inclure une extension du Générateur de solutions) et les mises à jour autonomes SBE.

    Si vous ne voyez pas de mise à jour attendue mentionnée, supprimez le filtre de la commande pour voir si elle est mentionnée dans l'état non-ready :

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

    Pour plus d’informations, veuillez consulter la section À propos des phases de mise à jour pour obtenir des détails sur les états de mise à jour.

  3. Sélectionnez la mise à jour que vous souhaitez installer et notez son ResourceId. Examinez les détails de la mise à jour pour vous assurer que vous avez bien sélectionné la mise à jour désirée.

    $Update = Get-SolutionUpdate –Id <ResourceId>
$Update
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

    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://zcusa.951200.xyz/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://zcusa.951200.xyz/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}

    Remarque

    Il est normal que HealthState soit Unknown pour une mise à jour qui n'a pas encore été planifiée ou préparée.

  4. Si vous le souhaitez, passez en revue les versions des composants du package de mise à jour.

    $Update = Get-SolutionUpdate -Id <ResourceID>
$Update.ComponentVersions
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

    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>

Vous pouvez maintenant continuer à télécharger et installer les mises à jour.

Étape 3 : Importer et redécouvrir les mises à jour

Il s’agit d’une étape facultative. L’importation des mises à jour peut être requise dans l’un des scénarios suivants :

  • La mise à jour que vous souhaitez installer indique un état AdditionalContentRequired. Du contenu supplémentaire peut être nécessaire avant de pouvoir planifier la mise à jour dans l’état AdditionalContentRequired. Pour plus de détails sur cet état et sur les mises à jour de l’extension de solution, veuillez consulter la section Mises à jour de l’extension de solution sur Azure Local, version 23H2.

  • La mise à jour que vous souhaitez installer n’est pas répertoriée car le support vous fournit une version privée pour résoudre un problème que vous rencontrez.

  • La mise à jour est répertoriée sous Ready, mais comme votre système dispose d’une connectivité réseau limitée, vous souhaitez éviter la phase de téléchargement en ligne de la mise à jour de l’extension de solution.

Procédez comme suit pour importer et découvrir vos mises à jour de solution.

  1. Connectez-vous à un ordinateur sur votre local Azure à l’aide du compte d’utilisateur de déploiement.

  2. Accédez au partage réseau et achetez le package de mise à jour que vous utilisez. Vérifiez que le package de mise à jour que vous importez contient les fichiers suivants :

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

    Si une extension du générateur de solutions fait partie du package de mise à jour, vous devez également voir les fichiers suivants :

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

  3. Téléchargez les fichiers que vous avez l’intention d’importer dans un emplacement auquel votre instance Azure Local peut accéder. Si vous importez une extension de solution, vous téléchargez toujours trois fichiers dont le nom respecte le modèle suivant :

    Modèle Filename Exemple Description
    SBE_Discovery_<Manufacturer>.xml SBE_Discovery_Contoso.xml Un manifeste de découverte d’extension de solution qui permet la découverte de mises à jour.
    SBE_<Manufacturer>_<Family>_<Version>.xml SBE_Contoso_GenA_4.1.2410.5.xml Un fichier contenant l’inventaire de l’extension de solution et une Bill of Materials logicielle signée
    SBE_<Manufacturer>_<Family>_<Version>.zip SBE_Contoso_GenA_4.1.2410.5.zip Un fichier contenant la charge utile de l’extension de solution

  4. Créez un dossier pour la découverte par le service de mise à jour à l’emplacement suivant dans le volume d’infrastructure de votre système.

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

  5. Copiez les fichiers de mise à jour dans le dossier que vous avez créé à l’étape précédente.

  6. Découvrez manuellement le package de mise à jour à l’aide du service De mise à jour. Exécutez la commande suivante :

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

  7. Vérifiez que le service de mise à jour découvre le package de mise à jour et qu’il est disponible pour démarrer la préparation et l’installation. Répétez la commande Get-SolutionUpdate pour redécouvrir les mises à jour.

Vous pouvez télécharger la mise à jour et effectuer un ensemble de vérifications pour vérifier l’état de préparation de la mise à jour de votre cluster sans lancer l’installation.

  1. Pour télécharger les mises à jour sans lancer l’installation, exécutez la commande suivante :

    Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

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

  2. Pour suivre la progression de la mise à jour, surveillez l’état de mise à jour. Exécutez la commande suivante :

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

    Au démarrage de la mise à jour, les actions suivantes se produisent :

    • Le téléchargement des mises à jour commence. En fonction de la taille du package de téléchargement et de la bande passante réseau, le téléchargement peut prendre plusieurs minutes.
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie lorsque les mises à jour sont téléchargées :

    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. Une fois le package téléchargé, les vérifications de préparation sont effectuées pour évaluer la préparation des mises à jour de votre système. Pour plus d’informations sur les vérifications de préparation, consultez phases de mise à jour. Pendant cette phase, l’état de la mise à jour s’affiche sous la forme HealthChecking.

    Développez cette section pour afficher un exemple de sortie. 
    PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

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

  4. Lorsque les vérifications de préparation sont terminées, le système est prêt à installer les mises à jour. Le State de la mise à jour s’affiche comme ReadyToInstall. Si le State de la mise à jour s’affiche comme HealthCheckFailed, veuillez consulter la section Résoudre les problèmes de vérifications de préparation avant de continuer.

Étape 5: Démarrer la mise à jour

Pendant l’installation, les machines du système peuvent redémarrer et vous devrez peut-être établir à nouveau la session PowerShell distante pour surveiller les mises à jour. Si vous mettez à jour une seule machine, votre Azure Local subira une interruption de service.

Démarrez une mise à jour en sélectionnant une seule mise à jour et en la transmettant à Start-SolutionUpdate.

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

Remarque

Si l’étape 4 a été ignorée (et que vous n’avez pas fait d’appel similaire à Start-SolutionUpdate -PrepareOnly), appeler Start-SolutionUpdate télécharge d’abord les mises à jour et effectue un ensemble de vérifications pour confirmer l’état de préparation de la mise à jour de votre cluster avant de lancer l’installation.

Développez cette section pour afficher un exemple de sortie. 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Cela lance le processus d’installation de la mise à jour.

Conseil

Enregistrez le $InstanceId, car vous pourriez l’utiliser plus tard pour résoudre les problèmes de mises à jour de solution pour Azure Local.

Étape 6: Suivre la progression de la mise à jour

Microsoft recommande de suivre la progression de la mise à jour du cluster dans le portail Azure après le début de la mise à jour. Le portail est une excellente option pour suivre la progression de la mise à jour, même lorsque la mise à jour est lancée via PowerShell, car il n’est pas soumis aux interruptions dans la remontée d’état.

Conseil

  • Si vous effectuez le suivi via PowerShell, nous vous recommandons de connecter votre session PowerShell au dernier serveur de votre cluster pour éviter toute déconnexion prématurée. Les sessions se déconnectent lors du redémarrage des systèmes, donc basculer la surveillance sur un serveur déjà mis à jour peut réduire la fréquence des déconnexions.
  • Nous vous recommandons de suivre la progression de la mise à jour du cluster dans le portail Azure pour éviter d’avoir à vous reconnecter aux sessions PowerShell après le redémarrage d’une machine.

Procédez comme suit pour suivre la progression de la mise à jour avec PowerShell.

  1. Pour suivre la progression de la mise à jour, surveillez l’état de mise à jour. Exécutez la commande suivante :

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

    La mise à jour progresse à travers plusieurs états, comme décrit dans Examiner les phases de mise à jour.

    En utilisant la commande ci-dessus, les exemples suivants montrent comment surveiller la mise à jour au fur et à mesure de sa progression à travers ces phases à l’aide des propriétés State et UpdateStateProperties.

    • État du téléchargement

      Peu après que Start-SolutionUpdate est appelée, le téléchargement des mises à jour commence. En fonction de la taille du package de téléchargement et de la bande passante réseau, le téléchargement peut prendre plusieurs minutes.

      Développez cette section pour afficher un exemple de sortie.

      Voici un exemple de sortie lorsque les mises à jour sont téléchargées :

      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

    • Préparation de l’état

      Une fois les mises à jour téléchargées, elles doivent être préparées. Dans l’état de préparation, les hachages des fichiers de mise à jour sont confirmés et les fichiers sont extraits pour préparer et mettre en phase les fichiers de mise à jour.

      Développez cette section pour afficher un exemple de sortie.

      Voici un exemple de sortie lorsque les mises à jour sont téléchargées :

      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

    • État de vérification de l’intégrité

      Une fois les mises à jour préparées, des vérifications sont effectuées pour évaluer l’état de préparation de la mise à jour de votre cluster. Pour plus d’informations sur les vérifications de préparation, consultez phases de mise à jour.

      Pendant cette phase, le State de la mise à jour s’affiche comme HealthChecking. Si le State de la mise à jour s’affiche comme HealthCheckFailed, veuillez consulter la section Résoudre les problèmes de vérifications de préparation avant de continuer.

      Développez cette section pour afficher un exemple de sortie.

      Voici un exemple de sortie lorsque les mises à jour sont en cours de 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

    • État de l’installation Lorsque le système est prêt, la mise à jour passe à Installing. Au cours de cette phase, le State des mises à jour s’affiche comme Installing et UpdateStateProperties indique le pourcentage de l’installation qui a été réalisée.

      Développez cette section pour afficher un exemple de sortie.

      Voici un exemple de sortie lorsque les mises à jour sont en cours de 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

Une fois l’installation terminée, l’état passe à Installed. Pour plus d’informations sur les différents états des mises à jour, consultez Progression et surveillance de l’installation.

Étape 7: Reprendre la mise à jour (si nécessaire)

Pour reprendre l’exécution d’une mise à jour ayant échoué précédemment via PowerShell, utilisez la commande suivante :

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

Pour reprendre une mise à jour précédemment échouée en raison de vérifications de préparation de la mise à jour dans un état Warning, utilisez la commande suivante :

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

Pour résoudre les problèmes liés à l’exécution d’autres mises à jour, veuillez consulter la section Résolution des problèmes de mises à jour.

Étape 8: Vérifier l’installation

Une fois les mises à jour installées, vérifiez la version de la solution de l’environnement et la version du système d’exploitation.

  1. Une fois la mise à jour en Installed état, vérifiez la version de la solution d’environnement. Exécutez la commande suivante :

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion
    Développez cette section pour afficher un exemple de sortie. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

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

  2. Vérifiez la version du système d’exploitation pour confirmer qu’elle correspond à la recette que vous avez installée. Exécutez la commande suivante :

    cmd /c ver
    Développez cette section pour afficher un exemple de sortie.

    Voici un exemple de sortie :

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

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

Étape suivante