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

  • Article

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

Important

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

Cet article explique comment utiliser Gestionnaire de mise à jour Azure pour rechercher et installer les mises à jour de cluster disponibles sur des clusters Azure Stack HCI sélectionnés. En outre, nous fournissons des conseils sur la façon de passer en revue les mises à jour de cluster, de suivre la progression et de parcourir l’historique des mises à jour du cluster.

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 serveur unique et à un cluster multiserveur qui exécute la dernière version avec l’orchestrateur (Gestionnaire de cycle de vie) installé. Si votre cluster a été créé via un nouveau déploiement d’Azure Stack HCI, version 23H2, l’orchestrateur a été automatiquement installé dans le cadre du déploiement.

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’avaient pas installé l’orchestrateur , consultez Mettre à jour des 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. Assurez-vous 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. Utilisez le vérificateur d’environnement pour vérifier que votre cluster est en bonne santé.
  5. Découvrez les mises à jour disponibles et filtrez celles que vous pouvez appliquer à votre cluster.
  6. Téléchargez les mises à jour, évaluez la préparation des mises à jour de votre cluster et, une fois prêt, 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.
  7. Vérifiez la version des mises à jour installées.

Le temps nécessaire à l’installation des mises à jour peut varier en fonction des facteurs suivants :

  • Contenu de la mise à jour.
  • Chargez 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 serveur unique et un cluster à 4 serveurs sont résumées dans le tableau suivant :

Cluster/Heure Il est temps de case activée 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 qui exécute la version 2310 ou ultérieure. Le cluster doit être inscrit dans Azure.
  • Vous avez accès à un client qui peut se 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 la 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

    Notes

    Vous devez vous connecter à l’aide des informations d’identification de votre compte d’utilisateur de déploiement : il s’agit du 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 d’empreinte sur votre cluster

Avant de découvrir les mises à jour, assurez-vous que le cluster a été déployé à l’aide du logiciel Azure Stack HCI, version 23H2, version 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. Notez le StampVersion sur votre cluster. La version d’empreinte reflète la version de la solution que votre cluster exécute.

Étape 2 : Éventuellement valider l’intégrité du système

Avant de découvrir les mises à jour, vous pouvez valider manuellement l’intégrité du système. Cette étape est facultative, car l’orchestrateur évalue toujours la préparation des mises à jour avant d’appliquer les mises à jour.

Notes

Toute erreur dont la gravité est critique empêche l’application des mises à jour.

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

  2. Exécutez la commande suivante pour valider l’intégrité du système via le vérificateur d’environnement.

    $result = Test-EnvironmentReadiness
$result | ft Name,Status,Severity

    Voici un exemple de sortie :

    PS C:\Users\lcmuser> whoami
rq2205\lcmuser                                                                                               
PS C:\Users\lcmuser> $result=Test-EnvironmentReadiness                                                         
VERBOSE: Looking up shared vhd product drive letter.                                                                    
WARNING: Unable to find volume with label Deployment                                                                    
VERBOSE: Get-Package returned with Success:True                                                                        
VERBOSE: Found package Microsoft.AzureStack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment with version  10.2303.0.31 at                                                                                                         C:\NugetStore\Microsoft.AzureStack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment.10.2303.0.31\Microsoft.Azure Stack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment.nuspec.                                                   
03/29/2023 15:45:58 : Launching StoragePools                                                                            
03/29/2023 15:45:58 : Launching StoragePhysicalDisks                                                                    
03/29/2023 15:45:58 : Launching StorageMapping                                                                          
03/29/2023 15:45:58 : Launching StorageSubSystems                                                                       
03/29/2023 15:45:58 : Launching TestCauSetup                                                                            
03/29/2023 15:45:58 : Launching StorageVolumes                                                                          
03/29/2023 15:45:58 : Launching StorageVirtualDisks                                                                     
03/29/2023 15:46:05 : Launching OneNodeEnvironment                                                                      
03/29/2023 15:46:05 : Launching NonMigratableWorkload                                                                   
03/29/2023 15:46:05 : Launching FaultSummary                                                                            
03/29/2023 15:46:06 : Launching SBEHealthStatusOnNode                                                                   
03/29/2023 15:46:06 : Launching StorageJobStatus                                                                        
03/29/2023 15:46:07 : Launching StorageCsv
WARNING: There aren't any faults right now.
03/29/2023 15:46:09 : Launching SBEPrecheckStatus
WARNING: rq2205-cl: There aren't any faults right now.
VERBOSE: Looking up shared vhd product drive letter.
WARNING: Unable to find volume with label Deployment
VERBOSE: Get-Package returned with Success:True
VERBOSE: Found package Microsoft.AzureStack.Role.SBE with version 4.0.2303.66 at
C:\NugetStore\Microsoft.AzureStack.Role.SBE.4.0.2303.66\Microsoft.AzureStack.Role.SBE.nuspec.
VERBOSE: SolutionExtension module supports Tag 'HealthServiceIntegration'.
VERBOSE: SolutionExtension module SolutionExtension at
C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\CloudMedia\SBE\Installed\Content\Configuration\SolutionExtension is valid.
VERBOSE: Looking up shared vhd product drive letter.
WARNING: Unable to find volume with label Deployment
VERBOSE: Get-Package returned with Success:True
VERBOSE: Found package Microsoft.AzureStack.Role.SBE with version 4.0.2303.66 at
C:\NugetStore\Microsoft.AzureStack.Role.SBE.4.0.2303.66\Microsoft.AzureStack.Role.SBE.nuspec.
VERBOSE: SolutionExtension module supports Tag 'HealthServiceIntegration'.
VERBOSE: SolutionExtension module SolutionExtension at
C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\CloudMedia\SBE\Installed\Content\Configuration\SolutionExtension is valid.
PS C:\Users\lcmuser> $result|ft Name,Status,Severity

Name                                    Status  Severity
----                                    ------  --------
Storage Pool Summary                    SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Physical Disks Summary SUCCESS CRITICAL
Storage Services Summary                SUCCESS CRITICAL
Storage Services Summary                SUCCESS CRITICAL
Storage Services Summary                SUCCESS CRITICAL
Storage Subsystem Summary               SUCCESS CRITICAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS CRITICAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           SUCCESS INFORMATIONAL
Test-CauSetup                           FAILURE INFORMATIONAL
Test-CauSetup                           FAILURE INFORMATIONAL
Test-CauSetup                           FAILURE INFORMATIONAL
Storage Volume Summary                  SUCCESS CRITICAL
Storage Volume Summary                  SUCCESS CRITICAL
Storage Volume Summary                  SUCCESS CRITICAL
Storage Volume Summary                  SUCCESS CRITICAL
Storage Virtual Disk Summary            SUCCESS CRITICAL
Storage Virtual Disk Summary            SUCCESS CRITICAL
Storage Virtual Disk Summary            SUCCESS CRITICAL
Storage Virtual Disk Summary            SUCCESS CRITICAL
Get-OneNodeRebootRequired               SUCCESS WARNING
Test-NonMigratableVMs                   SUCCESS WARNING
Faults                                  SUCCESS INFORMATIONAL
Test-SBEHealthStatusOnNode              Success Informational
Test-SBEHealthStatusOnNode              Success Informational
Storage Job Summary                     SUCCESS CRITICAL
Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
Test-SBEPrecheckStatus                  Success Informational  

PS C:\Users\lcmuser>

    Notes

    Dans cette version, les échecs d’information pour Test-CauSetup sont attendus et n’auront pas d’impact sur les mises à jour.

  3. Passez en revue les défaillances et résolvez-les avant de passer à l’étape de découverte.

Étape 3 : 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 solution sont découvertes via le catalogue de mises à jour en ligne.
  • Chargement indépendant et découverte des mises à jour : une alternative à la découverte des mises à jour en ligne et doit être utilisée pour les scénarios avec une connectivité Internet peu 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 de manière indépendante les mises à jour dans 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 . Pour découvrir les mises à jour de la solution en ligne, procédez comme suit :

  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étecte 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 
$Update.ComponentVersions

    Voici un exemple de sortie :

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate 
 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 passer à Télécharger et installer les mises à jour.

Chargement indépendant et découverte des mises à jour de 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 indépendante. Suivez ces étapes pour charger une version test 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 obtenez le package de mise à jour que vous utilisez. Vérifiez que le package de mise à jour que vous chargez de manière indépendante 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
-----------                 -------      -----
Azure Stack HCI 2303 bundle 10.2303.0.31 Ready

 PS C:\Users\lcmuser>

  7. Éventuellement case activée la version des composants du package de mise à jour. Exécutez la commande suivante :

    $Update = Get-SolutionUpdate 
$Update.ComponentVersions

    Voici un exemple de sortie :

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate 
 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 4 : Télécharger, case activée 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 aux 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 | 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 la mise à jour. Exécutez la commande suivante :

    Get-SolutionUpdate | ft Version,State,UpdateStateProperties,HealthState

    Lorsque la mise à jour démarre, les actions suivantes se produisent :

    • Le téléchargement des mises à jour commence. Selon la taille du package de téléchargement et la bande passante réseau, le téléchargement peut prendre plusieurs minutes.

      Voici un exemple de sortie lorsque les mises à jour sont en cours de téléchargement :

        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é, des vérifications de préparation sont effectuées pour évaluer la préparation à la mise à jour de votre cluster. Pour plus d’informations sur les vérifications de préparation, consultez Phases de mise à jour. Au cours de 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

    • Lorsque le système est prêt, les mises à jour sont installées. Au cours de cette phase, l’état des mises à jour s’affiche comme Installing et UpdateStateProperties affiche 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 devient Installed. Pour plus d’informations sur les différents états des mises à jour, consultez Progression de l’installation et surveillance.

Étape 5 : 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 dans Installed l’état, case activée 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 vérifier 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 une exécution de mise à jour ayant échoué précédemment via PowerShell, utilisez la commande suivante :

get-solutionupdate | start-solutionupdate

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

get-solutionUpdate | start-solutionUpdate -IgnoreWarnings

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

Étape suivante

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