Appliquer les mises à jour à l’aide de la CLI xe

Appliquez les mises à jour à vos hôtes et pools XenServer 8 à l’aide de l’interface de ligne de commande xe.

Pour recevoir les mises à jour, vos hôtes XenServer ont besoin d’un accès Internet. Si vos hôtes sont protégés par un pare-feu, assurez-vous qu’ils ont accès aux sous-domaines de ops.xenserver.com. Pour plus d’informations, consultez la section Exigences en matière de connectivité.

Procédez comme suit pour pouvoir mettre à jour vos pools XenServer :

1. Installez ou effectuez une mise à niveau vers XenServer 8.

2. Configurez les mises à jour pour votre pool.

3. Synchronisez les nouvelles mises à jour pour votre pool.

4. Comprenez les catégories de directives et mettez à jour les tâches.

5. Consultez les mises à jour disponibles pour votre pool.

6. Appliquez les mises à jour à votre pool.

Configurer les mises à jour pour votre pool

Avant de pouvoir appliquer des mises à jour à vos hôtes et pools XenServer, vous devez configurer les mises à jour des hôtes en abonnant votre pool ou votre hôte à un canal de mise à jour. Ces chaînes contrôlent la rapidité avec laquelle vous pouvez accéder aux mises à jour disponibles sur le réseau de mise à disposition de contenu (CDN).

Les deux canaux de mise à jour sont les suivants :

• Accès anticipé : idéal pour les environnements de test
• Normal : recommandé pour les environnements de production

Après avoir inscrit votre pool à l’un des canaux de mise à jour, votre pool se synchronise régulièrement et automatiquement avec le canal de mise à jour. Vous pouvez également synchroniser manuellement votre pool avec le canal de mise à jour. Cette action de synchronisation télécharge toutes les mises à jour disponibles vers le coordinateur du pool. Vous pouvez ensuite appliquer les mises à jour téléchargées à l’aide de l’interface de ligne de commande xe.

1. Créez et activez le canal de mise à jour en accès anticipé pour votre pool :

   pool_uuid=$(xe pool-list --minimal)
   
   base_binary_url="https://repo.ops.xenserver.com/xs8/base"
   base_source_url="https://repo-src.ops.xenserver.com/xs8/base"
   base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false)
   
   update_binary_url="https://repo.ops.xenserver.com/xs8/earlyaccess"
   update_source_url="https://repo-src.ops.xenserver.com/xs8/earlyaccess"
   update_repo_uuid=$(xe repository-introduce name-label=early_access_repo name-description="Early Access" binary-url=<update_binary_url> source-url=<update_source_url> update=true)
   
   xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid>
   <!--NeedCopy-->
   

   Vous pouvez également créer et activer le canal de mise à jour normal pour votre pool :

   pool_uuid=$(xe pool-list --minimal)
   
   base_binary_url="https://repo.ops.xenserver.com/xs8/base"
   base_source_url="https://repo-src.ops.xenserver.com/xs8/base"
   base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false)
   
   update_binary_url="https://repo.ops.xenserver.com/xs8/normal"
   update_source_url="https://repo-src.ops.xenserver.com/xs8/normal"
   update_repo_uuid=$(xe repository-introduce name-label=normal name-description="Normal" binary-url=<update_binary_url> source-url=<update_source_url> update=true)
   
   xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid>
   <!--NeedCopy-->
   

2. Récupérez la liste des UUID du référentiel actuellement activés :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=repositories
   <!--NeedCopy-->
   

3. À l’aide de l’UUID du référentiel, affichez plus de détails sur un référentiel en particulier :

   xe repository-param-list uuid=<UUID>
   <!--NeedCopy-->
   

4. (Facultatif) Configurez et activez un serveur proxy de connexion HTTP qui est utilisé pour la communication entre l’hôte et le CDN public qui héberge les référentiels :

   xe pool-configure-repository-proxy proxy-url=<http://proxy.example.com> proxy-username=<proxy-user> proxy-password=<proxy-password>
   <!--NeedCopy-->
   

   Désactivez la configuration du serveur proxy :

   xe pool-disable-repository-proxy
   <!--NeedCopy-->
   

   Afficher la configuration du serveur proxy :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-url
   xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-username
   <!--NeedCopy-->
   

Synchronisez les nouvelles mises à jour pour votre pool

Activez la synchronisation automatique de votre pool avec le canal de mise à jour en configurant un calendrier de synchronisation. Vous pouvez planifier une synchronisation quotidienne ou hebdomadaire un certain jour de la semaine. La synchronisation de votre pool avec le canal de mise à jour télécharge toutes les mises à jour disponibles vers le coordinateur du pool et vous pouvez ensuite appliquer toutes les mises à jour téléchargées à votre pool.

1. Configurez votre pool pour qu’il se synchronise quotidiennement :

   xe pool-configure-update-sync update-sync-frequency=daily update-sync-day=0
   xe pool-set-update-sync-enabled value=true
   <!--NeedCopy-->
   

   Vous pouvez également configurer votre pool pour qu’il soit synchronisé chaque semaine :

   xe pool-configure-update-sync update-sync-frequency=weekly update-sync-day=1 (# 0 is Sunday, 1 is Monday, etc)
   xe pool-set-update-sync-enabled value=true
   <!--NeedCopy-->
   

2. Consultez votre configuration de synchronisation :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-frequency
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-day
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-enabled
   <!--NeedCopy-->
   

3. Obtenez l’horodatage de la dernière synchronisation réussie de votre pool avec le canal de mise à jour :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get param-name=last-update-sync uuid=<pool_uuid>
   <!--NeedCopy-->
   

Vous pouvez également synchroniser manuellement votre pool XenServer avec le canal de mise à jour :

pool_uuid=$(xe pool-list --minimal)
update_checksum=$(xe pool-sync-updates uuid=<pool_uuid> --minimal)
<!--NeedCopy-->

update_checksum est un identifiant unique qui indique le niveau des mises à jour installées. Il change chaque fois que de nouvelles mises à jour sont mises à disposition dans le CDN public et est ensuite utilisé lors de l’application des mises à jour à votre pool afin de garantir que vous appliquez toujours les dernières mises à jour disponibles. update_checksum peut également fournir des informations utiles si vous devez contacter le support technique.

Remarque :

Après la synchronisation, appliquez les mises à jour à votre pool dès que possible pour bénéficier des dernières mises à jour.

Si vous désignez un nouveau coordinateur de pool après la synchronisation mais avant d’appliquer les mises à jour aux hôtes du pool, vous devez effectuer une nouvelle synchronisation avec le nouveau coordinateur de pool avant de pouvoir mettre à jour le pool.

Ne synchronisez pas votre pool XenServer lorsque celui-ci est en cours de mise à jour.

Comprendre les catégories de directives et mettre à jour les tâches

Certaines tâches (telles que l’évacuation ou le redémarrage de vos hôtes) peuvent être nécessaires avant et après l’application des mises à jour à votre pool. Parfois, aucune tâche de mise à jour n’est requise.

Catégories de directives

XenServer essaie de minimiser les perturbations que ces tâches peuvent entraîner pour vos machines virtuelles en les classant dans les catégories suivantes : obligatoire, recommandée, efficacité totale et correctif actif. Ces catégories vous permettent de déterminer si une tâche de mise à jour susceptible d’entraîner des interruptions ou des perturbations mineures pour vos hôtes ou vos machines virtuelles est nécessaire compte tenu de votre environnement et de votre profil de risque.

Les tâches des mises à jour peuvent être répertoriées dans plusieurs de ces catégories. Par exemple, une mise à jour peut nécessiter le redémarrage de l’hôte pour que la mise à jour soit pleinement efficace, mais il est recommandé de redémarrer la pile d’outils pour tirer le meilleur parti de la mise à jour tout en limitant les perturbations potentielles pour le pool.

Au cours du processus de mise à jour, vous pouvez choisir d’exécuter l’un des trois niveaux de tâches suivants :

1. Mandatory
2. Obligatoire + Recommandé
3. Obligatoire + Recommandé + Pleine efficacité

Mandatory

Les tâches obligatoires doivent être effectuées après une mise à jour, sinon le système risque de tomber en panne lors de l’exécution. Ces actions sont nécessaires pour activer les correctifs critiques et garantir la sécurité et la stabilité de votre environnement. Vous ne pouvez pas désactiver les tâches obligatoires.

Recommandé

Les tâches recommandées sont celles que nous vous recommandons d’effectuer pour tirer parti de la majorité des fonctionnalités et des correctifs fournis dans les mises à jour. Si vous choisissez de ne pas effectuer ces tâches maintenant, elles sont répertoriées dans les tâches de mise à jour en attente pour le pool, l’hôte ou la machine virtuelle applicable.

Pourquoi effectuer les tâches recommandées :

• Ces tâches sont celles qui garantissent un environnement XenServer stable et sécurisé.

Pourquoi ne pas participer aux tâches recommandées :

• Après avoir examiné les informations détaillées relatives aux mises à jour, vous estimez que le risque de ne pas appliquer intégralement ces mises à jour est acceptable pour le moment.
• Les tâches recommandées perturbent désormais vos machines virtuelles de manière indésirable.

Efficacité totale

Des tâches d’efficacité complètes sont nécessaires pour tirer parti de la mise à jour correspondante. Les mises à jour associées à des tâches d’efficacité totale ne concernent généralement que les utilisateurs utilisant certains matériels ou utilisant des fonctionnalités spécifiques.

Consultez les informations de mise à jour pour savoir si ces tâches sont requises pour votre environnement. Si vous choisissez de ne pas effectuer ces tâches maintenant, elles sont répertoriées dans les tâches en attente pour le pool, l’hôte ou la machine virtuelle concerné.

Pourquoi effectuer les tâches de pleine efficacité :

• Les mises à jour qui comportent des tâches d’efficacité totale sont pertinentes pour votre matériel, votre environnement ou votre configuration.

Pourquoi ne pas participer aux tâches de pleine efficacité :

• Les mises à jour qui contiennent des conseils d’efficacité complets ne sont pas pertinentes pour votre matériel, votre environnement ou votre configuration.
• Les tâches d’efficacité totale perturbent désormais vos machines virtuelles de manière indésirable.
• Vous n’avez pas besoin des avantages de ces mises à jour pour le moment.

Si les tâches d’efficacité totale s’appliquent à votre environnement, mais que vous avez choisi de les reporter, prévoyez de les exécuter pendant une période de maintenance appropriée afin de maintenir la stabilité de votre environnement.

Patchs en direct

Les mises à jour de certains composants peuvent inclure un correctif actif. L’application d’un correctif actif à vos hôtes dépend de la version du composant installé lors du dernier redémarrage des hôtes. Si une mise à jour peut être appliquée en tant que correctif actif à vos hôtes, le guide de mise à jour en direct remplace le guide recommandé.

Exemple :

Vous avez deux pools. Le pool A a été mis à jour à un niveau récent. Le pool B n’a pas été mis à jour depuis un certain temps. Nous publions une nouvelle mise à jour qui comporte la tâche de mise à jour recommandée « Redémarrer l’hôte » et la tâche de mise à jour des correctifs en direct « Redémarrer la pile d’outils ».

Dans le pool A, le patch live peut être appliqué à ces hôtes les plus récents. Le guide recommandé indique « Redémarrer la pile d’outils ». La tâche la moins perturbatrice du guide de mise à jour en direct l’emporte sur les conseils recommandés.

Dans le pool B, le patch actif ne peut pas être appliqué aux hôtes, car ils sont à un niveau plus ancien. Le guide recommandé indique « Redémarrer l’hôte ». Les recommandations restent applicables. Les directives relatives à la mise à jour en temps réel ne sont pas pertinentes dans ce cas.

Parfois, seuls certains des correctifs d’une mise à jour sont activés lorsque celle-ci est appliquée en tant que correctif actif. Consultez les détails de la mise à jour pour savoir si vous avez besoin de tous les correctifs contenus dans la mise à jour ou uniquement des correctifs activés par le correctif actif. Vous pouvez ensuite utiliser ces informations pour choisir d’exécuter ou non les tâches recommandées. Pour plus d’informations, voir Afficher les mises à jour disponibles pour votre pool.

Mettre à jour les tâches

Une ou plusieurs des tâches suivantes peuvent être requises lors de l’application d’une mise à jour. Tout type de tâche de mise à jour peut être répertorié dans n’importe quelle catégorie de directives.

Mettre à jour les tâches pour votre hôte

Vous n’effectuez cette tâche qu’avant d’appliquer les mises à jour et vous l’effectuez parfois dans le cadre de la tâche « Redémarrer l’hôte » :

Les tâches suivantes nécessitent des actions sur l’hôte mis à jour :

Afficher les tâches de mise à jour requises pour votre hôte

Consultez les tâches requises pour votre hôte avant et après l’application des mises à jour à l’aide des commandes suivantes.

Consultez la liste des tâches obligatoires pour votre hôte :

xe host-param-get param-name=pending-guidances uuid=<host UUID>
<!--NeedCopy-->

Consultez la liste des tâches recommandées pour votre hôte :

xe host-param-get param-name=pending-guidances-recommended uuid=<host UUID>
<!--NeedCopy-->

Obtenez une liste des tâches à pleine efficacité pour votre hôte :

xe host-param-get param-name=pending-guidances-full uuid=<host UUID>
<!--NeedCopy-->

Mettre à jour les tâches de votre machine virtuelle

Certaines mises à jour fournissent de nouvelles fonctionnalités à vos machines virtuelles. Ces mises à jour peuvent nécessiter les tâches suivantes sur vos machines virtuelles :

Afficher les tâches de mise à jour requises pour votre machine virtuelle

Obtenez la liste des tâches obligatoires pour votre machine virtuelle :

xe vm-param-get param-name=pending-guidances uuid=<VM UUID>
<!--NeedCopy-->

Consultez la liste des tâches recommandées pour votre machine virtuelle :

xe vm-param-get param-name=pending-guidances-recommended uuid=<VM UUID>
<!--NeedCopy-->

Obtenez une liste des tâches d’efficacité complète pour votre machine virtuelle :

xe vm-param-get param-name=pending-guidances-full uuid=<VM UUID>
<!--NeedCopy-->

Afficher les mises à jour disponibles pour votre pool

Avant d’installer les mises à jour, consultez les mises à jour disponibles pour votre pool et passez en revue les tâches de mise à jour requises. Pour plus d’informations sur les différentes tâches de mise à jour qui peuvent être requises pour une mise à jour, voir Comprendre les catégories de directives et les tâches de mise à jour.

Vérifiez les mises à jour disponibles pour un hôte en particulier

Vérifiez si des mises à jour sont disponibles pour un hôte en particulier :

xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID>
<!--NeedCopy-->

Cette commande indique yes si des mises à jour sont disponibles pour un hôte en particulier et no si aucune n’est disponible.

Vérifiez les mises à jour disponibles pour tous les hôtes

Vérifiez les mises à jour disponibles pour tous les hôtes en effectuant une requête GET sur le point de terminaison HTTP /updates.

Obtenez des mises à jour pour tous les hôtes à l’aide de l’utilitaire wget :

wget -O - --no-check-certificate https://<user name>:<password>@<coordinator IP address>/updates
<!--NeedCopy-->

Vous pouvez également utiliser la bibliothèque cliente HTTP :

HTTP GET
session_id: <XAPI session ID returned from login>
host_refs: <host XAPI reference>
<!--NeedCopy-->

La sortie renvoyée est au format JSON et contient les objets suivants :

• hosts : répertorie les mises à jour disponibles pour chaque hôte.

• updates : répertorie les détails des mises à jour disponibles.

• hash : update_checksum (utilisé pour garantir que vous appliquez toujours les dernières mises à jour disponibles).

Les objets hosts et updates contiennent également l’objet guidance qui se compose des clés suivantes :

• mandatory
• recommended
• full
• livepatch

Ces clés font référence aux différentes catégories de directives pour les tâches de mise à jour. Ils répertorient les tâches de mise à jour requises pour vos hôtes et vos machines virtuelles. Pour plus d’informations sur les différentes tâches qui peuvent être requises pour une mise à jour, voir Comprendre les catégories de directives et les tâches de mise à jour.

Appliquez des mises à jour à votre pool

Avant de commencer

• Assurez-vous que tous les hôtes de votre pool sont en ligne avant de procéder à la mise à jour du pool.

• Assurez-vous qu’aucune tâche de mise à jour obligatoire n’est en attente sur aucun hôte ou machine virtuelle. Toutes les tâches de mise à jour obligatoires en attente des mises à jour précédentes doivent être effectuées avant de commencer une nouvelle mise à jour du pool. Pour plus d’informations, consultez Afficher les tâches de mise à jour requises pour votre hôte et Afficher les tâches de mise à jour requises pour votre machine virtuelle.

• Désactivez la haute disponibilité (HA) si elle est activée :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-ha-disable uuid=<pool_uuid>
   <!--NeedCopy-->
  

• Désactivez Workload Balancing (WLB) s’il est activé :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-set wlb-enabled=false uuid=<pool_uuid>
   <!--NeedCopy-->
  

Installer les mises à jour

Pour effectuer une mise à jour de votre pool, vous devez appliquer des mises à jour sur chaque hôte du pool, en commençant par le coordinateur du pool. Suivez ces étapes, en commençant par le coordinateur de pool :

1. Désactivez l’hôte :

   xe host-disable uuid=<host UUID>
   <!--NeedCopy-->
   

2. Si l’une des tâches de mise à jour requises pour la mise à jour est « Évacuer l’hôte » ou « Redémarrer l’hôte », évacuez l’hôte :

   xe host-evacuate uuid=<host UUID>
   <!--NeedCopy-->
   

   Si vous ne parvenez pas à migrer une machine virtuelle vers d’autres hôtes pendant l’évacuation de l’hôte, arrêtez ou suspendez la machine virtuelle.

3. Appliquez les mises à jour à l’hôte :

   xe host-apply-updates uuid=<host UUID> hash=<update_checksum>
   <!--NeedCopy-->
   

4. Obtenez la liste des tâches de mise à jour de l’hôte requises. Pour plus d’informations, voir Mettre à jour les tâches de votre hôte.

   Exécutez les tâches de mise à jour de l’hôte dans la liste dans l’ordre suivant :

   1. Redémarrer la pile d’outils (peut être ignoré s’il y a un « Redémarrer l’hôte » à effectuer)
   2. Redémarrer l’hôte

5. Pour chaque machine virtuelle en cours d’exécution sur l’hôte, obtenez une liste des tâches de mise à jour de la machine virtuelle requises. Pour plus d’informations, consultez la section Tâches de mise à jour pour votre machine virtuelle.

   Exécutez les tâches de mise à jour de la machine virtuelle dans la liste dans l’ordre suivant :

   1. Redémarrer le modèle de l’appareil (peut être ignoré s’il y a un « Redémarrer la machine virtuelle » à effectuer)
   2. Redémarrer la machine virtuelle

6. Activez l’hôte s’il est toujours désactivé :

   xe host-enable uuid=<host UUID>
   <!--NeedCopy-->
   

7. Pour chaque machine virtuelle que vous avez migrée vers un autre hôte host-evacuate avant la mise à jour de l’hôte, obtenez une liste des tâches de mise à jour. Pour plus d’informations, consultez la section Tâches de mise à jour pour votre machine virtuelle.

   Si « Redémarrer la machine virtuelle » figure dans la liste des tâches de mise à jour, arrêtez la machine virtuelle et démarrez-la sur l’hôte actuellement mis à jour. Sinon, migrez de nouveau la machine virtuelle vers l’hôte actuellement mis à jour.

8. Redémarrez ou redémarrez les machines virtuelles que vous avez arrêtées ou suspendues avant d’appliquer les mises à jour.

9. Afficher l’état de mise à jour de l’hôte :

   xe host-param-get param-name=last-software-update uuid=<host UUID>
   xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID>
   xe host-param-get param-name=last-update-hash uuid=<host UUID>
   <!--NeedCopy-->
   

Répétez les étapes ci-dessus pour mettre à jour tous les hôtes de votre pool.

Après avoir mis à jour vos hôtes

Après avoir mis à jour chaque hôte de votre pool, effectuez les tâches de mise à jour restantes.

1. Pour chaque machine virtuelle de votre pool, obtenez une liste des tâches de mise à jour. Pour plus d’informations, consultez la section Tâches de mise à jour pour votre machine virtuelle.

   Si « Redémarrer la machine virtuelle » figure dans la liste des tâches de mise à jour, exécutez-la.

2. Activez HA si vous l’avez désactivée avant d’appliquer les mises à jour :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-ha-disable uuid=<pool_uuid>
   <!--NeedCopy-->
   

3. Activez WLB si vous l’avez désactivé avant d’appliquer les mises à jour :

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-set wlb-enabled=true uuid=<pool_uuid>
   <!--NeedCopy-->
   

4. Si vous avez choisi d’effectuer uniquement les tâches de mise à jour obligatoires requises pour la mise à jour d’un pool, les tâches de mise à jour qui n’ont pas été effectuées sont ajoutées à la liste des tâches de mise à jour en attente requises pour vos hôtes. Pour consulter cette liste et effectuer ces tâches, voir Mettre à jour les tâches pour votre hôte.