Guide de l'administrateur NetBackup™ for MySQL

Last Published:
Product(s): NetBackup & Alta Data Protection (10.1)

Correction des erreurs pour Agent NetBackup for MySQL

Pour corriger les erreurs, vous pouvez consulter les journaux NetBackup.

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

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

install_path\netbackup\logs\nbmysql.log

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

<NetBackup_install_path>/netbackup/logs/exten_client

Étapes préliminaires

Vérifiez les éléments suivants avant de résoudre les problèmes :

  • Toutes les conditions préalables sont respectées.

  • Tous les ordinateurs disposent de versions de système d'exploitation compatibles.

  • Les journaux de débogage et les rapports sont vérifiés à la recherche d'erreurs.

Dépannage de NetBackup

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

Dépannage de NetBackup pour les opérations MySQL

Tableau : Dépannage des sauvegardes et des restaurations NetBackup for MySQL

Problèmes

Description

Solution

La sauvegarde nbmysql échoue avec l'erreur suivante :

Une erreur est survenue pendant la sauvegarde

La sauvegarde nbmysql peut échouer pour l'une des raisons suivantes :

  • Le serveur de médias ou le client NetBackup exécute NetBackup 8.0 ou une version antérieure.

  • La case Activer la communication non sécurisée avec des hôtes exécutant NetBackup 8.0 et des versions antérieures n'est pas cochée.

  • Le certificat d'ID de l'hôte NetBackup qui existe sur le client MySQL n'est pas valide.

Pour une sauvegarde réussie, effectuez l'une des opérations suivantes :

  • Mettez à niveau le serveur de médias ou le client afin d'utiliser NetBackup 8.1 ou versions ultérieures.

  • Dans la console d'administration NetBackup, sous Gestion de la sécurité > Paramètres de sécurité globaux, cochez la case Activer la communication non sécurisée avec l'option NetBackup 8.0 et des hôtes antérieurs.

  • Vérifiez le certificat d'ID de l'hôte NetBackup. Vous pouvez obtenir manuellement le certificat d'ID de l'hôte. Pour plus d'informations, consultez

    www.veritas.com/support/en_US/article.000127129

L'agent nbmysql ne parvient pas à lancer une opération.

L'agent MySQL affiche une erreur liée à l'absence du fichier I18N. Vous pouvez rencontrer ce problème lorsque vous lancez l'agent.

Lorsque l'agent ne parvient pas à lancer des opérations en raison de l'absence du fichier I18N, copiez le fichier de langue à l'emplacement du programme d'installation de l'agent, puis exécutez les opérations.

La sauvegarde nbmysql échoue avec l'erreur suivante :

Impossible de charger la bibliothèque MySQL

Vous pouvez rencontrer ce problème si le chemin d'accès à la bibliothèque n'est pas spécifié dans la commande nbmysql à l'aide du commutateur "-l" ou s'il est spécifié mais ne contient pas libmysql.so (Linux) ou libmysql.dll (Windows).

Vérifiez les éléments suivants et réexécutez la sauvegarde :

  • Veillez à spécifier le chemin d'accès à la bibliothèque mysql approprié, qui contient le fichier libmysql.so (Linux) ou libmysql.dll (Windows).

  • (Linux) Si libmysql.so n'est pas disponible, créez un lien symbolique nommé libmysql.so qui pointe vers libmysql.so.<n>.

  • (Windows) Si libmysql.dll n'est pas disponible dans le répertoire bin de l'emplacement d'installation de mysql, il se trouve peut-être dans le répertoire lib.

La sauvegarde de nbysql échoue avec le message d'erreur suivant :

Connexion impossible à la base de données

La sauvegarde mysql échoue lorsque la commande nbmysql 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 nbmysql.

  • Spécifiez le numéro de port de la base de données à l'aide du commutateur "-portnum" de la commande nbmysql.

  • 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 MySQL.

La sauvegarde nbmysql échoue avec l'erreur suivante :

Impossible de charger xbsa.dll

La sauvegarde nbmysql échoue si le chemin d'accès à la variable d'environnement n'est pas mis à jour avec le répertoire bin de NetBackup.

Pour qu'une sauvegarde MySQL aboutisse :

  • Mettez à jour le chemin d'accès à la variable d'environnement avec NetBackup_install_path/bin.

La sauvegarde nbmysql échoue avec l'erreur suivante :

Echec du lancement de l'interface XBSA

La sauvegarde nbmysql échoue si les paramètres requis ne sont pas spécifiés dans la ligne de commande.

Pour exécuter correctement la sauvegarde NetBackup :

  • Spécifiez un nom de serveur principal, un nom de politique et un type de planification valides dans la ligne de commande.

    Pour plus d'informations,

  • Vérifiez s'il existe des erreurs de communication entre l'agent et le serveur principal NetBackup. Pour plus d'informations, consultez le Guide de l'administrateur NetBackup, volume I.

La sauvegarde nbmysql 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 de snapshot-mysqlsnap_<timestamp>

Remarque :

<timestamp> est l'heure à laquelle le snapshot LVM a été effectué.

La sauvegarde nbmysql é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 :

  1. Obtenez la liste de tous les systèmes de fichiers montés à l'aide de la commande suivante :

    $ mount-l

  2. 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éé sous /mnt/<snapshot_name>. Les noms de préfixe pour le snapshot sont mysqlsnap.

  3. Pour supprimer le répertoire de montage, exécutez la commande suivante :

    $rm -rf <mount_directory>

  4. Pour supprimer le snapshot manuellement, exécutez la commande suivante :

    1vremove -f <volume_group>/<snapshot_name>

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 nbmysql renvoie ces erreurs lorsque le groupe de volumes contient les snapshots. Vous pouvez répertorier les snapshots, puis les supprimer avant d'exécuter de nouveau la sauvegarde.

Pour supprimer les snapshots :

  1. Exécutez la commande suivante pour répertorier les snapshots existants :

    $lvs

    La commande affiche les détails des snapshots.

  2. Exécutez la commande suivante pour supprimer les snapshots :

    $ lvremove -f <volume_group>/<snapshot_name>

La sauvegarde nbmysql échoue avec l'erreur suivante :

(Linux) Erreur lors de la création du snapshot LVM

La sauvegarde nbmysql 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 :

  1. Exécutez la commande suivante pour afficher les détails du groupe de volumes :

    $vgs

  2. Indiquez la taille de snapshot appropriée.

    Vérifiez que la taille du snapshot est au moins équivalente à celle de l'instance.

(Windows) Échec de la création de snapshot VSS

La sauvegarde nbmysql peut échouer lorsque l'utilisateur ne dispose pas des privilèges requis pour exécuter les opérations nbmysql.

Exécutez cmd.exe en mode Administrateur.

L'opération de restauration nbmysql ne restaure aucune donnée à partir du client NetBackup cible.

La restauration nbmysql échoue si le nom du client NetBackup n'est pas mis à jour.

Ajoutez ou mettez à jour le nom du client NetBackup.

Pour plus d'informations,

La restauration nbmysql échoue lorsque vous la déclenchez à partir du client cible.

La restauration nbmysql échoue si le répertoire cible n'est pas valide ou n'est pas vide.

La restauration peut également échouer lorsque vous lancez une restauration redirigée depuis le client cible NetBackup au lieu du client source NetBackup.

Pour que la restauration aboutisse :

  • Vérifiez que le répertoire cible est valide et vide.

  • Lancez la restauration à partir du client source NetBackup.

Erreur de type exception pendant les sauvegardes et les restaurations.

Les sauvegardes et restaurations nbmysql échouent si l'espace disque n'est pas suffisant pour ces opérations.

Vérifiez que l'espace disque est supérieur à la taille de la base de données MySQL, et lancez les sauvegardes ou les restaurations.

Remarque :

Environ 50 % d'espace en plus de la taille de la base de données MySQL est requis pour les sauvegardes et les restaurations.

Même après une restauration réussie, les services MySQL ne démarrent pas.

L'opération de restauration est réussie uniquement lorsque vous restaurez la sauvegarde sur un ordinateur de la même version mineure que MySQL.

Par exemple, si vous sauvegardez un fichier à partir de MySQL 5.5.x, vous devez le restaurer sur un ordinateur doté de MySQL 5.5.x.

  • Vérifiez que la version de MySQL des données sauvegardées est identique à la version de MySQL sur l'ordinateur sur lequel vous souhaitez restaurer les données.