Recherche dans <book_title>…

Guide de l'administrateur NetBackup™ for PostgreSQL

Last Published: 2022-05-10

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

Présentation de NetBackup for PostgreSQL
Installation de l'agent NetBackup for PostgreSQL
Configuration de NetBackup for PostgreSQL
1. Fichier de configuration nbpgsql.conf
2. Configuration de sauvegardes PostgreSQL avec des politiques de stockage de données
Sauvegarde et restauration de NetBackup for PostgreSQL
Dépannage de PostgreSQL
1. Correction des erreurs lors de l'utilisation de Agent NetBackup for PostgreSQL
Annexe A. Commandes et conventions de NetBackup for PostgreSQL
1. À propos des commandes Agent NetBackup for PostgreSQL
2. Conventions des commandes Agent NetBackup for PostgreSQL
Annexe B. Commandes de NetBackup for PostgreSQL
Index

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

Instructions générales de 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é d'effectuer ? Quelle méthode avez-vous utilisée ? Quels types de plate-forme serveur et de système d'exploitation étaient impliqués ? Si votre site utilise à la fois un serveur maître et un serveur de médias, s'agissait-il du serveur maître ou du serveur de médias ? Si un client était impliqué, de quel type de client s'agissait-il ? Êtes-vous déjà parvenu à effectuer cette opération auparavant ? 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 du microprogramme de votre 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 pouvant s'avérer précieuses : Journaux NetBackup. Journaux propres à la consignation Agent NetBackup for PostgreSQL. Journaux propres à l'interface XBSA NetBackup.
É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 vous ne pouvez pas résoudre le problème, contactez le support technique.

Correction des erreurs à l'aide des journaux et des rapports

Pour corriger les erreurs, vous pouvez consulter les journaux NetBackup, les journaux Agent NetBackup for PostgreSQL et l'interface XBSA NetBackup. Ces journaux se trouvent aux emplacements suivants :

Les journaux NetBackup se trouvent ici :

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 propres à Agent NetBackup for PostgreSQL se trouvent ici :

install_path\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 de NetBackup, consultez le Guide de dépannage de NetBackup et le Guide de référence des commandes NetBackup

Dépannage de Agent 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 lorsque le fichier `nbpgsql.conf` n'est pas mis à jour avec les éléments suivants : Emplacement du fichier de bibliothèque postgresql PGSQL_LIB_INSTALL_PATH ne pointe pas vers la version appropriée de la bibliothèque `libpq.so`.	Suivez les instructions ci-dessous et réexécutez la sauvegarde : Ajoutez ou mettez à jour l'emplacement du fichier de bibliothèque PostgreSQL dans le fichier `nbpgsql.conf`. Assurez-vous que `PostgreSQL_LIB_INSTALL_PATH` est défini sur le chemin d'accès correct. Il doit pointer vers la version de la bibliothèque `libpq.so`. Créez un lien symbolique `libpq.so` qui pointe vers `libpq.so.<n>`, où `n` est la version de la bibliothèque PostgreSQL. Pour plus d'informations, Se reporter à Conditions requises après l'installation pour Agent NetBackup for PostgreSQL.
La sauvegarde nbpgsql échoue avec l'erreur suivante : Connexion à la base de données impossible	La sauvegarde nbpgsql échoue si le fichier `nbpgsql.conf` est mis à jour avec un nom d'utilisateur ou un numéro de port non valide.	Pour ajouter le nom d'utilisateur et le numéro de port appropriés pour la base de données Configurez le nom d'utilisateur de base de données et le numéro de port appropriés dans le fichier `nbpgsql.conf` ou fournissez les options appropriées avec la commande nbpgsql. Pour plus d'informations, Se reporter à Fichier de configuration nbpgsql.conf.
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 réussir l'exécution d'une sauvegarde nbpgsql Mettez à jour le chemin d'accès à la variable d'environnement avec `chemin_installation_NetBackup/bin`.
La sauvegarde nbpgsql échoue avec l'erreur suivante : Echec du lancement de XBSA	La sauvegarde nbpgsql échoue si le fichier `nbpgsql.conf` n'est pas mis à jour avec les paramètres requis.	Pour réussir l'exécution de la sauvegarde nbpgsql Configurez le nom du serveur maître 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 d'administration de NetBackup.
(Windows) Echec de la création du 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 tant qu'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) Une erreur s'est produite 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 vérifier l'espace 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 équivalente ou supérieure à 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 de réexécuter 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 échoue avec l'erreur suivante : "Echec du chargement de la bibliothèque PostgreSQL"	Vous pouvez rencontrer ce problème lorsque le fichier `nbpgsql.conf` n'est pas mis à jour avec les éléments suivants : Emplacement du fichier de bibliothèque PostgreSQL. PGSQL_LIB_INSTALL_PATH ne pointe pas vers `libpq.so`.	Suivez les instructions ci-dessous et réexécutez la sauvegarde : Ajoutez ou mettez à jour l'emplacement du fichier de bibliothèque PostgreSQL dans le fichier `nbpgsql.conf`. Pour plus d'informations, Se reporter à Fichier de configuration nbpgsql.conf. Assurez-vous que le paramètre PGSQL_LIB_INSTALL_PATHest défini sur le chemin d'accès approprié. Il doit pointer vers `libpg.so.<n>`, où `n` est la version de la bibliothèque PostgreSQL. Créez un lien symbolique `libpq.so` qui pointe vers `libpq.so.<n>`, où `<n>` est la version de la bibliothèque PostgreSQL.
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_<timestamp> Remarque : <timestamp> est l'heure de prise du snapshot LVM	La sauvegarde nbpgsql échoue pendant une tentative de démontage du snapshot ou du périphérique, ou lorsque vous supprimez les 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éé dans `/mnt/<nom_snapshot>`. Les noms de snapshot contiennent le préfixe `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 lorsqu'une restauration aboutit, les services PostgreSQL ne démarrent pas.	L'opération de restauration aboutit uniquement lorsque vous restaurez la sauvegarde sur un ordinateur doté de la même version mineure de 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 les versions de l'agent PostgreSQL et de NetBackup sont identiques pour que les opérations de restauration aboutissent. Vérifiez que la version de PostgreSQL des données sauvegardées est identique à la version de PostgreSQL installée sur l'ordinateur sur lequel les données doivent être restauré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 simplement 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.