Installation du patch
Extraction du patch et installation
Les patchs sont fournis dans une archive en ".tar.gz". Il convient de les décompresser avec la commande suivante :
$ tar zxf shinken-enterprise_V02.08.02-CumulativePatch-XX_FR_Linux_FULL_YYYY-MM-DD.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_V02.08.02-CumulativePatch-XX_FR_Linux_FULL_YYYY-MM-DD/ $ ./install-patch.sh |
Il est possible d'utiliser l'option "--force" afin de ne pas devoir valider les différentes demandes de confirmation présentes dans le déroulement du patch. ( cela peut être utile lorsque l'on veut intégrer l'installation du patch dans un script ) |
Il est possible d'utiliser l'option "--disable-daemons-restart-after-update" pour ne pas redémarrer les démons à la fin de l'installation du patch. Cette option peut être utilisée en même temps que l'option "--force" |
Installation du patch ( Mode avancé )
Options disponibles
Option pour l'installation du patch
|
Options de connexion à la base MongoDB
Dans tous les exemples ci-dessous, shinken-commande est à remplacer par la commande install-patch.sh.
Passer les demandes de saisies lors de l'installation
| Ignore toutes les demandes de confirmation de l'utilisateur, et répond par "oui". |
Il est cependant fortement conseillé de lire les informations fournies lors de l'installation du patch. |
Cette option peut être utilisée pour automatiser l'installation du patch, via un script ansible par exemple.
Toutes les demandes de confirmation par une saisie de l'utilisateur sont ignorées, comme si l'utilisateur avait répondu par un "oui".
Désactiver le redémarrage des démons à la fin de l'installation
| 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 ) |
Cette option peut être utilisée pour automatiser l'installation du patch sur plusieurs machines, et 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 ).
Etapes de l'installation
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, actions automatiques ( Sanitize ) 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 l'installation du patch sans affecter la version.
|
Dans cette capture d'écran, la liste des correctifs est un court exemple et son contenu sera différent d'un patch à un autre. |
Si le patch est déjà installé, alors l'installation s'arrêtera.
|
Pour réinstaller le patch, il faudra d'abord lancer le script de "revert" ( voir la deuxième partie de cette page ).
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 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.
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 :
N’utilisez cette option qu’en présence de votre support dédié |
|
Installation de paquets système
Il est possible que certains patchs installent de nouvelles dépendances qui sont livrées via des paquets système ( RPM - RedHat Package Manager - pour distributions RHEL et dérivéres, DEB pour la distribution Debian ).
|
Application des règles SELinux
Dans certains patchs, des règles SELinux peuvent être mises à jour durant l'installation.
La mise à jour d'une règle SELinux impose de retirer d'abord les règles existantes avant d'installer sa mise à jour. Il y a donc deux étapes:
- Retrait des règles SELinux déjà installées par une installation ou un autre patch.
- Installation de la nouvelle version de la règle SELinux.
|
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.
 |
Le patch commencera à modifier le système seulement à partir de cette étape. Si un démon ne peut pas être arrêté à ce moment-là, répondre "No" et le système ne sera pas modifié par le patch. |
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, du plus récent au plus ancien. Cela permet d'installer un patch sans avoir à désinstaller le patch précédent.
Cette étape ne modifie pas les fichiers de configuration. Cela implique que :
- Les fichiers de configuration livrés dans un patch précédent avec l'extension ".patchnew" ne seront pas retirés. N'étant pas lus par la configuration, ils ne posent pas problème.
- Les fichiers qui auraient été modifiés lors de l'installation par le patch ( ou par l'administrateur système ) conserveront les modifications apportées.
- Les fichiers ajoutés seront toujours présents.
|
Ici la liste des fichiers restaurés est un court exemple et son contenu sera différent d'un patch à un autre. |
Si aucun patch précédent n'a été installé, alors cette étape ne modifie pas le système.
|
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.
Cette étape permet, lors de l'installation du prochain patch de revenir à la version d'origine.
|
Ici la liste des fichiers sauvegardés est un court exemple et son contenu sera différent d'un patch à un autre. |
Copie des fichiers
Le script copie tous les fichiers nécessaires.
|
Ici la liste des fichiers sauvegardés est un court exemple et son contenu sera différent d'un patch à un autre. |
Si des fichiers de configuration présents dans les dossier /etc/shinken et /opt/graphite/conf ( configuration de démon, de module, de pack... ) ont été modifiés, et que ces fichiers sont livrés dans le patch, ils ne seront pas écrasés.
Le script d'installation dépose le nouveau fichier juste à côté, renommé en ".patchnew". Il est alors possible de regarder les différences entre ce nouveau fichier et le fichier original : ajout de nouveaux paramètres, modification des textes, ...
La liste des fichiers ajoutés avec cette extension est présentée à la fin de l'installation du patch.
Les fichiers de configuration présents dans les dossiers suivants sont propres à l'installation de Shinken et seront donc systématiquement écrasés :
- /etc/shinken/packs/shinken
- /etc/shinken/packs/shinken-core
- /etc/shinken/_default
- /etc/shinken/external
- /etc/shinken-user-example
- /etc/shinken-skeletons
Exécution des actions automatiques post installation ( Sanitize )
Certains patchs nécessitent d'effectuer des actions après l'installation pour modifier la base de données ou des fichiers de configuration.
|
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 l'installation du patch.
Il est possible 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.
|
Une fois les démons redémarrés, l'installation est terminée.
Si des fichiers de configuration ont été livrés avec l'extension .patchnew, la liste de ces fichiers est présentée à la fin de l'installation. Cette liste peut être retrouvée dans le dossier des logs d'installation présenté dans la partie sauvegarde de cette page.
Résolution des problèmes liés aux patchs
Les logs de l'installation
Pour chaque installation/désinstallation, un dossier est créé dans ~/shinken/versions_et_patch_installations/ et nommé comme suit:
# Installation YYYY-MM-DD-HHhMMmSS-install-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 d'installation : shinken.enterprise.patch.log ( installation seulement )
- Nettoyage de la configuration : sanitize.log ( installation seulement )
- Affichage des nouveaux fichiers de configuration créés : files_patchnew_created.log ( installation seulement )
- Dossier de backup de la configuration et données utilisateur avant l'installation : BACKUP_CONFIGURATION_PRE_PATCH---VXX_XX_XX_PATCH_CUMULATIVE_XX--- ( installation seulement )