| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
PrésentationLes patchs vous seront fournis par Shinken-Solutions pour corriger des bogues mineurs 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 ).
Prévoyez donc une interruption de service pour l'installation d'un patch.
Afin de voir si des patchs sont déjà installés, il faut utiliser l'option "--show-history" du Shinken-healthcheck :
| Panel |
|---|
|
Installation d'un patch
Les patchs sont fournis dans une archive en ".tar.gz". il convient de les décompresser avec la commande suivante :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ 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".
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ cd shinken-enterprise-patch_2020-05-29_V02.07.06-FR_Patched-cumulative-PATCH02
$ ./install-patch.sh |
| Info |
|---|
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 ...).
| Panel |
|---|
|
| Panel |
|---|
|
Si le patch est déjà installé, alors l'installation s'arrêtera.
| Panel |
|---|
|
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.
| Panel |
|---|
|
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.
| Panel |
|---|
|
Sauvegarde des fichiers qui seront modifiés
Tous les fichiers modifiés sont sauvegardés afin de pouvoir retirer le patch si besoin
( voir la page Shinken-healthcheck : Vérifier le bon fonctionnement de Shinken Entreprise ) :
| Code Block |
|---|
shinken-healthcheck --show-history |
| Panel |
|---|
|
| Panel |
|---|
|
Copie des fichiers
Le script copie tous les fichiers nécessaires.
| Info |
|---|
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êmes fichiers n'ont pas été modifiés depuis l'installation, ils seront remplacés par le nouveau fichier. |
| Panel |
|---|
|
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.
| Panel |
|---|
|
Installation des fichiers rpm
Il est possible que certains patchs installe des rpm nouvelles versions de dépendances qui sont livrées en RPM (Red hat Package Manager). Cette étape peut être absente d'un patch.
| Panel |
|---|
|
Exécution des sanatize
Certains patchs nécessitent de passer des sanatize pour modifier la base de données ou des fichiers de configuration. Cette étape peut être absente d'un patch.
| Panel |
|---|
|
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 ...)
| Panel |
|---|
|
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.py
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ cd 2020-05-20_V02.07.06-FR_Patched-cumulative-PATCH01
$ ./revert-patch.sh |
| Info |
|---|
La désinstallation d'un patch aura pour effet de retrouver la version originale qui a été installée 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 ...)
| Panel |
|---|
|
| Panel |
|---|
|
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.
| Panel |
|---|
|
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.
| Panel |
|---|
|
Restauration des fichiers
Les fichiers présents avant l'installation du patch sont restaurés à leurs emplacements.
| Panel |
|---|
|
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 ...)
| Panel |
|---|
|
