Recherche dans <book_title>…

Guide de l'administrateur NetBackup™ for MariaDB

Last Published: 2025-04-24

Product(s): NetBackup & Alta Data Protection (11.0)

Correction des erreurs lors de l'utilisation de NetBackup for MariaDB

Instructions générales pour la résolution des problèmes

Tableau : Étapes générales de résolution des problèmes répertorie les étapes générales qui vous aideront à résoudre les problèmes que vous pouvez rencontrer lors de l'utilisation de NetBackup for MariaDB Agent.

Tableau : Étapes générales de résolution des problèmes

Étapes	Action	Description
Étape 1	Souvenez-vous du message d'erreur.	Des messages d'erreur s'affichent généralement en cas de problème. Si vous ne voyez aucun message d'erreur sur la ligne de commande, mais suspectez néanmoins un problème, consultez les rapports et les journaux. Ils peuvent fournir un message d'erreur pointant directement vers le problème. Les journaux et les rapports sont des outils essentiels pour le dépannage.
Étape 2	Identifiez ce que vous faisiez quand le problème est survenu.	Posez les questions suivantes : Quelle opération avez-vous tentée ? Quelle méthode avez-vous utilisée ? Quels types de plate-forme serveur et de système d'exploitation étaient concernés ? Si votre site utilise un serveur principal et un serveur de médias, lequel des deux était concerné ? Si un client était concerné, de quel type de client s'agissait-il ? Êtes-vous déjà parvenu à exécuter cette opération par le passé ? Si oui, en quoi votre environnement diffère-t-il à présent ? Quel est le niveau de Service Pack ? Utilisez-vous les derniers correctifs disponibles pour le système d'exploitation, notamment ceux requis pour l'utilisation de NetBackup ? La version de votre microprogramme de périphérique est-elle équivalente ou supérieure à celle qui a été testée selon les listes de compatibilité de périphérique publiées ?
Étape 3	Enregistrez toutes les informations.	Enregistrez les informations qui peuvent être utiles : Journaux NetBackup. Journaux propres à la consignation NetBackup for MariaDB. Journaux spécifiques à NetBackup XBSA.
Étape 4	Corrigez le problème.	Après avoir défini le problème, utilisez les informations disponibles pour le corriger.
Étape 5	Contactez le support technique.	Si le problème persiste, contactez le support technique.

Correction des erreurs à l'aide des journaux

Pour corriger les erreurs, vous pouvez consulter les journaux NetBackup. Ces journaux se trouvent aux emplacements suivants :

Les journaux du serveur principal NetBackup se trouvent à l'emplacement suivant :

install_path\NetBackup\logs\bprd
chemin_installation\NetBackup\logs\bpbrm
chemin_installation\NetBackup\logs\user_ops\dbext\logs

Vous devez activer les fichiers journaux bprd et bpcd. Pour plus d'informations, consultez le Guide de dépannage NetBackup.

Les journaux spécifiques au client NetBackup se trouvent à l'emplacement suivant :

install_path\NetBackup\logs\nbmariadb

Les journaux propres à l'interface NetBackup XBSA se trouvent ici :

install_path\NetBackup/logs/exten_client

Dépannage des erreurs NetBackup

Pour le dépannage des erreurs NetBackup, consultez le Guide de dépannage NetBackup et le Guide de référence des commandes NetBackup.

Dépannage des erreurs NetBackup for MariaDB

Tableau : Dépannage de NetBackup for MariaDB répertorie les erreurs et les solutions de dépannage lors de l'exécution des opérations.

Tableau : Dépannage de NetBackup for MariaDB

Problèmes	Description	Solution
La sauvegarde nbmariadb échoue avec l'erreur suivante : Impossible de charger la bibliothèque mariadb	Vous pouvez rencontrer ce problème si le chemin d'accès à la bibliothèque n'est pas spécifié dans la commande nbmariadb à l'aide du commutateur "-l" ou s'il est spécifié mais ne contient pas `libmariadb.so` (Linux) ou `libmariadb.dll` (Windows).	Vérifiez les éléments suivants et réexécutez la sauvegarde : Veillez à spécifier le chemin d'accès approprié à la bibliothèque MariaDB, qui contient le fichier `libmariadb.so` (Linux) ou `libmariadb.dll` (Windows). (Linux) Si le fichier `libmariadb.so` n'est pas disponible, créez un lien symbolique nommé `libmariadb.so` et pointant vers `libmariadb.so.<n>`. (Windows) Si le fichier `libmariadb.dll` n'est pas disponible dans le répertoire bin à l'emplacement d'installation de MariaDB, il se trouve peut-être dans le répertoire lib.
La sauvegarde nbmariadb échoue avec l'erreur suivante : Connexion impossible à la base de données	La sauvegarde mariadb échoue lorsque la commande nbmariadb est exécutée avec un nom d'utilisateur de base de données, un numéro de port ou un mot de passe non valide.	Spécifiez le nom d'utilisateur de la base de données à l'aide du commutateur "-u" de la commande nbmariadb. Spécifiez le numéro de port de la base de données à l'aide du commutateur "-portnum" de la commande nbmariadb. Spécifiez le mot de passe de base de données à l'aide du fichier `my.cnf` (Linux) ou `my.ini` (Windows). Se reporter à Authentification du mot de passe de l'environnement MariaDB.
La sauvegarde nbmariadb échoue avec l'erreur suivante : Impossible de charger xbsa.dll	La sauvegarde nbmariadb échoue si le chemin d'accès à la variable d'environnement n'est pas mis à jour avec le répertoire bin de NetBackup.	Pour exécuter une sauvegarde nbmariadb : Mettez à jour le chemin d'accès à la variable d'environnement avec `NetBackup_install_path/bin`.
La sauvegarde nbmariadb échoue avec l'erreur suivante : Echec du lancement de l'interface XBSA	La sauvegarde nbmariadb échoue si les paramètres requis ne sont pas spécifiés dans la ligne de commande.	Pour exécuter la sauvegarde nbmariadb : Spécifiez un nom de serveur principal, un nom de politique et un type de planification valides dans la ligne de commande. Vérifiez s'il existe des erreurs de communication entre l'agent nbmariadb et le serveur principal NetBackup. Pour plus d'informations, consultez le Guide de l'administrateur NetBackup, volume I.
(Windows) Échec de la création de snapshot VSS	La sauvegarde nbmariadb peut échouer lorsque l'utilisateur ne dispose pas des privilèges requis pour exécuter les opérations nbmariadb.	Exécutez cmd.exe en mode Administrateur.
L'opération de restauration nbmariadb ne restaure aucune donnée à partir du client NetBackup cible.	La restauration nbmariadb échoue si le nom du client NetBackup et le répertoire cible ne sont pas mis à jour.	Pour que la restauration aboutisse : Vérifiez que le répertoire cible est valide et vide. Lancez la restauration à partir du client source NetBackup. Spécifiez le nom du client NetBackup et le répertoire cible.
La sauvegarde nbmariadb échoue avec l'erreur suivante : (Linux) Erreur lors de la création du snapshot LVM	La sauvegarde nbmariadb peut échouer lorsque le groupe de volumes ne dispose pas de suffisamment d'espace pour le snapshot.	Pour afficher l'espace disponible dans le groupe de volumes Pour afficher l'espace sur le volume, exécutez la commande suivante : $vgs La commande affiche les détails du groupe de volumes. Indiquez la taille de snapshot appropriée. La taille du snapshot doit être au moins équivalente à celle de l'instance.
Messages d'erreur après une sauvegarde réussie : <volume_group>/<snapshot_name> Échec de lecture après 0 de 4096 sur 29393616896 : erreur d'entrée ou de sortie. OU <volume_group>/<snapshot_name> : échec de lecture après 0 de 4096 sur 4096 : erreur d'entrée ou de sortie.	La sauvegarde nbmariadb renvoie ces erreurs lorsque le groupe de volumes contient les snapshots. Vous pouvez répertorier les snapshots, puis les supprimer avant d'exécuter à nouveau la sauvegarde. Remarque : les noms des snapshots LVM créés par nbmariadb contiennent le préfixe `mariadbsnap`.	Pour supprimer les snapshots : Pour répertorier les snapshots existants, exécutez la commande suivante : $lvs La commande affiche les détails des snapshots. Pour supprimer les snapshots, exécutez la commande suivante : $ lvremove -f <volume_group>/<snapshot_name>
La sauvegarde nbmariadb sous Linux (LVM) échoue avec l'erreur suivante : Erreur lors du démontage du snapshot - Périphérique ou ressource non disponible OU Erreur lors de la suppression du snapshot - mariadbsnap_<timestamp>	La sauvegarde nbmariadb échoue lors d'une tentative de démontage du snapshot ou du périphérique, ou lors de la suppression des snapshots existants.	Pour démonter le snapshot Pour obtenir la liste de tous les systèmes de fichiers montés, exécutez la commande suivante : $ mount-l Si le snapshot existe toujours, créez un répertoire de montage à l'aide de la commande suivante : $mount<mount_directory> Remarque : Ce répertoire est créé dans `/mnt/<snapshot_name>`. Les noms de préfixe des snapshots sont `mariadbsnap`. Pour supprimer le répertoire de montage, exécutez la commande suivante : $rm -rf <mount_directory> Pour supprimer le snapshot manuellement, exécutez la commande suivante : $ lvremove -f <volume_group>/<snapshot_name>
Même après une restauration réussie, les services MariaDB ne démarrent pas.	L'opération de restauration aboutit uniquement lorsque vous restaurez la sauvegarde sur un ordinateur exécutant la même version mineure que MariaDB. Par exemple, si vous sauvegardez un fichier à partir de MariaDB 10.2.x, vous devez le restaurer sur un ordinateur doté de MariaDB 10.2.x.	Vérifiez que la version de MariaDB des données sauvegardées est identique à la version de MariaDB sur l'ordinateur sur lequel vous souhaitez restaurer les données.