Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
bpduplicate — NetBackup によって作成されたバックアップのコピーを作成
概要
bpduplicate -npc new_primary_copy -backupid backup_id [-local] [-client name]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\
です。
説明
bpduplicate を実行すると、作成するバックアップのコピーを取得できます。また、bpduplicate で、プライマリコピーを変更し、複製されたバックアップからのリストアを行うこともできます。プライマリコピーは、リストア要求を満たすために使用される最初の元となるコピーです。
-mpx オプションを使用すると、多重化複製を作成できます。詳しくは、-mpx オプションの説明を参照してください。
複製されたバックアップの有効期限は、元のバックアップとは異なります。最初、コピーの有効期限は元のバックアップの有効期限に設定されています。コピーまたは元のバックアップの有効期限は、bpexpdate を使用して変更できます。
bpduplicate を使用して、期限が切れていないバックアップのコピーを最大 10 個作成できます。
オプション
- -altreadhost hostname
このオプションでは、メディアを読み込む代替ホストを指定します。デフォルトの状態では、bpduplicate を実行すると、バックアップを行ったホストからソースメディアが読み込まれます。
- -backupid backup_id
このオプションでは、複製する 1 つのバックアップのバックアップ ID、またはプライマリコピーを変更するバックアップ ID を指定します。
- -bc_only
個別の情報をカタログ化します (つまり、カタログのみを構築します)。このオプションを実行すると、イメージの別のコピーを作成する必要性がなくなり、将来の参照またはリストア操作のパフォーマンスを改善できます。
- -Bidfile file_name
このオプションの file_name では、複製するバックアップ ID のリストを含むファイル名を指定します。ファイル内で 1 行に 1 つのバックアップ ID が指定されます。このパラメータを指定すると、他の選択条件は無視されます。
また、NetBackup GUI がこのパラメータを共通で使うため、file_name は CLI (コマンドラインインターフェース) の実行中に削除されます。GUI では、コマンドラインインターフェースの完了時に -Bidfile オプションで使用された一時ファイルが削除されることを前提としています。ユーザーはコマンドラインインターフェースで直接このオプションを使用することができますが、この場合でも、ファイルは削除されます。
- -client name
このオプションでは、元のバックアップを生成したクライアント名を指定します。これは、複製するバックアップの検索条件として使用されます。デフォルトはすべてのクライアントです。
-client を -npc オプションと同時に指定してプライマリコピーを変更すると、NetBackup によって、クライアントに属するバックアップ ID が最初に検索されます。この検索は、クライアント名が変更された場合に有効です。
- -cn copy_number|-primary
このオプションでは、複製のコピー番号を指定します。有効な値は、1 から 10 です。デフォルトは 1 です。
-primary はプライマリコピーを検索するか、または複製することを意味します。
- -dp destination_volume_pool_name [,copy2,...]
このオプションでは、複製のボリュームプールを指定します。NetBackup では、複製コピーに選択されたメディア ID が、元のバックアップが存在するメディア ID と異なることは検証されません。そのため、元のバックアップのメディア ID が存在するものとは異なるボリュームプールを指定し、デッドロックの可能性を回避します。デフォルトのプール名は、NB_duplicates です。
プールは、指定したコピーごとに指定します。
- -dstunit destination_storage_unit_label [,copy2,...]
このオプションでは、宛先ストレージユニットを指定します。このパラメータは、バックアップを複製するために必要です。このオプションを指定して、複製するバックアップをプレビュー (-p、-pb、-PM または -PD オプション) したり、プライマリコピーを変更 (-npc オプション) したりしないでください。このオプションには、デフォルトが存在しません。
ストレージユニットは、指定したコピーごとに指定します。
- -e date, -s date
このオプションでは、複製するすべてのバックアップが含まれる日時の範囲の終了日時 (-e) および開始日時 (-s) を指定します。デフォルトの終了日付は、現在の日時です。デフォルトの開始日時は、現在の日時の 24 時間前です。
NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。
/usr/openv/msg/.conf
ファイル (UNIX) とinstall_path\VERITAS\msg\LC.CONF
ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。システムのロケールについて詳しくは、『NetBackup 管理者ガイド Vol. 2』の「NetBackup インストールのロケールの指定について」を参照してください。
- -fail_on_error 0|1[,0|1,...,0|1]
このオプションでは、コピーが失敗した場合、他の複製を失敗とするかどうかを指定します。ここでは、次のとおりです。
0 (ゼロ) - 他のコピーを失敗にしません
1 - 他のコピーを失敗にします
プールは、指定したコピーごとに指定します。
- -granular_proxy
複製操作の定義済みの Exchange 個別リストア用プロキシホストを上書きします。このホストはテープへの複製の場合、個別の情報をカタログ化します。デフォルトでは、定義済みの Exchange 個別リストア用プロキシホストはバックアップの元の Exchange クライアントです。バックアップクライアントのクライアントホストの[Exchange]プロパティでプロキシホストを構成できます。
- -hoursago hours
このオプションでは、現在の時刻より何時間前までのバックアップが検索されるかを指定します。このオプションは、-s オプションと同時に使用しないでください。デフォルトは、現在の日付の午前 0 時です。
- -id media_id
このオプションを指定すると、指定したメディア ID 上に存在する、複製するバックアップのイメージカタログが検索されます。元のバックアップが異なるメディア ID 間でフラグメント化されている場合、指定したメディア ID 上に存在するバックアップだけが NetBackup によって複製されます。メディアをまたがったバックアップは複製されますが、またがったメディア ID 上の他のバックアップは複製されません。
- -L output_file [-en]
このオプションでは、進捗情報を書き込むファイル名を指定します。デフォルトでは、進捗ファイルは使用されません。
UNIX システムの例は、
/usr/openv/netbackup/logs/user_ops
です。Windows システムの例は、
c:\Program Files\Veritas\NetBackup\logs\user_ops
です。-en オプションを指定すると、ログが英語で生成されます。ログ名には文字列[_en]が含まれます。このオプションは、異なるロケールでさまざまな言語のログが作成される分散環境において有効です。
このオプションに対してはデフォルトパスのみが許可されます。ベリタスはデフォルトパスを使用することをお勧めします。設定で NetBackup のデフォルトパスを使用できない場合は、NetBackup 構成にカスタムパスを追加する必要があります。
カスタムパスを追加する方法について詳しくは、『NetBackup 管理者ガイド Vol. 1』の「NetBackup サーバーおよびクライアントの BPCD_WHITELIST_PATH オプション」の項を参照してください。
- -local
-local を使用せずに (デフォルト) bpduplicate をマスターサーバー以外のホストから実行する場合、bpduplicate によってマスターサーバー上のコマンドのリモートコピーが開始されます。リモートコピーでは、アクティビティモニターからコマンドを終了できます。
このオプションを使用すると、マスターサーバー上のリモートコピーの作成が回避されます。また、bpduplicate は開始されたホストからだけ実行されます。
-local オプションを使用すると、bpduplicate をアクティビティモニターから取り消すことはできません。
- -M master_server
このオプションでは、メディア ID を含むメディアカタログを管理するマスターサーバーを指定します。このオプションを指定しない場合、デフォルトは次のいずれかになります。
NetBackup Server では、リモートメディアサーバーを持たない 1 つのマスターサーバーだけがサポートされます。そのため、この場合のデフォルトは常に、コマンドを実行する NetBackup Server のマスターサーバーです。
NetBackup Enterprise Server では、このコマンドがマスターサーバーで実行される場合、そのサーバーがデフォルトです。コマンドをマスターサーバーではなくメディアサーバー上で実行する場合、そのメディアサーバーのマスターサーバーがデフォルトです。
- -mpx
このオプションを指定すると、多重化されたバックアップを複製する場合、NetBackup によって宛先メディア上に多重化されたバックアップが作成されます。これによって、多重化されたバックアップを複製する時間が短縮されます。
多重化複製は次の操作ではサポートされません。
多重化されていないバックアップ
ディスク形式のストレージユニットからのバックアップ
ディスク形式のストレージユニットへのバックアップ
FlashBackup または NDMP バックアップ
複製中に前述のカテゴリのバックアップが検出されると、NetBackup では、最初にそのバックアップが複製され、多重化されていない複製が使用されます。次に、多重化複製を使用して、多重化されたバックアップが複製されます。
多重化グループ内のすべてのバックアップが複製されない場合、複製された多重化グループのフラグメントのレイアウトが異なります。(多重化グループとは、1 つの多重化セッション中に一緒に多重化された一連のバックアップです。)
このオプションを指定しない場合、すべてのバックアップは、多重化されていない複製を使用して複製されます。
多重操作について詳しくは、『NetBackup 管理者ガイド Vol. 1』を参照してください。
- -npc new_primary_copy
このオプションを指定すると、プライマリコピーを変更できます。1 から 10 の値を指定できます。-backupid オプションは、このオプションと同時に指定する必要があります。
- -number_copies number
このオプションでは、作成するコピーの数を指定します。インラインテープコピーオプションまたは NetBackup Vault の拡張機能がインストールされていない場合、1 しか設定できません。デフォルトは 1 です。
このオプションは、次のとおり -dstunit、-dp、-fail_on_error および -r1 と同時に使用します。
-number_copies 2 -dstunit stunit-copy1,stunit-copy2 -number_copies 2 -dp pool1, pool2
- -owner media_share_group [,share_group_copy2,...]
このオプションでは、複製の共有グループを指定します。共有グループは、指定したコピーごとに指定します。
- -p
このオプションを指定すると、オプションの設定に従って、複製するバックアップがプレビューされます。ただし、複製は実行されません。メディア ID、サーバー名、複製の対象にならないバックアップ (および対象にならない理由) および複製するバックアップについての情報が表示されます。
- -pb
このオプションを指定すると、複製がプレビューされます。ただし、複製は実行されません。-p オプションに類似していますが、バックアップについての情報は表示されません。
- -PD
このオプションは、-PM オプションと同じです。ただし、バックアップが (新しい方から古い方へ) 日時でソートされて表示されます。
- -PM
このオプションを指定すると、オプションの設定に従って複製するバックアップの情報が表示されます。ただし、複製は実行されません。この形式では、まず複製できないバックアップ ID およびその理由 (バックアップにはすでに 2 つのコピーが存在しているなど) が表示されます。バックアップの日時、ポリシー、スケジュール、バックアップ ID、ホスト、メディア ID またはパス、コピー番号、およびそのコピーがプライマリコピーかどうかなど、バックアップについての情報が表示されます。
1 =プライマリコピー
0 =プライマリコピー以外
- -policy name
このオプションを指定すると、指定したポリシー内で、複製するバックアップが検索されます。デフォルトはすべてのポリシーです。
- -priority number
このオプションを指定すると、ディスクステージングの複製よりも低いまたは高い優先度で実行するようにバックアップポリシーが設定されます。
- -pt policy_type
このオプションを指定すると、指定したポリシー形式で作成されたバックアップが検索されます。デフォルトは、すべてのポリシー形式です。
policy_type は、次のいずれかの文字列です。
- -rl retention_level[,rl-copy2,...]
このオプションでは、各コピーの保持レベルを指定します。
保持レベルを指定しない場合、元のコピーの有効期限が各コピーに対して使用されます。保持期間が指定されている場合、コピーに対する有効期限は、バックアップの日付に保持期間を足した値になります。
たとえば、2012 年 5 月 14 日にバックアップが作成され、保持期間が 1 週間である場合、新しいコピーの有効期限は 2012 年 5 月 21 日になります。
値が -1 の場合、元のコピーの有効期限がそのコピーに対して使用されます。
- -set_primary copy_index
このオプションを指定すると、新しいコピーがプライマリコピーになります。
copy_index には、次のいずれかを指定します。
0 =プライマリコピーを変更しません (デフォルト)。
1 = 1 番目の新しいコピーがプライマリコピーになります。
2 = 2 番目の新しいコピーがプライマリコピーになります。
3 = 3 番目の新しいコピーがプライマリコピーになります。以降も同様です。
copy_index には、-number_copies の値を超えない値を指定する必要があります。
プライマリコピーにするために指定したコピーが失敗し、他のコピーが正常に行われた場合、プライマリコピーは現行の値から変更されません。
- -shost source_host
このオプションを指定すると、指定したバックアップサーバー上に作成されたバックアップだけが複製の対象になります。デフォルトでは、バックアップサーバーに関係なく、すべてのバックアップが対象となります。
- -sl sched_label
このオプションを指定すると、指定したスケジュールによって作成されたバックアップが、複製するバックアップとして検索されます。デフォルトはすべてのスケジュールです。
- -st sched_type
このオプションを指定すると、指定したスケジュール形式によって作成されたバックアップが、複製するバックアップとして検索されます。デフォルトはすべての形式のスケジュールです。
次に、有効な値を示します。
FULL (完全バックアップ)
INCR (差分増分バックアップ)
CINC (累積増分バックアップ)
UBAK (ユーザーバックアップ)
UARC (ユーザーアーカイブ)
NOT_ARCHIVE (ユーザーアーカイブ以外のすべてのバックアップ)
- -v
このオプションを指定すると、詳細モードが選択されます。このオプションを指定すると、デバッグログまたは進捗ログに、より詳細な情報が書き込まれます。
例
例 1 - コピー番号 1 のバックアップを一覧表示します。表示されるバックアップは、2013 年 7 月 1 日から 2013 年 8 月 1 日の間に作成され、stdpol
というポリシーによって実行されたバックアップです。
# bpduplicate -PM -cn 1 -policy stdpol -s 07/01/13 -e 08/01/13
例 2 - tmp ディレクトリ内のファイル bidfile に一覧表示されたバックアップのコピー番号 1 を複製します。宛先ストレージユニットは unit1 で、宛先プールは dup_pool です。進捗情報は、bpdup.ls に書き込まれます。次のコマンドは改行せずに 1 行で、または継続文字であるバックスラッシュを使用して入力します。
UNIX システムの場合:
# bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -L /usr/openv/netbackup/logs/user_ops/bpdup.ls -dp dup_pool -cn 1
Windows システムの場合:
# bpduplicate -dstunit unit1 -Bidfile C:\tmp\bidfile -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpdup.ls -dp dup_pool -cn 1
例 3 - 例 2 と同様に複製が行われますが、多重化されたバックアップは、多重化複製を選択したときに複製されます。次のコマンドは改行せずに 1 行で、または継続文字であるバックスラッシュを使用して入力します。
UNIX システムの場合:
# bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -mpx -L /usr/openv/netbackup/logs/user_ops/bpdup.ls -dp dup_pool -cn 1
Windows システムの場合:
# bpduplicate -dstunit unit1 -Bidfile C:\tmp\bidfile -mpx -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpdup.ls -dp dup_pool -cn 1
ファイル
UNIX システムの場合:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/*
Windows システムの場合:
install_path\NetBackup\db\images\* install_path\NetBackup\logs\admin\*