| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Concept
Afin de prévenir d'une perte de données après un crash d'un ou de plusieurs des serveurs utilisés dans l'architecture Shinken, il est conseillé d'utiliser les commandes shinken-backup et shinken-restore.
Ces deux commandes permettront de sauvegarder ou de restaurer tout ou une partie d'un serveur de l'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 |
| Info |
|---|
La commande shinken-backup ne peut pas être exécutée dans les dossiers /etc/shinken et /etc/shinken-user |
Les options disponibles
Sauvegardes et restaurations entre des distributions différentes
Shinken Enterprise supporte la sauvegarde et la restauration entre deux distributions différentes.
Cela signifie qu'une sauvegarde effectuée sous une distribution RedHat ou ses dérivées ( CentOS, Alma, Rocky ) peut être restaurée sur une distribution Debian et inversement.
| Sauvegarde sous RHEL / CentOS 7 | Sauvegarde sous RHEL / Alma / Rocky 8 | Sauvegarde sous RHEL / Alma / Rocky 9 | Sauvegarde sous Debian 13 | |
|---|---|---|---|---|
| Restauration sous RHEL / CentOS 7 | Oui  | Oui | Oui | Oui |
| Restauration sous RHEL / Alma / Rocky 8 | Oui | Oui | Oui | Oui |
| Restauration sous RHEL / Alma / Rocky 9 | Oui | Oui | Oui | Oui |
| Restauration sous Debian 13 | Oui | Oui | Oui | Oui |
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 |
| Info |
|---|
La commande shinken-backup ne peut pas être exécutée dans les dossiers /etc/shinken et /etc/shinken-user |
Options pour la sauvegarde
| Scroll Title | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Scroll Title | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
--- | Sauvegarde les données de configuration anonymisées
--- | Sauvegarde les données du bac à événements
--- | Sauvegarde les logs.
--- | Permet de sauvegarder les données de tous les modules NON fournis par Shinken Enterprise ( exemple : le module mssql_export )
--- | Permet de sauvegarder les données d'un seul type de module NON fourni par Shinken Enterprise. À utiliser en complément de l'option --modules/-M.
--- | Permet de lister tous les types de modules NON fournis par Shinken Enterprise qui peuvent être sauvegardés.
--- | Sauvegarde les données de métrologie.configuration anonymisées
--- | Sauvegarde les données SLA.du bac à événements
--- | Sauvegarde les logs.
--- | Permet de sauvegarder les données de tous les modules NON fournis par Shinken Enterprise ( exemple : le module mssql_export les données des utilisateurs de l'interface de visualisation ( portails, listes, favoris, tableaux de bord... )
--- | Permet de sauvegarder les données d'un seul type de module NON fourni par Shinken Enterprise. À utiliser en complément de l'option --modules/-M.
--- | Permet de lister tous les types de modules NON fournis par Shinken Enterprise qui peuvent être sauvegardés.
--- | Sauvegarde les données de métrologie.
--- | Sauvegarde les données SLA.
--- | Sauvegarde les données des utilisateurs de l'interface de visualisation ( portails, listes, favoris, tableaux de bord... )
--- | Nom de la base de données MongoDB dans laquelle les données sont stockées. Cette option peut être utilisée en complément des options
|
Options de connexion à la base MongoDB
| excerpt-include | ||||||
|---|---|---|---|---|---|---|
|
Sauvegarde de données de configuration chiffrées
Lors de la sauvegarde de données de configuration avec des données protégées, la commande "shinken-backup" affiche un avertissement si la clé de chiffrement de la base n'a pas été exporté.
La sauvegarde est tout de même effectuée, mais il est préconisé d'effectuer un export de la clé en utilisant la commande "shinken-protected-fields-keyfile-export" ( voir la page shinken-protected-fields-keyfile-export ) .
| Panel |
|---|
|
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és.
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 remplacée | Description |
|---|---|---|
| address | clean address | Permets de masquer les adresses des équipements. |
| check_command | clean_command | Permets 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ées par la valeur "clean".
La liste des champs protégés est disponible via la commande shinken-protected-fields-data-manage.
Le nom de la sauvegarde générée sera succédé de "--anonymous" afin de le distinguer des sauvegardes par défaut.
| Info |
|---|
Exemple de nom de sauvegarde anonyme : 2020-10-27__10-49-55__V02.08.02-001_BUILD066.fr--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 complète d'un serveur hébergeant l'ensemble des démons
| Code Block | ||||
|---|---|---|---|---|
| ||||
root@vm-shinken: ~ $ shinken-backup Saving Events Events save size: 51M Saving Sla Sla save size: 147M Saving service-weather service-weather size: 2M Saving User User save size: 136K Saving Configuration Configuration save size: 17M Saving Metrology Metrology save size: 47M Saving Logs Logs save size: 1.1G Saving addons data Addons save size: 4.8M Saving custom modules data There is no custom modules in database to backup. Done : your backup directory is /root/shinken-backups/2021-02-02__08-22-45__V02.08.02-002.fr |
Sauvegarde sur un serveur hébergeant le démon Synchronizer
De la configuration:
| Panel |
|---|
|
Sauvegarde complète :
| Panel |
|---|
|
Erreur lors du Backup
Si le backup nécessite l'archivage de données depuis la base MongoDB, il est essentiel de vérifier la connectivité avant de lancer la sauvegarde de Shinken. En cas d'inaccessibilité de la base, un message s'affichera, indiquant les paramètres utilisés pour la tentative de connexion.
| Panel |
|---|
|
Lorsqu'une erreur survient pendant la sauvegarde, un message d'erreur indique la section où l'erreur s'est produite. Le dossier qui aurait dû contenir le contenu de la sauvegarde contiendra les logs d'erreurs.
Dans ce message est précisé le nom du dossier créé :
| Panel |
|---|
|
| Note |
|---|
La partie floutée du chemin de la capture d'écran correspond au dossier créé par le shinken-restore. |
Commande de restauration ( shinken-restore )
Utilisation
| Code Block | ||||
|---|---|---|---|---|
| ||||
shinken-restore DIRECTORY-TO-RESTORE |
Le dossier "DIRECTORY-TO-RESTORE" doit contenir au moins un des dossiers de sauvegarde suivant:
- configuration/
- context/
- events/
- logs/
- metrology/
- sla/
- user/
- weather/
Options pour la restauration
| Scroll Title | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Cette option nOptions de connexion à la base MongoDB
| excerpt-include | ||||||
|---|---|---|---|---|---|---|
|
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 signalant qu'elle est automatiquement exportée dans un fichier temporaire, en enjoignant de le déplacer en lieu sûr.
| Panel |
|---|
|
Si les deux clés sont différentes, il est nécessaire de spécifier l'option --with-key-backup suivi de l'export de la clé, qui permet de faire la restauration et de placer automatiquement la clé fournie.
En suivant, redémarrer le Synchronizer.
- Le Synchronizer refusera de démarrer tant que la clé n'est pas restaurée.
Si la clé est égarée, il est possible de la restaurer par l'intermédiaire du support Shinken ( voir la page shinken-protected-fields-keyfile-rescue-from-backup ).
| Panel |
|---|
|
Exemples
Restauration d'une sauvegarde complète de Shinken depuis le dossier ~/shinken-backups
| Code Block | ||||
|---|---|---|---|---|
| ||||
root@vm-shinken: ~/shinken-backups $ shinken-restore 2020-10-27__10-47-43__V02.08.02-001_BUILD066.fr__crypted-backup2 Stopping Shinken before restoring Restoring from 02.08.02-001_BUILD066.fr to 02.08.02-001_BUILD066.fr -Restoring Sla DONE -Restoring User DONE -Restoring Configuration DONE -Restoring Metrology DONE -Restoring Logs DONE -Restoring Weather 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/service-shinken start |
| Info | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Après la restauration des données, des actions automatiques ( sanitizes ) sont lancés. Ces actions permettent, si nécessaire, de mettre les données à jours vers la version de Shinken où sont restaurées les données. Une fois la restauration terminée, démarrer Shinken:
|
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 2020-10-27__10-47-43__V02.08.02-001_BUILD066.fr__crypted-backup2 Stopping Shinken before restoring Restoring from 02.08.02-001_BUILD066.fr to 02.08.02-001_BUILD066.fr -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/service-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 2020-10-27__10-47-43__V02.08.02-001_BUILD066.fr__crypted-backup2 Restoring from 02.08.02-001_BUILD066.fr to 02.08.02-001_BUILD066.fr -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-13__12-18-24__V02.08.02-004_BUILD08.fr/
Restoring from 02.08.02-004_BUILD08.fr to 02.08.02-004_BUILD08.fr
=> Restoring Configuration :
=> Checking encryption status for your current database : NOT ENCRYPTED
=> The keyfile used in the backup is the same as the one from the current configuration.
=> Stopping Shinken before restoring : DONE
=> Restoring configuration database : DONE
The backup you are restoring contains a encrypted Synchronizer database.
=> Setting addons state
nagvis : ENABLED
- [ WARNING ] Cannot find local broker daemon configuration in /etc/shinken/brokers. The 'Livestatus' module must be enabled manually in your broker configuration file for this addon to work properly.
nagvis-shinken-architecture : ENABLED
- [ WARNING ] Cannot find local broker daemon configuration in /etc/shinken/brokers. The 'Livestatus' module must be enabled manually in your broker configuration file for this addon to work properly.
- [ WARNING ] Cannot find local arbiter daemon configuration in /etc/shinken/arbiters. The 'architecture-export' module must be enabled manually in your arbiter configuration file for this addon to work properly.
=> Restoring configuration files : DONE
=> Restoring configuration : DONE
=> Restoring Sla : SKIPPED
No sla data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
=> Restoring service-weather : SKIPPED
No service-weather data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
=> Restoring Events : SKIPPED
No events data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
=> Restoring User : SKIPPED
No user data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
=> Restoring Metrology : SKIPPED
No metrology data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
=> Restoring Logs : DONE
=> Restoring Addons : DONE
=> Restoring custom modules data : SKIPPED
No custom modules data to restore in /tmp/shinken-backups/2021-04-13__12-18-24__V02.08.02-004_BUILD08.fr
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 : executed [OK]
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 : skip (unecessary)
fix_double_link : skip (unecessary)
fix_service_overrides_encryption : skip (unecessary)
fix_enable_synchronizer_database_module : skip (unecessary)
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 : skip (unecessary)
add_nmap_mac_prefixes_path_discovery : skip (unecessary)
update_notes_multi_url_syntax : skip (unecessary)
update_synchronizer_collector_linker_collection_for_cipher_transformation : skip (unecessary)
remove_pidfile_comment_in_mongodb_config_files : executed [OK]
cleanup_monitoring_pack : skip (unecessary)
remove_presence_protection : skip (unecessary)
fix_new_spare_daemon_broker_option : skip (unecessary)
change_work_area_info_for_multiple_users : skip (unecessary)
rename_graphite_scheduler_checks_metrics_files : skip (unecessary)
replace_duplicate_widgets_uuids : skip (unecessary)
add_sla_output_store_and_worker_options : skip (unecessary)
add_retry_options_to_synchronizer_import : skip (unecessary)
add_map_realm_layout_to_architecture_export_module : skip (unecessary)
clean_old_nagvis_shinken_tmp_files : skip (unecessary)
deleted_service_override_useless : skip (unecessary)
Restoration done. You can restart your Shinken with /etc/init.d/service-shinken start
|
Sauvegarde et restauration de la rétention du Scheduler
Pour l'instant, la rétention du Scheduler ne peut se sauvegarder et se restaurer que manuellement ( voir la page Sauvegarde et restauration manuelle de la rétention ).
Erreurs lors de la restauration
Lorsqu'une erreur arrive pendant le restore, on a un message d'erreur 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 |
|---|
|
| 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. |