Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpdbjobs — interagir avec la base de données de travaux de NetBackup
Synopsis
[-report] [-M master_servers] [-ignore_parent_jobs] [ -vault | -lvault | -all_columns | -most_columns | -gdm ] [-file pathname] [-append] [-noheader] [-mastertime] [-utc] [-t timestamp] [-jobid job1,job2,...jobn | -dtemode Off|On] [verbose]
-summary [-M master_servers] [-ignore_parent_jobs] [ -U | -L | -all_columns ] [-file pathname] [-append] [verbose]
-resume | -suspend | -delete | -cancel | -restart job1,job2,...jobn | type=jobtype | type=all [-M master_servers] [-quiet] [-reason "string"]
-cancel_all [-M master_servers] [-reason "string"]
-clean [-M master_servers] [ -keep_hours hours | -keep_days days ] [ -keep_successful_hours hours | -keep_successful_days days ] [verbose]
-version
-change_priority_by [-M master_servers] -priority number -jobid job1,job2,...jobn
-set_priority [-M master_servers] -priority number -jobid job1,job2,...jobn
-fast
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is install_path\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. Entrez l'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 indique la quantité de données qui ont été transférées via 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 plus de détails, consultez les rubriques d'accélérateur dans le Volume I du guide de l'administrateur de NetBackup, le Guide de l'administrateur de NetBackup for VMware et le Guide de l'administrateur de NetBackup pour NDMP.
OPTIONS
- -all_columns
Affiche toutes les colonnes d'un rapport ou d'un résumé. 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 virgules. Des informations telles que l'ID de travail (champ 1) et le nom de client (champ 7), sont incluses dans la sortie.
Remarque :
Les valeurs de champ dans les options -all_columns ne sont pas stables. Elles peuvent changer selon la version. Les informations relatives aux champs sont sujettes à modification sans préavis.
- -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 autorisées pour jobtype sont répertoriées dans la section Description.
- -dtemode Off|On
Répertorie les travaux selon le mode de chiffrement des données en transit (DTE) défini : On ou Off.
- -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 de-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 pour les rendre cohérentes avec l'heure locale. Un travail qui démarre 10 minutes avant ne subira aucune variation, quelles que 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. Consultez l'option -utc pour appliquer l'heure UTC au lieu de l'heure locale.
- -most_columns
Se comporte pareillement à l'option -all_columns, mais n'inclut pas la liste des fichiers ou les informations relatives aux tentatives précédentes. L'option -most_columns est plus rapide que -all_columns.
Remarque :
Les valeurs de champ dans les options -most_columns ne sont pas stables. Elles peuvent changer selon la version. Les informations relatives aux champs sont sujettes à modification sans préavis.
- -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 été modifiés 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 section relative à la spécification des paramètres régionaux de l'installation NetBackup dans le 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 NetBackup-Java Reports utilisent ce format de rapport.
- -utc
Imprime les heures de début et de fin en heure universelle coordonnée (UTC) au lieu de l'heure locale. Les heures converties par cette option incluent +0000 dans la signature horaire pour indiquer qu'elles sont au format UTC. Un exemple complet serait : 01/01/19 12:00:00+0000. Divers rapports passent par des horodatages bruts et ne sont pas convertis.
- -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 :
Sur les systèmes 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.