Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
bpflist — NetBackup サーバーにバックアップおよびアーカイブされたファイルの表示
概要
bpflist [-l | -L | -U ] [-v] [-M master_server,...] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-ut unixtime] [-bt unixtime] [-st sched_type] [-policy policy_name] [-client client_name] [-keyword keyword_phrase] [-pattern fullpath] [-pt policy_type] [-user name] [-group name] [-raw mode] [-backupid name] [-psep path_separator_character] [-malgo match_algorithm] [-rl recursion_level] [-option option ...]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\
です。
説明
bpflist コマンドを実行すると、指定したオプションに従って、以前にアーカイブまたはバックアップされたファイルのリストが表示されます。 このコマンドは NetBackup サーバーでのみ利用可能で、認可済みユーザーのみが実行できます。 このコマンドは、クライアントを含むすべての NetBackup ホストで利用可能な bplist コマンドに似ています。
リストの表示には次の方法があります。
- -l
簡易形式でレポートを生成します。デフォルト状態です。 この簡潔なリストは、カスタマイズされたレポート形式にリストを再生成するスクリプトまたはプログラムに役立ちます。 「例 1」を参照してください。
- -L
詳細形式でレポートを生成します。
- -U
それぞれの結果にテキストヘッダーが付けられるユーザー形式でレポートを生成します。 値はカンマで区切られます。 「例 2」を参照してください。
オプション
- -backupid name
リストに表示するイメージの検索に使用するバックアップ ID を指定します。
- -bt unixtime
指定した UNIX 時間に開始日を設定します。 -bt オプションは - d オプションの代わりです。
- -client client_name
このオプションでは、表示するバックアップまたはアーカイブの検索に使用するクライアント名を指定します。 デフォルトでは、bpflist はコマンドを実行するホストの名前を使用します。
- -s mm/dd/yyyy [hh:mm:ss] -e mm/dd/yyyy[hh:mm:ss]
表示の開始日から終了日までの範囲を次のように指定します。
-d では、表示の対象とする開始日時を指定します。 出力リストには、指定した日時以降に実行されたバックアップまたはアーカイブのファイルのみが表示されます。 -d デフォルトは、現在の日付の午前 0 時です。
-e では、表示の対象とする終了日時を指定します。 出力リストには、指定した日時以前に実行されたバックアップまたはアーカイブ内のファイルだけが表示されます。 -e デフォルトは、現在の日時です。
開始日と終了日の形式は同じです。 有効な日時の範囲は、01/01/1970 00:00:00 から 01/19/2038 03:14:07 です。
NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。
/usr/openv/msg/.conf
ファイル (UNIX) とinstall_path\VERITAS\msg\LC.CONF
ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。システムのロケールについて詳しくは、『NetBackup 管理者ガイド Vol. 2』の「NetBackup インストールのロケールの指定について」を参照してください。
- -group name
アクセスしてファイルをリストできるグループを指定します。 グループがアクセスできるファイルのみをリストできます。 このオプションは、 - malgo オプションが 3 に設定されている場合にのみ有効です。
- -keyword "keyword_phrase"
NetBackup がファイルをリストするバックアップまたはアーカイブを検索する際に使用するキーワード句を指定します。 この句は、bpbackup -k コマンドまたは bparchive -k コマンドによってバックアップまたはアーカイブに以前に関連付けられた句と一致している必要があります。 このオプションは、他のオプションの代わりに使用するか、または他のオプションと同時に使用して、簡単にバックアップとアーカイブを選択できます。
次のメタ文字を使用して、句の中のキーワードまたはキーワードの一部を一致させることができます。
* は、任意の文字数の文字列に一致します。
? 任意の 1 文字に一致します。
[ ] は、この角カッコ内に指定されている連続した文字に一致します。
[ - ] は、ハイフン ("-") によって区切られた文字の範囲に一致します。
キーワード句は、最大 128 文字で指定できます。 空白 (" ") とピリオド (".") を含む印字可能なすべての文字を指定できます。 キーワード句は、二重引用符 ("...") または一重引用符 ('...') で囲む必要があります。デフォルトのキーワード句は NULL (空) 文字列です。
- -M master_server,...
1 つ以上の代替マスターサーバーを表すホスト名をカンマで区切ったリストを指定します。 リストの各マスターサーバーが bpflist コマンドを実行します。 マスターサーバーでエラーが発生した場合、その時点で処理が停止します。 レポートは、このリストのすべてのマスターサーバーから返された情報で構成されます。 bpflist コマンドは、各マスターサーバーに問い合わせを実行します。 マスターサーバーによって、イメージカタログのイメージまたはメディアの情報が戻されます。各マスターサーバーによって、bpflist コマンドを発行するシステムからのアクセスが許可されている必要があります。 デフォルトは、bpflist コマンドを実行しているシステムのマスターサーバーです。
- -malgo match_algorithm
このオプションでは、表示するファイルまたはディレクトリを指定します。 すべてのファイルまたはディレクトリは、他のすべてのオプションに続いて、最後に指定する必要があります。 パスを指定しない場合、現在作業中のディレクトリがデフォルトになります。有効値は次のとおりです。
0 (MA_DEFAULT)
1 (MA_AWBUS)
2 (MA_USE_GMATCH)
3 (MA_WITH_SECURITY)
- -option option ...
コマンドの動作に影響する空白で区切られたオプションのリストを指定します。 option に指定できる値は、次のとおりです。
NONE FILESYSTEM_ONLY GET_ALL_FILES GET_PRIMARY_COPY_NUM_BLOCKS (Return the number of blocks in the primary copy) IGNORE_CASE INCLUDE_BITMAP INCLUDE_EDI (Include EDI images) INCLUDE_EFI (Include EFI system partition images) INCLUDE_FSMAP INCLUDE_HIDDEN_IMAGES (Include hidden images) INCLUDE_RAW_INCR (Include raw incremental images) INCLUDE_TIR (Include True Image Restore images) NO_HSHAKE (Continue sending data even if the socket is not ready) ONE_CONNECT (Run multiple queries on a single connection) ONE_PASS (Return all files at once) ONLY_DIRS(Return only directories) ONLY_ENV_VARS (Return only NDMP environment variables) ONLY_FIRST_FRAGMENT ONLY_INPROGRESS_IMAGES (Return only in progress or unvalidated images) ONLY_SC_CLIENT_TYPES ONLY_TIR (Return only TIR images) ONLY_VM_FILES (Return only virtual machine images) STR2FILE_ENTRY_FORMAT
- -pattern fullpath
指定されたパターンに一致するファイルのみがリストされます。
- -policy policy_name
このオプションでは、リストの生成時に検索するポリシーを指定します。 このオプションを指定しない場合、すべてのポリシーが検索されます。
- -psep path_separator_character
パスの区切り記号を指定します。
- -pt policy_type
このオプションでは、ポリシー形式を指定します。デフォルトでは、bpflist はすべてのポリシー形式を検索します。 policy_type は、次のいずれかの文字列です。
- -raw mode
raw パーティションモードを指定します。
- -rl recursion_level
指定された階層まで、サブディレクトリを再帰的にリストします。
- -st schedule_type
このオプションでは、プライマリコピーを変更するバックアップイメージのスケジュール形式を指定します。デフォルトでは、bpchangeprimary ではすべてのスケジュール形式が使用されます。次に、有効な値を示します。
FULL (完全バックアップ)
INCR (差分増分バックアップ)
CINC (累積増分バックアップ)
UBAK (ユーザーバックアップ)
UARC (ユーザーアーカイブ)
NOT_ARCHIVE (ユーザーアーカイブ以外のすべてのバックアップ)
SCHED (FULL、INCR、CINC、TLOG)
USER (UBAK と UARC)
TLOG (トランザクションログ)
ANY (前の任意の種類)
- -user name
アクセスしてファイルをリストできるユーザーを指定します。 ユーザーがアクセスできるファイルのみをリストできます。 このオプションは、 - malgo オプションが 3 に設定されている場合にのみ有効です。
- -ut unixtime
- d オプションと - e オプションの代わりを指定し、開始日と終了日を指定した UNIX 時間に設定します。 リストするバックアップまたはアーカイブを 1 つのみ指定する場合は、このオプションを使用します。
- -v
詳細モードのレポートを生成し、コンソールにログメッセージを表示します。
例
例 1 - UNIX システムで、Unix 時間 1380000000 以降のバックアップ内でパス /images
を検索します。 リストは簡易形式です (デフォルト状態)。
# bpflist -client cl2 -bt 1380000000 -rl 0 -pt Standard -pattern /images FILES 10 0 0 1383577314 0 cl2 test cl2_1383577314 - *NULL* 1 0 unknown unknown 0 0 *NULL* 1 0 19 50 8 1 0 0 2051 /images/ 16877 root root 0 1383334897 1382366087 1383559354 FILES 10 0 0 1383334895 0 cl2 test cl2_1383334895 - *NULL* 1 0 unknown unknown 0 0 *NULL* 1 0 19 50 8 1 0 0 2051 /images/ 16877 root root 0 1383331790 1382366087 1383296672 FILES 10 0 0 1383331752 0 cl2 test cl2_1383331752 - *NULL* 1 0 unknown unknown 0 0 *NULL* 355 0 19 50 1708556 1 0 0 2051 /images/ 16877 root root 0 1382647177 1382366087 1383296672
例 2 - ユーザー (-U) 形式でリストを表示します。
# bpflist -client cl2 -bt 1380000000 -rl 0 -pt Standard -pattern /images -U Client: cl2 Policy: test Backup ID: cl2_1383577314 Backed up: Mon 04 Nov 2013 09:01:54 AM CS (1383577314) Software Version: ? Policy Type: Standard Schedule Type: FULL Version: 10 Keyword: ? Num Files: 1 Files: FN=1 L=0 PL=19 DL=50 BK=8 II=1 RS=0 GB=0 DN=2051 P=/images/ D=16877 root root 0 1383334897 1382366087 1383559354 Client: cl2 Policy: test Backup ID: cl2_1383334895 Backed up: Fri 01 Nov 2013 02:41:35 PM CD (1383334895) Software Version: ? Policy Type: Standard Schedule Type: FULL Version: 10 Keyword: ? Num Files: 1 Files: FN=1 L=0 PL=19 DL=50 BK=8 II=1 RS=0 GB=0 DN=2051 P=/images/ D=16877 root root 0 1383331790 1382366087 1383296672