Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bperror — afficher l'état de NetBackup et les informations ou les entrées de dépannage du catalogue d'erreurs de NetBackup
Synopsis
{-S | -statuscode code_état} [-r | -recommendation] [[-p Unx | NTx] | [-platform Unx | NTx]] [-v]
[-all | -problems | -media | tape] {-backstat [-by_statcode]} [-L | -l | -U] [-columns ncols] [-d date | -hoursago heures] [-e date] [-client nom_client] [-server nom_serveur] [-jobid id_travail] [-M serveur_maître,...] [-v]
[-s {gravité[+]}|gravité ...] [-t type ...] [-dt type_disque] [-L | -l | -U] [-columns ncols] [-d date | -hoursago heures] [-e date] [-client nom_client] [-server nom_serveur] [-jobid id_travail] [-M serveur_maître,...] [-v]
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/netbackup/bin/admincmd/
Sur les systèmes Windows, le chemin d'accès à cette commande est chemin_d'accès\NetBackup\bin\admincmd\
DESCRIPTION
bperror affiche les informations de la même source que le programme de dépannage en ligne (dans le moniteur d'activité ou des applications de rapports) ou du catalogue d'erreur de NetBackup. bperror fournit les types d'affichages suivants :
Un affichage du message qui correspond à un code d'état et, en option, à une recommandation concernant la manière de dépanner le problème. Dans ce cas, les résultats affichés viennent de la même source que le programme de dépannage en ligne du système local.
Un affichage des rubriques de catalogue d'erreur qui satisfont les options de ligne de commande. Par exemple, bperror peut afficher toutes les entrées de problème pour la veille.
Un affichage des rubriques de catalogue d'erreur qui correspond à une gravité et à un type de message de message particuliers.
Pour plus d'informations sur l 'affichage, consultez les FORMATS D'AFFICHAGE plus loin dans cette description de commande.
bperror enregistre ses informations de débogage de journal sur le répertoire suivant :
Sur les systèmes Windows : install_path\NetBackup\logs\admin
Sur les systèmes UNIX : /usr/openv/netbackup/logs/admin
Vous pouvez utiliser les informations se trouvant dans ce répertoire à des fins de dépannage.
La sortie de bperror va à la sortie standard.
OPTIONS
- -all, -backstat [-by_statcode], -media, -problems
Ces options spécifient le type et la gravité des messages de journal à afficher. Le type par défaut est ALL. La gravité par défaut est ALL.
-all : le type est ALL et la gravité est ALL. Exécutez bperror avec cette option et avec -U pour produire un rapport Toutes les entrées de journal.
-backstat : le type est BACKSTAT et la gravité est ALL. Si -by_statcode est présent, l'affichage contient une entrée pour chaque code d'état unique. La ligne 1 de l'entrée contient le code d'état et le texte du message correspondant. La ligne 2 de l'entrée contient la liste des clients pour lesquels ce code d'état s'est produit. -by_statcode est seulement valide lorsque la ligne de commande contient -backstat et -U. Exécutez bperror avec cette option et avec -U pour produire un rapport Etat des sauvegardes.
-media : le type est MEDIADEV et la gravité est ALL. Exécutez bperror avec cette option et avec -U pour produire un rapport Journaux de médias.
-problems : le type est ALL et la gravité est l'union de WARNING, ERROR et CRITICAL. Exécutez bperror avec cette option et avec -U pour produire un rapport Problèmes.
- -client client_name
Spécifie le nom d'un client NetBackup. Ce nom doit être identique à celui présent dans le catalogue NetBackup. Par défaut, bperror recherche tous les clients.
- -columns ncols
Pour les rapports -L et -U, -columns fournit une limite supérieure approximative sur la longueur de ligne maximum. bperror ne tente pas de produire des lignes contenant le nombre de caractères de ncols exacts.
-columns ne s'applique pas au rapport -l.
ncols doit contenir au moins 40 caractères. Le paramètre par défaut est 80.
- -d date, -e date
Spécifie la plage des dates de début et de fin de la liste.
L'option -d spécifie une date et une heure (facultative) de début de la liste. La liste générée affiche uniquement les images se trouvant dans les sauvegardes ou les archivages survenues aux date et heure spécifiées ou ultérieurement. La plage valide des dates s'étale entre le 01/01/1970 0h00 : 00 et le 01/19/2038 3h14 : 07. Le paramètre par défaut correspond aux date et heure en cours moins 24 heures.
L'option -e spécifie la date et l'heure (facultative) de fin de la liste. La liste générée affiche uniquement les fichiers provenant des sauvegardes ou des archivages survenues aux date et heure spécifiées ou précédemment. Utilisez le même format que celui de la date de début. Par défaut, il s'agit de la date et de l'heure en cours. La date de fin doit être supérieure ou égale à la date de début.
Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Le fichier
/user/openv/msg/.conf
(UNIX) et le fichierinstall_path\VERITAS\msg\LC.CONF
(Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.Pour plus d'informations sur les paramètres régionaux de votre système, consultez la rubrique "A propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
Ce qui suit est un format typique pour les options -d et -e :
[-d mm/dd/yyyy hh:mm:ss | -hoursago hours] [-e mm/dd/yyyy hh:mm:ss]
- -dt type_disque
Permet à l'utilisateur de spécifier un type de disque. Vous pouvez spécifier les valeurs suivantes pour la chaîne disk_type :
0 - Tout
1 - BasicDisk
3 - SnapVault
6 - DiskPool
- -hoursago hours
Spécifie une heure de début, située des heures en arrière, ce qui revient à spécifier une heure de début (-d) sur l'heure actuelle moins plusieurs heures. Les heures sont des entiers. Le paramètre par défaut est 24, soit une heure de début 24 heures avant l'heure actuelle.
- -jobid id_travail
Spécifie une ID de travail de NetBackup. Par défaut, bperror recherche tous les ID de travail.
- -L
Rapports au format long.
- -l
Rapports au format court. Ce rapport produit une liste courte. Cette option sert aux scripts ou programmes qui transforment le contenu des listes en un rapport formaté. Cette option est le type de liste par défaut.
- -M master_server,...
Spécifie une liste séparée par des virgules d'un ou plusieurs noms d'hôte. La commande est exécutée sur chacun des serveurs maîtres de cette liste. Les serveurs maîtres doivent autoriser l'accès par le système ayant émis la commande. En cas d'erreur sur un serveur maître quelconque, le processus s'interrompt à l'entrée de ce serveur dans la liste. Par défaut, il s'agit du serveur maître du système sur lequel la commande est entrée.
- -p Unx | NTx, -platform Unx | NTx
Affiche le message qui s'applique à la plate-forme (UNIX ou Windows) pour le code d'état spécifié. Le paramètre par défaut est d'afficher le message pour la plate-forme sur laquelle bperror est exécuté. Lorsque vous utilisez cette option, vous devez spécifier l'option -S ou -statuscode.
- -r | -recommendation
Affiche l'action recommandée pour le code d'état spécifié dans le Guide de référence des codes d'état NetBackup. Le paramètre par défaut n'est pas d'afficher la recommandation. Lorsque vous utilisez cette option, vous devez spécifier l'option -S ou -statuscode.
- -S code_état, -statuscode code_état
Affiche le message qui correspond au code d'état. Cette option n'a aucune condition par défaut.
- -s gravité, -s gravité+
Spécifie la gravité des messages de journal à afficher. Les valeurs définies sont ALL, DEBUG, INFO, WARNING, ERROR et CRITICAL.
Vous pouvez spécifier la gravité de deux manières. La première manière utilise une liste d'une ou plusieurs valeurs de gravité. Par exemple, "-s INFO ERROR" affiche les messages avec la gravité INFO ou ERROR. Le délimiteur doit être un espace blanc (" ") entre les éléments de la liste. La deuxième manière utilise une valeur de gravité unique à laquelle est ajouté "+", qui signifie la gravité définie ou une gravité ultérieure. Par exemple," -s WARNING+" affiche les messages avec les valeurs de gravité WARNING, ERROR et CRITICAL.
La valeur par défaut est ALL. La valeur de gravité peut être en majuscules ou en minuscules.
- -server server_name
Spécifie le nom d'un serveur NetBackup. Ce nom doit être identique à celui présent dans le catalogue NetBackup. L'affichage se limite aux messages qui sont consignés pour ce serveur, qui répond également aux critères pour toutes les autres options de bperror. Par exemple, si -server plim et -hoursago 2 sont des options de bperror, l'affichage contient les messages qui ont été consignés pour
plim
au cours des deux dernières heures.Le nom du serveur doit correspondre à celui qui a été enregistré dans les messages de journal. Par exemple, si les journaux enregistrent le nom du serveur comme étant plim.null.com, -server plim n'affiche pas les journaux, mais -server plim.null.com le fait.
La demande est dirigée au catalogue d'erreurs qui réside sur le serveur maître local ou le serveur maître que -M spécifie. Le serveur maître doit permettre l'accès par le système qui exécute bperror.
Le paramètre par défaut est d'afficher les messages de journal pour tous les serveurs de médias qui sont connus par le ou les serveurs maîtres.
- -t type
Spécifie le type des messages de journal à afficher. Les valeurs définies sont ALL, BACKSTAT, MEDIADEV, GENERAL, BACKUP, ARCHIVE, RETRIEVE et SECURITY. La valeur par défaut est ALL. La valeur de type peut être en majuscules ou en minuscules. Elle est entrée sous forme de liste d'une ou plusieurs valeurs. Par exemple, -t BACKSTAT MEDIADEV affiche les messages avec le type BACKSTAT ou MEDIADEV. Le délimiteur entre les éléments de liste doit être un blanc (" ").
- -U
Rapports au format utilisateur. Les outils de génération de rapports NetBackup, tels que l'application de rapports de NetBackup-Java, utilisez ce rapport.
- -v
Mode détaillé. Cette option demande à bperror de consigner des informations supplémentaires pour le débogage qui sont ajoutées dans le journal de débogage quotidien de NetBackup-administration. -v est significatif seulement quand le répertoire de débogage de NetBackup est activé (répertoire install_path\NetBackup\logs\admin/usr/openv/netbackup/logs/admin défini). Le paramètre par défaut est de ne pas être en mode détaillé.
FORMATS D'AFFICHAGE
Les formats d'affichage qui suivent sont ceux de la commande bperror :
L'affichage du code d'état (par exemple, bperror -S status_code) :
bperror interroge le programme de dépannage en ligne de NetBackup sur le système local pour le message qui correspond au code d'état. bperror affiche le texte du message sur une ligne et une explication sur une deuxième ligne.
Si -r est une option, bperror interroge également la recommandation de dépannage qui correspond au code d'état. bperror affiche la recommandation après le message d'état, sur une ou plusieurs lignes.
Le catalogue d'erreur s'affiche (par exemple, bperror -all; bperror -s severity) :
bperror interroge le catalogue d'erreur de NetBackup sur le serveur maître local ou les serveurs maîtres dans la liste d'options -M. L'affichage comprend les résultats renvoyés par le catalogue d'erreur sur les serveurs maîtres. Les résultats sont limités au catalogage des entrées qui satisfont toutes les options de bperror. Par exemple, la ligne de commande bperror peut contenir des options pour le client, l'heure de début et l'heure de fin. Si c'est le cas, alors bperror signale uniquement les travaux exécutés pour ce client entre l'heure de début et l'heure de fin.
La variante d'affichage qui affiche différentes entrées de message du catalogue d'erreur peut apparaître au format long (-L), utilisateur (-U) ou au format court ( -l). La variante d'affichage qui classe par code d'état ne peut apparaître qu'au format d'utilisateur (-U). Le contenu d'affichage suivant vaut pour chacun de ces formats :
Chaque catalogue d'erreur affiche différentes entrées de message, long format (par exemple, bperror -media -L). Ce rapport produit plusieurs lignes par entrée de journal, avec le contenu suivant :
Champ 1 : Date et heure - nombre de secondes depuis le 1/1/1970
Champ 2 : Version de NetBackup - version de NetBackup en service
Champ 3 : Type d'erreur - identifiants numériques de médias de l'erreur
Champ 4 : Type d'entrée de journal - 2 =Débogage, 4=Informations, 8=Avertissement, 16=Erreur, 32=Critique
Champ 5 : Serveur - nom du serveur
Champ 6 : ID de travail
Champ 7 : ID de travail du groupe
Champ 8 : Inutilisé
Champ 9 : Processus NetBackup - nom du processus NetBackup qui effectue la consignation
Champ 10 : Nom client
Champ 11 : Nom de politique
Champ 12 : Type de planification - type de planification exécutée pour la sauvegarde
0=FULL, 1=INCR, 2=CINC, 3=UBAK, 4=UARC
Champ 13 : Etat de sortie - état une fois la sauvegarde effectuée
Le catalogue d'erreur affiche différentes entrées de message au format d'utilisateur (par exemple, bperror -media -U). Le format d'utilisateur produit une ligne d'en-tête qui affiche des noms de colonne et une ou plusieurs lignes par entrée de journal avec ce contenu :
Ligne 1 : date et heure
Serveur
Client
Texte (au début du message de consignation, ensuite sur les lignes ultérieures si nécessaire)
Affichage du catalogue d'erreur, différentes entrées de message, format court (par exemple, bperror -media -l). Le format court produit une unique ligne par entrée de journal, avec le contenu suivant :
Ligne 1 : heure (représentation de système interne)
Version NetBackup
Code de type (décimal)
Code de gravité d'erreur (décimal)
Serveur
ID du travail
ID de groupe de travail
Un champ inutilisé
Client
Qui
Texte (le texte entier du message de consignation, sans troncature de la longueur de ligne)
Le catalogue d'erreur affiche le code d'état par catégorie. Ceci affiche uniquement chaque code d'état unique, au lieu de lister chaque entrée de journal pour ce code d'état (par exemple, bperror -backstat -by_statcode -U). Cette option produit deux lignes ou plus par code d'état, avec le contenu suivant :
Ligne 1 : code d'état
Texte (début du texte du message de journal, puis sur les lignes suivantes, s'il y a lieu)
Ligne 2 : liste de clients pour lesquels cet état s'est produit.
EXEMPLES
Exemple 1 - Affichage de l'erreur pour un travail qui a échoué parce que le package de chiffrement NetBackup n'a pas été installé. Le code d'état 9 est le code d'état de NetBackup pour ce défaut. La deuxième exécution de bperror affiche l'action recommandée pour le code d'état 9 de NetBackup.
# bperror -d 12/23/2012 16:00:00 -e 12/23/2012 17:00:00 -t backstat -U STATUS CLIENT POLICY SCHED SERVER TIME COMPLETED 9 plim dhcrypt user plim 12/23/2012 16:38:09 an extension package is needed, but was not installed # bperror -S 9 -r an extension package is needed, but was not installed A NetBackup extension product is required in order to perform the requested operation. Install the required extension product.
Exemple 2 - Rapport des problèmes au format d'utilisateur qui se sont produits pendant les dernières 24 heures.
# bperror -U -problems TIME SERVER CLIENT - TEXT 11/23/2012 16:07:39 raisins - no storage units configured 11/23/2012 16:07:39 raisins - scheduler exiting - failed reading storage unit database information (217) 11/23/2012 16:17:38 raisins - no storage units configured 11/23/2012 16:17:38 raisins - scheduler exiting - failed reading storage unit database information (217) 11/23/2012 18:11:03 raisins nut bpcd on nut exited with status 59: access to the client was not allowed 11/23/2012? 18:11:20 raisins - WARNING: NetBackup database backup is currently disabled
Exemple 3 - L'exemple suivant affiche l'état pour le type backstat
pour les travaux exécutés au cours des 24 heures précédentes. L'option -by_statcode -produit un affichage organisé par code d'état.
L'affichage indique qu'un ou plusieurs travaux pour chacun des clients chive
, gava
, et raisins
se sont terminés avec succès (le code d'état est 0). En outre, un ou plusieurs travaux pour l'écrou client ont échoué parce que l'écrou n'a pas autorisé l'accès au serveur maître ou au serveur de médias. (Le code d'état est 59.)
# bperror -U -backstat -by_statcode 0 the requested operation was successfully completed chive gava raisins 59 access to the client was not allowed nut
Exemple 4 - Identification et récupération des résultats pour un travail d'utilisateur particulier. Il liste tout d'abord les entrées de journal dont les ID de travail sont différents de zéro. Il exécute alors un rapport au format d'utilisateur sur le travail concerné.
# bperror -hoursago 2012 -L | grep 'S:' | egrep 'J\:[1-9]' 12/21/2012 17:24:14 V1 S:plim C:plim J:1 (U:0,0) 12/23/2012 16:31:04 V1 S:plim C:plim J:1 (U:0,0) 12/23/2012 16:38:04 V1 S:plim C:plim J:3 (U:0,0) # bperror -d 1/7/2007 -jobid 34 -U TIME SERVER CLIENT - TEXT 01/07/2012 13:12:31 plim plim started backup job for client plim, policy jdhcrypt, schedule user on storage unit jdhcrypt 01/07/2012 13:12:40 plim plim successfully wrote backup id plim_0947272350,copy 1, fragment 1, 32 Kbytes at 11.057 Kbytes/sec 01/07/2012 13:12:41 plim plim CLIENT plim POLICY jdhcrypt SCHED user EXIT STATUS 0 (the requested operation was successfully completed)
Exemple 5 - Affichage des entrées de médias dans le catalogue d'erreur pour les dernières 2000 heures.
bperror -hoursago 2000 -media -U TTIME SERVER CLIENT - TEXT 12/23/2012 16:31:04 plim plim Media Manager terminated during mount of media id A00000, possible media mount timeout 12/24/2012 04:31:20 plim - media id A00000 removed from Media Manager database (manual deassign)
Exemple 6 - Rapport et cumul du nombre total d'octets sauvegardés au cours des dernières 24 heures.
bperror -all -hoursago 24 | grep "successfully wrote backup id | awk '{bytes= bytes + $20} END {print "backed up",bytes," Kbytes of data"}' backed up 64 Kbytes of data up",bytes," Kbytes of data"}'