Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
bparchive — NetBackup サーバーへのファイルのアーカイブ
概要
bparchive [-p policy] [-s schedule][-L progress_log [-en]] [-S master_server [,master_server,...]] [-t policy_type] [-w [hh:mm:ss]] [-k "keyword_phrase"] -f listfile | filenames
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\ です。
説明
bparchive を実行すると、コマンドラインまたは -f listfile オプションで指定したファイル内に一覧表示されたファイルが処理されます。ファイルパスには、ファイル名またはディレクトリ名を入力できます。ファイルのリストにディレクトリが含まれる場合、そのディレクトリ以下のすべてのファイルおよびサブディレクトリのアーカイブが行われ、コマンドはそのディレクトリから開始されます。
デフォルトでは、bparchive が正常に発行されると、システムプロンプトに戻ります。このコマンドはバックグラウンドで実行され、完了状態はユーザーに直接戻されません。-w オプションを指定すると、bparchive がフォアグラウンドで実行され、指定した時間の経過後に完了状態が戻されるように変更できます。
bparchive を実行すると、進捗ログファイルが作成されている場合、情報メッセージおよびエラーメッセージがこのファイルに書き込まれます。このファイルは、bparchive の実行前に作成しておく必要があります。その後、-L progress_log オプションを使用して、このファイルを指定します。bparchive を実行しても、要求したファイルまたはディレクトリのアーカイブが行われない場合、この進捗ログを使用して、エラーの原因を判断することができます。
書き込みを許可してディレクトリを作成した場合、bparchive を実行すると、このディレクトリにデバッグログファイルが作成され、トラブルシューティングに使用できます。
Windows システムでは、nbu_dir_path は install_path\NetBackup\logs\bparchive\ です。
UNIX システムでは、ディレクトリは /usr/openv/netbackup/logs/bparchive/
です。
USEMAIL = mail_address の場合、NetBackup は mail_address にアーカイブの完了状態を通知するメールを送信します。管理者以外のユーザーは $HOME/bp.conf
ファイルで指定します。管理者は /usr/openv/netbackup/bp.conf ファイル
で指定します。このメッセージはアーカイブ処理が完了すると送信されます。
次に、このコマンドに適用される制限事項を示します。
UNIX システムの場合: bparchive を実行してファイルのアーカイブを行う場合、そのファイルを削除するために、root ユーザーであるか、所有者としてのプライマリグループのメンバーである必要があります。また、このファイルのアクセス権限は読み取り専用にしないでください。読み取り専用の場合、NetBackup によってこのファイルは保存されますが、ファイルのアクセス時間 (
utime
) をリセットできないため、ファイルはディスクから削除されません。Windows システムでは、bparchive を実行してファイルのアーカイブを行う場合、ユーザーがファイルを削除する権限を所有している必要があります。また、このファイルのアクセス権限は読み取り専用でないことが必要です。読み取り専用の場合、NetBackup によってこのファイルは保存されますが、ディスクからは削除されません。
UNIX システムの場合: リンクである UNIX ファイルを指定して bparchive を実行すると、リンク先のファイルではなく、そのリンク自身のアーカイブだけが行われます。
bparchive を実行しても、[.]または[..]ディレクトリエントリのアーカイブは行われません。また、ディスクイメージのバックアップのアーカイブも行われません。
オプション
- -p policy
このオプションでは、ユーザーアーカイブに使用するポリシー名を指定します。名前を指定しない場合、NetBackup サーバーでは、そのクライアントとユーザーアーカイブスケジュールが含まれるポリシーのうち、最初に検出されたポリシーを使用します。
- -s schedule
このオプションでは、ユーザーアーカイブに使用するスケジュール名を指定します。名前を指定しない場合、NetBackup サーバーでは、そのクライアントが使用するポリシー内で最初に検出されたユーザーアーカイブスケジュールが使用されます(-p オプションを参照してください。)
- -S master_server
UNIX システムでは、このオプションは NetBackup マスターサーバーの名前を指定します。デフォルトは、/usr/openv/netbackup/bp.conf ファイルの最初の
SERVER
エントリです。Windows システムでは、このオプションは NetBackup マスターサーバーの名前を指定します。デフォルトは、[NetBackup マシンの指定 (Specify NetBackup Machines)]ダイアログボックスの[サーバー (Servers)]タブで操作対象として指定されているサーバーです。このダイアログボックスを表示するには、クライアント上でバックアップ、アーカイブおよびリストアユーザーインターフェースを起動します。次に[ファイル (File)]メニューから[NetBackup マシンおよびポリシー形式の指定 (Specify NetBackup Machines and Policy Type)]を選択します。
- -t policy_type
このオプションでは、ポリシー形式に対応する次のいずれかの番号を指定します。Windows クライアントのデフォルトは 13 です。その他のすべてのクライアントのデフォルトは 0 です。
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
13 = MS-Windows
15 = MS-SQL-Server
16 = MS-Exchange-Server
19 = NDMP
次のポリシー形式は、NetBackup Enterprise Server だけに適用されます。
11 = DataTools-SQL-BackTrack
17 = SAP
18 = DB2
20 = FlashBackup
21 = Split-Mirror
39 = Enterprise-Vault
- -L progress_log [-en]
このオプションでは、進捗情報を書き込む既存のファイル名を指定します。
UNIX システムでは、ファイル名は / から始まる必要があります。
例:
netbackup/logs/user_ops/proglog
Windows システムの例は、
NetBackup\logs\user_ops\proglog
です。デフォルトでは、進捗ログは使用されません。
-en オプションを指定すると、進捗ログが英語で生成されます。ログ名には文字列[_en]が含まれます。このオプションは、異なるロケールでさまざまな言語のログが作成される分散環境において有効です。
このオプションに対してはデフォルトパスのみが許可されます。Symantec はデフォルトパスを使用することをお勧めします。設定で NetBackup のデフォルトパスを使用できない場合は、NetBackup 構成にカスタムパスを追加する必要があります。
カスタムパスを追加する方法について詳しくは、『NetBackup 管理者ガイド Vol. 1』の「NetBackup サーバーおよびクライアントの BPCD_WHITELIST_PATH オプション」の項を参照してください。
- -w [hh:mm:ss]
このオプションを指定すると、NetBackup はサーバーから完了状態が送信されるまで待機し、その後、システムプロンプトに戻ります。
NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。
/usr/openv/msg/.conf
ファイル (UNIX) とinstall_path\VERITAS\msg\LC.CONF
ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。『NetBackup 管理者ガイド Vol. 2』の NetBackup インストールのロケールの指定に関する項を参照してください。
必要に応じて、待機時間を時間、分、秒で指定できます。指定可能な最大待機時間は、23:59:59 です。 アーカイブが完了する前に待機時間が経過すると、コマンドはタイムアウト状態で終了します。ただし、サーバー上ではアーカイブが完了します。
待機時間を指定せずに -w を使用する場合、または待機時間の値に 0 (ゼロ) を指定する場合、NetBackup は無制限に完了状態を待機します。
- -k keyword_phrase
このオプションでは、このアーカイブ操作で作成されるイメージに関連付けるキーワード句を指定します。その後、bprestore で -k オプションを使用して、キーワード句を指定し、イメージのリストアを行うことができます。
キーワード句は、アーカイブのテキスト形式の記述で、128 文字以内で指定します。空白 (「 」) およびピリオド (「.」) を含むすべての印字可能な文字列を指定できます。
キーワード句は、二重引用符 ("...") または一重引用符 ('...') で囲んでください。
デフォルトのキーワード句は NULL (空) 文字列です。
- -f listfile
このオプションでは、アーカイブを行うファイルのリストを含むファイル名 (listfile) を指定します。このオプションは、filenames オプションの代わりに使用できます。listfile では、各ファイルパスが個別の行に表示されます。
必要なファイルリストの形式は、ファイル名に空白、改行文字、または復帰文字が含まれるかどうかによって異なります。名前に空白、改行文字または復帰文字が含まれないファイルのアーカイブを行うには、次の形式を使用します。
filepath
アーカイブするファイルへのパス。UNIX システムの例は
/home、/etc、/var
などです。Windows システムの例は
c:\Programs、c:\documents\old_memos
などです。名前に空白、改行文字または復帰文字が含まれるファイルのアーカイブを行うには、次の形式を使用します。
filepathlen filepath
filepath は、アーカイブを行うファイルへのパスです。また、filepathlen はファイルパスの文字数です。
アーカイブするファイルへのパス。UNIX システムの例は
/home、/etc、/var
などです。
Windows システムの例は
c:\Programs、c:\documents\old_memos
などです。UNIX システムでの例は次のとおりです。
5 /home 4 /etc 4 /var 19 /home/abc/test file
Windows システムでの例は次のとおりです。
11 c:\Programs 8 c:\winnt 22 c:\documents\old memos
- filenames
このオプションでは、アーカイブを行う 1 つ以上のファイル名を指定します。このオプションは、-f オプションの代わりに使用できます。指定するファイルは、他のすべてのオプションに続いて、最後に指定する必要があります。
例
例 1 - 単一ファイルをアーカイブする場合
UNIX システムの場合: bparchive /usr/user1/file1
Windows システムの場合: bparchive c:\usr\user1\file1
例 2 - archive_list というファイルに一覧表示されたファイルのアーカイブを行う場合
bparchive -f archive_list
例 3 - キーワード句「Archive My Home Directory 02/02/10」をディレクトリ kwc
のアーカイブに関連付け、arch.log という名前の進捗ログを使用する場合
UNIX システムの場合: bparchive -k "Archive My Home Directory 02/02/10" \-L/usr/openv/netbackup/logs/user_ops/arch.log /home/kwc
Windows システムの場合: bparchive -k "Archive My Home Directory 02/02/10" \-L c:\Program Files\Veritas\NetBackup\logs\user_ops\arch.log c:\home\kwc