Recherche dans <book_title>…

Guide de l'administrateur NetBackup™ for PostgreSQL

Last Published: 2024-01-05

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

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 ultérieure à celle qui a été testée selon les listes de périphériques compatibles 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

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 :

chemin_installation\netbackup\logs\nbpgsql.log

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 que vous pouvez rencontrer lors de diverses opérations et les solutions correspondantes.

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	Vous pouvez rencontrer ce problème si le chemin d'accès à la bibliothèque n'est pas spécifié dans la commande nbpgsql à l'aide du commutateur "-l" ou s'il est spécifié mais ne contient pas `libpq.so` (Linux) ou `libpq.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 postgresql approprié, qui contient le fichier `libpq.so` (Linux) ou `libpq.dll` (Windows). (Linux) Si `libpq.so` n'est pas disponible, créez un lien symbolique nommé `libpq.so` qui pointe vers `libpq.so.<n>`. (Windows) Si `libpq.dll` n'est pas disponible dans le répertoire bin de l'emplacement d'installation de PostgreSQL, il se trouve peut-être dans le répertoire lib.
La sauvegarde nbpgsql échoue avec l'erreur suivante : Connexion impossible à la base de données	La sauvegarde PostgreSQL échoue lorsque la commande nbpgsql 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.	Pour ajouter le nom d'utilisateur de base de données et le numéro de port appropriés : Spécifiez le nom d'utilisateur de la base de données à l'aide du commutateur "-u" de la commande nbpgsql. Spécifiez le numéro de port de la base de données à l'aide du commutateur "-portnum" de la commande nbpgsql. 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 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 : Exécutez la commande suivante : $vgs La commande affiche les détails du groupe de volumes. 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 : Exécutez la commande suivante pour répertorier les snapshots existants : $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 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 Exécutez la commande suivante pour répertorier tous les systèmes de fichiers montés : $ 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éé sous `/mnt/<nom_snapshot>`. Les noms de préfixe pour le snapshot sont `pgsqlsnap`. Exécutez la commande suivante pour supprimer le répertoire de montage : $rm -rf <mount_directory> 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.
Le fichier `nbpgsql.conf` est manquant après l'installation de l'agent sur RHEL ou SUSE.	À partir de NetBackup 8.2, le fichier `nbpgsql.conf` n'est pas créé par défaut lorsque vous installez l'agent sur RHEL ou SUSE. Il est impossible d'écraser le fichier de configuration, car le programme d'installation du RPM remplace tous les fichiers du répertoire de destination `/usr/NBPostgreSQLAgent/`.	Si le fichier `nbpgsql.conf` n'existe pas, vous pouvez le créer en exécutant la commande de l'utilitaire de sauvegarde sans aucune option. Par exemple, `./nbpgsql`. Cette commande crée le fichier `nbpgsql.conf` par défaut.