Guide de l'administrateur NetBackup™ for PostgreSQL

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

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

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

Le tableau suivant présente les étapes qui vous aideront à résoudre les problèmes que vous pouvez rencontrer lors de l'utilisation de Agent NetBackup for PostgreSQL.

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.

Saisissez les informations potentiellement utiles.

  • Journaux NetBackup.

  • Journaux propres à la consignation Agent NetBackup for PostgreSQL.

  • 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 et des rapports

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 :

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

  • <NetBackup_install_path>/netbackup/logs/exten_client

Dépannage de 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 PostgreSQL

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

Tableau : Dépannage de NetBackup for PostgreSQL

Problèmes

Description

Solution

La sauvegarde nbpgsql échoue avec l'erreur suivante :

Impossible de charger la bibliothèque postgresql

  

La sauvegarde nbpgsql échoue avec l'erreur suivante :

Connexion impossible à la base de données

 

Se reporter à Authentification du mot de passe de l'environnement PostgreSQL .

La sauvegarde nbpgsql échoue avec l'erreur suivante :

Impossible de charger xbsa.dll

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

Pour que la sauvegarde nbpgsql aboutisse :

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

La sauvegarde nbpgsql échoue avec l'erreur suivante :

Echec du lancement de l'interface XBSA

La sauvegarde nbpgsql échoue si le fichier nbpgsql.conf n'est pas mis à jour avec les paramètres requis.

Pour que la sauvegarde nbpgsql aboutisse :

  • Configurez le nom du serveur principal valide, le nom de la politique et le type de planification dans le fichier nbpgsql.conf ou à partir de la ligne de commande.

  • Vérifiez s'il existe des erreurs de communication entre l'agent nbpgsql 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 nbpgsql peut échouer lorsque l'utilisateur ne dispose pas des privilèges requis pour exécuter les opérations nbpgsql.

Exécutez cmd.exe en mode Administrateur.

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

La restauration nbpgsql échoue si le fichier nbpgsql.conf n'est pas mis à jour avec le nom du client NetBackup et le répertoire cible.

Pour que la restauration aboutisse :

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

  • Lancez la restauration à partir du client source NetBackup.

  • Définissez les paramètres de nom de client NetBackup et de répertoire cible dans le fichier nbpgsql.conf.

La sauvegarde nbpgsql échoue avec l'erreur suivante :

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

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

    $vgs

    La commande affiche les détails du groupe de volumes.

  2. Mettez à jour le fichier nbpgsql.conf avec 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 nbpgsql 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.

Remarque :

Les noms de snapshot LVM créés par nbpgsql contiennent le préfixe pgsqlsnap.

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. Pour supprimer les snapshots, exécutez la commande suivante :

    $ lvremove -f <volume_group>/<snapshot_name>

La sauvegarde nbpgsql 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 - pgsqlsnap_<horodatage>

Remarque :

<horodatage> correspond à l'heure à laquelle le snapshot LVM a été effectué.

La sauvegarde nbpgsql é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. Exécutez la commande suivante pour répertorier tous les systèmes de fichiers montés :

    $ 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 pgsqlsnap.

  3. Exécutez la commande suivante pour supprimer le répertoire de montage :

    $rm -rf <mount_directory>

  4. Exécutez la commande suivante pour supprimer le snapshot manuellement :

    lvremove -f <volume_group>/<snapshot_name>

Même après une restauration réussie, les services PostgreSQL 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 PostgreSQL.

Par exemple, si vous sauvegardez un fichier à partir de PostgreSQL version 9.6.x, vous devez restaurer le fichier sur un ordinateur avec PostgreSQL version 9.6.x.

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

La restauration ou la restauration et la récupération à partir d'images créées avant la mise à niveau échouent avec le message d'erreur suivant :

2816 DataStore policy restore

La restauration ou la restauration et la récupération à partir d'images créées avant la mise à niveau échouent avec une erreur lorsque les versions du serveur de médias et du client ne correspondent pas.

Assurez-vous que les versions du client et du serveur de médias correspondent pour l'opération de restauration ou de restauration et de récupération.