Présentation

Les patchs vous seront fournis par Shinken-Solutions pour corriger des bogues mineurs sans avoir besoin de mettre a 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).

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 xf 2020-05-20_V02.07.06-FR_Patched-cumulative-PATCH01.tar.gz

Les fichiers contenus dans l'archive sont regroupé 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 2020-05-20_V02.07.06-FR_Patched-cumulative-PATCH01
$ ./install-patch.sh


Il est possible d'utiliser l'option "--force" afin de ne pas devoir valider les différentes confirmations et d'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 (serveur non concerné, redémarrage impossible, ...)


Arrêt des démons

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


Retrait des patchs précédents (Facultatif)

Afin de garantir que le patch s'installe sur la bonne version, il désinstalle les patchs précédents. Cette étape est facultative et peut être absente d'un patch


Sauvegarde des fichiers qui seront modifiés

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


Copie des fichiers

Le script copie tous les fichiers nécessaires.

Si des fichiers cfg livrés dans l'installation (configuration de démon, de module, de pack, ...) ont été modifiés, ils ne seront pas écrasés. Le script d'installation se contente de copier le nouveau fichier, renommé en ".patchnew". Vous pouvez alors regarder les différences entre ce fichier et votre fichier : ajout de nouveaux paramètres, modification des textes, ... En revanche, si ces même fichiers n'ont pas été modifiés depuis l'installation, ils seront remplacés par le nouveau fichier.



Application des règles SELINUX (Facultatif)

Dans certains patchs, des règles Selinux peuvent être mises à jour durant l'installation. Cette étape est facultative et peut être absente d'un patch


Installation des fichiers rpm (Facultatif)

Il est possible que certains patchs installe des rpm nouvelles versions de dépendances qui sont livrés en RPM (Red hat Package Manager). Cette étape est facultative et peut être absente d'un patch


Exécution des sanatize (Facultatif)

Certains patchs nécessitent de passer des sanatize pour modifier la base de données ou des fichiers de configuration. Cette étape est facultative et peut être absente d'un patch


Redémarrage des démons

Les démons sont redémarrés après l'installation du patch. Il est possible que des démons autres que shinken ait besoin d'être redémarré (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 l'installation (modification manuelle à apporter, période de maintenance, ...)


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

$ 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 version originale qui a été installé sur le serveur. Ex. : Sur une version 02.07.06, vous installer le patch 01 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, ...)


Arrêt des démons

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


Restauration des règles SELINUX (Facultatif)

Si des règles SELINUX ont été mise à 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 à leur 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 ait besoin d'être redémarré (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, ...)