Guide de mise à jour de version VergeOS

Procédure opérationnelle standard pour mettre à jour en toute sécurité un système VergeOS vers une nouvelle version ponctuelle, y compris la préparation, l'étape de staging, l'exécution, la vérification après mise à jour et les conseils de retour arrière.

Ce guide fournit les meilleures pratiques pour mettre à jour en toute sécurité un système VergeOS vers une nouvelle version ponctuelle. Il met l’accent sur la sécurité des données et la résilience du système grâce à une approche méthodique.

Vue d'ensemble

La mise à jour de votre système VergeOS nécessite une planification et une exécution minutieuses afin de garantir une perturbation minimale de vos services. Ce guide décompose le processus en grandes phases :

1. Préparation - Étapes à suivre avant votre fenêtre de maintenance planifiée
2. Vérification préalable à la mise à jour - Vérifications finales immédiatement avant de commencer la mise à jour
3. Exécution de la mise à jour - Le processus d’installation de la mise à jour
4. Vérification après la mise à jour - S’assurer que la mise à jour a réussi

Exigences spécifiques à l'environnement

Ce guide présente les meilleures pratiques générales. Vous devrez peut-être adapter ces étapes à votre environnement et à vos exigences spécifiques.

Prérequis

• Accès administrateur au système VergeOS
• Accès IPMI à tous les nœuds du cluster
• Connectivité réseau pour les téléchargements de mise à jour
• Temps estimé : 1 à 2 heures selon la taille du cluster et la complexité de la mise à jour

Phase de préparation

Effectuez ces étapes bien avant votre fenêtre de maintenance planifiée :

Préparation du système

• Assurez-vous que la rétention des instantanés du système est suffisante pour un éventuel retour arrière
• Définissez des critères précis de réussite et de vérification pour vos charges de travail
• Identifier les cohortes de VM, services, etc. requises pour votre cas d’utilisation particulier

Exemples de cas d’utilisation

La VDI peut comporter plusieurs images distinctes ou pools de ressources. La VPS peut se concentrer davantage sur les fonctionnalités réseau et la connectivité.

• Cartographier les événements système et invités sensibles au temps qui doivent continuer à fonctionner

Documentation et planification

• Mettre à jour la documentation de la plateforme avec la fenêtre de maintenance planifiée
• Examiner les mises à jour/mises à niveau synergiques qui pourraient devoir être exécutées

  • Évitez de combiner des mises à jour inutiles
• Consultez les notes de version et prévoyez tout impact spécifique
• Documenter la configuration actuelle du système comme référence pour le retour arrière
• Planifiez le calendrier de communication pour les utilisateurs concernés

Vérification des ressources

• Vérifiez l’utilisation des ressources du cluster

  • Assurez-vous que votre système dispose de suffisamment de ressources libres pour perdre son plus gros nœud
• Confirmer les chemins réseau entre les hôtes

  • Sur chaque nœud : Diagnostics du nœud -> Configuration Fabric (tous les chemins de tous les nœuds doivent être « confirmed:true »)
• Si la redondance réseau n’a pas été testée récemment, planifiez un test avant la mise à jour
• Confirmer l’accès IPMI à tous les hôtes via une méthode permettant l’accès à la console en cas d’urgence

Préparation de la mise à jour

1. Dans VergeOS, accédez à Système > Mises à jour
2. Cliquez sur Rechercher des mises à jour
3. Téléchargez la mise à jour (elle ne démarrera pas tant que vous n’aurez pas cliqué sur « Installer »)
4. Enregistrer la version actuelle et la version cible pour la documentation

Vérification préalable à la mise à jour

Effectuez ces vérifications le jour de la maintenance planifiée, avant de commencer la mise à jour :

Vérification de l'état actuel

• Confirmer que la version en cours d’exécution est bien celle attendue
• Vérifier les journaux pour détecter les erreurs récentes

  • Noter tout problème non critique
  • Annuler si des erreurs critiques sont détectées
• Vérifier que la disponibilité des ressources répond aux exigences N+1

  • Confirmer que l’utilisation de la RAM permet aux charges de travail de s’exécuter avec un nœud hors ligne
• Vérifier que les snapshots système sont récents et disponibles

  • Définir l’expiration du snapshot le plus récent à plusieurs jours dans le futur pour une rétention supplémentaire
• Confirmer que la synchronisation multi-site est fonctionnelle et à jour
• Vérifiez que tous les niveaux vSAN sont en bon état (statut vert)
• Confirmez qu’aucun nœud n’attend un redémarrage
• Enregistrer la base de référence des performances du système pour la comparaison après la mise à jour

Vérification de la mise à jour

• Confirmez votre mise à jour préparée dans Système > Mises à jour
• Rechercher à nouveau des mises à jour

  • S’il existe une autre mise à jour, évaluez-la soigneusement avant de continuer
• Vérifier que l’espace disque est suffisant pour le processus de mise à jour
• Confirmer que tous les nœuds sont accessibles et réactifs

Phase d'exécution

Installation de la mise à jour

Le processus de mise à jour proprement dit :

1. Accédez à Système > Mises à jour
2. Cliquez sur Installation pour commencer le processus de mise à jour
3. Surveiller le nœud 1 pendant qu’il :

   • Se met automatiquement en mode maintenance
   • Redémarre et applique la mise à jour
   • Revient en service
4. Observer les nœuds suivants pendant que le système continue à mettre à jour et à redémarrer les nœuds
5. Surveiller les charges de travail et l’utilisation des ressources système tout au long du processus
6. Suivre la progression - chaque nœud se mettra à jour séquentiellement pour maintenir la disponibilité du service

Suivi de la mise à jour

Pendant le processus de mise à jour, vous pouvez suivre la progression dans la section Système > Mises à jour. Chaque nœud affichera son statut actuel et sa progression à travers les étapes de la mise à jour.

Ne pas interrompre

N’éteignez pas les nœuds et n’interrompez pas le processus de mise à jour une fois qu’il a commencé. Laissez chaque nœud terminer naturellement son cycle de mise à jour.

Vérification après la mise à jour

Une fois la mise à jour terminée, vérifiez que le système fonctionne correctement :

Confirmation de la version

• Confirmer la version attendue dans Système > Mises à jour

  • Vérifiez que les paquets suivants sont à la version attendue :

    • osm (données OpenStreetMap)
    • yb (pile logicielle cloud Verge.io)
    • yb-help (aide et documentation intégrées)
    • ybos (système d’exploitation Verge.io)

Vérifications de l'état du système

• Confirmer que la tuile « Nodes Updated » dans Système > Mises à jour est verte et que tous les nœuds ont terminé
• S’assurer que tous les niveaux vSAN affichent un statut vert
• Vérifier que tous les nœuds affichent un statut vert « Running »

  • Confirmer que les nœuds n’ont aucun redémarrage en attente
• Testez/confirmez les systèmes invités selon les besoins et conformément à vos critères de réussite
• Prendre un snapshot manuel avec plusieurs jours de rétention
• Vérifiez les journaux pour détecter tout événement nouveau ou inattendu
• Vérifiez tous les critères de réussite définis dans vos étapes de préparation
• Confirmer que les performances du système correspondent à la base de référence ou la dépassent

Tests de fonctionnalité

• Tester les opérations critiques des VM (démarrage, arrêt, migration)
• Vérifier la connectivité et les performances du réseau
• Confirmer que les opérations de sauvegarde et de snapshot fonctionnent
• Tester toute intégration ou automatisation personnalisée

Dépannage

Problèmes courants

Le processus de mise à jour se bloque sur un nœud

• Vérifier l’accessibilité du nœud via IPMI
• Consulter les journaux système pour les messages d’erreur
• Vérifier la connectivité réseau vers le nœud bloqué
• Contacter le support si le nœud reste non réactif

Incohérence de version après la mise à jour

• Accorder du temps supplémentaire pour que tous les composants se synchronisent
• Vérifier si des installations de paquets ont échoué
• Vérifiez la connectivité réseau entre les nœuds
• Consulter les journaux de mise à jour pour des erreurs spécifiques

Dégradation des performances après la mise à jour

• Comparer avec la base de référence d’avant mise à jour
• Vérifier l’apparition de nouvelles contraintes de ressources
• Examiner l’état et les performances des niveaux vSAN
• Surveiller pendant 24 à 48 heures pour établir une nouvelle base de référence

Les VM ne parviennent pas à démarrer après la mise à jour

• Vérifier la compatibilité de la configuration des VM
• Vérifier l’accessibilité du niveau de stockage
• Consulter les journaux spécifiques à la VM pour détecter des erreurs
• Tester individuellement les opérations des VM

Procédure de retour arrière

Considérations sur le retour arrière

Si des problèmes surviennent, l’approche la plus sûre consiste à faire une pause, à enquêter sur le comportement inattendu, puis à reprendre avec une compréhension claire du problème. Les mises à jour VergeOS sont conçues pour être compatibles vers l’avant, et le retour arrière n’est pas toujours possible.

Si des problèmes surviennent

1. Documenter le problème en détail avec des captures d’écran et des journaux
2. Isoler le problème - déterminer s’il affecte tous les nœuds ou seulement des composants spécifiques
3. Contactez le support avant d’essayer toute procédure de retour arrière
4. Préserver l’état du système pour l’analyse de dépannage
5. Suivre les recommandations du support pour la résolution ou les procédures de retour arrière

Étapes suivantes

Après la réussite de la mise à jour :

• Mettre à jour la documentation du système avec les nouvelles informations de version
• Planifier une surveillance de routine pour garantir la stabilité
• Examiner les nouvelles fonctionnalités ou modifications introduites dans la mise à jour
• Planifier les futures mises à jour en fonction des calendriers de publication
• Mettre à jour les procédures de sauvegarde et de reprise après sinistre si nécessaire

Support d'urgence

Si vous rencontrez des problèmes avec votre mise à jour logicielle VergeOS, veuillez contacter notre équipe support pour une assistance immédiate.