NetBackup™ コマンドリファレンスガイド

Last Published:
Product(s): NetBackup & Alta Data Protection (10.5)
  1. 概要
    1.  
      NetBackup コマンドについて
    2.  
      複数階層のメニューの操作
    3.  
      NetBackup のコマンドの表記規則
    4.  
      NetBackup Media Manager コマンドの注意事項
    5.  
      IPV6 の更新
  2. 付録 A. NetBackup コマンド
    1.  
      acsd
    2.  
      backupdbtrace
    3.  
      backuptrace
    4.  
      bmrc
    5.  
      bmrconfig
    6.  
      bmrepadm
    7.  
      bmrprep
    8.  
      bmrs
    9.  
      bmrsrtadm
    10.  
      bp
    11.  
      bparchive
    12.  
      bpbackup
    13.  
      bpbackupdb
    14.  
      bpcatarc
    15.  
      bpcatlist
    16.  
      bpcatres
    17.  
      bpcatrm
    18.  
      bpcd
    19.  
      bpchangeprimary
    20.  
      bpcleanrestore
    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.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configureCerts
    84.  
      configureMQ
    85.  
      configureWebServerCerts
    86.  
      create_nbdb
    87.  
      csconfig cldinstance
    88.  
      csconfig cldprovider
    89.  
      csconfig meter
    90.  
      csconfig reinitialize
    91.  
      csconfig throttle
    92.  
      duplicatetrace
    93.  
      importtrace
    94.  
      jbpSA
    95.  
      jnbSA
    96.  
      ltid
    97.  
      mklogdir
    98.  
      msdpcldutil
    99.  
      nbauditreport
    100.  
      nbcallhomeproxyconfig
    101.  
      nbcatsync
    102.  
      NBCC
    103.  
      NBCCR
    104.  
      nbcertcmd
    105.  
      nbcertupdater
    106.  
      nbcldutil
    107.  
      nbcmdrun
    108.  
      nbcomponentupdate
    109.  
      nbcplogs
    110.  
      nbcredkeyutil
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdb2adutl
    118.  
      nbdbms_start_server
    119.  
      nbdbms_start_stop
    120.  
      nbdc
    121.  
      nbdecommission
    122.  
      nbdelete
    123.  
      nbdeployutil
    124.  
      nbdevconfig
    125.  
      nbdevquery
    126.  
      nbdiscover
    127.  
      nbdna
    128.  
      nbemm
    129.  
      nbemmcmd
    130.  
      nbepicfile
    131.  
      nbfindfile
    132.  
      nbfirescan
    133.  
      nbfp
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nblogparser
    150.  
      nbmariadb
    151.  
      nbmysql
    152.  
      nbmlb
    153.  
      nboraadm
    154.  
      nborair
    155.  
      nboracmd
    156.  
      nbpem
    157.  
      nbpemreq
    158.  
      nbmariadb
    159.  
      nbmlb
    160.  
      nbperfchk
    161.  
      nbpgsql
    162.  
      nbplupgrade
    163.  
      nbrb
    164.  
      nbrbutil
    165.  
      nbreplicate
    166.  
      nbrepo
    167.  
      nbrestorevm
    168.  
      nbseccmd
    169.  
      nbserviceusercmd
    170.  
      nbsetconfig
    171.  
      nbshvault
    172.  
      nbsmartdiag
    173.  
      nbsnapimport
    174.  
      nbsnapreplicate
    175.  
      nbsqladm
    176.  
      nbsqlcmd
    177.  
      nbsqlite
    178.  
      nbstl
    179.  
      nbstlutil
    180.  
      nbstop
    181.  
      nbsu
    182.  
      nbsvrgrp
    183.  
      netbackup_deployment_insights
    184.  
      resilient_clients
    185.  
      restoretrace
    186.  
      stopltid
    187.  
      tldd
    188.  
      tldcd
    189.  
      tpautoconf
    190.  
      tpclean
    191.  
      tpconfig
    192.  
      tpext
    193.  
      tpreq
    194.  
      tpunmount
    195.  
      verifytrace
    196.  
      vltadm
    197.  
      vltcontainers
    198.  
      vlteject
    199.  
      vltinject
    200.  
      vltoffsitemedia
    201.  
      vltopmenu
    202.  
      vltrun
    203.  
      vmadd
    204.  
      vmchange
    205.  
      vmcheckxxx
    206.  
      vmd
    207.  
      vmdelete
    208.  
      vmoprcmd
    209.  
      vmphyinv
    210.  
      vmpool
    211.  
      vmquery
    212.  
      vmrule
    213.  
      vmupdate
    214.  
      vnetd
    215.  
      vssat
    216.  
      vwcp_manage
    217.  
      vxlogcfg
    218.  
      vxlogmgr
    219.  
      vxlogview
    220.  
      W2KOption

名前

netbackup_deployment_insights — クライアントと容量に関するマスターサーバー情報を収集、分析、報告するためのツール

概要

netbackup_deployment_insights --debug-inputs dir1 [dir2dir3]

netbackup_deployment_insights --gather [--bpimagelist=options] <--capacity ¦ --traditional> [--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] [--credential-file filename] [--apikey-file filename]

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\

説明

NetBackup 9.1 で、nbdeployutil の名前が netbackup_deployment_insights に変更されました。ライセンスレポートを手動で生成する場合は、netbackup_deployment_insights コマンドを使用することをお勧めします。nbdeployutil コマンドも同じオプションを指定して引き続き使用できます。

netbackup_deployment_insights ツールは、マスターサーバーから配置情報を収集し、分析します。このツールは、従来のライセンスと容量ライセンスの 2 つの NetBackup ライセンスモデルのうちのいずれかに従って配置分析を実行します。従来のライセンスの配置分析は、クライアントとサーバーの数を数えてライセンス取得済みオプションの数に対してこの情報を比較します。容量ライセンスの配置分析は、保護されるソースデータの量を計算します。

コマンドは 2 段階で動作します。netbackup_deployment_insights は第 1 段階でデータを集め、第 2 段階でデータを分析します。

netbackup_deployment_insights コマンドは増分レポートをサポートします。この機能では、指定された間隔に基づいて netbackup_deployment_insights を実行し、増分データを収集して容量ベースのライセンスレポートを生成します。この機能の有効化と使用方法について詳しくは、『NetBackup 管理者ガイド Vol. 2』を参照してください。

このツールは収集操作の間に nbdeployutil-gather-timestamp.log という名前のログファイルを生成します。このツールは分析操作およびレポート生成操作の間に nbdeployutil-report-timestamp.log という名前のログファイルを生成します。デフォルトでは、ログファイルは収集されたデータが存在するディレクトリに作成されます。

従来のライセンスと容量ベースのライセンスについて詳しくは、『NetBackup 管理者ガイド Vol. 2』を参照してください。

操作

--apikey-file filename

このオプションは、NetBackup API キーを含むファイルへのパスを指定する場合に使用します。ファイルの形式は次のとおりです。

NetBackup primary server hostname : APIKey

複数の NetBackup プライマリサーバーのホスト名エントリを指定できます。各プライマリサーバーとそれに対応する API キーファイルを新しい行に指定します。netbackup_deployment_insights コマンドは、接続する NetBackup プライマリサーバーホストに対応する API キーを使用します。

NetBackup primary server hostname 1 : APIKey 1
NetBackup primary server hostname 2 : APIKey 2
NetBackup primary server hostname n : APIKey n

Veritasでは、API キーを使用して NetBackup Web 管理サービスに対してユーザーを認証することをお勧めします。多要素認証が構成されている場合は、API キーを使用する必要があります。複数の NetBackup ドメインの場合は、すべてのプライマリサーバーに API キーを指定するようにします。

--client-timeout seconds

このオプションは、NetBackup 構成とは無関係に、nbdeployutilbptestbpcd のタイムアウトを実施します。

このオプションは、--gather オプションが指定された場合のみ適用されます。--capacity を指定した場合、このオプションは適用されません。

--debug-inputs

レポート生成に使用されるファイルを人が判読できるフォーマットに変換します。このように変換されたファイルは、未加工の出力文書より読みやすくなっています。基本 ASCII 文字を含んでいるディレクトリのみを指定できます。拡張 ASCII 文字が付いているディレクトリは指定できません。

--exclude-all-clients

このオプションを使用すると、すべてのクライアントを bptestbpcd 接続から除外できます。指定したクライアントは、接続不能としてレポートに表示されます。

このオプションは、--gather オプションが指定された場合のみ適用されます。--capacity を指定した場合、このオプションは適用されません。

--exclude-clientlist path

このオプションを使用して、bptestbpcd 接続から除外するクライアントのリストを含むファイルを指定します。各クライアント名は、ファイル内の別々の行にリストします。指定したクライアントは、接続不能としてレポートに表示されます。

このオプションは、--gather オプションが指定された場合のみ適用されます。--capacity を指定した場合、このオプションは適用されません。

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

このオプションを使用すると、指定した任意のクライアントを bptestbpcd 接続から除外できます。指定したクライアントは、接続不能としてレポートに表示されます。

このオプションは、--gather オプションが指定された場合のみ適用されます。--capacity を指定した場合、このオプションは適用されません。

--gather

report オプションを指定して分析用のデータを収集します。--gather 操作を使う場合は、capacity または traditional パラメータを使う必要があります。指定したライセンスモデル (capacity または traditional) のデータのみが収集されます。

容量ライセンスまたは従来ライセンスで netbackup_deployment_insights --gather コマンドを実行すると、追加情報を入力するように求められます。NetBackup Web 管理サービスの認証に示されているクレデンシャル情報を入力する必要があります。

  • ドメイン形式: ドメイン形式の値として NISNISPLUSWINDOWSvxunixpwdldap のいずれかを入力します。この値では大文字と小文字が区別されます。

  • ドメイン名: マスターサーバーホストが属するドメインの名前。マスターサーバーがドメインに属していない場合は、マスターサーバーの名前を入力します。

  • ユーザー名: 管理者権限を持つユーザーの名前。

  • パスワード: 管理者権限を持つ同じユーザーのパスワード。パスワードを入力するとき、文字は意図的にコマンドラインに表示されません。

マスターサーバーが複数の場合は、gather コマンドで指定したすべてのマスターサーバーのクレデンシャルを入力する必要があります。

--report

gather オプションで収集されるデータに基づいてライセンスのレポートを生成します。このツールがレポートに使用できるディレクトリまたはディレクトリのリストを指定します。--report 操作を使う場合は、capacity または traditional パラメータを使う必要があります。

--retry

ギャザー操作を再実行し、ギャザー処理中に失敗したホストをギャザーディレクトリの情報から判断し、これらのホストへの再接続を試みます。この操作は、従来のライセンスモデルで、複数のホストについて接続不可能との報告があった場合に役立ちます。

--version

コマンドのバージョンを戻します。このオプションは、コマンドが動作するように設計されている NetBackup 製品の最新バージョンを識別するために使われます。バージョン文字列は、エンジニアリングバイナリのような特別なバージョンのツールも示します。このオプションはツールが 7.1 より前のマスターサーバーに手動でコピーされた場合に役立ちます。

オプション

--bpimagelist

処理の gather 部分の実行中に bpimagelist コマンドに特定のオプションを渡すために使います。

--capacity

gather または report と併用された場合に、ライセンスモデルを指定します。capacity は、NetBackup の TB ごとの容量ライセンスモデルに従って配置について報告するために使います。

--credential-file filename

ユーザー認証のクレデンシャルのために NetBackup が読み取るファイルを指定するために使用します。このオプションを使用すると、ユーザーにプロンプトを表示せずに NetBackup がこの情報を読み取ることができます。ファイルに複数のプライマリサーバーのクレデンシャルを指定することもできます。

クレデンシャルファイルには、指定した順序で示された情報が含まれている必要があります。各項目を独立した行に配置します。追加の各プライマリサーバーに対して、空の行なしでこの順序を繰り返します。

Primary server name
Domain type
Domain name
Username
Password
--day-boundary

レポートを作成するためのレポートの時間帯の開始を移動します。デフォルトのレポート時間帯は、午前 0 時から午後 11 時 59 分 59 秒までです。時間値 hh:mm は 24 時間表記で指定します。たとえば、午前 6 時は 06:00、午後 6 時は 18:00 となります。

--dirsfile

レポートを生成するために report パラメータが使うディレクトリのリストを含んでいるファイルです。このパラメータは report パラメータの後にすべてのファイルをリストする場合の代替方法です。report パラメータで使う親ディレクトリをリストするために parentdir パラメータを使うこともできます。

--end

制限された収集期間の日付範囲の終了日を指定します。このオプションは start オプションを指定する場合にのみ使います。このパラメータの形式は "MM/DD/YYYY hh:mm:ss" です。時間値 hh:mm:ss は 24 時間表記で指定します。たとえば、午前 6 時は 06:00:00、午後 6 時は 18:00:00 となります。二重引用符によって日付時刻値を囲む必要があります。

--hoursago

イメージの収集時間間隔のデフォルト値を変更します。値は時間単位で指定されます。デフォルト値は 2160 時間 (90 日) です。

--log

ログ出力を特定のログファイルに強制的に出力します。デフォルトでは、ログ出力は収集されたデータとレポートが保存されるディレクトリ内のログファイルに書き込まれます。

--master

指定したマスターサーバーの容量ライセンスデータを収集します。このオプションは --gather を指定した場合にのみ使われます。ローカルホストでリモートサーバーからのデータを収集するには、ホスト名がリモートサーバーのサーバーリストに表示されている必要があります。

このオプションは、リモートで収集される容量ライセンス情報のみをサポートします。リモートで収集される従来のライセンスデータはサポートされません。

--nolog

デバッグログファイルの作成を無効にします。

--output

指定した出力ディレクトリに結果を保存します。基本 ASCII 文字を含んでいるディレクトリのみを指定できます。拡張 ASCII 文字が付いているディレクトリは指定できません。操作が gather の場合、出力ディレクトリは収集されたデータを保持します。report 操作では、レポートとログファイルは、指定済みの入力ディレクトリに収集されたデータと同じ場所に配置される代わりに、出力ディレクトリに置かれます。output オプションが指定されていない場合、出力は次のディレクトリに配置されます。

  • UNIX の場合: /usr/openv/var/global/reports/ YYYYMMDD_hhmmss_masterserver

  • Windows の場合: install_path\Netbackup\var\global\reports\YYYYMMDD_hhmmss_masterserver

--overlap-details

容量ライセンスレポートの[重複する対象 (Duplicate Selections)]列に、重複するバックアップ対象を表示します。このオプションは、ASCII 文字または英語のみのバックアップ対象データでのみ使用できます。

--parentdir

report パラメータがレポート生成に使用する収集済みライセンスデータが格納された多数のディレクトリが含まれるディレクトリツリーの最上位を指定します。ディレクトリのリストを含んでいるファイルを指定するために dirsfile パラメータを使うこともできます。

--runtimestats

ツールの実行時間の統計を表示します。この統計はメモリの使用量と CPU の使用率を含んでいます。

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

制限された収集期間の日付範囲の開始日を指定します。このパラメータの形式は "MM/DD/YYYY hh:mm:ss" です。時間値 hh:mm:ss は 24 時間表記で指定します。たとえば、午前 6 時は 06:00:00、午後 6 時は 18:00:00 となります。日時の値を二重引用符で囲む必要があることに注意してください。

--traditional

gatherreport と併用して、ライセンスモデルを指定します。--traditional は、NetBackup の従来のサーバーごとのライセンスモデルに従って配置について報告するために使います。デフォルト値は 2160 時間 (90 日) です。

--verbose

画面にツールの詳しい進捗情報を出力します。これにより、デバッグログファイル内の情報に影響が及ぶことはありません。ログファイルの内容は常に詳細です。

前提条件

次に示すのは netbackup_deployment_insights ツールの前提条件です。

  • データを収集するためには、マスターサーバーのデーモンまたはサービスが環境で動作している必要があります。

  • gather コマンドを実行するマスターサーバーに十分なディスク容量があることを確認します。容量ライセンスデータの収集では、過去 90 日間の bpimagelist 出力情報を収集します。出力のサイズは、その期間のカタログ内のイメージ数の関数となります。デフォルトの期間は、移動または短縮できます。分析の時間範囲を短くすると、数値が不正確になったり不完全になります。

  • レポートを表示するには Microsoft Excel が必要です。このソフトウェアはマスターサーバーにインストールされている必要はありません。

例 1 - 容量ライセンスレポートのデータを収集します。ディレクトリパスは UNIX システム用ですが、この例は 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
#

例 2 - 例 1 のデータを含む容量ライセンスレポートを生成します。ディレクトリパスは UNIX システム用ですが、この例は 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
#

例 3 - 従来ライセンスレポートのデータを収集します。ディレクトリパスは UNIX システム用ですが、この例は 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
#

例 4 - 例 3 のデータを含む従来ライセンスレポートを生成します。ディレクトリパスは UNIX システム用ですが、この例は 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
#

例 5 - 複数のプライマリサーバークレデンシャルを持つクレデンシャルファイルで指定された容量ライセンスを使用してデータを収集します。

#./netbackup_deployment_insights --gather --capacity 
 - -master=nb-host1,nb-host2 --credential-file 
/usr/openv/var/global/cred-file

cred-file ファイルには、次に示す情報が含まれます。

nb-host1
unixpwd
testdomain1
user1
testpass1
nb-host2
unixpwd
testdomain2
user2
testpass2

関連項目

bpimagelist(1m)を参照してください。

nbdeployutil(1m)を参照してください。