Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
NBCC — NetBackup の一貫性チェック (NBCC) ユーティリティの実行
概要
NBCC [-batch] [-debug] [-gather] [-help] [-idar] [-kbfree ####] [-locale locale_name] [-nozip] [-nocleanup] [-terse] [-upgrade] [-use_reg_cmd [32 | 64]] [-version] [-unknown_image_servers_option]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/support/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\support\
です。
機能説明
NBCC コマンドは、次の要素を含む NetBackup カタログおよびデータベースの一部の整合性を確認するために使われる NBCC ユーティリティを実行します。
テープメディアおよび関連付けられたイメージ
NBDB イメージ、ImageCopy テーブルレコード、ImageFragment テーブルレコード、およびイメージカタログ
Enterprise Media Manager (EMM) サーバーエントリと構成されたストレージユニットエントリ
NBCC はカタログの不整合を検出すると、一連の出力ファイルを生成します。利用可能なシステムユーティリティを使用して、これらのファイルのサポートパッケージバンドルが作成されます。
これらの不整合には、関連付けられたメディアサーバーが EMM データベースに認識されないイメージが含まれます。このような場合、-unknown_image_servers_option 機能を使って、認識されないメディアサーバーに関連付けられたイメージをコメントアウトする、期限切れにする、認識されるメディアサーバーで継承する、のいずれかのオプションを選択します。
NBCC ユーティリティについての詳しくは『NetBackup トラブルシューティングガイド』を参照してください。
オプション
- -batch
NBCC を非対話モードで実行します。このモードでは、次の処理が実行されます。
出力レポートがすでに存在する場合は、NBCC によって自動的に上書きされます。
bpimagelist 情報の処理後、EMM に認識されないメディアサーバーはフラグを付けられます。完全分析により、今後の確認のためにコメントアウトすべきすべての修復が生成されます。
NBCC は NetBackup カタログの不整合を検出しなければ、サポートパッケージを作成しません。
- -debug
追加のプログラムデバッグ情報が
nbcc-info.txt
ファイルに追加されるため、このファイルのサイズは大幅に増加します。- -gather
NetBackup の構成とカタログ情報のみを収集します。このオプションでは、NetBackup カタログの一貫性はチェックされません。
- -help
NBCC ユーティリティについて、より詳細なヘルプ情報を出力します。
- -idar
一貫性チェックに破棄されたテープメディアリソースの ID を含めます。
- -kbfree freespace
NBCC の実行に必要なファイルシステムの空き領域の量を指定します。整数のみ割り当てることができます。デフォルト値はヘルプの出力に表示されます。
NBCC のデフォルトでは、ファイルシステムの空き領域 (KB) は 2048000 です。
ファイルシステムのすべての空き領域チェックをスキップするには、この値をゼロ (0) に設定し、英語以外のロケール環境で実行します。
- -locale locale_name
NetBackup の common_local_name を指定します。NBCC は次のファイルでこの名前の有無を検索します。
UNIX の場合:
/usr/openv/msg/.conf
Windows の場合:
。\VERITAS\msg\LC_CONF
この名前は bpimagelist -d コマンドラインオプションで使用する関連付けられた日付形式を決定します。
- -nocleanup
NBCC が不整合を検出せずに一貫性チェックを実行した場合、結果のサポートパッケージまたはファイルはクリーンアップされません。
メモ:
-nocleanup オプションと -gather オプションを一緒に使わないでください。これらは一貫性チェック状態であるために相互に排他的です。
- -nozip
サポートパッケージバンドルの作成をスキップします。生成された NBCC ファイルは出力ディレクトリに残ります。
- -terse
各カタログレコードから個々のカタログの内容ファイルに、一貫性チェックに関連付けられたフィールドのみを抽出します。
- -unknown_image_servers_option
一貫性の分析で、EMM に認識されないイメージデータベースで検出される任意のメディアサーバーに行う処理を指定します。option には、次のいずれかの値を指定します。
comment_all - 認識されないメディアサーバーに関連付けられるイメージに関連していると分析プログラムが生成する、推奨される修復操作 (SRA) をコメントアウトします。したがって、NBCCR はこれらのコメントアウトされた修復の処理を試みません。
expire_all - 分析プログラムが NBCCR で処理するために生成する SRA で、認識されないメディアサーバーに関連付けられるすべてのイメージを期限切れにします。
inherit_all hostname - 認識されるメディアサーバー (hostname) を指定して、認識されないサーバーと置き換えます。この新しいサーバーは、任意の認識されないメディアサーバーと関連付けられるすべてのイメージを継承します。分析プログラムは、NBCCR で処理するため SRA 項目を生成します。
たとえば、次のコマンドにより、任意の認識されないメディアサーバーと関連付けられるすべてのイメージがメディアサーバー MS1 に継承されます。
# NBCC -unknown_image_servers_inherit_all MS1
- -upgrade
NetBackup カタログをアップグレードする機能に関連する一貫性チェックのみを含めます。
- -use_reg_cmd [32 | 64]
Windows レジストリに問い合わせる
Reg.exe
ユーティリティの使用を有効にします。このオプションが正しく機能するように、/reg:32
または /reg:64 コマンドラインパラメータをサポートするバージョンの Reg.exe がインストールされている必要があります。このオプションは Windows システムでのみ動作します。
- -version
NBCC の内部バージョン番号を出力します。
前提条件
NBCC ユーティリティを使用するには、次の項目が必要です。
サポートパッケージを作成する NBCC の場合、次のプログラムへのパスを $PATH 環境変数に含める必要があります。tar および gzip
tar が利用できない場合は、makecab プログラムを使い (該当する場合)、出力ファイルをバンドルし、圧縮します。
これらのプログラムが利用できず、単一のサポートパッケージファイルが必要な場合は、出力ディレクトリのファイルを手動でサポートパッケージにバンドルします。
コマンドラインオプションの -kbfree 0 を使わない場合、NBCC はファイルシステムの使用状況の特性を検査します。次に、設定情報とカタログ情報をアンロードし、サポートパッケージを作成します。この情報には利用可能なファイルシステムの空き領域が含まれています (KB 単位)。(-kbfree オプションの説明を参照してください。)
EMM サーバーは稼働中である必要があります。
vmd プロセスはマスターサーバーと、NetBackup 構成内で EMM サーバーとして機能する他のすべてのサーバーで動作する必要があります。
bpdbm プロセスはマスターサーバーで動作する必要があります。
インストールされた NetBackup ですべてのメディアサーバーと ltid プロセスが実行しており、ネットワークサービスが構成されている必要があります。
NetBackup 構成内のすべてのサーバーと、NBCC ユーティリティが実行するサーバーの UTC 時間は、互いに数分以内に同期する必要があります。
メモ:
クロックの同期が確認できないと、NBCC が不正確な結果を報告する原因となる場合があります。
プログラムの使用方法
以下は、プログラムの使用方法の注意事項です。
NBCC はサポートディレクトリから実行されます (使用方法を参照してください)。別のディレクトリから実行する場合、NBCC は次のデフォルトのディレクトリの場所を使います。
UNIX の場合:
/usr/openv/netbackup/bin/support/config
Windows の場合:
install_path\NetBackup\bin\support\
カタログの一貫性の問題を特定し、適切に修正するには、以下を確認します。 データが収集されてから修正作業が完了するまでの間、NetBackup ジョブが実行していない、または開始されていない。ほとんどの構成でこの条件を満たすのは不可能であるため、NBCC はアクティブな NetBackup ジョブに関連付けられたテープメディアを特定しようとします。通常の処理中に発生することがある伝播遅延が原因で、すべての有効なテープメディアが識別されないことがあります。そのため、一貫性の分析の結果を慎重に見直す必要があります。
NBCC は EMM マスターサーバーを検出します。複数のマスターサーバーが検出された場合、NBCC は NBCC が実行するシステムに関連付けられているものを特定します。 NBCC は、識別された EMM マスターサーバーを使って、どの EMM メディアサーバーがそのマスターサーバーと関連付けられているかを判断します。
戻り値
次の終了値が戻されます。
0 = Consistency checks skipped (-gather) No inconsistency detected 1 = Inconsistency detected 2 = Program error condition detected: Invalid command line option .nbcc.lock file exists File permission problem File open/read/write problem Insufficient free disk space Unable to obtain the version of NetBackup Issue with NetBackup configuration information/detection Issue with NetBackup catalog information/detection 3 = -help information displayed -version information displayed