Options avancées de la mise à jour adaptée aux clusters et mise à jour des profils d’exécution
S’applique à : Windows server 2022, Windows server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Azure Stack HCI, versions 21H2 et 20H2
Cette rubrique décrit les options d’exécution de mise à jour qui peuvent être configurées pour une exécution de mise à jour de la mise à jour adaptée aux clusters. Ces options avancées peuvent être configurées lorsque vous utilisez l’interface utilisateur de la mise à jour adaptée aux clusters ou les applets de commande Windows PowerShell de la mise à jour adaptée aux clusters pour appliquer des mises à jour ou configurer des options de mise à jour automatique.
La plupart des paramètres de configuration peuvent être enregistrés sous la forme d’un fichier XML appelé profil d’exécution de mise à jour et réutilisés pour des exécutions de mise à jour ultérieures. Les valeurs par défaut des options d’exécution de mise à jour qui sont fournies par la mise à jour adaptée aux clusters peuvent également être utilisées dans de nombreux environnements de clusters.
Pour plus d’informations sur d’autres options que vous pouvez spécifier pour chaque exécution de mise à jour et sur les profils d’exécution de mise à jour, voir les sections suivantes plus loin dans cette rubrique :
Options que vous spécifiez lorsque vous demandez une exécution de mise à jour - Utilisez les options de profils d’exécution qui peuvent être définies dans un profil d’exécution de mise à jour
Le tableau suivant répertorie les options que vous pouvez définir dans un profil d’exécution de mise à jour pour une mise à jour adaptée aux clusters.
Remarque
Pour définir l’option PreUpdateScript ou PostUpdateScript, vérifiez que Windows PowerShell et .NET Framework 4.6 ou 4.5 sont installés et que la communication à distance de PowerShell est activée sur chaque nœud du cluster. Pour plus d’informations, consultez Configurer les nœuds pour la gestion à distance dans Configuration requise et meilleures pratiques concernant la Mise à jour adaptée aux clusters.
| Option | Valeur par défaut | Détails |
|---|---|---|
| StopAfter | Durée illimitée | Délai, en minutes, au-delà duquel l’exécution de mise à jour sera arrêtée si elle n’est pas terminée. Remarque : Si vous spécifiez un script PowerShell antérieur ou postérieur à la mise à jour, l’ensemble du processus d’exécution des scripts et des mises à jour doit être effectué dans le délai StopAfter. |
| WarnAfter | Par défaut, aucun avertissement ne s’affiche | Délai, en minutes, au-delà duquel un avertissement est affiché si l’exécution de mise à jour (y compris un script antérieur à la mise à jour et un script postérieur à la mise à jour, s’ils sont configurés) n’est pas terminée. |
| MaxRetriesPerNode | 3 | Nombre maximal de fois où le processus de mise à jour (y compris un script antérieur à la mise à jour et un script postérieur à la mise à jour, s’ils sont configurés) sera relancé par nœud. La valeur maximale est 64. |
| MaxFailedNodes | Pour la plupart des clusters, un entier à peu près égal au tiers du nombre de nœuds de cluster | Nombre maximal de nœuds sur lesquels la mise à jour peut échouer, en raison de l’échec des nœuds ou de l’arrêt de l’exécution du service de cluster. Si un nœud supplémentaire échoue, l’exécution de mise à jour est arrêtée. La plage valide contient des valeurs inférieures de 0 à 1 au nombre de nœuds de cluster. |
| RequireAllNodesOnline | Aucun | Indique que tous les nœuds doivent être en ligne et accessibles avant le début de la mise à jour. |
| RebootTimeoutMinutes | 15 | Délai, en minutes, que la mise à jour adaptée aux clusters autorisera pour le redémarrage d’un nœud (si un redémarrage est nécessaire) et le démarrage de tous les services de démarrage automatique. Si le processus de redémarrage n’est pas terminé pendant ce délai, l’exécution de mise à jour sur ce nœud est marquée comme ayant échoué. |
| PreUpdateScript | Aucun | Chemin d’accès et nom de fichier d’un script PowerShell à exécuter sur chaque nœud avant le début de la mise à jour et avant la mise en mode de maintenance du nœud. L’extension du nom de fichier doit être .ps1, et la longueur totale du chemin d’accès et du nom de fichier ne doit pas excéder 260 caractères. Nous vous recommandons, à titre de meilleure pratique, de placer le script sur un disque dans le stockage du cluster ou sur un partage de fichiers réseau hautement disponible pour garantir qu’il est toujours accessible à tous les nœuds de cluster. Si le script est situé sur un partage de fichiers réseau, assurez-vous de configurer le partage avec l’autorisation de lecture pour le groupe Tout le monde et limitez l’accès en écriture pour empêcher toute falsification des fichiers par des utilisateurs non autorisés. Si vous spécifiez un script antérieur à la mise à jour, assurez-vous que des paramètres tels que les limites de temps (par exemple, StopAfter) sont configurés pour permettre l’exécution correcte du script. Ces limites couvrent la totalité du processus d’exécution des scripts et d’installation des mises à jour, et pas seulement le processus d’installation des mises à jour. |
| PostUpdateScript | Aucun | Chemin d’accès et nom de fichier d’un script PowerShell à exécuter une fois la mise à jour terminée (après que le nœud a quitté le mode de maintenance). L’extension du nom de fichier doit être .ps1 et la longueur totale du chemin d’accès et du nom de fichier ne doit pas excéder 260 caractères. Nous vous recommandons, à titre de meilleure pratique, de placer le script sur un disque dans le stockage du cluster ou sur un partage de fichiers réseau hautement disponible pour garantir qu’il est toujours accessible à tous les nœuds de cluster. Si le script est situé sur un partage de fichiers réseau, assurez-vous de configurer le partage avec l’autorisation de lecture pour le groupe Tout le monde et limitez l’accès en écriture pour empêcher toute falsification des fichiers par des utilisateurs non autorisés. Si vous spécifiez un script postérieur à la mise à jour, assurez-vous que des paramètres tels que les limites de temps (par exemple, StopAfter) sont configurés pour permettre l’exécution correcte du script. Ces limites couvrent la totalité du processus d’exécution des scripts et d’installation des mises à jour, et pas seulement le processus d’installation des mises à jour. |
| ConfigurationName | Ce paramètre n’a d’effet que si vous exécutez des scripts. Si vous spécifiez un script antérieur ou postérieur à la mise à jour sans indiquer de paramètre ConfigurationName, la configuration de la session par défaut pour PowerShell (Microsoft.PowerShell) est utilisée. |
Spécifie la configuration de la session PowerShell qui définit la session dans laquelle les scripts (spécifiés par PreUpdateScript et PostUpdateScript) sont exécutés, et peut limiter les commandes susceptibles d’être exécutées. |
| CauPluginName | Microsoft.WindowsUpdatePlugin | Plug-in que vous configurez avec la Mise à jour adaptée aux clusters à utiliser pour afficher un aperçu des mises à jour ou effectuer une exécution de mise à jour. Pour plus d’informations, voir Fonctionnement des plug-ins de mise à jour adaptée aux clusters. |
| CauPluginArguments | Aucun | Ensemble de paires de type nom=valeur (arguments) pour le plug-in de mise à jour à utiliser ; par exemple : Domain=Domain.local Ces paires nom=valeur doivent être significatives pour le plug-in que vous spécifiez dans CauPluginName. Pour spécifier un argument à l’aide de l’interface utilisateur de la mise à jour adaptée aux clusters, tapez le nom, appuyez sur la touche Tab, puis tapez la valeur correspondante. Appuyez à nouveau sur la touche Tab pour fournir l’argument suivant. Chaque nom et chaque valeur sont automatiquement séparés par un signe égal (=). Plusieurs paires sont automatiquement séparées par des points-virgules. Pour le plug-in par défaut Microsoft.WindowsUpdatePlugin, aucun argument n’est nécessaire. Toutefois, vous pouvez spécifier un argument facultatif, par exemple pour spécifier une chaîne de requête standard émise par l’Agent de mise à jour automatique Windows Update pour filtrer l’ensemble des mises à jour appliquées par le plug-in. Pour un nom, utilisez QueryString, et pour une valeur, placez la totalité de la requête entre guillemets. Pour plus d’informations, voir Fonctionnement des plug-ins de mise à jour adaptée aux clusters. |
Options que vous spécifiez lorsque vous demandez une exécution de mise à jour
Le tableau suivant répertorie les options (autres que celles présentes dans un profil d’exécution de mise à jour) que vous pouvez spécifier lorsque vous demandez une exécution de mise à jour. Pour plus d’informations sur les options que vous pouvez définir dans un profil d’exécution de mise à jour, voir le tableau précédent.
| Option | Valeur par défaut | Détails |
|---|---|---|
| Nom du cluster | Aucun Remarque : Cette option doit être définie uniquement lorsque l’interface utilisateur de la mise à jour adaptée aux clusters n’est pas exécutée sur un nœud de cluster de basculement ou quand vous voulez faire référence à un cluster de basculement différent de l’endroit où l’interface utilisateur de la mise à jour adaptée aux clusters est exécutée. |
Nom NetBIOS du cluster sur lequel effectuer l’exécution de mise à jour. |
| Informations d'identification | Informations d’identification de compte en cours | Informations d’identification administratives du cluster cible sur lequel l’exécution de mise à jour sera effectuée. Il est possible que vous disposiez déjà des informations d’identification requises si vous démarrez l’interface utilisateur de la mise à jour adaptée aux clusters (ou ouvrez une session PowerShell, si vous utilisez les applets de commande PowerShell de la mise à jour adaptée aux clusters) à partir d’un compte avec des droits d’administrateur et autorisations sur le cluster. |
| NodeOrder | Par défaut, la mise à jour adaptée aux clusters démarre avec le nœud possédant le plus petit nombre de rôles en cluster, puis progresse vers le nœud ayant le deuxième plus petit nombre de rôles, etc. | Noms des nœuds de cluster dans l’ordre où ils devraient être mis à jour (si possible). |
Utiliser des profils d’exécution de mise à jour
Chaque exécution de mise à jour peut être associée à un profil d’exécution de mise à jour spécifique. Le profil d’exécution de mise à jour par défaut est stocké dans le dossier %windir%\cluster. Si vous utilisez l’interface utilisateur de la mise à jour adaptée aux clusters en mode de mise à jour à distance, vous pouvez spécifier un profil d’exécution de mise à jour au moment de l’application des mises à jour ou vous pouvez utiliser le profil d’exécution de mise à jour par défaut. Si vous utilisez la mise à jour adaptée aux clusters en mode de mise à jour automatique, vous pouvez importer les paramètres à partir d’un profil d’exécution de mise à jour spécifié lorsque vous configurez les options de mise à jour automatique. Dans les deux cas, vous pouvez remplacer les valeurs affichées pour les options d’exécution de mise à jour en fonction de vos besoins. Si vous le souhaitez, vous pouvez enregistrer les options d’exécution de mise à jour en tant que profil d’exécution de mise à jour sous le même nom de fichier ou sous un autre nom de fichier. La prochaine fois que vous appliquez des mises à jour ou configurez les options de mise à jour automatique, la mise à jour adaptée aux clusters sélectionne automatiquement le profil d’exécution de mise à jour précédemment sélectionné.
Vous pouvez modifier un profil d’exécution de mise à jour existant ou en créer un nouveau en sélectionnant Créer ou modifier un profil d’exécution de mise à jour dans l’interface utilisateur de la Mise à jour adaptée aux clusters.
Voici quelques remarques importantes sur l’utilisation de la mise à jour des profils d’exécution :
- Un profil d’exécution de mise à jour ne stocke pas d’informations spécifiques aux clusters telles que les informations d’identification d’administration. Si vous utilisez la mise à jour adaptée aux clusters en mode de mise à jour automatique, le profil d’exécution de mise à jour ne stocke pas non plus les informations de planification de mise à jour automatique. Il est ainsi possible de partager un profil d’exécution de mise à jour entre tous les clusters de basculement d’une classe spécifiée.
- Si vous configurez les options de mise à jour automatique en utilisant un profil d’exécution de mise à jour et que vous modifiez par la suite le profil avec différentes valeurs pour les options d’exécution de mise à jour, la configuration de mise à jour automatique n’est pas automatiquement modifiée. Pour appliquer les nouveaux paramètres d’exécution de mise à jour, vous devez à nouveau configurer les options de mise à jour automatique.
- L’éditeur de profil d’exécution ne prend malheureusement pas en charge les chemins d’accès aux fichiers qui incluent des espaces, comme C:\Program Files. Pour contourner ce problème, stockez vos scripts de pré et de post-mise à jour dans un chemin qui n’inclut pas d’espaces, ou utilisez PowerShell exclusivement pour gérer les profils d’exécution, en plaçant des guillemets autour du chemin lors de l’exécution d’Invoke-CauRun.
Commandes Windows PowerShell équivalentes
Vous pouvez importer les paramètres à partir d’un profil d’exécution de mise à jour lorsque vous exécutez l’applet de commande Invoke-CauRun, Add-CauClusterRole ou Set-CauClusterRole.
L’exemple suivant effectue une analyse et une exécution de mise à jour entière sur le cluster nommé CONTOSO-FC1 en utilisant les options d’exécution de mise à jour qui sont spécifiées dans C:\Windows\Cluster\DefaultParameters.xml. Les valeurs par défaut sont utilisées pour les paramètres d’applet de commande restants.
$MyRunProfile = Import-Clixml C:\Windows\Cluster\DefaultParameters.xml
Invoke-CauRun –ClusterName CONTOSO-FC1 @MyRunProfile
À l’aide d’un profil d’exécution de mise à jour, vous pouvez mettre à jour un cluster de basculement de façon répétée avec des paramètres cohérents pour la gestion des exceptions, des durées déterminées et d’autres paramètres de fonctionnement. Dans la mesure où ces paramètres sont en général spécifiques à une classe de clusters de basculement (par exemple, « Tous les clusters Microsoft SQL Server » ou « Mes clusters critiques »), vous pouvez nommer chaque profil d’exécution de mise à jour en fonction de la classe de clusters de basculement avec laquelle il sera utilisé. En outre, vous pouvez gérer le profil d’exécution de mise à jour sur un partage de fichiers qui est accessible à tous les clusters de basculement d’une classe spécifique dans votre département informatique.