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

  • Article

S’applique à : Azure Stack HCI, version 23H2

Cet article explique comment appliquer une mise à jour de solution à votre cluster Azure Stack HCI via PowerShell.

La procédure décrite dans cet article s’applique à un seul serveur et à un cluster multi-serveur qui exécute la dernière version avec l’orchestrateur (Lifecycle Manager) installé. Si votre cluster a été créé via un nouveau déploiement d’Azure Stack HCI, version 23H2, l’orchestrateur a été installé automatiquement dans le cadre du déploiement.

Important

La procédure décrite ici s’applique uniquement lors de la mise à jour d’une version d’Azure Stack HCI, version 23H2 à une autre version ultérieure. Pour plus d’informations sur les mises à jour des versions antérieures, consultez Mettre à jour les clusters pour Azure Stack HCI, version 22H2.

Pour plus d’informations sur l’application des mises à jour de solution aux clusters créés avec des versions antérieures d’Azure Stack HCI qui n’ont pas été installées par l’orchestrateur, consultez Mettre à jour les clusters Azure Stack HCI, version 22H2.

À propos des mises à jour de solution

Les mises à jour de la solution Azure Stack HCI 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 Stack HCI, 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. Identifiez la version logicielle en cours d’exécution sur votre cluster.
  3. Connectez-vous à votre cluster Azure Stack HCI via PowerShell distant.
  4. Découvrez les mises à jour disponibles et filtrez celles que vous pouvez appliquer à votre cluster.
  5. Téléchargez les mises à jour, évaluez la préparation des mises à jour de votre cluster et, une fois prêtes, installez les mises à jour sur votre cluster. Suivez la progression des mises à jour. Si nécessaire, vous pouvez également surveiller la progression détaillée.
  6. Vérifiez la version des mises à jour installées.

Le temps nécessaire pour installer les mises à jour peut varier en fonction des facteurs suivants :

  • Contenu de la mise à jour.
  • Chargez-le sur votre cluster.
  • Nombre de serveurs dans votre cluster.
  • Type du matériel utilisé.
  • Extension du Générateur de solutions utilisée.

Les estimations de temps approximatives pour un seul serveur et un cluster 4 serveurs sont résumées dans le tableau suivant :

Cluster/Heure Heure du contrôle d’intégrité
hh :mm :ss		 Heure d’installation de la mise à jour
hh :mm :ss
Serveur unique 0:01:44 1:25:42
Cluster 4 serveurs 0:01:58 3:53:09

Prérequis

Avant de commencer, assurez-vous que :

  • Vous avez accès à un cluster Azure Stack HCI version 23H2 exécutant 2310 ou version ultérieure. Le cluster doit être inscrit dans Azure.
  • Vous avez accès à un client qui peut vous connecter à votre cluster Azure Stack HCI. Ce client doit exécuter PowerShell 5.0 ou version ultérieure.
  • Vous avez accès au package de mise à jour de solution sur le réseau. Vous chargez ou copiez ces mises à jour sur les serveurs de votre cluster.

Se connecter à votre cluster Azure Stack HCI

Suivez ces étapes sur votre client pour vous connecter à l’un des serveurs de votre cluster Azure Stack HCI.

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

  2. Ouvrez une session PowerShell distante sur un serveur sur votre cluster Azure Stack HCI. Exécutez la commande suivante et fournissez les informations d’identification de votre serveur lorsque vous y êtes invité :

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

    Remarque

    Vous devez vous connecter à l’aide de vos informations d’identification de compte d’utilisateur de déploiement : c’est-à-dire le compte que vous avez créé lors de la préparation d’Active Directory et utilisé pendant le déploiement du système Azure Stack HCI.

    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 : Identifier la version du tampon sur votre cluster

Avant de découvrir les mises à jour, assurez-vous que le cluster a été déployé à l’aide d’Azure Stack HCI, version 23H2, version logicielle 2310.

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

    whoami

  2. Pour vous assurer que le cluster a été déployé en exécutant Azure Stack HCI, version 23H2, exécutez la commande suivante sur l’un des serveurs de votre cluster :

    Get-StampInformation

    Voici un exemple de sortie :

    PS C:\Users\lcmuser> Get-StampInformation
Deployment ID             : b4457f25-6681-4e0e-b197-a7a433d621d6
OemVersion                : 2.1.0.0
PackageHash               :
StampVersion              : 10.2303.0.31
InitialDeployedVersion    : 10.2303.0.26
PS C:\Users\lcmuser>

  3. Prenez note du StampVersion cluster. La version d’empreinte reflète la version de la solution exécutée par votre cluster.

Étape 2 : Découvrir les mises à jour

Vous pouvez découvrir les mises à jour de l’une des deux manières suivantes :

  • Découvrir les mises à jour en ligne : option recommandée lorsque votre cluster dispose d’une bonne connectivité Internet. Les mises à jour de la solution sont découvertes via le catalogue de mises à jour en ligne.
  • Chargement indépendant et découverte des mises à jour : alternative à la découverte des mises à jour en ligne et doit être utilisée pour les scénarios avec une connectivité Internet non fiable ou lente, ou lors de l’utilisation des mises à jour d’extension de solution fournies par votre fournisseur de matériel. Dans ces cas, vous téléchargez les mises à jour de la solution vers un emplacement central. Vous chargez ensuite les mises à jour vers un cluster Azure Stack HCI et découvrez les mises à jour localement.

La découverte des mises à jour de solution à l’aide du catalogue en ligne est la méthode recommandée . Procédez comme suit pour découvrir les mises à jour de solution en ligne :

  1. Connectez-vous à un serveur sur votre cluster Azure Stack HCI à l’aide du compte d’utilisateur de déploiement.

  2. Vérifiez que le service de mise à jour découvre le package de mise à jour.

    Get-SolutionUpdate | ft DisplayName, State

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

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    Voici un exemple de sortie :

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

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

Chargement indépendant et découverte des mises à jour de la solution

Si vous utilisez des mises à jour d’extension de solution à partir de votre matériel, vous devez charger ces mises à jour de manière test. Suivez ces étapes pour charger et découvrir les mises à jour de votre solution.

  1. Connectez-vous à un serveur sur votre cluster Azure Stack HCI à 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 chargez contient les fichiers suivants :

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2303.4.1.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_Content_4.1.2.3.xml
    • SBE_Content_4.1.2.3.zip
    • SBE_Discovery_Contoso.xml

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

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

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

  5. 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\sideload

  6. 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.

    Get-SolutionUpdate | ft DisplayName, Version, State

    Voici un exemple de sortie :

     PS C:\Users\lcmuser> Get-SolutionUpdate | ft DisplayName, Version, State

DisplayName                 Version      State
-----------                 -------      -----
2023.03 Feature Update 10.2303.0.31 Ready

 PS C:\Users\lcmuser>

  7. Vérifiez éventuellement la version des composants du package de mise à jour. Exécutez la commande suivante :

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    Voici un exemple de sortie :

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

Étape 3 : Télécharger, vérifier la préparation et installer les mises à jour

Vous pouvez télécharger les mises à jour, effectuer un ensemble de vérifications pour vérifier la préparation des mises à jour de votre cluster et commencer à installer les mises à jour.

  1. Vous pouvez uniquement télécharger la mise à jour sans démarrer l’installation ou télécharger et installer la mise à jour.

    • Pour télécharger et installer la mise à jour, exécutez la commande suivante :

      Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

    • Pour télécharger uniquement les mises à jour sans démarrer l’installation, utilisez l’indicateur -PrepareOnly avec Start-SolutionUpdate.

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

    Get-SolutionUpdate | 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.

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

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

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 Downloading                        InProgress

    • 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 cluster. 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.

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

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 HealthChecking                        InProgress

    • Une fois le système prêt, les mises à jour sont installées. Pendant cette phase, l’état des mises à jour s’affiche et Installing UpdateStateProperties indique le pourcentage de l’installation terminée.

      Important

      Pendant l’installation, les serveurs de cluster peuvent redémarrer et vous devrez peut-être rétablir la session PowerShell distante pour surveiller les mises à jour. Si vous mettez à jour un serveur unique, votre instance Azure Stack HCI subira un temps d’arrêt.

      Voici un exemple de sortie pendant l’installation des mises à jour.

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

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 6% complete.              Success


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

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 25% complete.             Success

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

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 40% complete.             Success

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

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 89% complete.             Success

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 4 : 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

    Voici un exemple de sortie :

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

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2303.0.31

  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

    Voici un exemple de sortie :

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

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

Résoudre les problèmes de mise à jour

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

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

Pour reprendre une mise à jour ayant échoué précédemment en raison de la mise à jour des vérifications d’intégrité dans un état d’avertissement , utilisez la commande suivante :

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate -IgnoreWarnings

Pour résoudre d’autres problèmes d’exécution des mises à jour, consultez Résoudre les problèmes de mise à jour.

Étape suivante

En savoir plus sur la mise à jour des clusters Azure Stack HCI, version 22H2 lorsque l’orchestrateur n’est pas installé.