Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
bpimage — データベースに保存されているイメージに対する機能の実行
概要
bpimage -[de]compress [-allclients | -client name] [-M master_server,...][-update_compression]
bpimage -npc copy_number -backupid backupid [-client name] [-M master_server,...]
bpimage -newserver newserver_name [-oldserver oldserver_name] [-id id] [-M master_server,...]
bpimage -deletecopy copy_number -backupid backupid [-M master_server,...]
bpimage -testlock copy_number -backupid backupid [-M master_server,...]
bpimage -prunetir [-allclients | -client name] -cleanup [-notimmediate] [-M master_server,...]
bpimage -cleanup_image_change_log [-M master_server,...]
bpimage -gendrreport -backupid backupid [-M master_server,...]
bpimage -wff pathbytes -backupid backupid [-client name] [-M master_server,...]
bpimage -update [-rfile 0|1 | -filesysonly 0|1 | -numfiles number | -keyword keyword_phrase | -objdesc string] [-client name -policy name -t type -d mm/dd/yyyy hh:mm:ss] [-id id] [-M master_server,...]
UNIX システムでは、このコマンドのディレクトリパスは /usr/openv/netbackup/bin/admincmd です。
Windows システムでは、このコマンドのディレクトリパスは install_path\NetBackup\bin\admincmd\
です。
機能説明
このコマンドを実行すると、データベースに格納されているイメージに対してさまざまな機能を実行できます。実行できる機能には、次のものがあります。
格納されているイメージの圧縮または解凍。
データベースからの既存のイメージの削除。
イメージに対するロック機能のテスト。
オプション
次のオプションを指定すると、レポート対象として選択するイメージまたはメディアを決定する条件が表示されます。イメージに対するこれらのオプションの説明は、コンテキストがメディアレポートを参照する場合、メディアに置き換えることができます。
- -allclients
すでにシステム上にバックアップされているすべての NetBackup クライアントが選択されます。
- -backupid backup_id
このオプションでは、適用可能なイメージの検索に使用するバックアップ ID を指定します。
- -cleanup
このオプションを指定すると、期限切れになったイメージが削除され、圧縮するようにスケジュールされているイメージが圧縮され、指定したイメージから TIR 情報が削除されます。
メモ:
このオプションを実行すると、ユーザーは、スケジューラによって定期的に実行されるのと同じタスクを手動で実行できます。スケジューラによって実行されるまで待ちきれない場合は、このコマンドを使用してタスクを実行することができます。
- -cleanup_image_change_log
現在のマスターサーバーでのイメージの変更をクリーンアップし、必要に応じて、-M オプションで指定された他のマスターサーバーでのイメージの変更をクリーンアップします。
- -client name
このオプションでは、指定した機能を実行するバックアップまたはアーカイブの検索に使うクライアント名を指定します。bpimage で検索するクライアント名は大文字と小文字が区別されません。たとえば、
client
、cLiEnT
、CLIENT
のいずれを指定してもイメージが表示されます。デフォルトでは、bpimage を実行すると、すべてのクライアントのイメージが検索されます。- -d date
これらのオプションでは、表示の対象とする開始日時から終了日時の範囲を指定します。
-d では、表示の対象とする開始日時を指定します。リストには、指定した日時以降に実行されたバックアップまたはアーカイブ内のイメージだけが表示されます。
NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。
/usr/openv/msg/.conf
ファイル (UNIX) とinstall_path\VERITAS\msg\LC.CONF
ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。システムのロケールについて詳しくは、『NetBackup 管理者ガイド Vol. 2』の「NetBackup インストールのロケールの指定について」を参照してください。
有効な日時の範囲は、01/01/1970 00:00:00 から 01/19/2038 03:14:07 です。デフォルトは、現在の日付の午前 0 時です。
- -[de]compress
指定したクライアントまたはすべてのクライアントを圧縮または圧縮解除します。
- -deletecopy copy_number
コピー番号と backup_id によって指定されたイメージが削除されます。
- -filesysonly 0|1
1 に設定すると、ローカルファイルシステムの問い合わせのみに bpimage を制限します。
- -gendrreport
指定された backup_id に対してディザスタリカバリレポートを生成します。
- -id id
-newserver コマンドと使われる場合はメディア ID を指定し、-update コマンドと使われる場合はバックアップ ID を指定します。
- -keyword "keyword_phrase"
このオプションでは、検索に使用する NetBackup のキーワード句を指定します。キーワード句は、事前にイメージに関連付けられているキーワード句に一致している必要があります。
- -M master_server,...
このオプションでは、代替マスターサーバーのリストを指定します。このリストは、カンマで区切られたホスト名のリストです。リストの各マスターサーバーが bpimage コマンドを実行します。マスターサーバーでエラーが発生した場合、その時点で処理が停止します。
レポートは、このリスト内のすべてのマスターサーバーから戻される情報で構成されます。bpimage コマンドを実行すると、各マスターサーバーに対して問い合わせが発行されます。マスターサーバーによって、イメージカタログのイメージまたはメディアの情報が戻されます。各マスターサーバーによって、bpimage コマンドを発行するシステムからのアクセスが許可されている必要があります。
デフォルトは、bpimage コマンドを実行しているシステムのマスターサーバーです。
- -newserver name | -oldserver name
このオプションでは、NetBackup サーバーの元の名前または新しい名前を指定します。
- -notimmediate
このオプションを指定すると、ディスク上のイメージが期限切れになった後、bpexpdate による nbdelete コマンドの呼び出しが行われません。一度に多数のイメージを削除する場合、-notimmediate を使用すると、nbdelete 処理で複数のジョブが作成されることによって発生するオーバーヘッドを回避できます。nbdelete コマンドは後で実行できます。
- -npc copy_number
このオプションを指定すると、指定したイメージが、イメージのコピー番号に基づいてプライマリイメージとして設定されます。
- -numfiles number
このオプションでは、-update コマンドの実行時のファイル数を指定します。
- -objdesc string
このオプションでは、-update コマンドの実行時の Informix クライアント形式のオブジェクト記述文字列を指定します。
- -policy name
このオプションを指定すると、指定したポリシー内で、インポートするバックアップが検索されます。デフォルトはすべてのポリシーです。
- -prunetir
このオプションを指定すると、指定したクライアントから True Image Restore (TIR) 情報が削除されます。 デフォルトはすべてのクライアントです。
- -rfile 0|1
-update コマンドで指定するとリストアファイルが使用されます。
- -t type
このオプションでは、ポリシー形式を指定します。デフォルトでは、bpimage コマンドを実行すると、すべてのポリシー形式が検索されます。type には、次のいずれかの文字列を指定します。
Informix-On-BAR MS-Exchange-Server MS-SQL-Server MS-Windows Oracle Standard Sybase NDMP
次のポリシー形式は、NetBackup Enterprise Server だけに適用されます。
- -testlock
指定されたバックアップ ID のコピーがロックされているかどうかを特定します。
- -update
このコマンドを実行すると、選択したパラメータに基づいてイメージが更新されます。
- -update_compression
以前の圧縮アルゴリズムを使用して圧縮されたイメージを解凍し、新しいアルゴリズムでそれらを再圧縮するように NetBackup に指示されます。-update_compression フラグは、-compress オプションと一緒に使用した場合にのみ適用されます。
新しい圧縮アルゴリズムは、NetBackup 7.6 で配備されています。以前のアルゴリズムでは、NetBackup の .f ファイルには、Linux または UNIX 上では .Z というファイル名拡張子が付きます。新しいアルゴリズムでは、.Zs または .Zl のいずれかの拡張子が付きます。.Zs 拡張子は、それらのファイルがユーザー指定のスクリプトを使用して圧縮されており、Linux および UNIX 上でのみ使用されることを示します。.Zl 拡張子は、NetBackup によって内部的に圧縮され、Windows、Linux、UNIX の各プラットフォームで使用されるファイル用です。
- -wff path bytes
このコマンドを実行すると、
-backupID
で指定したバックアップの files-file (イメージの .f ファイル) が書き込まれます。
例
例: この例では、指定されたバックアップ ID のコピーがロックされているかどうかを判別します。
# bpimage -testlock 1 -backupid abc123.server.domain.com_1416316372 Backupid abc123.server.domain.com_1416316372 copy 1 is not locked