Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Panel

title	Sommaire

Table of Contents

style	none

Contexte

Afin de prévenir d'une perte de données après un crash d'un ou de plusieurs de vos serveurs utilisés dans votre architecture Shinken, nous vous conseillons d'utiliser les commandes shinken-backup et shinken-restore.

Ces deux commandes vous permettront de sauvegarder ou de restaurer tout ou une partie d'un serveur de votre architecture Shinken.

Commande de sauvegarde ( shinken-backup )

Utilisation

La commande de base pour la sauvegarde complète d'un serveur shinken est la suivante :

Code Block
shinken-backup

Les différentes options possibles :

Option courte	Option	Description	Démon sur lequel se trouve les données à sauvegarder
-h	--help	Affiche l'aide de la commande

Tous

--
-od [dir]	--output-directory [dir]	Permet de choisir le répertoire où

enregistrer

sera enregistrée la sauvegarde.

Prends en compte les chemin absolus

Les répertoires nécessaires seront créés:

Soit le chemin fourni est absolu ( /root/backups/example)

et les chemins relatifs ( ajoute le chemin par rapport au répertoire de travail courant ). Cette option crée tous les répertoires nécessaire dans l'arborescence.

Soit le chemin relatif, dans ce cas le répertoire fourni sera créé à partir du répertoire où sera exécuté la commande shinken-backup.

( Par défaut, la sauvegarde se fait dans le répertoire où est lancée la commande )

--

Tous


-on [name]	--output-name [name]	Permet de choisir le nom

de

du répertoire contenant la sauvegarde

Tous

( par défaut il sera YYYY-MM-DD__HH-MM-SS__ShinkenVersion )	--
-a	--addons	Sauvegarde les configurations et les données des addons ( exemple: nagvis )

Tous-c--configurationSauvegarde les données de configurationSynchronizer

Addon nagvis : les données dans /opt/nagvis et /etc/httpd/conf.d/ Addon nagvis-shinken-architecture : Les données dans /var/lib/shinken-nagvis et /etc/httpd/conf.d	--
-c

-ca

--configuration

-anonymous

Sauvegarde les données de configuration

anonymisées

:

Les données du Synchronizer

-l--logSauvegarde les logsTous-M

dans MongoDB Les fichiers de configuration dans /etc/shinken/ Les fichiers de configuration dans /etc/shinken-user Les sondes utilisateurs dans /var/lib/shinken-user/libexec ( Si vos sondes utilisent des dépendances systèmes, il faudra aussi qu'elles soit présentes lors de la restauration pour que les sondes soient opérationnelles ). La rétention de l'Arbiter	Synchronizer
-ca	--configuration-anonymous	Sauvegarde les données de configuration anonymisées Les données du Synchronizer dans MongoDB anonymisées Voir le chapitre : Sauvegarde d'une configuration anonymisée	Synchronizer
-l	--log	Sauvegarde les logs Tous les logs du dossier /var/log/shinken	Tous
-M	--

--

modules

Permet de sauvegarder les données de tous les modules NON

fournie

fournis par Shinken Enterprise ( exemple : le module mssql_export )

Tous

Les données des modules dans MongoDB	Tous
	-

-

-module-type [type]	Permet de sauvegarder les données d'un seul type de module NON fournie par Shinken Enterprise. Uniquement utilisable avec l'option --modules/-M.	Tous
-L	--list-modules	Permet de lister tous les types de modules NON fournie par Shinken Enterprise qui peuvent être sauvegardé.

Tous

--
-m	--metrology	Sauvegarde les données de métrologie Les fichiers du dossier /opt/graphite/storage/whisper	Broker
-s	--sla	Sauvegarde les données SLA Les données mongo des SLA	Broker
-u	--user	Sauvegarde les données des utilisateurs de l'interface de visualisation ( portails, listes, favoris, tableaux de bords... )

Broker

Info

La commande shinken-backup ne peut pas être exécutée dans les dossiers /etc/shinken et /etc/shinken-user

Attention, pensez bien à utiliser cet outil générique sur le bon serveur. Par exemple, sauvegarder les SLA depuis un serveur Poller ne sera pas cohérent. Ou encore, pour sauvegarder la configuration de Shinken, placez vous sur le serveur hébergeant le duo Arbiter/Synchronizer.

Sauvegarde de données de configuration chiffrées

Lorsque la sauvegarde de données de configuration avec des données protégées est effectué, shinken-backup affiche un avertissement si la clé n'a pas été sauvegardée.

La sauvegarde est tout de même effectué mais vous devez effectuer une sauvegarde de la clé en utilisant la commande shinken-protected-fields-keyfile-export avant toute autre opération impliquant un changement de clé.

Le message suivant apparaîtra si vous n'avez pas effectué de sauvegarde de la clé avant la sauvegarde de la configuration :

The protected fields key from this backup looks like it has never been saved

Si la sauvegarde de la clé a été effectuée par la suite, vous pouvez ignorer ce message et restaurer la clé selon la procédure de restauration habituelle.

Panel
Image Removed

Les données mongo des dashboard utilisateurs Les données mongo des listes utilisateurs Les données mongo des préférences utilisateurs	Broker
	--mongo-host	Nom ou IP du serveur MongoDB à contacter ( défaut: localhost )	Broker, Scheduler, Synchronizer
	--mongo-port	Port du serveur MongoDB à contacter ( défaut: 27017 )	Broker, Scheduler, Synchronizer
	--mongo-use-ssh	Utiliser un tunnel SSH pour accéder au serveur MongoDB ( défaut: non )	Broker, Scheduler, Synchronizer
	--mongo-ssh-key	Clé privée à utiliser pour créer le tunnel SSH vers le serveur MongoDB ( défaut: /var/lib/shinken/.ssh/id_rsa )	Broker, Scheduler, Synchronizer
	--mongo-ssh-user	Utilisateur pour la connexion SSH sur le serveur MongoDB ( défaut: shinken )	Broker, Scheduler, Synchronizer

Info

La commande shinken-backup ne peut pas être exécutée dans les dossiers /etc/shinken et /etc/shinken-user

Attention, pensez bien à utiliser cet outil générique sur le bon serveur. Par exemple, sauvegarder les SLA depuis un serveur Poller ne sera pas cohérent. Ou encore, pour sauvegarder la configuration de Shinken, placez-vous sur le serveur hébergeant le duo Arbiter/Synchronizer.

Warning

Si certains modules ou démons utilisent une base de données spécifique pour le stockage des données, attention à utiliser les bons paramètres de base de données en relation avec le type de sauvegarde à réaliser

Exemple:

option --sla ( ou -s ) avec les paramètres de connexion à la base de données du module SLA
option --user ( ou -u ) avec les paramètres de connexion à la base de données du module WebUI
option --configuration ou --configuration-anonymous avec les paramètres de connexion à la base de données du Synchronizer

Sauvegarde de données de configuration chiffrées

Lorsque la sauvegarde de données de configuration avec des données protégées est effectuée, shinken-backup affiche un avertissement si la clé n'a pas été sauvegardée.

La sauvegarde est tout de même effectuée, mais vous devez effectuer une sauvegarde de la clé en utilisant la commande shinken-protected-fields-keyfile-export avant toute autre opération impliquant un changement de clé.

Le message suivant apparaîtra si vous n'avez pas effectué de sauvegarde de la clé avant la sauvegarde de la configuration :

The protected fields key from this backup looks like it has never been saved

Si la sauvegarde de la clé a été effectuée par la suite, vous pouvez ignorer ce message et restaurer la clé selon la procédure de restauration habituelle ( voir la page shinken-protected-fields-keyfile-export )

Panel
Image Added

Anchor

	SauvegardeDUneConfigurationAnonymisee
	SauvegardeDUneConfigurationAnonymisee

Sauvegarde d'une configuration anonymisée

Afin de transmettre une configuration au support, il est possible d'anonymiser la configuration lors de la sauvegarde.

L'anonymisation est réalisée pour les données présentes dans la base de données du Synchronizer. Si l'option --configuration-anonymous est utilisée, les autres options (--sla par exemple) sont ignorées. Les fichiers de configuration des démons et de l'architecture de Shinken ne sont pas sauvegardé.

Cette étape est réalisée entre la récupération des données dans la base et l'écriture des fichiers de sauvegarde, la base de données n'est donc pas impactée par ce fonctionnement. Le tableau suivant présente les propriétés qui seront remplacées avant d'être écrites dans les fichiers de sauvegarde.

Type de donnée	Valeur de substitution	Description
address	clean address	Permet de masquer les adresses des équipements
check_command	clean_command	Permet de masquer les commandes : Une fois restaurée, la configuration pourra démarrer sans effectuer de check
poller_tag		La valeur est supprimée pour permettre à la configuration de démarrer
reactionner_tag		La valeur est supprimée pour permettre à la configuration de démarrer
realm		La valeur est supprimée pour permettre à la configuration de démarrer
password	clean	Les mots de passe sont effacés

Toutes les données utilisateur, chiffrées ou non, présentes dans le système de champs protégé sont également remplacée par la valeur "clean". Pour connaître la liste des champs protégés, utilisez la commande shinken-protected-fields-data-manage.

Le nom de la sauvegarde généré sera succédé de "--anonymous" afin de le distinguer des sauvegardes par défaut.

Info
Exemple de nom de sauvegarde anonyme :

Sauvegarde d'une configuration anonymisée

Afin de transmettre une configuration au support, il est possible d'anonymiser la configuration lors de la sauvegarde.

L'anonymisation est réalisée pour les données présentes dans la base de données du Synchronizer. Les fichiers de configuration seront sauvegardés sans aucune modification. Si l'option --configuration-anonymous est utilisée avec une autre option (--sla par exemple) les données de sla ne seront pas impactés par l'anonymisation.

Cette étape est réalisée entre la récupération des données dans la base et l'écriture des fichiers de sauvegarde, la base de donnée n'est donc pas impactées par ce fonctionnement. Le tableau suivant présente les propriétés qui seront remplacées avant d'être écrit dans les fichiers de sauvegarde.

Type de donnéeValeur de substitutionDescriptionaddressclean addressPermet de masquer les adresses des équipementscheck_commandclean_commandPermet de masquer les commandes : Une fois restaurée, la configuration pourra démarrer sans effectuer de checkpoller_tagLa valeur est supprimée pour permettre à la configuration de démarrerreactionner_tagLa valeur est supprimée pour permettre à la configuration de démarrerrealmLa valeur est supprimée pour permettre à la configuration de démarrerpasswordcleanLes mots de passe sont effacés

Toutes les données utilisateur, chiffrées ou non, présentes dans le système de champs protégé sont également remplacée par la valeur "clean". Pour connaître la liste des champs protégés, utilisez la commande shinken-protected-fields-data-manage.

Le nom de la sauvegarde généré sera succédé de "--anonymous" afin de le distinguer des sauvegardes par défaut.

Info
exemple de nom de sauvegarde anonyme : 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11--anonymous

Info
Les données ne sont ni effacées ni modifiées sur le serveur sur lequel le shinken-backup est effectué. Elles sont simplement remplacées avant d'être écrites dans les fichiers de sauvegardes.

Info
La sauvegarde réalisée n'est pas chiffrée, car toutes les données présentant un risque ont été remplacées.

Exemples

Voici un exemple de sauvegarde complet d'un serveur hébergeant l'ensemble des démons :

Code Block

root@vm-shinken: ~
$ shinken-backup
Saving Sla
  Sla save size: 360M
Saving User
  User save size: 72K
Saving Configuration
  Configuration save size: 8.0M
Saving Metrology
  Metrology save size: 3.9M
Saving Logs
  Logs save size: 2.8M

Done : your backup directory is /root/shinken-backups/2021-01-18__10-28-21__V02.07.06-release_7_8.fr-Patched-06

Exemple de la sauvegarde de la configuration sur un serveur hébergeant le démon Synchronizer :

Code Block

root@vm-shinken: ~
$ shinken-backup --configuration
Saving Configuration
  Configuration save size: 3.1M

Done : your backup directory is /root/shinken-backups/2021-01-18__10-3233-2115__V02.07.06-release_7_8.fr-Patched-06

Commande de restauration (shinken-restore)

Utilisation

Code Block
shinken-restore DIRECTORY-TO-RESTORE

Le dossier "DIRECTORY-TO-RESTORE" doit contenir les dossiers de sauvegardes comme :

configuration/
context/
logs/
metrology/
sla/
user/

Les différences options possibles :

Option courteOptionDescriptionDémon sur lequel se trouve les données à restaurer-h--helpAffiche l'aide de la commandeTous-a--addonsRestaure les configurations et les données des addons (exemple: nagvis) présent dans l'archive. Tous-c--configurationRestaure les données de configuration

Synchronizer

--with-key-backup [HASH]Pour une sauvegarde contenant des données protégées, restaure également le hash de la clé de chiffrement spécifiée. Il s'agit du résultat de la commande shinken-protected-fields-keyfile-export.Synchronizer--rocd--restore-only-configuration-databaseCette option restaure uniquement les données de la configuration, sans restaurer les fichiers de configuration (.cfg).
Cette option est pratique pour transférer la politique de supervision d'un pré-production vers une production ( ou inversement ), sans changer les fichiers de définition des démons.Synchronizer-l--logRestaure les logsTous-m--metrologyRestaure les données de métrologieBroker-M--modulesRestaure les données de tous les modules NON fournie par Shinken Enterprise présent dans l'archive. ( exemple : le module mssql_export développé par un tiers )Tous--module-type [TYPE]Restaure les données d'un type de module NON fournie par Shinken Enterprise. Uniquement utilisable avec l'option --modules/-M.Tous-L--list-modulesPermet de lister tous les types de modules NON fournie par Shinken Enterprise présent dans l'archive de sauvegarde et qui peuvent être restauré Tous-s--slaRestaure les données SLABroker-u--userRestaure les données des utilisateurs de l'interface de visualisation (portails, listes, favoris, tableaux de bords..)Broker--restore-only-user [USER]

Restaure les données de l'interface de visualisation (portails, listes, favoris, tableaux de bords..) pour l'utilisateur spécifié. La valeur a utiliser est le Nom ( contact_name ) de l'utilisateur - à utiliser avec l'option -u

Cette option ne demande pas le redémarrage de Shinken

Broker

Restauration d'une base de données de configuration dont les données sensibles sont chiffrées

Si une clé est déjà présente sur le serveur et qu'elle est identique à celle de la sauvegarde, shinken-restore restaurera cette sauvegarde en utilisant la clé.

Si la clé n'a pas été exportée, shinken-restore affichera un avertissement vous signalant qu'elle est automatiquement exportée dans un fichier temporaire, en vous enjoignant de le déplacer en lieu sûr.

Panel
Image Removed

Si les deux clés sont différentes vous devez spécifier l'option --with-key-backup suivi du l'export de la clé, qui vous permet de faire la restauration et de placer automatiquement la clef fournie.

En suivant, vous devrez redémarrer le Synchronizer.

Le Synchronizer refusera de démarrer tant que la clé n'est pas restaurée.

Si vous avez égaré votre clé, nous vous conseillons de lire la page de la documentation "shinken-protected-fields-keyfile-rescue-from-backup". Cette commande vous permettre de restaurer votre clé via l'intermédiaire du support Shinken.

Panel
Image Removed

_B11--anonymous

Info
Les données ne sont ni effacées ni modifiées sur le serveur sur lequel le shinken-backup est effectué. Elles sont simplement remplacées avant d'être écrites dans les fichiers de sauvegardes.

Info
La sauvegarde réalisée n'est pas chiffrée, car toutes les données présentant un risque ont été remplacées.

Exemples

Sauvegarde complete d'un serveur hébergeant l'ensemble des démons

Code Block

root@vm-shinken: ~
$ shinken-backup
Saving Sla
  Sla save size: 360M
Saving User
  User save size: 72K
Saving Configuration
  Configuration save size: 8.0M
Saving Metrology
  Metrology save size: 3.9M
Saving Logs
  Logs save size: 2.8M

Done : your backup directory is /root/shinken-backups/2021-01-18__10-28-21__V02.07.06-release_7_8.fr-Patched-06

Sauvegarde sur un serveur hébergeant le démon Synchronizer

De la configuration:

Panel
Image Added

Sauvegarde complète :

Panel
Image Added

Erreur lors du Backup

Lorsqu'une erreur arrive pendant le backup, on a un message d'erreur nous indiquant la section où l'erreur est survenue, le dossier qui aurait du contenir le contenu du backup va contenir les logs d'erreurs.

Dans ce message est précisé le nom du dossier créé :

Panel
Image Added

Note
La partie floutée du chemin de la capture d'écran correspond au dossier créé par le shinken-restore. Ce nom de dossier est créé à partir de la date, du nom de la version de Shinken et de la langue.

Commande de restauration ( shinken-restore )

Utilisation

Code Block
shinken-restore DIRECTORY-TO-RESTORE

Le dossier "DIRECTORY-TO-RESTORE" doit contenir les dossiers de sauvegardes comme :

configuration/
context/
logs/
metrology/
sla/
user/

Les différentes options possibles :

Option courte	Option	Description	Démon sur lequel se trouve les données à restaurer
-h	--help	Affiche l'aide de la commande	Tous
-a	--addons	Restaure les configurations et les données des addons (exemple: nagvis) présent dans l'archive.	Tous
-c	--configuration	Restaure les données de configuration	Synchronizer
	--with-key-backup [HASH]	Pour une sauvegarde contenant des données protégées, restaure également le hash de la clé de chiffrement spécifiée. Il s'agit du résultat de la commande shinken-protected-fields-keyfile-export.	Synchronizer
--rocd	--restore-only-configuration-database	Cette option restaure uniquement les données de la configuration, sans restaurer les fichiers de configuration (.cfg). Cette option est pratique pour transférer la politique de supervision d'une pré-production vers une production ( ou inversement ), sans changer les fichiers de définition des démons.	Synchronizer
-l	--log	Restaure les logs	Tous
-m	--metrology	Restaure les données de métrologie	Broker
-M	--modules	Restaure les données de tous les modules NON fournies par Shinken Enterprise présent dans l'archive. ( exemple : le module mssql_export développé par un tiers )	Tous
	--module-type [TYPE]	Restaure les données d'un type de module NON fourni par Shinken Enterprise. Uniquement utilisable avec l'option --modules/-M.	Tous
-L	--list-modules	Permet de lister tous les types de modules NON fournis par Shinken Enterprise présent dans l'archive de sauvegarde et qui peuvent être restaurés	Tous
-s	--sla	Restaure les données SLA	Broker
-u	--user	Restaure les données des utilisateurs de l'interface de visualisation (portails, listes, favoris, tableaux de bords..)	Broker
	--restore-only-user [USER]	Restaure les données de l'interface de visualisation (portails, listes, favoris, tableaux de bord...) pour l'utilisateur spécifiée. La valeur à utiliser est le Nom ( contact_name ) de l'utilisateur - à utiliser avec l'option -u Cette option ne demande pas le redémarrage de Shinken	Broker
	--mongo-host	Nom ou IP du serveur MongoDB à contacter ( défaut: localhost )	Tous
	--mongo-port	Port du serveur MongoDB à contacter ( défaut: 27017 )	Tous
	--mongo-use-ssh	Utiliser un tunnel SSH pour accéder au serveur MongoDB ( défaut: non )	Tous
	--mongo-ssh-key	Clé privée à utiliser pour créer le tunnel SSH vers le serveur MongoDB ( défaut: /var/lib/shinken/.ssh/id_rsa ) ( active la connexion par tunnel SSH )	Tous
	--mongo-ssh-user	Utilisateur pour la connexion SSH sur le serveur MongoDB ( défaut: shinken ) ( active la connexion par tunnel SSH )	Tous

Warning

Si certains modules/démons utilisent une base de données spécifique pour le stockage des données, attention à utiliser les bons paramètres de base de données en relation avec le type de sauvegarde à restaurer

Exemple:

option --sla ( ou -s ) avec les paramètres de connexion à la base de données du module SLA
option --user ( ou -u, --restore-only-user XXX ) avec les paramètres de connexion à la base de données du module WebUI
option --configuration ( -c ) ou --restore-only-configuration-database ( --rocd ) avec les paramètres de connexion à la base de données du Synchronizer

Restauration d'une base de données de configuration dont les données sensibles sont chiffrées

Si une clé est déjà présente sur le serveur et qu'elle est identique à celle de la sauvegarde, shinken-restore restaurera cette sauvegarde en utilisant la clé.

Si la clé n'a pas été exportée, shinken-restore affichera un avertissement vous signalant qu'elle est automatiquement exportée dans un fichier temporaire, en vous enjoignant de le déplacer en lieu sûr.

Panel
Image Added

Si les deux clés sont différentes vous devez spécifier l'option --with-key-backup suivi du l'export de la clé, qui vous permet de faire la restauration et de placer automatiquement la clef fournie.

En suivant, vous devrez redémarrer le Synchronizer.

Le Synchronizer refusera de démarrer tant que la clé n'est pas restaurée.

Si vous avez égaré votre clé, nous vous conseillons de lire la page de la documentation "shinken-protected-fields-keyfile-rescue-from-backup". Cette commande vous permettre de restaurer votre clé via l'intermédiaire du support Shinken.

Panel
Image Added

Exemples

Restauration d'une sauvegarde complète de Shinken depuis le dossier ~/shinken-backups

Code Block

root@vm-shinken: ~/shinken-backups

$ shinken-restore 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11

Stopping Shinken before restoring
Restoring from 02.04.01.fr to 02.04.02.fr
-Restoring Sla            DONE
-Restoring User           DONE
-Restoring Configuration  DONE
-Restoring Metrology      DONE
-Restoring Logs           DONE

Sanatizing your restored data
   fix_double_link                         :   skip (unecessary)
   fix_double_sync_keys                    :   skip (unecessary)
   fix_default_item_se_uuid                :   skip (unecessary)
   fix_remove_shinken_core                 :   skip (unecessary)
   fix_remove_deprecated_check             :   skip (unecessary)
   fix_remove_undefined_aix_templates      :   skip (unecessary)
   fix_flapping_thresholds                 :   skip (unecessary)
   fix_business_impact                     :   skip (unecessary)

Done. You can restart your shinken with /etc/init.d/shinken start

Info

Après la restauration des données, des scripts de "Sanatize" sont lancés. Ces scripts permettent, si nécessaire, de réparer certaines incohérences dans vos données.

Une fois la restauration terminée, vous devez démarrer Shinken:

Code Block
/etc/init.d/shinken start

Restauration d'une sauvegarde de la configuration de Shinken, lancé depuis le serveur hébergeant l'Arbiter/Synchronizer :

Code Block

root@vm-shinken: ~/shinken-backups

$ shinken-restore --configuration 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11

Stopping Shinken before restoring
Restoring from 02.04.01-release to 02.04.02-release
-Restoring Configuration  DONE

Sanatizing your restored data
   fix_double_link                         :   executed [OK]
   fix_double_sync_keys                    :   skip (unecessary)
   fix_default_item_se_uuid                :   skip (unecessary)
   fix_remove_shinken_core                 :   skip (unecessary)
   fix_remove_deprecated_check             :   skip (unecessary)
   fix_remove_undefined_aix_templates      :   skip (unecessary)
   fix_flapping_thresholds                 :   skip (unecessary)
   fix_business_impact                     :   skip (unecessary)

Done. You can restart your shinken with /etc/init.d/shinken start

Restauration d'une sauvegarde des données de l'utilisateur "monutilisateur" de Shinken ( portails, listes, favoris, tableaux de bord ), lancé depuis le serveur hébergeant le Broker

Code Block

root@vm-shinken: ~/shinken-backups

$ shinken-restore -u --restore-only-user monutilisateur 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11/
Restoring from 02.04.01-release to 02.04.03-release
-Restoring User
 Restoring only the user monutilisateur

Restore of the user monutilisateur data is OK

Restauration avec une sauvegarde contenant seulement certaines parties

Code Block

root@vm-shinken: ~/shinken-backups 

$ shinken-restore 2021-04-01__15-27-25__V02.07.06-Patched-08_B02/
Restoring from 02.07.06-Patched-08_B02 to 02.07.06
 => Restoring Configuration          :
     => Checking encryption status for your current database : NOT ENCRYPTED
     => Stopping Shinken before restoring : DONE
     => Restoring configuration database  : DONE
     => Setting addons state
 nagvis                        : ENABLED
 nagvis-shinken-architecture   : ENABLED
     => Restoring configuration files     : DONE
     => Restoring configuration           : DONE
 => Restoring Sla                    : SKIPPED
 No sla data to restore in /root/shinken-backups/2021-04-01__15-27-25__V02.07.06-Patched-08_B02
 => Restoring User                   : SKIPPED
 No user data to restore in /root/shinken-backups/2021-04-01__15-27-25__V02.07.06-Patched-08_B02
 => Restoring Metrology              : DONE
 => Restoring Logs                   : DONE
 => Restoring Addons                 : DONE
 => Restoring custom modules data    : SKIPPED
  No custom modules data to restore in /root/shinken-backups/2021-04-01__15-27-25__V02.07.06-Patched-08_B02

Sanatizing your restored configuration for this version of Shinken
   fix_double_sync_keys                    :   skip (unecessary)
   fix_default_item_se_uuid                :   skip (unecessary)
   fix_remove_shinken_core                 :   skip (unecessary)
   fix_remove_deprecated_check             :   skip (unecessary)
   fix_remove_undefined_aix_templates      :   skip (unecessary)
   fix_flapping_thresholds                 :   skip (unecessary)
   fix_business_impact                     :   skip (unecessary)
   fix_host_name_inheritance               :   skip (unecessary)
   fix_bp_rule_args                        :   skip (unecessary)
   fix_uuid_in_sla_info                    :   skip (unecessary)
   fix_synchronizer_install_missing_addons :   skip (unecessary)
   fix_missing_skeletons                   :   skip (unecessary)
   fix_missing_sources                     :   skip (unecessary)
   fix_update_protected_fields_parameters  :   skip (unecessary)
   fix_all_move_overload_files             :   skip (unecessary)
   remove_hostgroups_in_working_area       :   skip (unecessary)
   make_index_for_sla_module               :   skip (unecessary)
   migrate_links_name_into_id

Exemples

Voici un exemple de restauration d'une sauvegarde complète de Shinken depuis le dossier ~/shinken-backups :

Après la restauration des données, des scripts de "Sanatize" sont lancés. Ces scripts permettent, si nécessaire, de réparer certaines incohérences dans vos données.

Une fois la restauration terminée, vous devez démarrer Shinken:

Code Block

root@vm-shinken: ~/shinken-backups

$ shinken-restore 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11

Stopping Shinken before restoring
Restoring from 02.04.01.fr to 02.04.02.fr
-Restoring Sla            DONE
-Restoring User           DONE
-Restoring Configuration  DONE
-Restoring Metrology      DONE
-Restoring Logs           DONE

Sanatizing your restored data
   fix_double_link                         :   skip (unecessary)
   fix_double_sync_keys                    :   skip (unecessary)
   fix_default_item_se_uuid                :   skip (unecessary)
   fix_remove_shinken_core                 :   skip (unecessary)
   fix_remove_deprecated_check             :   skip (unecessary)
   fix_remove_undefined_aix_templates      :   skip (unecessary)
   fix_flapping_thresholds                 :   skip (unecessary)
   fix_business_impact     double_link                         :   skip (unecessary)
   fix_service_overrides_encryption        :   skip (unecessary)
   fix_enable_synchronizer_database_module :   skip (unecessary)

Done. You can restart your shinken with /etc/init.d/shinken start

Info

Code Block
/etc/init.d/shinken start

Voici un autre exemple de restauration d'une sauvegarde de la configuration de Shinken, lancé depuis le serveur hébergeant l'Arbiter/Synchronizer :

Code Block

root@vm-shinken: ~/shinken-backups

$ shinken-restore --configuration 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11

Stopping Shinken before restoring
Restoring from 02.04.01-release to 02.04.02-release
-Restoring Configuration  DONE

Sanatizing your restored data
   fix_double_link           fix_escape_properties_for_xss           :   skip (unecessary)
   add_internal_option_to_retention_mongo_cfg:   skip (unecessary)
   add_ssl_architecture_export             :   skip (unecessary)
   add_ssl_shinken_listener                :   skip (unecessary)
   add_rules_path_discovery                :   executed [OK]skip (unecessary)
   fix_double_sync_keys  add_nmap_mac_prefixes_path_discovery    :   skip (unecessary)
   update_notes_multi_url_syntax           :   skip (unecessary)
   fix_default_item_se_uuidupdate_synchronizer_collector_linker_collection_for_cipher_transformation:   skip (unecessary)
            remove_pidfile_comment_in_mongodb_config_files:   skip (unecessary)
   fixcleanup_removemonitoring_shinken_corepack                 :   skip (unecessary)
   fix_remove_deprecatedpresence_checkprotection              :   skip (unecessary)
   fix_new_removespare_undefineddaemon_aixbroker_templatesoption      :   skip (unecessary)
   fix_flapping_thresholdschange_work_area_info_for_multiple_users:   skip (unecessary)
   deleted_service_override_useless          :   skip (unecessary)
   fix_business_impactrename_graphite_scheduler_checks_metrics_files:   skip (unecessary)
     replace_duplicate_widgets_uuids            :   skip (unecessary)

DoneRestoration done. You can restart your shinken with /etc/init.d/shinken start

Voici un dernier exemple de restauration d'une sauvegarde des données de l'utilisateur "monutilisateur" de Shinken (portails, listes, favoris, tableaux de bords), lancé depuis le serveur hébergeant le Broker :

 Shinken with /etc/init.d/shinken start

Erreurs lors de la restauration

Lorsqu'une erreur arrive pendant le restore, on a un message d'erreur nous indiquant qu'une erreur est survenue dans une section en particulier.

Un log d'erreur est alors créé dans le dossier du backup utilisé par le script.

Panel
Image Added

Note
La partie floutée du chemin de la capture d'écran correspond au dossier que l'on donne en paramètre au shinken-restore.
Code Block
root@vm-shinken: ~/shinken-backups $ shinken-restore -u --restore-only-user monutilisateur 2021-01-18__10-33-15__V02.07.06-release_7_8.fr-Patched-06_B11/ Restoring from 02.04.01-release to 02.04.03-release -Restoring User Restoring only the user monutilisateur Restore of the user monutilisateur data is OK

Page tree

Versions Compared

Old Version 23

New Version Current

Key

Contexte

Commande de sauvegarde ( shinken-backup )

Utilisation

Sauvegarde de données de configuration chiffrées

Sauvegarde de données de configuration chiffrées

Sauvegarde d'une configuration anonymisée

Sauvegarde d'une configuration anonymisée

Exemples

Commande de restauration (shinken-restore)

Utilisation

Restauration d'une base de données de configuration dont les données sensibles sont chiffrées

Exemples

Sauvegarde complete d'un serveur hébergeant l'ensemble des démons

Sauvegarde sur un serveur hébergeant le démon Synchronizer

Erreur lors du Backup

Commande de restauration ( shinken-restore )

Utilisation

Restauration d'une base de données de configuration dont les données sensibles sont chiffrées

Exemples

Restauration d'une sauvegarde complète de Shinken depuis le dossier ~/shinken-backups

Restauration d'une sauvegarde de la configuration de Shinken, lancé depuis le serveur hébergeant l'Arbiter/Synchronizer :

Restauration d'une sauvegarde des données de l'utilisateur "monutilisateur" de Shinken ( portails, listes, favoris, tableaux de bord ), lancé depuis le serveur hébergeant le Broker

Restauration avec une sauvegarde contenant seulement certaines parties

Exemples

Erreurs lors de la restauration