Présentation

Les patchs vous seront fournis par Shinken-Solutions pour corriger des bogues  sans avoir besoin de mettre à jour vers une version supérieure. Les patchs sont moins contraignants qu'une mise à jour complète, mais il faudra néanmoins redémarrer les démons impactés dans le patch ( la liste est précisée lors de l'installation ).


Afin de voir si des patchs sont déjà installés, il faut utiliser l'option "--show-history" du Shinken-healthcheck :





Installation d'un patch

Les patchs sont fournis dans une archive en ".tar.gz". il convient de les décompresser avec la commande suivante :

$ tar xzf shinken-enterprise-patch_2020-05-29_V02.07.06-FR_Patched-cumulative-PATCH02.tar.gz

Les fichiers contenus dans l'archive sont regroupés dans un dossier du même nom que le patch.

Pour installer le patch, il faut se déplacer dans ce dossier et lancer l'installation avec le script : "install-patch.sh".

$ cd shinken-enterprise-patch_2020-05-29_V02.07.06-FR_Patched-cumulative-PATCH02
$ ./install-patch.sh


Il est possible d'utiliser l'option "--force" afin de ne pas devoir valider les différentes demandes de confirmation présente dans le déroulement du patch.

( cela peut être utile lorsque l'on veut intégrer l'installation du patch dans un script )


Informations sur le patch et confirmation de l'installation

La première étape de l'installation consiste à présenter les correctifs et des informations sur le patch : démons impactés, sanatize à lancer ...

Lors de cette étape, il est possible d'annuler l'installation du patch.






Si le patch est déjà installé, alors l'installation s'arrêtera.



Sauvegarde des configurations

Avant d'appliquer les changements, 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 est 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_PATCH
  • 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.  



Arrêt des démons

Le script présente les démons concernés par l'installation du patch. Seuls les démons concernés seront arrêtés.

Ils seront redémarrés à la fin du script.



Retrait des patchs précédents

Afin de garantir que le patch s'installe sur la bonne version, il désinstalle les patchs précédents.

Cette étape peut être absente d'un patch.





Sauvegarde des fichiers qui seront modifiés

Tous les fichiers modifiés par le patch sont sauvegardés afin de pouvoir retirer le patch si besoin.




Copie des fichiers

Le script copie tous les fichiers nécessaires.

Si vous aviez modifié des fichiers cfg qui sont livrés dans le patch ( configuration de démon, de module, de pack, ... ), ils ne seront pas écrasés.

Le script d'installation de déposer le nouveau fichier juste à côté, renommé en ".patchnew". Vous pouvez alors regarder les différences entre ce fichier et votre fichier : ajout de nouveaux paramètres, modification des textes ...






Application des règles SELINUX

Dans certains patchs, des règles Selinux peuvent être mises à jour durant l'installation.

Cette étape peut être absente d'un patch.




Installation des fichiers rpm

Il est possible que certains patchs installent des nouvelles dépendances qui sont livrées en RPM ( Red hat Package Manager ).

Cette étape peut être absente d'un patch.




Exécution des "Sanatizes"

Certains patchs nécessitent de passer des "Sanatizes" pour modifier la base de données ou des fichiers de configuration.

Cette étape peut être absente d'un patch.



Redémarrage des démons Shinken

Les démons sont redémarrés après l'installation du patch.

Vous pouvez choisir de laisser Shinken éteint à cette étape, sans incidence sur la suite de l'installation ( modification manuelle à apporter, période de maintenance ... )

Seuls les démons impactés par le patch seront redémarrés.



Redémarrage des démons externes

Il est possible que l'installation nécessite de redémarrer des services externes (ex. : carbon-cache).


Désinstallation d'un patch

La désinstallation du patch peut s'effectuer depuis le répertoire du patch à l'aide du script revert-patch.sh

$ cd 2020-05-20_V02.07.06-FR_Patched-cumulative-PATCH01
$ ./revert-patch.sh


La désinstallation d'un patch aura pour effet de retrouver la dernière version officiel 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.07.06,

  1. Vous installez le patch 01,
  2. Puis le patch 02.

Si vous désinstaller le patch 02, la version est la 02.07.06 et non le patch 01.


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. Lors de cette étape, il est possible d'annuler la désinstallation du patch (serveur non concerné, redémarrage impossible ...)





Sauvegarde des configurations

Avant d'appliquer les changements, 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 est 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_PATCH
  • 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.  



Arrêt des démons

Le script présente les démons concernés par l'installation du patch. Seuls les démons concernés seront arrêtés. Ils seront redémarrés à la fin du script.



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.






Redémarrage des démons

Les démons sont redémarrés après la désinstallation du patch. Il est possible que des démons autres que Shinken aient besoin d'être redémarrés (httpd, carbon-cache). Si c'est le cas, cela vous sera précisé.

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 ...)





Redémarrage des démons externes

Il est possible que l'installation nécessite de redémarrer des services externes (carbon-cache).