8. Procédure de montée de version de V101 à V102

8.1. Prérequis

Pour déployer la mise à jour V2.5.3.102 :

  • le GCenter devra être en version V2.5.3.101-HF3 ou supérieure

  • le GCap devra être en version V2.5.3.105 ou supérieure

  • si une configuration LDAP existe en v2.5.3.101, refaire cette configuration en v2.5.3.101 avant la migration vers la V2.5.3.102

    Important

    Pour la mise à jour vers la V2.5.3.102, il est impératif d'utiliser le package suivant afin d'éviter certains problèmes de migration: https://update.gatewatcher.com/upgrade/2.5.3.102/gcenter/gcenter_2.5.3.102-8595~prod-hf2.gwp

  • si des questions se posent sur ces éléments, veuillez contacter le support technique de Gatewatcher.

    Important

    Il est fortement recommandé d'avoir une connexion de type iDRAC afin de pouvoir se connecter post-mise à jour si un problème survient pendant le processus.

    Important

    Avant de procéder à la mise à jour, il est fortement recommandé de procéder à une sauvegarde de la configuration du GCenter dans le menu `Administrators > Backup / Restore > Operations` et de sauvegarder le fichier sur un serveur externe dans un répertoire indiquant la version actuelle du GCenter (exemple: 2.5.3.102-XXXX-HFX).

8.2. Données conservées

L'ensemble de la configuration du GCenter est conservée.
Les données (métadonnées et alertes) devront être migrées au préalable avec un hotfix spécifique (se référer à la procédure d'installation avec conservation des données ci-dessous).

Important

Une fois migrées, les données seront uniquement disponibles dans le menu `Discover` de l'interface Kibana (Hunting).

8.3. Procédure d'installation avec conservation des données

  1. Vérifier que les sondes GCap sont en version V2.5.3.105 ou supérieure, sinon se référer à la procédure de mise à jour suivante : https://releases.gatewatcher.com/fr/gcap/2.5.3/105/8_upgrade_procedure.html
  2. Télécharger la nouvelle version du GCenter disponible et le sha256 associé sur la plate-forme https://update.gatewatcher.com/upgrade/ (répertoire 2.5.3.102).
  3. Faire la vérification de l'image avec le sha256 associé.
  4. Télécharger le hotfix permettant de préparer les données avant migration : https://update.gatewatcher.com/hotfix/2.5.3.101/gcenter/gcenter_2.5.3.101_hf_data-preparation-for-2.5.3.102.gwp et le sha256 associé.
  5. Faire la vérification de l'image avec le sha256 associé.
  6. Se connecter à la WebUI du GCenter et aller dans le menu `Administrators > GUM > Hotfix`.
  7. Dans la section `Uploading a new hotfix package`, cliquer sur le bouton `Choisir un fichier`, sélectionner le hotfix précédemment téléchargé puis cliquer sur `Send hotfix`.
  8. Toujours dans la WebUI du GCenter, aller dans le menu `Administrators > GUM > Upgrade`.
  9. Dans la section `Upload an upgrade`, cliquer sur le bouton `Choisir un fichier`, sélectionner la nouvelle version du GCenter précédemment téléchargée puis cliquer sur `Submit`.
  10. Se connecter en SSH sur le GCap avec le compte setup.
  11. Stopper le moteur de détection avec la commande suivante : `monitoring-engine stop`.
  12. Modifier le mode de compatibilité avec la commande suivante : `set compatibility-mode 2.5.3.102+`.
  13. Démarrer le moteur de détection avec la commande suivante : `monitoring-engine start`.
  14. Retourner dans la WebUI du GCenter, dans le menu `Administrators > GUM > Hotfix`.
  15. Dans la section `Saved package list`, au niveau du hotfix précédemment envoyé, cliquer sur le bouton `Apply`.
  16. Une fois appliqué, se connecter en SSH sur le GCenter avec le compte setup.
  17. Aller dans le nouveau menu disponible `data persistence`.
  18. Dans le menu `Warning data preparation` lire attentivement l'avertissement puis cliquer sur `Continue (reversible)` pour continuer.
    Le menu suivant offre la possibilité de supprimer les données (index) les plus anciennes afin d'accélérer le processus de migration et que les données migrées puissent être stockées dans la nouvelle architecture.

    Important

    Il se peut que certaines données présentes soient plus anciennes que la durée de rétention configurée.
    Ces données seront donc automatiquement supprimées une fois la mise à jour en V2.5.3.102 effectuée.
    Il est donc important de supprimer manuellement ces données à cette étape.
    Pour vérifier la durée de conservation configurée, il faut se connecter à la WebUI du GCenter et aller dans le menu `Administrators > GCenter > Configuration > Global settings`.
    La configuration se situe au niveau de l'entrée `Data retention (in days):`

    Important

    Les changements d'architecture opérés en V2.5.3.102 impliquent une limitation dans le volume de données conservées qui s'étend à 95% de la partition /es.
    La partition de backup n'est donc plus utilisée pour le stockage des données relatives à Elastic Search.
    Ce comportement sera modifiable dans le prochain hotfix.
  19. Pour supprimer les index, sélectionner ceux qui ne doivent pas être conservés puis cliquer sur `Delete selected indices (irreversible)`.
  20. Une fois l'opération effectuée, cliquer sur `Continue (reversible)`.
  21. Le menu suivant présente les différentes phases de la migration et leur statut, cliquer sur `Continue (reversible)`.
  22. La dernière fenêtre permet de lancer la migration qui sera alors irréversible, cliquer sur `Launch data preparation (irreversible)`.

    Important

    Le temps de migration dépend du matériel et du volume de données à migrer. Il faut compter en moyenne 1h pour 100Go.
  23. Le menu suivant présente les différentes phases de la migration et leur statut, cliquer ponctuellement sur `Refresh` pour voir la progression de l'opération.
    A la fin de l'opération, si toutes les étapes sont en vert true, cela signifie que la migration s'est correctement effectuée, dans le cas contraire veuillez contacter le support technique Gatewatcher.
  24. Quitter le menu setup, se connecter à la WebUI du GCenter, aller dans le menu `Administrators > GUM > Upgrade`.
  25. Dans la section `Saved package list`, au niveau de la mise à jour précédemment envoyée, cliquer sur le bouton `Apply`.
  26. Une fois l'opération terminée, redémarrer le GCenter en se connectant en SSH avec le compte setup puis en allant dans le menu `Restart`.
  27. Une fois le GCenter redémarré, se connecter à la WebUI et vérifier que des nouveaux évènements apparaissent dans la partie `Hunting` (interface Kibana).

8.4. Procédure d'installation sans conservation des données

  1. Vérifier que les sondes GCap sont en version V2.5.3.105 ou supérieure, sinon se référer à la procédure de mise à jour suivante : https://releases.gatewatcher.com/fr/gcap/2.5.3/105/8_upgrade_procedure.html
  2. Télécharger la nouvelle version du GCenter disponible et le sha256 associé sur la plate-forme https://update.gatewatcher.com/upgrade/ (répertoire 2.5.3.102).
  3. Faire la vérification de l'image avec le sha256 associé.
  4. Se connecter en SSH sur le GCap avec le compte setup.
  5. Stopper le moteur de détection avec la commande suivante : `monitoring-engine stop`.
  6. Modifier le mode de compatibilité avec la commande suivante : `set compatibility-mode 2.5.3.102+`.
  7. Démarrer le moteur de détection avec la commande suivante : `monitoring-engine start`.
  8. Se connecter à la WebUI du GCenter, aller dans le menu `Administrators > GUM > Upgrade`.
  9. Dans la section `Upload an upgrade`, cliquer sur le bouton `Choisir un fichier`, sélectionner la nouvelle version du GCenter précédemment téléchargée puis cliquer sur `Submit`.
  10. Dans la section `Saved package list`, au niveau de la mise à jour précédemment envoyée cliquer sur le bouton `Apply`.
  11. Une fois l'opération terminée, redémarrer le GCenter en se connectant en SSH avec le compte setup puis en allant dans le menu `Restart`.
  12. Une fois le GCenter redémarré, se connecter à la WebUI et vérifier que des nouveaux évènements apparaissent dans la partie `Hunting` (interface Kibana).