Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
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 --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 オプションを指定して分析用のデータを収集します。capacity か traditional パラメータが使われている場合、その特定のライセンスモデルのデータのみが収集されます。capacity も traditional も指定されていない場合、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
- --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
gather か report と併用して、ライセンスモデルを指定します。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