Désinstallation du patch
Commande de désinstallation
La désinstallation du patch peut s'effectuer depuis le répertoire du patch à l'aide du script revert-patch.sh.
$ cd shinken-enterprise_V02.08.01-CumulativePatch-19_FR_Linux_FULL_2022-02-03/ $ ./revert-patch.sh
IMPORTANT
La désinstallation d'un patch aura pour effet de retrouver la dernière version officielle originale qui a été installée sur le serveur ( celle mise en place via un install.sh ou update.sh ).
Ex. : Sur une version 02.08.01,
- Vous installez le patch 01,
- Puis le patch 02.
Si vous désinstaller le patch 02, la version est la 02.08.01 et non le patch 01.
Désinstallation du patch ( Mode avancé )
Options disponibles
| Option | Description |
|---|---|
| --force | Force à "oui" toutes les demandes de confirmation de l'utilisateur. Les démons seront redémarrés sauf si l'option "--disable-daemons-restart-after-update" est utilisée. |
| --disable-daemons-restart-after-update | Désactive l'étape de redémarrage des démons après la mise à jour. (Désactiver le redémarrage des démons à la fin de l'installation) |
| --ignore-pre-setup-non-blocking-errors | Permets d’ignorer certaines erreurs "mineures" qui pourraient arriver pendant les étapes non essentielles pour le bon fonctionnement de Shinken. Cette option ignore les problèmes suivants :
N’utilisez cette option qu’en présence de votre support dédié |
Passer les demandes de saisies lors de l'installation
Si vous voulez automatiser l'installation du patch, via un script ansible par exemple, vous allez avoir besoin de désactiver les demandes de saisies.
- --force permet de désactiver les prompts vous demandant confirmation avant de continuer le processus.
Il vous est cependant fortement conseillé de lire les informations fournies lors de l'installation du patch.
Désactiver le redémarrage des démons à la fin de l'installation
Dans le cas où vous voulez automatiser l'installation du patch sur plusieurs machines, vous pouvez avoir envie de redémarrer tous les démons de toutes les machines en même temps ( afin d'éviter par exemple qu'un Arbiter mis à jour tente de parler avec des démons qui ne le sont pas ).
- --disable-daemons-restart-after-update permets de désactiver le redémarrage des démons à la fin de l'installation du patch.
Etapes de la désinstallation
Informations sur le patch et confirmation de la désinstallation
La première étape de la désinstallation consiste à présenter les correctifs et des informations sur le patch : démons impactés, actions automatiques lors d'une mise à jour à lancer... Les informations affichées en gris sont celles présentes dans le fichier readme.txt.
Lors de cette étape, il est possible d'annuler la désinstallation du patch ( serveur non concerné, redémarrage impossible... ).
Dans cette capture d'écran, la liste des fixes est un court exemple et son contenu sera différent d'un patch à un autre.
Sauvegarde des configurations
Avant de désinstaller le patch, le script fait une sauvegarde de la configuration du Synchronizer et du paramétrage de l'interface de Visualisation.
Cette sauvegarde est l'équivalent de la commande suivante :
shinken-backup --configuration --user
Toutes les sauvegardes sont placées dans un dossier et un sous dossier situé dans /root/shinken/versions_and_patch_installations. Le nom de ce dossier comporte plusieurs informations :
- La date et l'heure de la réalisation de la sauvegarde
- Le nom complet de la version du patch
Celui du sous-dossier se nommera avec :
- Les mots : BACKUP_CONFIGURATION_PRE_UNPATCH
- Suivi de trois tirets : ---
- Puis le nom complet de la version du patch
- Et enfin de trois tirets : ---
Ce nommage spécifique du dossier et du sous-dossier permet d'organiser et de retrouver plus facilement les sauvegardes effectuées au cours des installations des patchs et des versions.
Il est possible d’ignorer certaines erreurs "mineures" qui pourraient arriver pendant les étapes non essentielles pour le bon fonctionnement de Shinken.
Pour se faire utilisez l’option --ignore-pre-setup-non-blocking-errors
Cette option ignore les problèmes suivants :
- Les erreurs lors de la sauvegarde du backup avant la mise à jour.
N’utilisez cette option qu’en présence de votre support dédié
Arrêt des démons
Le script présente les démons concernés par la désinstallation du patch. Seuls les démons concernés seront arrêtés. Ils seront redémarrés à la fin du script.
Votre installation sera modifiée seulement quand cette étape sera terminée. Si vous ne pouvez pas éteindre un démon à ce moment-là, vous pouvez répondre "No" et votre installation ne sera pas affectée par le revert.
Restauration des règles SELinux
Si des règles SELinux ont été mises à jour pendant l'installation du patch, celles-ci sont également désinstallées.
Restauration des fichiers
Les fichiers présents avant l'installation du patch sont restaurés à leurs emplacements.
Ici la liste des fichiers restaurés est un court exemple et son contenu sera différent d'un patch à un autre.
Redémarrage des outils utilisés par Shinken
Il est possible que la désinstallation nécessite de redémarrer des services externes ( httpd ).
Redémarrage des démons
Les démons sont redémarrés après la désinstallation du patch.
Vous pouvez choisir de laisser Shinken éteint à cette étape, sans incidence sur la suite de la désinstallation ( modification manuelle à apporter, période de maintenance... ).
À ce stade la désinstallation du patch est terminée.
Concernant les fichiers de configuration:
- les fichiers ajoutés avec l'extension ".patchnew" ne sont pas retirés. Comme ils ne sont pas pris en compte dans la configuration, cela n'a pas d'incidence.
- Les fichiers de configuration modifiés à l'installation du patch (fichier non modifié manuellement depuis l'installation) ne sont pas remodifiés. Les paramètres éventuellement ajoutés ne seront plus utilisés par le code, mais cela ne gêne pas le fonctionnement de Shinken.
Résolution des problèmes liés aux patchs
Les logs de la désinstallation
Pour chaque installation/désinstallation, un dossier est créé dans ~/shinken/versions_et_patch_installations/ et nommé comme suit:
# Désinstallation YYYY-MM-DD-HHhMMmSS-revert-patch-VXX.XX.XX_PATCH_CUMULATIVE_XX
Ce dossier contient les dossiers et fichiers suivants :
- Dossier de logs d'installation : patch_installation_logs
- Affichage du script de désinstallation : shinken.enterprise.unpatch.log ( désinstallation seulement )
- Dossier de backup de la configuration et données utilisateur avant la désinstallation : BACKUP_CONFIGURATION_PRE_UNPATCH---VXX_XX_XX_PATCH_CUMULATIVE_XX--- ( désinstallation seulement )