Guide de l'administrateur NetBackup™ for MongoDB
- Présentation de la protection de MongoDB à l'aide de NetBackup
- Vérifiez les conditions requises pour le plug-in MongoDB for NetBackup
- Configuration de NetBackup for MongoDB
- À propos de l'outil de configuration MongoDB
- Conditions requises pour la création manuelle du fichier mongodb.conf
- Configuration d'options de sauvegarde pour MongoDB à l'aide du fichier mongodb.conf
- Obtention de la clé RSA des nœuds MongoDB
- Ajout des informations d'authentification MongoDB dans NetBackup
- Conditions requises pour l'utilisateur de l'hôte
- Gestion des hôtes de sauvegarde
- Sauvegarde de MongoDB à l'aide de NetBackup
- Restauration ou récupération de données de MongoDB à l'aide de NetBackup
- À propos de la restauration de données MongoDB
- Conditions requises pour la restauration et la récupération MongoDB
- Restauration des données MongoDB sur le même cluster
- Restauration des données MongoDB sur un autre cluster
- Restauration de données MongoDB dans une configuration de haute disponibilité sur un autre client
- Étapes manuelles après le processus de récupération
- Dépannage
- Annexe A. Informations supplémentaires
Configuration d'options de sauvegarde pour MongoDB à l'aide du fichier mongodb.conf
Remarque :
si vous utilisez l'outil de configuration MongoDB, ces étapes manuelles ne sont pas requises.
NetBackup utilise les options par défaut pour sauvegarder les données MongoDB. Pour spécifier des options personnalisées à utiliser lors d'une opération de sauvegarde, vous devez créer un fichier mongodb.conf dans le répertoire /usr/openv/var/global/ sur un serveur principal UNIX et dans le répertoire <Install_Dir>\NetBackup\var\global\ sur un serveur principal Windows.
Attention :
le nom de fichier mongodb.conf est sensible à la casse.
Il n'est pas nécessaire de spécifier toutes les options dans le fichier mongodb.conf. NetBackup utilise les valeurs par défaut pour les options pour lesquelles aucune valeur personnalisée n'est définie.
Assurez-vous que le fichier mongodb.conf utilise le format JSON et ajoutez le chemin d'accès au fichier à la liste autorisée. Pour cela, utilisez l'option bpcd_allowed_path dans le fichier bp.conf.
Se reporter à Ajout du chemin d'accès au fichier de configuration à la liste autorisée du serveur principal NetBackup.
Vous pouvez spécifier les options de sauvegarde suivantes et leurs valeurs dans le fichier mongodb.conf :
Attention :
les options du fichier sont sensibles à la casse.
|
Options |
Détails |
|---|---|
|
application_servers |
Nom de domaine complet (FQDN), nom d'hôte ou nom court et numéro de port du serveur de configuration principal, et ports mongod et mongos au format suivant : clientFQDN_OR_hostname_OR_shortname:portnumber Assurez-vous que application_server correspond au nom d'hôte utilisé dans l'environnement MongoDB et vérifié à l'aide de la commande db.hostInfo(). Par exemple, le nom d'hôte affiché par db.hostInfo() : "hostname" : "<hostname_value>:<port>" Avertissement : n'indiquez pas le nom du nœud qui fait office de nœud arbitre pour MongoDB. |
|
alternate_config_server |
Nom de domaine complet (FQDN), nom d'hôte ou nom court et numéro de port du serveur de configuration secondaire ou de l'autre serveur de configuration. Vous ne pouvez ajouter qu'un autre serveur de configuration pour un cluster. La valeur doit être indiquée au format suivant : clientFQDN_OR_hostname_OR_shortname:portnumber Assurez-vous que alternate_config_server correspond au nom d'hôte utilisé dans l'environnement MongoDB et vérifié à l'aide de la commande db.hostInfo(). Par exemple, le nom d'hôte affiché par db.hostInfo() : "hostname" : "<hostname_value>:<port>" Si une connexion au serveur de configuration principal échoue, le premier autre serveur de configuration actif est utilisé. Pour les clusters MongoDB partitionnés, les processus mongod et mongos doivent être en cours d'exécution sur le serveur de configuration alternatif. Vous devez entrer la valeur de alternate_config_server séparément pour chaque entrée application_servers. |
|
cleanup_time_in_min |
Spécifiez le délai (en minutes) de nettoyage des snapshots ou oplogstore obsolètes créés lorsque des travaux sont annulés. La valeur spécifiée doit être un entier. |
|
free_space_percentage_snapshot |
Spécifie le pourcentage d'espace libre sur un groupe de volumes qui peut être utilisé pour créer un snapshot. Cette option est utilisée seulement pour les sauvegardes complètes. La valeur par défaut (si aucune valeur n'est spécifiée) est 20 %. La valeur doit être comprise entre 0 et 100. N'utilisez pas le symbole de pourcentage (%). Par exemple, exécutez la commande vgdisplay pour vérifier la valeur du champ "Free PE / Size". La valeur free_space_percentage_snapshot correspond au pourcentage de Free PE / Size du groupe de volumes dans lequel se trouvent les données. Définissez la valeur de free_space_percentage_snapshot en fonction du taux de changement des données de l'instance MongoDB lors de l'opération de sauvegarde et de l'espace disponible sur le groupe de volumes. Par exemple, lorsque :
Spécifiez ensuite 25 % comme valeur minimale pour free_space_percentage_snapshot. Si le pourcentage d'espace libre réservé aux snapshots est trop faible, les snapshots (et les sauvegardes ultérieures) risquent d'échouer. Si le pourcentage d'espace libre réservé aux snapshots est trop élevé, cela peut réduire l'espace disponible sur le groupe de volumes. Pour plus d'informations et pour découvrir d'autres pratiques standard, consultez la page du manuel Linux relative à la commande lvcreate. |
|
data_channel_tls |
Utilisez ce paramètre pour désactiver ou activer le chiffrement du canal de données entre le cluster MongoDB et l'hôte de sauvegarde. Par exemple, utilisez "data_channel_tls": false pour désactiver le chiffrement du canal de données. Par défaut, l'ensemble du trafic entre l'hôte de sauvegarde NetBackup et le client léger (mdbserver) s'effectue sur un canal TLS. Vous pouvez désactiver ce canal TLS pour le transfert de données du client léger (mdbserver) vers l'hôte de sauvegarde pour de meilleures performances. Remarque : Les données de contrôle et les données sensibles, telles que les informations d'authentification, sont toujours transférées sur le canal TLS lorsque cette option est désactivée. |
|
logdir |
Emplacement auquel les journaux ( L'emplacement par défaut est |
|
loglevel |
Spécifiez le niveau de consignation. La valeur par défaut est 3. Reportez-vous aux options suivantes pour les valeurs de niveau de consignation :
|
|
max_log_mbsize |
Spécifiez la taille maximale (en Mo) du fichier journal du client léger NetBackup. La taille par défaut est 10 Mo. Un nouveau fichier journal est créé chaque jour ou lorsque le fichier journal existant atteint la taille maximale autorisée. La création d'un fichier journal n'affecte pas les travaux en cours et la substitution du journal intervient lors du prochain travail exécuté par mdbserver. Le nettoyage des journaux est effectué tous les 30 jours. |
|
max_streams |
Remarque : Ce paramètre s'applique uniquement aux clusters MongoDB partitionnés. Définit le nombre de flux de données parallèles par hôte de sauvegarde. La valeur minimale est 32. Si max_streams n'est pas défini, la valeur par défaut est 32 flux de données parallèles par hôte de sauvegarde. Ajoutez l'entrée suivante au fichier mongodb.conf : max_streams:
{
"global_default":<set_value>,
"<backup_host>":<set_value>
}
Où :
Remarque : cette option définit le nombre maximal de flux de données parallèles par hôte de sauvegarde. Le travail de sauvegarde ou de récupération n'utilise pas nécessairement tous les flux disponibles. |
|
mdb_progress_loglevel |
Permet d'imprimer les informations de consignation de progression sur les fichiers restaurés dans le moniteur d'activité. La valeur par défaut est 0 (désactivée). Pour activer cette option, définissez "mdb_progress_loglevel": 1. Remarque : l'activation de cette option peut augmenter le temps de récupération. |
|
mdbserver_location |
Spécifiez un emplacement pour la copie des fichiers binaires du client léger ( Les fichiers sont copiés sur les serveurs sur lesquels sont stockées les données à protéger, puis supprimés une fois l'opération de sauvegarde terminée. L'emplacement de copie des fichiers par défaut est Remarque : ne spécifiez pas le chemin de montage ou les répertoires Linux de niveau supérieur pour éviter les conflits d'autorisations sur les répertoires. Par exemple, évitez de spécifier /root, /etc, /usr, /bin, /home, etc. comme chemin d'accès. |
|
mdbserver_port |
Port utilisé par l'hôte de sauvegarde pour se connecter au client léger NetBackup (mdbserver) en cours d'exécution sur le nœud MongoDB. La valeur par défaut est « Cette valeur est une chaîne. |
|
mdbserver_port_range |
Utilisez ce paramètre lorsque plusieurs instances mongod sont en cours d'exécution sur le même nœud MongoDB. Cette option vous permet d'utiliser le port disponible suivant dans la plage de l'opération de sauvegarde et de restauration si le port existant est utilisé. Cette option vous permet d'exécuter plusieurs travaux de sauvegarde simultanément sur différents ports en déployant plusieurs clients légers NetBackup (mdbserver). Entrez la valeur "mdbserver_port_range":range_value (où range_value est un nombre entier) pour définir la plage des numéros de port qui peuvent être utilisés. Par exemple, si vous ajoutez range_value avec la valeur 10 et que la valeur définie pour mdbserver_port est 12000, les ports 12000 à 12009 sont utilisés. La valeur par défaut est 10. Modifiez cette valeur en fonction du nombre d'instances mongod sauvegardées simultanément sur un hôte MongoDB. |
|
mdbserver_timeout_min |
Définit le délai d'attente (en minutes) avant l'arrêt d'un processus de client léger NetBackup (mdbserver). La valeur par défaut est 300 (minutes). Définissez une valeur supérieure à 300 minutes si votre fenêtre de sauvegarde nécessite plus de temps. Idéalement, mdbserver est arrêté après l'arrêt du plug-in ou à la fin de la sauvegarde. |
|
mongos_port |
Port utilisé par le processus mongos pour la communication. Ce paramètre est obligatoire pour les clusters MongoDB partitionnés. Vous devez spécifier cette valeur pour chacune des entrées application_servers ou alternate_config_server . Cette valeur se présente sous la forme d'une chaîne. |
|
oplog_location |
Pour les sauvegardes incrémentielles différentielles, spécifiez un répertoire personnalisé pour enregistrer le fichier L'emplacement est enregistré dans l'image de sauvegarde. L'emplacement par défaut est Assurez-vous que l'espace libre à cet emplacement est suffisant pour l'enregistrement des données oplog des sauvegardes incrémentielles. |
|
snapshot_mount_path |
Spécifiez le chemin d'accès sur les nœuds MongoDB pour le montage des snapshots LVM lors des sauvegardes complètes. Le chemin par défaut est |
Remarque :
assurez-vous que la valeur définie pour HostUser dans le fichier d'informations d'authentification MongoDB dispose des autorisations de lecture et d'écriture sur tous les chemins d'accès mentionnés dans le fichier mongodb.conf.
Si vous n'ajoutez pas toutes les options, une entrée relative aux options manquantes est ajoutée aux journaux. Les valeurs par défaut sont utilisées pour les options non mentionnées et l'opération de sauvegarde se poursuit.
{
"application_servers": {
"FQDN_primary_configuration_server_1:port": {
"alternate_config_server": [
{
"hostname:port": "FQDN_alternate_configuration_server_1:26051",
"mongos_port": "26051"
}
],
"mongos_port": "26052"
},
"FQDN_primary_configuration_server_2:port": {
"alternate_config_server": [
{
"hostname:port": "FQDN_alternate_configuration_server_2:26053",
"mongos_port": "26053"
}
],
"mongos_port": "26054"
}
},
"mdbserver_location": "/path/to/store/mdbserver/",
"logdir": "/path/to/store/logdir/",
"mdbserver_port": "21020",
"loglevel": 5,
"max_log_mbsize": 4,
"oplog_location": "/path/to/store/oplog/",
"free_space_percentage_snapshot": "25",
"mdb_progress_loglevel": 1,
"snapshot_mount_path": "/path/to/mount/snapshot/",
"max_streams":
{
"global_default":2,
"FQDN_backup_host_1":1
}
}