Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpdbjobs — interagir avec la base de données de travaux de NetBackup
Synopsis
[-report] [-M serveurs_maître] [-ignore_parent_jobs] [ -vault | -lvault | -all_columns | -most_columns | -gdm ] [-file chemin_accès] [-append] [-noheader] [-mastertime] [-t horodatage] [-jobid travail1,travail2,...travailn] [verbose]
-summary [-M serveurs_maître] [-ignore_parent_jobs] [ -U | -L | -all_columns ] [-file chemin_accès] [-append] [verbose]
-resume | -suspend | -delete | -cancel | -restart travail1,travail2,...travailn | type=type_travail | type=all [-M serveurs_maître] [-quiet] [-reason "chaîne"]
-cancel_all [-M serveurs_maître] [-reason "chaîne"]
-clean [-M serveurs_maître] [ -keep_hours heures | -keep_days jours ] [ -keep_successful_hours heures | -keep_successful_days jours ] [verbose]
-version
-change_priority_by [-M serveurs_maître] -priority nombre -jobid travail1,travail2,...travailn
-set_priority [-M serveurs_maître] -priority nombre -jobid travail1,travail2,...travailn
-fast
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
bpdbjobs interagit avec les travaux base de données et est utile dans les scripts ou comme outil d'administration de ligne de commande. Ce processus imprime la base de données de travaux entièrement, imprime aussi un résumé de la base de données, supprime des travaux réalisés, annule des travaux incomplets et nettoie les anciens travaux.
Pour personnaliser la sortie de bpdbjobs, ajoutez des entrées de définition de colonne (BPDBJOBS_COLDEFS) dans le fichier bp.conf
.
Consultez le Guide de l'administrateur NetBackup, volume I, pour plus d'informations sur le fichier bp.conf
, la liste complète des définitions et les entrées BPDBJOBS_COLDEFS.
Les options -cancel, -delete, -jobid, -resume et les -suspend utilisent toutes le type de travail jobtype comme sous-option. Entrée un des types suivants comme type de travail jobtype. (Les lettres suivant les lettres en majuscule ne sont pas à prendre en compte.)
ALL | * REStore BACkup ARChive VERify DUPlicate IMPort LABel ERAse VAUlt TPReq CLEan FORmat INVentory QUAlification DBbackup | CATalogbackup
Remarque :
Pour la fonction d'accélérateur NetBackup, bpdbjobs signale la quantité de données transférées sur le réseau pour chaque sauvegarde. Vous pouvez également configurer la commande pour afficher les données transférées dans le champ qui affiche normalement la taille de l'image de sauvegarde de l'accélérateur. Pour des détails, consultez les rubriques d'accélérateur dans le Volume I du guide de l'administrateur de NetBackup , Guide de l'administrateur NetBackup for Vmware et le Guide de l'administrateur NetBackup for NDMP.
OPTIONS
- -all_columns
Affiche toutes les colonnes d'un rapport ou d'un résumé. Vous trouverez ci-dessous les descriptions des champs :
champ1 = ID de travail
champ2 = type de travail
0=sauvegarde, 1=archivage, 2=restauration, 3=vérification, 4=duplication, 5=importation phase 1 ou phase 2, 6=sauvegarde du catalogue, 7=duplication du centre de sauvegarde, 8=étiquetage de la bande, 9=effacement de la bande, 10=demande de bande, 11=nettoyage de la bande, 12=formatage de la bande, 13=inventaire physique de bandothèque, 14=test de qualification du lecteur ou de la bandothèque, 15=récupération du catalogue, 16=contenu du média, 17=nettoyage de l'image, 18=LiveUpdate, 20=réplication (Auto Image Replication), 21=importation (Auto Image Replication), 22=sauvegarde depuis snapshot, 23=réplication (snapshot), 24=importation (snapshot), 25=capture d'état d'application, 26=indexation, 27=nettoyage de l'index, 28=Snapshot, 29=SnapIndex, 30=ActivateInstantRecovery, 31=DeactivateInstantRecovery, 32=ReactivateInstantRecovery, 33=StopInstantRecovery, 34=InstantRecovery
Remarque :
Les types de travaux 26=indexation et 27=nettoyage d'index liés à la recherche NetBackup qui n'est pas pris en charge à partir de la version 7.7 de NetBackup.
champ3 = état du travail
0=placé en file d'attente ; en attente des ressources, 1=actif, 2=replacé en fil d'attente ; en attente des ressources, 3=terminé, 4=interrompu, 5=incomplet
champ4= code d'état du travail
champ5 = nom de politique pour le travail
champ6 = nom de planification du travail
champ7 = nom client
champ8 = serveur de médias utilisé par le travail
champ9 = heure de début du travail
champ10 = temps écoulé pour le travail
champ11 = heure de fin de travail
champ12= unité de stockage utilisée par le travail
champ13 = nombre de tentatives
champ14 = opération
0=montage de bande, 1=positionnement de bande, 2=connexion de NetBackup à un serveur de médias, 3=enregistrement sur bande, 4=sélection d'images, 5=duplication d'image, 6=sélection de médias, 7=sauvegarde de catalogue, 8=éjection de la bande et génération de rapports, 10=lecture à partir de la bande, 11=duplication, 12=importation, 13=vérification, 14=restauration, 15=sauvegarde du catalogue, 16=opération du centre de sauvegarde, 17=étiquetage de la bande, 18=effacement de la bande, 19=interrogation de la base de données, 20=traitement des zones de stockage, 21=organisation des programmes de lecture, 22=création de snapshot, 23=suppression de snapshot, 24=récupération de la base de données, 25=contenu du média, 26=requête de ressources de travail, 27=travail parent, 28 =indexation, 29=duplication sur le maître distant, 30=en cours d'exécution
champ15 = volume de données enregistrées en kilo-octets
champ16 = nombre de fichiers enregistrés
champ17 = dernier chemin d'accès enregistré
champ18 = pourcentage terminé
champ19 = PID de travail
champ20 = compte utilisateur (propriétaire) qui lance le travail
champ21 = sous-type
0=sauvegarde immédiate, 1=sauvegarde planifiée, 2=sauvegarde ou archive initiée par l'utilisateur, 3=effacement de bande rapide, 4=effacement de bande lent, 5=sauvegarde intermédiaire de base de données
champ22 = type de politique
0 = Standard (clients UNIX et Linux), 4 = Oracle, 6 = Informix-On-BAR, 7 = Sybase, 8 = serveur du portail MS-SharePoint, 11 = DataTools-SQL-BackTrack, 13 = MS-Windows, 15 = MS-SQL-Server, 16 = MS-Exchange-Server, 17 = SAP, 18 = DB2, 19 = NDMP, 20 = FlashBackup, 25 = Lotus Notes, 29 = FlashBackup-Windows, 35 = NBU-Catalog, 39 = Enterprise_Vault, 40 = VMware, 41 = Hyper-V, 44 = BigData
champ23 = type de planification
0=complète, 1=incrémentielle, 2=sauvegarde utilisateur, 3=archive utilisateur, 4=cumulative incrémentielle, 5=tlog (sauvegarde de journal des transactions)
champ24 = priorité de travail assignée à ce travail d'après la configuration définie dans les attributs de politique
champ25 = nom du groupe de serveurs
champ26 = nom du serveur maître
champ27 = niveau de conservation
champ28 = période de conservation
champ29 = compression
0=désactivé, 1=activé
champ30 = nombre estimé de kilo-octets à enregistrer
champ31 = fichiers prévus pour l'enregistrement
champ32 = nombre de liste de fichiers. Nombre de fichiers enregistrés.
champ33 = liste de chemins d'accès au fichier enregistrés délimités par des virgules
champ34 = nombre de tentatives. Nombre de tentatives pour l'ID de travail
champ35 = informations sur la tentative. Liste délimitée par des virgules contenant les informations d'état
trypid=PID de la tentative, trystunit=unité de stockage, tryserver=serveur, trystarted=heure du début de la tentative consignée au format epoch, tryelapsed=temps écoulé, tryended=heure de fin de la tentative au format epoch, trystatus=code d'état de la tentative, trystatusdescription, trystatuscount=nombre de chaînes délimitées par des virgules pour trystatuslines, trystatuslines=sortie d'état de la tentative, trybyteswritten=volume de données enregistrées en kilo-octets, tryfileswritten=nombre de fichiers enregistrés
champ36 = numéro de tâche parent
champ37= kbpersec - vitesse de transfert de données en kilo-octets/seconde
champ38 = nombre de copies
champ39 = robot - bandothèque utilisée pour le travail
champ40 = ID du centre de sauvegarde
champ41 = profil du centre de sauvegarde
champ42 = session de centre de sauvegarde
champ43 = nombre de bandes à éjecter
champ44 = unité de stockage source
champ45 = serveur de médias source
champ46 = ID du média source
champ47 = ID du média d'emplacement
champ48 = numéro du flux
champ49 = opération avec interruption possible : 0=pas d'interruption possible, 1=interruption possible
champ50 = opération avec reprise possible : 0=pas de reprise possible, 1=reprise possible
champ51 = avec redémarrage possible : 0=pas de redémarrage possible, 1=redémarrage possible
champ52 = type de transfert de données
0=standard, 1=disque de reprise après incident uniquement, 2=disque de reprise après incident et unité de stockage, 3=synthétique, 4=sauvegarde intermédiaire, 5=snapshot
champ53 = opération de snapshot : 0=sans snapshot, 1=avec snapshot
champ54 = ID de sauvegarde
champ55 = opération avec arrêt du processus possible : 0=pas d'arrêt du processus possible, 1=arrêt du processus possible
champ56 = hôte de contrôle. Hôte exécutant le PID actif pour ce travail.
champ57 = type hors hôte
champ58 = utilisation de Fibre Transport. 0=lan, 1=ft
champ59 = motif de file d'attente
0=motif inconnu, 1=média en service, 2=lecteurs en service, 3=serveur de médias de la bande inactif, 4=bandothèque indisponible sur le serveur, 5=nombre max de travaux atteint pour l'unité de stockage, 6=en attente de l'expiration du délai de demande de médias, 7=lecteurs locaux indisponibles, 8=le média se situe dans un lecteur utilisé par NetBackup, 9=lecteurs physiques indisponibles, 10=médias de nettoyage indisponibles, 11=hôte d'analyse de lecteur inactif,12=serveur de médias disque inactif, 13=serveur de médias non connecté au serveur maître, 14=le serveur de médias n'est pas le nœud actif du cluster,15=travaux simultanés de l'unité de stockage régulés, 16=l'historique de travail indique que les lecteurs sont en cours d'utilisation, 17=volume de disque temporairement indisponible, 18=nombre max de lecteurs de volume de disque simultanés atteint, 19=pool de disques indisponible, 20=canaux FT en cours d'utilisation, 21=démontage du volume de disque, 22=volume de disque en cours d'utilisation, 23=nombre max de volumes partiellement pleins atteint, 24=limite de ressource logique atteinte, 25=lecteurs en cours d'utilisation dans les unités de stockage, 26=attente de l'arrêt de l'analyse de lecteur de bande partagé, 27=en attente du montage du volume de disque, 28= le point de montage de la bande existe déjà, 29=action en attente, 30=nombre maximal de flux d'E/S pour le volume de disque atteint
champ60 = pourcentage du taux de déduplication
champ61 = optimisation de l'accélérateur
champ62 = nom de la base de données de l'instance
champ63 = l'appliance qui héberge le partage NFS pour les sauvegardes Oracle Copilot
champ64 = kilo-octets de données transférées pour les sauvegardes d'accélérateur
La sortie de cette commande se compose d'une seule ligne par travail de sauvegarde. Chaque ligne de la sortie est une liste délimitée par des virgules au format suivant :
jobid,jobtype,state,status,policy,schedule,client server,started,elapsed,ended,stunit,tries,operation,kbytes, files,pathlastwritten,percent,jobpid,owner,subtype,policytype, scheduletype,priority,group,masterserver,retentionlevel ,retentionperiod,compression,kbytestobewritten,filestobe written,filelistcount,[files],trycount,[trypid,trystunit, tryserver,trystarted,tryelapsed,tryended,trystatus,trys tatusdescription,trystatuscount,trystatuslines,trybytes written,tryfileswritten],parentjob,kbpersec,copy,robot, vault,profile,session,ejecttapes,srcstunit,srcserver,src media,dstmedia,stream,suspendable,resumable,restartable, datamovement,snapshot,backupid,killable,controllinghost, offhosttype,ftusage,queuereason,dedupratio, acceleratorOptimization,instancedbname,dumpHost, kbDataTransferred
Voici un exemple :
213,0,3,0,hansel-itc,f,hansel,hansel,1368467705,0000000099, 1368467804,hansel-hcart-robot-tld-0,1,,448,451,,100,122,root, 0,0,0,0,root,gamefunvm2,2,2,0,,,1,/nbbackup,1,122,hansel-hcart -robot-tld-0,hansel,1368467706,0000000098,1368467804,0,the requested operation was successfully completed,17,05/13/2013 12:55:05 - requesting resource hansel-hcart-robot-tld-0,05/13 /2013 12:55:05 - requesting resource gamefunvm2.NBU_CLIENT. MAXJOBS.hansel,05/13/2013 12:55:05 - requesting resource gamefunvm2.NBU_POLICY.MAXJOBS.hansel-itc,05/13/2013 12:55:06 - granted resource gamefunvm2.NBU_CLIENT.MAXJOBS.hansel,05/13/2013 12:55:06 - granted resource gamefunvm2.NBU_POLICY.MAXJOBS.hansel -itc,05/13/2013 12:55:06 - granted resource AP6001,05/13/2013 12:55:06 - granted resource SEAGATE.ULTRIUM06242-XXX.000,05/13/2013 12:55:06 - granted resource hansel-hcart-robot-tld-0,05/13/2013 12:55:07 - started process bpbrm (122),05/13/2013 12:55:08 - connecting,05/13/2013 12:55:08 - connected; connect time: 000:00:00,05/13/2013 12:55:11 - mounting AP6001,05/13/2013 12:56:15 - mounted; mount time: 000:01:04,05/13/2013 12:56:24 - positioning AP6001 to file 1,05/13/2013 12:56:30 - positioned; position time: 000:00:06,05/13/2013 12:56:30 - begin writing,05/13/2013 12:56:43 - end writing; write time: 000:00:13,448,451,211,14000,2,,,,,,,,, AP6001,0,,,1,0,0,hansel_1368467706,,,0,0, ,,
Consultez l'exemple 1 pour un exemple sur la manière d'interpréter la sortie -all_columns.
- -append
Ajoute la sortie au fichier que l'option de -file spécifie. Si aucune option -file n'est spécifiée, la sortie est dirigée vers stdout.
- -cancel travail1,travail2,...travailn |type=type_travail|type=all
bpdbjobs annule proprement les travaux actifs dont le code d'état est 150 dans le moniteur d'activité. Par exemple :
bpdbjobs -cancel 11328 bpdbjobs -cancel 11328,11329,11330
Les valeurs de type de travail jobtype autorisées sont listées dans la section Description.
- -cancel_all
bpdbjobs annule proprement tous les travaux inachevés qui ont un état 150 dans le moniteur d'activité. Par exemple :
bpdbjobs -cancel_all
- -change_priority_by [-M serveurs_maître] -priority nombre -jobid travail1,travail2,...travailn
Modifie la priorité du travail ou des travaux spécifiés.
- -clean
bpdbjobs supprime les travaux terminés qui sont antérieurs à une période spécifiée. Utilisez-la avec les paramètres -keep_hours, -keep_days, -keep_successful_hours ou -keep_successful_days pour spécifier une période de conservation. Par exemple :
bpdbjobs -clean -keep_hours 30
- -delete travail1,travail2,...travailn |type=type_travail|type=all
Supprime les travaux terminés qui apparaissent dans le moniteur d'activité. Vous pouvez supprimer plusieurs ID de travail dans une commande. Par exemple :
bpdbjobs -delete 11328,11329,11330
Cette option peut supprimer ce qui suit :
Les travaux que job1, job2,… jobn spécifie
Tous les travaux sélectionnables que le type de travail jobtype indique
Tous les travaux sélectionnables si type=all est spécifié
Les valeurs de type de travail jobtype autorisées sont listées dans la section Description.
- -fast
Récupère les métadonnées de travail de bpjobd, mais le fichier
try
et le fichierfiles
sont lus directement depuis le système de fichiers. Cette option est ignorée si bpdbjobs est démarré d'un hôte distant (un hôte qui n'est pas le maître).- -file chemin_accès
Nomme un fichier sur lequel la sortie de bpdbjobs est écrite. Si aucune option -file n'est spécifiée, la sortie est dirigée vers stdout.
- -gdm
Affiche moins d'informations dans un rapport que -most_columns.
- -ignore_parent_jobs
Ignore les travaux parent pour les options -report et -summary.
- -jobid travail1,travail2,...travailn |type=type_travail|type=all
Rapports sur plusieurs ID de travail.
Les valeurs de type de travail jobtype autorisées sont listées dans la section Description.
- -keep_days jours
Ajoutez-y l'option -clean pour spécifier le nombre de jours que bpdbjobs conserve les travaux terminés. Le paramètre par défaut est de 3 (trois) jours.
- -keep_hours heures
Ajoutez-y l'option -clean pour spécifier le nombre d'heures que bpdbjobs conserve les travaux terminés. Le paramètre par défaut est de 72 heures.
- -keep_successful_days jours
Ajoutez-y l'option -clean pour spécifier le nombre de jours que bpdbjobs conserve les travaux terminés correctement. Le paramètre par défaut est de 3 (trois) jours.
Cette valeur doit être inférieure à la valeur de -keep_days.
- -keep_successful_hours heures
Ajoutez-y l'option -clean pour spécifier le nombre d'heures que bpdbjobs conserve les travaux terminés correctement. Le paramètre par défaut est de 72 heures.
Cette valeur doit être inférieure à la valeur -keep_hours.
- -L
Rapports au format long.
- -lvault
Affiche des colonnes supplémentaires spécifiques aux travaux du centre de sauvegarde.
- -M serveurs_maître
S'applique à un environnement avec plusieurs serveurs maîtres. Utilisez l'option -M pour récapituler des travaux, supprimer des travaux, annuler des ID de travail et annuler tous les ID de travail actifs pour un serveur maître spécifique :
- -mastertime
Par défaut, bpdbjobs convertit les heures de début et de fin afin qu'elles prennent en compte l'horloge locale. Un travail qui démarre 10 minutes avant ne subira aucune variation quelques soient les différences de fuseau horaire avec le serveur maître. Cette option, cependant, évite la conversion de sorte que les valeurs horaires soient cohérentes entre les clients d'administration.
- -most_columns
Se comporte pareillement à -all_columns, mais n'imprime pas la liste des fichiers ou les informations relatives aux tentatives précédentes. L'option -most_columns est plus rapide que -all_columns.
- -noheader
Empêche l'impression de l'en-tête dans le rapport.
- -quiet
Annule le rapport sur le nombre de travaux repris, interrompus, supprimés et annulés.
- -reason "chaîne"
Indique la raison pour laquelle vous effectuez cette action de commande. La chaîne de texte de raison que vous entrez est capturée et apparaît dans le rapport d'audit. La chaîne doit être entre guillemets ("… ") et ne peut pas dépasser 512 caractères. Elle ne peut pas commencer par un tiret (-) ni contenir un guillemet simple (').
- -report
Fournit un rapport des données qui sont enregistrées dans le moniteur d'activité. Si l'option est spécifiée avec bpdbjobs, -report est l'option par défaut.
- -restart travail1,travail2,...travailn |type=type_travail|type=all
Relance correctement un travail que le type de travail jobtype indique. Cette option prend en charge des sauvegardes et vous permet de redémarrer un travail en saisissant le mot BACkup dans le moniteur d'activité.
- -resume travail1,travail2,...travailn |type=type_travail|type=all
Reprend les travaux que job1, job2,… jobn spécifie, toutes les sauvegardes de point de contrôle éligibles ou restaure les travaux que le type de travail jobtype indique, ou tous les travaux sélectionnables si type=all est spécifié.
Les valeurs de type de travail jobtype autorisées sont listées dans la section Description.
- -set_priority [-M serveurs_maître] -priority nombre -jobid travail1,travail2,...travailn
Définit la priorité du travail ou des travaux spécifiés sur le numéro de priorité spécifié.
- -summary [-U | -L | -all_columns]
Imprime une ligne récapitulative dans stdout pour tous les travaux qui sont enregistrés dans NBU/jobs. Les paramètres -U et -L formatent la sortie de la commande. Utilisez l'option -file pour écrire la sortie sur un répertoire ou un nom de fichier donné. Par exemple :
bpdbjobs -summary -U -file /tmp/summary.out
- -suspend travail1,travail2,...travailn |type=type_travail|type=all
Interrompt les travaux que job1, job2,… jobn spécifie, toutes les sauvegardes de point de contrôle éligibles ou restaure les travaux que le type de travail jobtype indique, ou tous les travaux sélectionnables si type=all est spécifié.
Les valeurs de type de travail jobtype autorisées sont listées dans la section Description.
- -t horodatage
Récupère les enregistrements de travail qui ont terminé après l'horodatage spécifié. L'horodatage est spécifié dans le format suivant :
mm/dd/yyyy hh:mm:ss
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 "À propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
- -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 format de rapport.
- -vault
Affiche des colonnes supplémentaires spécifiques aux travaux du centre de sauvegarde.
- -verbose
bpdbjobs consigne des informations supplémentaires dans le journal de débogage, sous le répertoire suivant, si ce répertoire existe :
Pour les systèmes d'exploitation UNIX :
/usr/openv/netbackup/logs/bpdbjobs/*
Sur les systèmes Windows :
install_path\NetBackup\logs\bpdbjobs\*
- -version
Imprime la chaîne de version, puis s'arrête. Tous les autres commutateurs sont ignorés.
EXEMPLES
Exemple 1 - Afficher la logique d'échantillon pour décoder la sortie -all_columns et afficher le temps d'initialisation d'un travail de sauvegarde réussi, mais pas au premier essai.
Champ 9 = heure de début (le temps où le travail a été aligné la première fois.)
Ce temps est de peu de valeur à moins que vous ne vouliez savoir quand le travail était en attente.
Jusqu'au champ 32, tous les champs sont réparés. Puis, le champ 32 vous indique combien d'entrées sont dans les champs de filelist
.
Champ 32 = filelistcount (le nombre de fichiers qui sont listés dans la liste de fichiers filelist
.)
Ajoutez cette valeur à 33 pour déterminer le champ qui affiche le nombre d'essais :
Champ 33 + filelistcount = trycount
S'il n'y a qu'un essai, calculez les champs suivants pour déterminer son heure de début :
Champ 33 + filelistcount
+ 4 = [premier] trystarted
S'il y a deux essais, passez les entrées d'état. D'abord, calculez le nombre d'entrées dans le champ d'état :
Champ 33 + filelistcount
+ 9 = trystatuscount
Puis, pour se rendre l'heure de début du deuxième essai, calculez ce qui suit :
Field 33 + filelistcount
+ 9 + trystatuscount
+ 6 = [second] trystarted