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

Last Published:
Product(s): NetBackup (8.1.1)
  1. 概要
    1.  
      NetBackup コマンドについて
    2.  
      複数階層のメニューの操作
    3.  
      NetBackup のコマンドの表記規則
    4.  
      NetBackup Media Manager コマンドの注意事項
    5.  
      IPV6 の更新
  2. 付録 A. 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.  
      bppolicynew
    62.  
      bpps
    63.  
      bprd
    64.  
      bprecover
    65.  
      bprestore
    66.  
      bpretlevel
    67.  
      bpschedule
    68.  
      bpschedulerep
    69.  
      bpsetconfig
    70.  
      bpstsinfo
    71.  
      bpstuadd
    72.  
      bpstudel
    73.  
      bpstulist
    74.  
      bpsturep
    75.  
      bptestbpcd
    76.  
      bptestnetconn
    77.  
      bptpcinfo
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configurePorts
    84.  
      create_nbdb
    85.  
      csconfig cldinstance
    86.  
      csconfig cldprovider
    87.  
      csconfig meter
    88.  
      csconfig throttle
    89.  
      duplicatetrace
    90.  
      importtrace
    91.  
      jbpSA
    92.  
      jnbSA
    93.  
      ltid
    94.  
      manageClientCerts
    95.  
      mklogdir
    96.  
      nbauditreport
    97.  
      nbcatsync
    98.  
      NBCC
    99.  
      NBCCR
    100.  
      nbcertcmd
    101.  
      nbcertupdater
    102.  
      nbcldutil
    103.  
      nbcomponentupdate
    104.  
      nbcplogs
    105.  
      nbdb_admin
    106.  
      nbdb_backup
    107.  
      nbdb_move
    108.  
      nbdb_ping
    109.  
      nbdb_restore
    110.  
      nbdb_unload
    111.  
      nbdbms_start_server
    112.  
      nbdbms_start_stop
    113.  
      nbdc
    114.  
      nbdecommission
    115.  
      nbdelete
    116.  
      nbdeployutil
    117.  
      nbdevconfig
    118.  
      nbdevquery
    119.  
      nbdiscover
    120.  
      nbdna
    121.  
      nbemm
    122.  
      nbemmcmd
    123.  
      nbexecute
    124.  
      nbfindfile
    125.  
      nbfirescan
    126.  
      nbftadm
    127.  
      nbftconfig
    128.  
      nbgetconfig
    129.  
      nbhba
    130.  
      nbholdutil
    131.  
      nbhostidentity
    132.  
      nbhostmgmt
    133.  
      nbhypervtool
    134.  
      nbjm
    135.  
      nbkmsutil
    136.  
      nboraadm
    137.  
      nborair
    138.  
      nbpem
    139.  
      nbpemreq
    140.  
      nbperfchk
    141.  
      nbplupgrade
    142.  
      nbrb
    143.  
      nbrbutil
    144.  
      nbregopsc
    145.  
      nbreplicate
    146.  
      nbrestorevm
    147.  
      nbseccmd
    148.  
      nbsetconfig
    149.  
      nbsnapimport
    150.  
      nbsnapreplicate
    151.  
      nbsqladm
    152.  
      nbstl
    153.  
      nbstlutil
    154.  
      nbstop
    155.  
      nbsu
    156.  
      nbsvrgrp
    157.  
      resilient_clients
    158.  
      restoretrace
    159.  
      stopltid
    160.  
      tl4d
    161.  
      tl8d
    162.  
      tl8cd
    163.  
      tldd
    164.  
      tldcd
    165.  
      tlhd
    166.  
      tlhcd
    167.  
      tlmd
    168.  
      tpautoconf
    169.  
      tpclean
    170.  
      tpconfig
    171.  
      tpext
    172.  
      tpreq
    173.  
      tpunmount
    174.  
      verifytrace
    175.  
      vltadm
    176.  
      vltcontainers
    177.  
      vlteject
    178.  
      vltinject
    179.  
      vltoffsitemedia
    180.  
      vltopmenu
    181.  
      vltrun
    182.  
      vmadd
    183.  
      vmchange
    184.  
      vmcheckxxx
    185.  
      vmd
    186.  
      vmdelete
    187.  
      vmoprcmd
    188.  
      vmphyinv
    189.  
      vmpool
    190.  
      vmquery
    191.  
      vmrule
    192.  
      vmupdate
    193.  
      vnetd
    194.  
      vwcp_manage
    195.  
      vxlogcfg
    196.  
      vxlogmgr
    197.  
      vxlogview
    198.  
      W2KOption

名前

nbdeployutil — クライアントと容量に関するマスターサーバー情報を収集して分析する配置ユーティリティ

概要

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

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

 

UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。

Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\ です。

説明

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

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

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

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

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

操作

--debug-inputs

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

--gather

report オプションを指定して分析用のデータを収集します。capacitytraditional パラメータが使われている場合、その特定のライセンスモデルのデータのみが収集されます。capacitytraditional も指定されていない場合、gather は両方のライセンスモデルのデータを収集します。

NetBackup 8.0 以降のマスターサーバーでは、キャパシティライセンスで nbdeployutil --gather コマンドを実行すると、追加情報を入力するように求められます。NetBackup Web 管理サービスの認証に示されているクレデンシャル情報を入力する必要があります。

  • ドメイン形式: NIS、NISPLUS、WINDOWS、vx、unixpwd、ldap. からドメイン形式の値を入力します。 この値では大文字と小文字が区別されます。

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

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

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

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

--report

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

--retry

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

--version

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

オプション

--bpimagelist

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

--capacity

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

--client または --clientlist

指定済みのクライアントまたはクライアントリストに対してのみ、データやデータレポートを収集します。client を使用する場合は、カンマで複数のクライアントを区切ります。clientlist パラメータを使うためには、filename で別々の行にクライアントをリストします。--client または --clientlist オプションを使うと、ユーティリティでは接続できるにもかかわらず一部のメディアサーバーは接続不可能であるとレポートに表示される場合があります。この問題が概略情報に影響を及ぼすことはありません。

--day-boundary

レポートを作成するためのレポートの時間帯の開始を移動します。デフォルトのレポート時間帯は、午前 0 時から午後 11 時 59 分 59 秒までです。time 値は、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:00 AM は 06:00:00、6:00 P.M. は 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\ VERITAS\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:00 AM は 06:00:00、6:00 P.M. は 18:00:00 です。日時の値を二重引用符で囲む必要があることに注意してください。

--traditional

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

--verbose

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

前提条件

次に、nbdeployutil ユーティリティの前提条件を示します。

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

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

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

例 1 - NetBackup のキャパシティライセンスモデルと従来のライセンスモデルの両方の配置分析レポートを作成します。ディレクトリパスは Windows システム用ですが、この例は 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

例 2 - 対象を絞った配置容量分析を実行します。このコマンドはデフォルトと異なる時間枠でクライアントのサブセットのデータを収集します。ディレクトリパスは Windows システム用ですが、この例は 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

関連項目

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