Recherche dans <book_title>…

Guide de l'administrateur Veritas NetBackup™ for PostgreSQL

Last Published: 2021-07-28

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

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ée ? 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 à 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 ?
Etape 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

Résolution des problèmes NetBackup

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

Résolution des problèmes agent 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	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 de bibliothèque `libpq.so` correcte.	Vérifiez les éléments suivants et exécutez à nouveau 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 impossible à la base de données	La sauvegarde nbpgsql échoue si le fichier `nbpgsql.conf` est mis à jour avec un nom d'utilisateur ou un numéro de port qui n'est pas valide.	Pour ajouter le nom d'utilisateur de base de données et le numéro de port appropriés Configurez le nom d'utilisateur de base de données et le numéro du 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 NetBackup.	Pour réussir l'exécution d'une sauvegarde nbpgsql Mettez à jour le chemin d'accès à la variable d'environnement avec `NetBackup_install_path/bin`.
La sauvegarde nbpgsql échoue avec l'erreur suivante : Échec 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 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 la présence d'erreurs de communication entre l'agent nbpgsql et le serveur maître NetBackup. Pour plus d'informations, consultez le Guide d'administration de NetBackup.
(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 nbpgsqll ne restaure pas les données à 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 une restauration réussie 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 n'a pas 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. Le snapshot doit être équivalent ou supérieur à la taille 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 à nouveau la sauvegarde. Remarque : Les noms de snapshot LVM créés par nbpgsql contiennent le préfixe `pgsqlsnap`	Pour supprimer des 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 : "Échec 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`.	Vérifiez les éléments suivants et exécutez à nouveau 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 PGSQL_LIB_INSTALL_PATH est défini sur le chemin d'accès correct. 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/<snapshot_name>`. 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 : 1vremove -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 est réussie uniquement lorsque vous restaurez la sauvegarde sur un ordinateur de 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 l'agent PostgreSQL et NetBackup sont de même version pour des opérations de restauration réussies. Vérifiez que la version de PostgreSQL des données sauvegardées est la même que la version de PostgreSQL sur l'ordinateur sur lequel 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 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.