Guide de référence des commandes NetBackup™

Last Published:
Product(s): NetBackup (10.0)
  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.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcallhomeproxyconfig
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_backup
    118.  
      nbdb_move
    119.  
      nbdb2adutl
    120.  
      nbdb_restore
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    134.  
      nbfp
    135.  
      nbftadm
    136.  
      nbftconfig
    137.  
      nbgetconfig
    138.  
      nbhba
    139.  
      nbholdutil
    140.  
      nbhostidentity
    141.  
      nbhostmgmt
    142.  
      nbhypervtool
    143.  
      nbidpcmd
    144.  
      nbimageshare
    145.  
      nbinstallcmd
    146.  
      nbjm
    147.  
      nbkmiputil
    148.  
      nbkmscmd
    149.  
      nbkmsutil
    150.  
      nboraadm
    151.  
      nborair
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmlb
    155.  
      nbperfchk
    156.  
      nbplupgrade
    157.  
      nbrb
    158.  
      nbrbutil
    159.  
      nbregopsc
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      W2KOption
  3.  
    Index

Nom

netbackup_deployment_insights — outil permettant de collecter, analyser et signaler les informations des serveurs maîtres concernant les clients et la capacité

Synopsis

netbackup_deployment_insights --debug-inputs dir1 [dir2dir3]

netbackup_deployment_insights --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]

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

netbackup_deployment_insights --retry dir1 [dir2dir#]

netbackup_deployment_insights --version

 

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

Dans NetBackup 9.1, nbdeployutil est renommé netbackup_deployment_insights. Veritas vous recommande d'utiliser la commande netbackup_deployment_insights lorsque vous générez manuellement les rapports de licence. Vous pouvez toujours utiliser la commande nbdeployutil avec les mêmes options.

L'outil netbackup_deployment_insights collecte et analyse les informations de déploiement du serveur maître. L'outil exécute une analyse de déploiement selon l'un des deux modèles de licence NetBackup : licence classique ou licence de capacité. Une analyse de déploiement de licence classique 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 netbackup_deployment_insights rassemble les données pendant une première étape, puis les analyse lors d'une deuxième étape.

La commande netbackup_deployment_insights prend en charge la génération de rapports incrémentielle. Avec cette fonction, netbackup_deployment_insights 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 NetBackup, volume II.

L'outil génère un fichier journal nommé nbdeployutil-gather-horodatage.log pendant l'opération de collecte. Il génère un fichier journal nommé nbdeployutil-report-horodatage.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.

Remarque :

Vous devez configurer l'audit amélioré et ajouter l'utilisateur spécifique pour utiliser netbackup_deployment_insights avec un utilisateur non-racine. Pour plus d'informations sur l'audit amélioré, consultez le Guide de sécurité et de chiffrement NetBackup.

OPÉRATIONS

--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 les 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. Vous devez utiliser le paramètre capacity ou traditional lorsque vous utilisez l'opération --gather. Seules les données du modèle de licence spécifié (capacity ou traditional) sont collectées.

Lorsque vous exécutez la commande netbackup_deployment_insights --gather dans la licence standard ou 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 depuis 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'outil 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'outil, telles que les fichiers binaires d'ingénierie. Cette option est pratique si l'outil 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'outil 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 démarre à minuit et s'exécute jusqu'à 23:59:59. Exprimez la valeur de temps en hh:mm au format 24 heures. Dans ce format, 6 h du matin (AM) correspond à 06:00 et 6 h de l'après-midi (PM) à 18:00.

--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 utilisée avec l'option start uniquement. Le format de ce paramètre est "MM/DD/YYYY hh:mm:ss". Spécifiez la valeur de temps hh:mm:ss au format 24 heures. Dans ce format, 6 h du matin (AM) correspond à 06:00:00 et 6 h de l'après-midi (PM) à 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 : chemin_installation\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'outil. 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/DD/YYYY hh:mm:ss". Spécifiez la valeur de temps hh:mm:ss au format 24 heures. Dans ce format, 6 h du matin (AM) correspond à 06:00:00 et 6 h de l'après-midi (PM) à 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'outil à 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

Les conditions requises pour l'outil netbackup_deployment_insights sont les suivantes :

  • 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 - Collecte des données pour un rapport de licence de capacité. Les chemins de répertoire affichés appartiennent à un système UNIX, mais cet exemple s'applique également à un système Windows.

# ./netbackup_deployment_insights --gather --capacity
NetBackup Deployment Insights, version 9.0.1
Gathering license deployment information...
  Discovered master server punnbuucsm5b38-vm80

Enter credentials for Master Server(s):

Master Server:punnbuucsm5b38-vm80
Domain Type (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap):unixpwd
Domain Name  :punnbuucsm5b38-vm80
User Name    :root
Password     :

Data gather is in progress. This process might take some time.
  Output for punnbuucsm5b38-vm80 at: /usr/openv/var/global/reports/
20210309_101511_punnbuucsm5b38-vm80
Gather DONE
Execution time: 25 secs
To create a report for this master server, run the following:
  netbackup_deployment_insights --report --capacity /usr/openv/var/global/
reports/20210309_101511_punnbuucsm5b38-vm80
#

Exemple 2 - Générer un rapport de licence de capacité avec les données de l'exemple 1. Les chemins de répertoire sont pour un système UNIX, mais cet exemple s'applique également à un système Windows.

# ./netbackup_deployment_insights --report --capacity /usr/openv/var/
global/reports/20210309_101511_punnbuucsm5b38-vm80
NetBackup Deployment Insights, version 9.0.1
Analyzing license deployment ...
  Report created at: /usr/openv/var/global/reports/
20210309_101511_punnbuucsm5b38-vm80/report-capacity-punnbuucsm5b38-
vm80-20210309_101705.xls
Analysis DONE
Execution time: 0 sec
#

Exemple 3 - Collecte des données pour un rapport de licence classique. Les chemins de répertoire affichés appartiennent à un système UNIX, mais cet exemple s'applique également à un système Windows.

# ./netbackup_deployment_insights --gather --traditional
NetBackup Deployment Insights, version 9.0.1
Gathering license deployment information...
  Discovered master server punnbuucsm5b38-vm80
  Output for punnbuucsm5b38-vm80 at: /usr/openv/var/global/reports/
20210309_101809_punnbuucsm5b38-vm80
Gather DONE
Execution time: 9 secs
To create a report for this master server, run the following:
  netbackup_deployment_insights --report --traditional /usr/openv/var/
global/reports/20210309_101809_punnbuucsm5b38-vm80
#

Exemple 4 - Générer un rapport de licence classique avec les données de l'exemple 3. Les chemins de répertoire sont pour un système UNIX, mais cet exemple s'applique également à un système Windows.

# ./netbackup_deployment_insights --report --traditional /usr/openv/var/
global/reports/20210309_101809_punnbuucsm5b38-vm80
NetBackup Deployment Insights, version 9.0.1
Analyzing license deployment ...
  Report created at: /usr/openv/var/global/reports/
20210309_101809_punnbuucsm5b38-vm80/report-traditional-punnbuucsm5b38-
vm80-20210309_101945.xls
Analysis DONE
Execution time: 1 sec
#

VOIR AUSSI

Se reporter à bpimagelist.

Se reporter à nbdeployutil.