Guide de référence des commandes Veritas NetBackup™

Last Published:
Product(s): NetBackup (8.2)
  1. Introduction
    1.  
      A propos des commandes de NetBackup
    2.  
      Navigation dans les niveaux de menu
    3.  
      Conventions des commandes NetBackup
    4.  
      Remarques sur les commandes de NetBackup Media Manager
    5.  
      Mises à jour IPv6
  2. Annexe A. Commandes NetBackup
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCertsForPlugins
    85.  
      configureMQ
    86.  
      configurePorts
    87.  
      configureWebServerCerts
    88.  
      create_nbdb
    89.  
      csconfig cldinstance
    90.  
      csconfig cldprovider
    91.  
      csconfig meter
    92.  
      csconfig throttle
    93.  
      csconfig reinitialize
    94.  
      duplicatetrace
    95.  
      importtrace
    96.  
      jbpSA
    97.  
      jnbSA
    98.  
      ltid
    99.  
      manageClientCerts
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcatsync
    103.  
      NBCC
    104.  
      NBCCR
    105.  
      nbcertcmd
    106.  
      nbcertupdater
    107.  
      nbcldutil
    108.  
      nbcloudrestore
    109.  
      nbcomponentupdate
    110.  
      Commande nbcplogs
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdbms_start_server
    118.  
      nbdbms_start_stop
    119.  
      nbdc
    120.  
      nbdecommission
    121.  
      nbdelete
    122.  
      nbdeployutil
    123.  
      nbdevconfig
    124.  
      nbdevquery
    125.  
      nbdiscover
    126.  
      nbdna
    127.  
      nbemm
    128.  
      nbemmcmd
    129.  
      nbfindfile
    130.  
      nbfirescan
    131.  
      nbftadm
    132.  
      nbftconfig
    133.  
      nbgetconfig
    134.  
      nbhba
    135.  
      nbholdutil
    136.  
      nbhostidentity
    137.  
      nbhostmgmt
    138.  
      nbhypervtool
    139.  
      nbimageshare
    140.  
      nbinstallcmd
    141.  
      nbjm
    142.  
      nbkmsutil
    143.  
      nboraadm
    144.  
      nborair
    145.  
      nbpem
    146.  
      nbpemreq
    147.  
      nbperfchk
    148.  
      nbplupgrade
    149.  
      nbrb
    150.  
      Commande nbrbutil
    151.  
      nbregopsc
    152.  
      nbreplicate
    153.  
      nbrepo
    154.  
      nbrestorevm
    155.  
      nbseccmd
    156.  
      nbsetconfig
    157.  
      Commande nbsnapimport
    158.  
      Commande nbsnapreplicate
    159.  
      nbsqladm
    160.  
      nbstl
    161.  
      nbstlutil
    162.  
      nbstop
    163.  
      nbsu
    164.  
      nbsvrgrp
    165.  
      resilient_clients
    166.  
      restoretrace
    167.  
      Commande stopltid
    168.  
      tl4d
    169.  
      tl8d
    170.  
      tl8cd
    171.  
      tldd
    172.  
      tldcd
    173.  
      tlhd
    174.  
      tlhcd
    175.  
      tlmd
    176.  
      tpautoconf
    177.  
      tpclean
    178.  
      tpconfig
    179.  
      tpext
    180.  
      tpreq
    181.  
      tpunmount
    182.  
      verifytrace
    183.  
      vltadm
    184.  
      vltcontainers
    185.  
      vlteject
    186.  
      vltinject
    187.  
      vltoffsitemedia
    188.  
      vltopmenu
    189.  
      vltrun
    190.  
      vmadd
    191.  
      vmchange
    192.  
      vmcheckxxx
    193.  
      vmd
    194.  
      vmdelete
    195.  
      vmoprcmd
    196.  
      vmphyinv
    197.  
      vmpool
    198.  
      vmquery
    199.  
      vmrule
    200.  
      vmupdate
    201.  
      vnetd
    202.  
      vssat
    203.  
      vwcp_manage
    204.  
      vxlogcfg
    205.  
      vxlogmgr
    206.  
      vxlogview
    207.  
      W2KOption

Nom

nbdeployutil — utilitaire de déploiement qui collecte et analyse les informations de serveurs maître concernant les clients et la capacité

Synopsis

nbdeployutil --debug-inputs dir1 [dir2dir3]

nbdeployutil --gather [--bpimagelist=options] [--capacity ¦ --traditional] [--client hostname1, [hostname2, ...] | --clientlist=filename] [--hoursago=number] [--log=filename] [--master=hostname] [--nolog] [--output=directory] [--runtimestats] [-start date [-end date]] [--client-timeout seconds] [--exclude-clients client1[,client2,...]] [--exclude-clientlist path] [--exclude-all-clients]

nbdeployutil --report [--capacity ¦ --traditional] [--day-boundary=time] [dir1 dir2 dir# | --dirsfile=filename | --parentdir=directory] [--log=filename] [--nolog] [--overlap-details] [--runtimestats]

nbdeployutil --retry dir1 [dir2dir#]

nbdeployutil --version

 

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

L'utilitaire nbdeployutil collecte et analyse les informations de déploiement du serveur maître. L'utilitaire exécute une analyse de déploiement selon l'un de deux modèles de licence NetBackup, licence traditionnelle ou licence de capacité. Une analyse de déploiement de licence traditionnelle compte le nombre de clients et serveurs, puis compare ces informations aux options. L'analyse de déploiement de licence de capacité calcule la quantité de données source qui est protégée.

La commande s'exécute en deux étapes. La commande nbdeployutil rassemble les données pendant une première étape, puis les analyse lors d'une deuxième étape.

La commande nbdeployutil prend en charge la génération de rapports incrémentielle. Avec cette fonction, nbdeployutil s'exécute selon une fréquence spécifiée pour collecter de manière incrémentielle des données et générer des rapports de gestion des licences selon la capacité. Pour plus d'informations sur l'activation et l'utilisation de cette fonction, consultez le Guide de l'administrateur Veritas NetBackup, volume II.

L'utilitaire génère un fichier journal nommé nbdeployutil-gather-timestamp.log pendant l'opération de collecte. L'utilitaire génère un fichier journal nommé nbdeployutil-report-timestamp.log pendant l'opération d'analyse et de génération de rapport. Par défaut les fichiers journaux sont créés dans le répertoire où se trouvent les données collectées.

Pour plus d'informations sur les licences traditionnelles et les licences basées sur la capacité, consultez le Guide de l'administrateur NetBackup, volume II.

OPERATIONS

--client-timeout secondes

Cette option impose un délai pour bptestbpcd dans nbdeployutil indépendamment de la configuration NetBackup.

Cette option s'applique uniquement si l'option --gather est spécifiée. L'option ne s'applique pas si l'option --capacity est spécifiée.

--debug-inputs

Convertit les fichiers utilisés pour générer le rapport dans un format lisible par l'homme. Ces nouveaux fichiers sont plus faciles à lire que leur version brute. Vous pouvez seulement spécifier les répertoires qui contiennent les caractères ASCII de base. Les répertoires avec caractères ASCII étendus ne sont pas autorisés.

--exclude-all-clients

Cette option permet d'exclure tous les clients des connexions bptestbpcd. Les clients spécifiés s'affichent dans le rapport comme non connectables.

Cette option s'applique uniquement si l'option --gather est spécifiée. L'option ne s'applique pas si l'option --capacity est spécifiée.

--exclude-clientlist chemin_accès

Utilisez cette option pour spécifier un fichier qui contient une liste de clients à exclure des connexions bptestbpcd. Répertoriez chaque nom de client sur une ligne distincte dans le fichier. Les clients spécifiés s'affichent dans le rapport comme non connectables.

Cette option s'applique uniquement si l'option --gather est spécifiée. L'option ne s'applique pas si l'option --capacity est spécifiée.

--exclude-clients client1[,client2,...]

Cette option permet d'exclure des clients spécifiés des connexions bptestbpcd. Les clients spécifiés s'affichent dans le rapport comme non connectables.

Cette option s'applique uniquement si l'option --gather est spécifiée. L'option ne s'applique pas si l'option --capacity est spécifiée.

--gather

Collecte des données pour l'analyse avec l'option report. Si le paramètre capacity ou traditional est utilisé, seulement les données pour ce modèle de licence spécifique sont collectées. Si ni capacity ni traditional n'est spécifié, la commande gather collecte les données pour les deux modèles de licence.

Sur les serveurs maîtres NetBackup 8.0 (ou versions ultérieures), lorsque vous exécutez la commande nbdeployutil --gather dans la licence de capacité, vous êtes invité à saisir des informations supplémentaires. Vous devez entrer les informations d'authentification affichées pour l'authentification du service de gestion web NetBackup :

  • Type de domaine : entrez une valeur de type de domaine (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap). Cette valeur est sensible à la casse.

  • Nom du domaine : nom du domaine auquel appartient l'hôte du serveur maître. Si le serveur maître n'appartient pas à un domaine, entrez le nom du serveur maître.

  • Nom de l'utilisateur : nom de l'utilisateur qui dispose de privilèges d'administrateur.

  • Mot de passe : mot de passe du même utilisateur qui dispose des droits d'administrateur. Lorsque vous entrez le mot de passe, les caractères ne s'affichent pas dans la ligne de commande.

Dans un scénario avec plusieurs serveurs maîtres, vous devez entrer les informations d'authentification pour tous les serveurs maîtres mentionnés avec la commande gather.

--report

Génère un rapport de licence basé sur les données collectées avec l'option gather. Spécifiez le répertoire ou la liste des répertoires que l'utilitaire doit utiliser pour le rapport. Vous devez utiliser le paramètre capacity ou traditional lorsque vous utilisez l'opération --report.

--retry

Réexécute l'opération gather et tente de se reconnecter aux hôtes qui ont échoué pendant le processus gather, tel que déterminé par les informations du répertoire gather. Cette action est utile avec le modèle de licence traditionnelle lorsque plusieurs hôtes sont signalés inaccessibles.

--version

Renvoie la version de la commande. Cette option permet d'identifier la dernière version du produit NetBackup sur laquelle la commande peut s'exécuter. La chaîne de version indique également les versions spéciales de l'utilitaire, telles que les fichiers binaires d'ingénierie. Cette option est pratique si l'utilitaire a été manuellement copié sur un serveur maître antérieur à la version 7.1.

OPTIONS

--bpimagelist

Permet de passer des options spécifiques à la commande bpimagelist pendant l'étape de gather (collecte) du processus.

--capacity

Spécifie le modèle de licence lorsqu'il est utilisé avec gather ou report. Utilisez capacity pour rendre compte du déploiement selon le modèle de licence de capacité de téraoctets de NetBackup.

--client ou --clientlist

Collecte les données ou les rapports sur les données pour un client ou une liste de clients spécifié uniquement. Lorsque vous utilisez la commande client, séparez les différents clients par une virgule. Pour utiliser le paramètre clientlist, répertoriez les clients dans la commande filename sur des lignes distinctes. Lorsque vous utilisez l'option --client ou --clientlist, le rapport peut indiquer que l'utilitaire ne peut pas se connecter à certains serveurs de médias même si ce n'est pas le cas. Ce problème n'affecte pas les informations récapitulatives.

--day-boundary

Déplace le début de la fenêtre de rapport pour créer des rapports. La fenêtre de rapport par défaut commence à minuit et s'exécute jusqu'à 11:59:59 P.M. Spécifiez la valeur time (temps) en hh:mm au format 24 heures, où 6:00 A.M.est 06:00h et 6:00 P.M. est 18:00h.

--dirsfile

Un fichier contenant une liste de répertoires que le paramètre de report utilise pour générer un rapport. Ce paramètre est une alternative à la liste de tous les fichiers après le paramètre report. Vous pouvez également utiliser le paramètre parentdir afin d'indiquer un répertoire parent pour que le paramètre report l'utilise.

--end

Spécifie la date de fin d'une plage de dates restreinte de la période de collecte. Cette option est uniquement utilisée avec l'option start. Le format de ce paramètre est "MM/JJ/AAAA hh:mm:ss". Spécifiez la valeur de temps hh:mm:ss au format 24 heures. Dans ce format, 6:00 A.M correspond à 06:00:00 et 6:00 P.M à 18:00:00. Les doubles guillemets doivent entourer la valeur date-heure.

--hoursago

Modifie la valeur par défaut pour l'intervalle de rassemblement d'image. La valeur est spécifiée en heures. La valeur par défaut est 2160 heures (90 jours).

--log

Oblige la sortie de journal à aller vers un fichier journal spécifique. Par défaut, la sortie de journal est enregistrée dans un fichier journal à l'intérieur du répertoire contenant les données collectées et le rapport.

--master

Collecte les données de licence de capacité pour le serveur maître spécifié. Cette option est uniquement utilisée avec --gather. Afin que l'hôte puisse collecter des données à partir d'un serveur distant, le nom de l'hôte local doit apparaître dans la liste de serveurs du serveur distant.

Cette option prend uniquement en charge les informations concernant le programme de licences de capacité à distance recueillies. Les données de gestion des licences traditionnelles à distance recueillies ne sont pas prises en charge.

--nolog

Désactivez la création du fichier de journal de débogage.

--output

Enregistre les résultats dans le répertoire de sortie indiqué. Vous pouvez seulement spécifier les répertoires qui contiennent les caractères ASCII de base. Les répertoires avec les caractères ASCII étendus ne sont pas autorisés. S'il s'agit d'une opération de collecte gather, le répertoire de sortie contient les données collectées. Pour les opérations report, le rapport et le fichier journal sont placés dans le répertoire de sortie au lieu du répertoire d'entrée spécifié avec les données recueillies. Si l'option de sortie n'est pas spécifiée, la sortie est placée dans le répertoire suivant :

  • UNIX : /usr/openv/var/global/reports/ YYYYMMDD_hhmmss_masterserver

  • Windows : install_path\ VERITAS\netbackup\var\global\reports\YYYYMMDD_hhmmss_masterserver

--overlap-details

Affiche les sélections de sauvegarde en double dans la colonne de Sélections de duplication du rapport de gestion des licences selon la capacité. Cette option peut uniquement être utilisée pour les caractères ASCII ou en anglais seulement dans les données de la sélection de sauvegarde.

--parentdir

Spécifie le niveau supérieur dans une arborescence contenant de nombreux répertoires avec les données de licence collectées que le paramètre report doit utiliser pour générer un rapport. Vous pouvez également utiliser le paramètre dirsfile pour spécifier un fichier contenant une liste de répertoires.

--runtimestats

Affiche des statistiques d'exécution pour l'utilitaire. Les statistiques incluent l'utilisation de mémoire et d'UC.

Exemple de sortie UNIX :

stats  mem 40.1 M, cpu 27.0% after splitting t/fixture/
nbdeployutil_sidon/bpimagelist_sidon.out
stats  mem 40.1 M, cpu 28.0% after parsing records from t/fixture/
nbdeployutil_sidon/tmp/policy_db_arc_tab_2gig_nt_client_totem7.out
stats  mem 40.6 M, cpu 50.0% after calculating for UNKNOWN-1 in 
t/fixture/nbdeployutil_sidon/ stats  mem 40.6 M, cpu 51.0% after 
main report loop took 1 sec
--start

Spécifie la date de début d'une plage de dates restreinte pour la période de collecte. Le format de ce paramètre est "MM/JJ/AAAA hh:mm:ss". Spécifiez la valeur de temps hh:mm:ss au format 24 heures. Dans ce format, 6:00 A.M correspond à 06:00:00 et 6:00 P.M à 18:00:00. Notez que les guillemets doubles autour de la valeur de date/heure sont requis.

--traditional

Utilisé avec gather ou report pour spécifier le modèle de licence. Utilisez --traditional pour rendre compte du déploiement selon le modèle de gestion de licences par serveur traditionnel de NetBackup. La valeur par défaut est 2160 heures (90 jours).

--verbose

Affiche les informations de progression détaillées de l'utilitaire à l'écran. Cet affichage n'affecte pas les informations du fichier journal de débogage. Le contenu du fichier journal est toujours détaillé.

PRÉREQUIS

Ce qui suit sont les conditions préalables pour l'utilitaire nbdeployutil :

  • Les daemons ou services de serveur maître doivent être en cours d'exécution dans l'environnement pour collecter les données.

  • Vérifiez que l'espace disque suffisant existe sur le serveur maître qui exécute la commande de collecte. La collecte des données des licences basées sur la capacité recueille les sorties bpimagelist des 90 derniers jours. La taille de la sortie est une fonction du nombre d'images dans le catalogue pour cette période. La période par défaut peut être déplacée ou rétrécie. Une analyse plus courte de plage horaire entraîne les schémas moins précis ou inachevés.

  • Microsoft Excel est requis pour afficher le rapport. Le logiciel ne doit pas être installé sur le serveur maître.

EXEMPLES

Exemple 1 - Créez un rapport d'analyse de déploiement pour le modèle de licence de capacité NetBackup et le modèle de licence traditionnel. Les chemins de répertoire affichés appartiennent à un système Windows, mais cet exemple s'applique également à un système UNIX.

# nbdeployutil --gather
NetBackup Deployment Utility, version 7.1.0000.0000
Gathering license deployment information...
  Discovered master server marybl2g1
  Output for marybl2g1 at: D:\Program Files\VERITAS\netbackup\
  var\global\reports\20101029_170534_marybl2g1
Gather DONE
Execution time: 1 min
To create a report for this master server, run the following:
  nbdeployutil.exe --report "D:\Program Files\VERITAS\netbackup\
  var\global\reports\20101029_170534_marybl2g1"

D:\>nbdeployutil.exe --report --traditional "D:\Program Files\
VERITAS\netbackup\var\global\reports\
20101029_170534_marybl2g1"
NetBackup Deployment Utility, version 7.1.0000.0000
Analyzing license deployment for master marybl2g1 ...
  Report created at: D:\Program Files\VERITAS\netbackup\var\global\
  reports\20101029_170534_marybl2g1\report-20101029_170705.xls
Analysis DONE
Execution time: 27 secs

Exemple 2 - Analyse ciblée de capacité de déploiement. La commande collecte des données pour un sous-ensemble de clients pour un calendrier différent de celui par défaut. Les chemins de répertoire affichés appartiennent à un système Windows, mais cet exemple s'applique également à un système UNIX.

# nbdeployutil.exe --gather --output pickedclient --start "11/01/10 
06:00:00" --end "11/02/10 01:00:00" --clients marybl2g1,marybl7g1  /
--verbose NetBackup Deployment Utility, version 7.1.0000.0000
Gathering license deployment information...
run: bpgetconfig
  Discovered master server marybl2g1
run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 
01:00:00" -l -client marybl2g1
run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 
01:00:00" -l -client marybl7g1
  Output for marybl2g1 at: pickedclient\20101102_155246_marybl2g1
Gather DONE
Execution time: 4 secs
To create a report for this master server, run the following:
  nbdeployutil.exe --report "pickedclient\20101102_155246_marybl2g1"

D:\># nbdeployutil.exe --report --capacity pickedclient\
20101102_154010_marybl2g1 --start "11/01/10 06:00:00" 
--end "11/02/10 01:00:00" --clients marybl2g1,
marybl7g1 --verbose
NetBackup Deployment Utility, version 7.1.0000.0000
Analyzing license deployment ...
  Master marybl2g1
  Report created at: pickedclient\20101102_154010_marybl2g1\
  report-20101102_155414.xls
Analysis DONE
Execution time: 2 secs

VOIR AUSSI

Se reporter à bpimagelist.