Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_backup
- nbdb_move
- nbdb2adutl
- nbdb_restore
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
- Index
Nom
bpconfig — modification ou affichage des attributs globaux de configuration pour NetBackup
Synopsis
[-cd seconds] [-ha hours] [-kl days] [-kt days] [-ma [address]] [-sto seconds] [-mj number] [-period hours] [-prep hours] [-to seconds] [cleanup_int hours] [cleanup_wait minutes] [-tries times] [-wi minutes] [-pui minutes] [-v] [-M master_server,...]
[-L | -l | -U [-v] [-M master_server,...]]
[-ica_min_size size] [-ica_retention seconds]
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
La commande bpconfig modifie ou affiche les attributs globaux de la configuration NetBackup. Ces attributs affectent les opérations de toutes les politiques et de tous les clients. Sauf pour l'adresse électronique de l'administrateur NetBackup, les valeurs par défaut de ces attributs fonctionnent pour la plupart des installations.
Consultez la rubrique "A propos de la spécification des paramètres régionaux de l'installation de NetBackup" du Guide de l'administrateur NetBackup, volume II.
Pour en savoir plus sur les incidences de la définition des valeurs des attributs, consultez la section Attributs globaux de NetBackup dans le Guide de l'administrateur NetBackup, volume I.
Les deux formats de la commande bpconfig sont les suivants :
Le premier format de la commande bpconfig modifie un ou plusieurs attributs globaux de la configuration NetBackup. Vous devez spécifier sur la ligne de commande au minimum une option modifiant un attribut global de la configuration NetBackup.
Le deuxième format de la commande bpconfig affiche les paramètres des attributs globaux de la configuration NetBackup. Pour plus d'informations, voir FORMATS D'AFFICHAGE.
Les erreurs sont envoyées à stderr. Un journal de l'activité de commande est envoyé au fichier journal d'administration de NetBackup pour le jour en cours.
OPTIONS
- -cd secondes
Spécifie le nombre de secondes correspondant à l'intervalle de compression de catalogue. Lorsque la variable seconds est un entier positif, l'image sera compressée au bout du nombre de secondes spécifié, à compter de la création de l'image. La plage de valeurs s'étale de 86400 à 2147472000. Par défaut, la valeur est de 0 (zéro). Cela signifie qu'aucune compression n'est effectuée.
Utilisez la commande bpimage pour décompresser les images.
- -cleanup_int heures
Spécifie la période minimale (en heures) pouvant s'écouler sans devoir nettoyer le catalogue. Par défaut, la valeur est de 12 heures. Puisque vous ne pouvez pas effectuer une opération de nettoyage pendant une sauvegarde de catalogue, vous pouvez spécifier un intervalle plus petit (par exemple, 3 heures) pour les environnements de grande envergre fonctionnant 24h/24 et 7j/7 qui exécutent de longues sauvegardes de catalogue. La base de données d'images est automatiquement nettoyée à la fin des sessions de sauvegardes planifiées, peu importe la valeur de cette option.
Cette option s'affiche dans la sortie en tant qu'intervalle de nettoyage base de données d'images (voir les exemples).
- -cleanup_wait minutes
Spécifie l'intervalle (en minutes) entre les opérations de nettoyage de catalogue de base de données d'images. La valeur par défaut est de 60 minutes. Si plusieurs sauvegardes sont effectuées pendant l'intervalle d'attente de nettoyage, NetBackup lance uniquement une opération de nettoyage pendant cette période. La plage de valeurs s'étale entre 0 (zéro) et 720.
- -ha heures
Spécifie le nombre d'heures (hours) correspondant au début de la plage horaire pendant laquelle vous pouvez sélectionner les entrées des rapports NetBackup. La fin de cette plage horaire correspond à la date et à l'heure en cours. Par exemple, si vous avez demandé un rapport d'état de sauvegarde en spécifiant une durée de 24 heures dans la variable hours à 10:00 AM, le rapport contient les éléments suivants : Toutes les sauvegardes exécutées à partir de 10:00 AM à la date d'hier jusqu'à 10:00 AM à la date d'aujourd'hui.
Cette valeur permet de calculer la plage horaire des rapports généraux et des rapports sur les médias. Les rapports généraux sont les suivants : Etat de sauvegarde, Sauvegardes client, Problèmes et Toutes les entrées de journal. Les rapports sur les médias sont les suivants : Liste des médias, Résumé des médias, Contenu des média, Images sur média et Entrées de journal de médias.
La variable HA correspond à un entier positif contenu dans la plage s'étalant de 1 à 32 767. La valeur par défaut est 24 (heures).
- -ica_min_size taille
Spécifie la taille minimale du fichier .f de catalogue en kilo-octets (Ko) pour l'archivage de catalogue intelligent (Intelligent Catalog Archiving, ICA). Lorsque la valeur est comprise entre 0 et 2097151, tous les fichiers .f de catalogue (ou fichiers de fichiers) dont la taille est supérieure ou égale à la taille indiquée sont supprimés du disque de catalogue. La valeur par défaut est 1024.
Remarque :
Cet attribut s'applique uniquement aux serveurs exécutant NetBackup 10.0 (ou versions ultérieures) à l'aide de MSDP ou du stockage en cloud MSDP.
- -ica_retention secondes
Spécifie en secondes la période de conservation de l'archivage de catalogue intelligent. Lorsque la valeur est comprise entre 1 et 2147472000, l'archivage de catalogue intelligent est activé et tous les fichiers .f de catalogue (ou fichiers de fichiers) antérieurs à la valeur indiquée sont supprimés du disque de catalogue. Si cette valeur est définie sur zéro (0), l'archivage de catalogue intelligent est désactivé. La valeur par défaut pour les environnements NetBackup Flex Scale est 2592000 (30 jours). La valeur par défaut pour tous les autres environnements NetBackup est 0 (désactivé).
Remarque :
Cet attribut s'applique uniquement aux serveurs exécutant NetBackup 10.0 (ou versions ultérieures) à l'aide de MSDP ou du stockage en cloud MSDP.
- -kl jours
Le nombre de jours de conservation des journaux. Ce nombre établit la duré de conservation des journaux de débogage et des erreurs de base de données du serveur maître NetBackup.
NetBackup établit les rapports Etat de sauvegarde, Problèmes, Toutes les entrées de journal et Entrées de journal de médias à partir des erreurs de base de données.
Cette valeur limite la période couverte par ces rapports. La plage de valeurs s'étale de 1 à 24855. La valeur par défaut est 28 jours. Une valeur 0 (zéro) désactive les journaux.
Remarque :
Cet attribut n'a aucune incidence sur les serveurs de médias distants ou les clients (les serveurs de médias distants s'appliquent uniquement au serveur Enterprise NetBackup).
- -kt jours
Le nombre de jours de conservation des informations de récupération d'image réelle Cette valeur établit la durée de conservation des informations de récupération d'image réelle des politiques spécifiant la collecte des informations de récupération d'image réelle La plage de valeurs s'étale de 1 à 24855. Par défaut, la valeur est de 1 jour. ne valeur 0 (zéro) désactive les informations de récupération d'image réelle.
- -L
Le type de liste est long. Pour plus d'informations, reportez-vous à la section Formats d'affichage.
- -l
La liste est de type court. Cette option correspond au paramètre par défaut si la ligne de commande ne contient aucune option de type de liste (par exemple, si vous entrez la commande bpconfig et un retour chariot). Pour plus d'informations, reportez-vous à la section Formats d'affichage.
- -M serveur_maître,...
Le serveur maître sur lequel les attributs globaux de configuration se trouvent.
- -ma [adresse]
L'adresse de courrier électronique de l'administrateur NetBackup. NetBackup envoie à cette adresse électronique une notification pour les sauvegardes automatiques défectueuses, les opérations de sauvegarde manuelle contrôlées par l'administrateur et les sauvegardes automatiques de la base de données. Le paramètre par défaut est NULL (aucune adresse électronique).
Si aucune adresse n'est spécifiée, le paramètre Adresse de courrier électronique de l'administrateur en cours est effacé. La notification n'est pas envoyée par courrier électronique à l'administrateur NetBackup.
- -mj nombre
Spécifie le nombre maximal de travaux par client. Il s'agit du nombre maximal de travaux pouvant être effectués en simultané par un client. Il doit s'agir d'un entier positif. La plage de valeurs s'étale entre 1 et 32 767. La valeur par défaut est de 1 jour.
- -period heures
La période associée au nombre de tentatives de sauvegarde (voir l'option -tries). Cet intervalle correspond à la période exprimée en heures pendant laquelle NetBackup tente un certain nombre de fois d'effectuer un travail de sauvegarde pour une combinaison client/politique/planification. Le nombre d'heures doit être un entier positif. La plage de valeurs s'étale entre 1 et 24. La valeur par défaut est de 1 jour.
Remarque :
Cet attribut ne s'applique pas aux sauvegardes utilisateurs et aux archives.
- -prep heures
Spécifie l'intervalle de pré-traitement. Lorsque NetBackup utilise le mode de flux de découverte automatique, cet intervalle correspond à la période minimale en heures entre les demandes client de détection de nouveaux chemins d'accès.
L'intervalle de pré-traitement par défaut est de 4 heures. Si l'intervalle de prétraitement et modifié, rétablissez sur la valeur par défaut en spécifiant l'option -prep -1. Vous pouvez définir l'intervalle de prétraitement pour qu'il soit exécuté immédiatement en spécifiant la valeur 0 comme intervalle de prétraitement de découverte automatique sur la ligne de commande bpconfig. La valeur maximale de l'intervalle de prétraitement est de 48 heures.
Pour plus d'informations, consultez le Guide de l'administrateur NetBackup, volume I.
- -pui minutes
Spécifie l'intervalle de mise à jour de la politique. Cette option correspond à la fréquence de traitement des mises à jour de politique NetBackup. La valeur par défaut est de 10 minutes. La plage de valeurs s'étale entre 1 et 1 440 minutes.
- -sto secondes
Le délai de montage des médias hébergés sur plusieurs hôtes. Ce délai correspond à la durée en secondes attendue par NetBackup pour monter, positionner et mettre à disposition un média pour les opérations de sauvegarde et es restauration. Ce délai permet d'éliminer les attentes excessives si un autre serveur utilise un média partagé. La valeur par défaut est de 0. Cela signifie l'absence de délai (temps d'attente illimité).
Pour plus de détails sur les lecteurs hébergés sur plusieurs hôtes, consultez le Guide de l'administrateur NetBackup, volume I.
- -to secondes
Spécifie le délai de montage des médias. Ce délai correspond à la durée en secondes attendue par NetBackup pour monter, positionner et mettre à disposition un média demandé pour les opérations de sauvegarde et es restauration. Utilisez l'option -to pour éliminer les temps d'attente excessifs pendant lesquels vous devez monter manuellement des médias (par exemple, lorsque le média robotique est en dehors du robot ou hors site).
La valeur par défaut est de 0. Cela signifie l'absence de délai (temps d'attente illimité). Si la variable seconds n'est pas égale à 0 (zéro), la plage de valeurs s'étale entre 1 à 32 767 secondes.
- -tries essais
Le nombre de tentatives de sauvegarde au cours de la période configurée (voir l'option -period). NetBackup tente un certain nombre de fois d'effectuer un travail de sauvegarde pour une combinaison client/politique/planification. En cas d'échech de plusieurs sauvegardes, cette option limite le nombre de tentatives.
Remarque :
Cet attribut ne s'applique pas aux sauvegardes utilisateurs et aux archives.
La plage de valeurs de l'option -tries s'étale entre 1 à 32 767. Le paramètre par défaut est de 2 tentatives. Si les valeurs par défaut sont spécifiées à la fois pour l'option -tries et -period, NetBackup tente d'effectuer 2 sauvegardes toutes les 12 heures.
- -U
La liste est de type utilisateur. Pour plus d'informations, voir FORMATS D'AFFICHAGE.
- -v
Sélectionne le mode détaillé pour consigner les informations. Cette option est utile uniquement si la fonction de débogage de journal est activée. Par conséquent, le répertoire suivant doit être défini :
Sur les systèmes UNIX :
/usr/openv/netbackup/logs/adminSur les systèmes Windows :
install_path\NetBackup\logs\admin- -wi minutes
Délai des nouvelles tentatives du travail. Spécifie le nombre de tentatives d'exécution d'un travail par NetBackup. La valeur par défaut est de 10 minutes. La plage de valeurs s'étale entre 1 et 1 440 minutes.
FORMATS D'AFFICHAGE
La commande bpconfig utilise trois formats d'affichage différents pour afficher les valeurs en cours des attributs globaux de la configuration NetBackup :
Format d'affichage utilisateur (-U)
L'interface utilisateur graphique NetBackup utilise ce format d'affichage. Cette option affiche une liste avec un attribut global par ligne. Chaque ligne présente le format suivant : descripteur d'attribut global : valeur. Cette liste correspond au format de l'option -L. Cependant, les descripteurs globaux d'attribut sont plus détaillés.
Ce qui suit est un exemple du format d'affichage d'utilisateur :
# bpconfig -U Admin Mail Address: Job Retry Delay: 1 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 2 time(s) in 12 hour(s) Keep Error/Debug Logs: 28 days Max drives this master: 0 Keep TrueImageRecovery Info: 1 days Compress DB Files: (not enabled) Media Mount Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutesFormat détaillé (-L)
Si la ligne de commande contient -L, le format d'affichage est long. Cette option génère une liste avec un attribut global par ligne, au format suivant : descripteur d'attribut global : valeur. Les champs s'affichent comme suit :
L'exemple suivant indique le format long :
# bpconfig -L Mail Admin: *NULL* Job Retry Delay: 1 minutes Max Jobs/Client: 1 Backup Tries: 2 in 12 hours Keep Logs: 28 days Max drives/master: 0 Compress DB Files: (not enabled) Media Mnt Timeout: 0 minutes (unlimited) Shared Timeout: 0 minutes(unlimited) Media Int Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Keep TIR Info: 1 days Prep Interval: 0 hours DB Clean Interval: 12 hours DB Clean Wait Time: 60 minutes Policy Update Interval:10 minutesFormat abrégé (-l)
Si la ligne de commande bpconfig contient l'argument -l ou ne contient aucune option de format de liste, les données s'affichent au format court, ce qui produit une liste courte. Cette option est particulièrement utile pour les scripts ou les programmes qui convertissent le contenu des listes en un rapport personnalisé et formaté. La structure de la liste correspond à une ligne unique contenant les valeurs de tous les attributs globaux. Les unités de temps suivent les attributs entre parenthèses pour les attributs qui sont exprimés en unités de temps. Les attributs sont séparés par des espaces et s'affichent dans l'ordre suivant :
Ce qui suit est un exemple du format court :
# bpconfig -l *NULL* 1 12 1 2 28 0 0 0 0 1 24 1 0 2 10 60Les champs du format d'affchage -l peuvent être interprétés comme suit :
L'adresse électronique de l'administrateur NetBackup n'a pas été définie.
Le délai de la nouvelle tentative de travail est de 1 minute.
La période est de 12 heures.
Le nombre maximal de travaux simultanés par client est de 1.
Le nombre de tentatives par période est de 2.
Les journaux sont conservés pendant 28 jours.
Le nombre maximal de lecteurs du serveur maître est de 0.
L'intervalle de compression de catalogue est 0 seconde ; 0 signifie aucune compression.
Le délai de montage des médias est de 0 secondes.
Le délai de montage des médias hébergés sur plusieurs hôtes est de 0 seconde. La valeur 0 signifie un délai illimité.
L'indicateur des les images de post-traitement est de 1 (exécution immédiate).
Les rapports datant de 24 heures s'affichent.
Les informations de récupération d'image réelle datent de 1 jour.
L'intervalle de pré-traitement est de 0 heure (zéro).
L'intervalle de nettoyage de la base de données de catalogue est de 2 heures.
Le temps d'attente de nettoyage de la base de données de catalogue est de 10 minutes.
L'intervalle de mise à jour de la politique est de 60 minutes.
La conservation de l'archivage de catalogue intelligent est de 259 200 secondes.
La taille minimale d'un fichier de l'archivage de catalogue intelligent est de 1 024 Ko.
VALEURS DE RETOUR
Un code état de sortie 0 (zéro) signifie que la commande est exécutée. Tout autre code d'état de sortie autre que zéro (0) signifie qu'une erreur s'est produite.
Si le journal d'administration est activé, l'état de sortie est connecté au journal d'administration quotidien se trouvant sous le répertoire de journaux :
Windows: install_path\NetBackup\logs\admin
UNIX: /usr/openv/netbackup/logs/admin
Le format est le suivant :
bpconfig: EXIT status = exit status
En cas d'erreur, un diagnostic s'affiche avant ce message.
EXEMPLES
Exemple 1 - Pendant que le serveur maître kiwi s'exécute, affichez les paramètres d'attributs globaux sur le serveur maître plim :
# bpconfig -U -M plim Admin Mail Address: ichabod@null.null.com Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 8 hour(s) Keep Error/Debug Logs: 6 days Max drives this master: 0 Keep TrueImageRecovery Info: 1 days Compress DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
Exemple 2 - Définissez l'intervalle de compression de catalogue sur 604 800 secondes ; NetBackup compressera les images de plus de sept jours :
# bpconfig -cd 604800 #bpconfig -U Admin Mail Address: *NULL* Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 2 time(s) in 12 hour(s) Keep Error/Debug Logs: 28 days Max drives this master: 0 Keep TrueImageRecovery Info: 2 days Compress DB Files: older than 7 day(s) Media Mount Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
Exemple 3 - Définition du délai de montage du média à 1800 secondes.
# bpconfig -to 1800 # bpconfig -U Admin Mail Address: sasquatch@wapati.edu Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 12 hour(s) Keep Error/Debug Logs: 3 days Max drives this master: 0 Keep TrueImageRecovery Info: 24 days Compress Image DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Policy Update Interval: 10 minutes
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/config/behavior
Systèmes Windows :
install_path\NetBackup\db\config\behavior install_path\NetBackup\logs\admin\*
VOIR AUSSI
Se reporter à bpimage.
Pour plus de détails sur les lecteurs hébergés sur plusieurs hôtes, consultez le Guide de l'administrateur NetBackup, volume I.