Symantec NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configurePorts
- create_nbdb
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcomponentupdate
- nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbexecute
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhypervtool
- nbjm
- nbkmsutil
- nboraadm
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmadm
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名前
bpimagelist — NetBackup イメージまたはリムーバブルメディアの状態レポートの生成
概要
bpimagelist [-media] [-l | -L | -U | -idonly] [-tape] [-d date] [-e date] [-hoursago hours] [-keyword "keyword phrase"] [-client client_name] [-server server_name] [-backupid backup_id] [-option INCLUDE_PRE_IMPORT | INCLUDE_TIR | LIST_COMPLETE_COPIES | LIST_OLD_TO_NEW | ONLY_PRE_IMPORT | ONLY_TIR] [-policy policy_name] [-pt policy_type] [-rl retention_level] [-sl sched_label] [-st sched_type] [-class_id class_guid] [-stl_complete] [-stl_incomplete] [-stl_name storage_lifecycle_name] [-M master_server,...] [-inter-domain] [-v]
bpimagelist -changelog [-L | -json | -json_compact] [-min_changelog_keykey] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-new_images] [-updated_images] [-deleted_images]
UNIX システムでは、このコマンドのディレクトリパスは /usr/openv/netbackup/bin/admincmd です。
Windows システムでは、このコマンドのディレクトリパスは install_path\NetBackup\bin\admincmd\ です。
機能説明
bpimagelist はコマンドオプションから送信される属性と一致するカタログイメージかリムーバブルメディアについて報告するために指定の形式を使います。-media オプションがコマンドラインにある場合、bpimagelist はリムーバブルメディアについて報告します。そうでなければ、カタログイメージについて報告します。
bpimagelist -changelog オプションを指定すると、イメージ変更ログのレコードがレポートされます。新しいイメージ、更新されたイメージ、削除されたイメージのいずれかだけを表示するようにレポートをフィルタ処理できます。
このコマンドのデバッグログの情報は次のディレクトリに書き込まれます。
On UNIX systems: /usr/openv/netbackup/logs/admin
On Windows systems: install_path\NetBackup\logs\admin
このディレクトリ内の情報は、トラブルシューティングに使用できます。
bpimagelist の出力は、標準出力に出力されます。
このコマンドは、認可済みユーザーが実行できます。
NetBackup による認可について詳しくは、『NetBackup セキュリティおよび暗号化ガイド』を参照してください。
メモ:
NetBackup アクセラレータ機能の場合、bpimagelist でバックアップごとにネットワーク経由で転送されたデータの量がレポートされます。また、通常はアクセラレータのバックアップイメージのサイズを示すフィールドで転送されたデータを示すようにコマンドを設定することもできます。詳しくは、『NetBackup 管理者ガイド Vol. 1』、『NetBackup for VMware 管理者ガイド』、『NetBackup for NDMP 管理者ガイド』のアクセラレータに関するトピックを参照してください。
オプション
bpimagelist のオプションは次のとおりです。
- -backupid backup_id
このオプションでは、適用可能なイメージの検索に使用するバックアップ ID を指定します (イメージの表示だけに適用されます)。
- -changelog
イメージ変更ログのレコードがレポートされます。
- -class_id class_guid
このオプションでは、イメージの選択に使用するクラス識別子を指定します。識別子は、GUID (グローバル一意識別子) を表します。bpimagelist コマンドを使用すると、指定したクラス識別子を持つイメージだけがレポートされます。
- -client client_name
このオプションでは、表示するバックアップまたはアーカイブの検索に使用するクライアント名を指定します。bpimagelist で検索するクライアント名は大文字と小文字が区別されません。たとえば、
client、cLiEnT、CLIENTのいずれを指定してもイメージが表示されます。デフォルトでは、bpimagelist を実行すると、すべてのクライアントが検索されます。- -d mm/dd/yy hh:mm:ss, -e mm/dd/yy hh:mm:ss
これらのオプションでは、表示の対象とする開始日時から終了日時の範囲を指定します。これらの値をコマンドラインで指定しなかった場合のデフォルト値は次のとおりです。
-d デフォルトは、現在の日付の午前 0 時です。
-e デフォルトは、現在の日時です。
開始日時と終了日時の完全な形式は次のとおりです。
-d では、表示の対象とする開始日時を指定します。出力リストには、指定した日時以降に実行されたバックアップまたはアーカイブ内のイメージ (-changelog オプションを指定した場合は変更ログのデータ) だけが表示されます。
-e では、表示の対象とする終了日時を指定します。出力リストには、指定した日時以前に実行されたバックアップまたはアーカイブ内のファイル (-changelog オプションを指定した場合は変更ログのデータ) だけが表示されます。開始日時と同じ形式を使用します。
有効な日時の範囲は、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 インストールのロケールの指定について」を参照してください。
- -hoursago hours
このオプションを指定すると、指定する時間までに書き込まれたイメージが含まれます。このオプションは、開始時刻 (-d) を現在の時刻からのマイナスの時間で指定することと同じです。hours には 1 以上を指定する必要があります。
- -idonly
このオプションを指定すると、省略されたリストが生成されます。イメージを表示する場合、リストには各イメージの作成時間、バックアップ ID およびスケジュール形式が含まれます。たとえば、表示の条件が時間の範囲である場合、イメージのリストには、この時間の範囲内に作成されたイメージごとに、そのイメージの作成時間、バックアップ ID およびスケジュール形式だけが含まれます。
メディアリストを表示する場合、リストには適切なメディア ID だけが含まれます。たとえば、表示の条件が時間の範囲である場合、リストにはこの時間の範囲内に書き込まれたメディア ID だけが含まれます。
次のオプションを指定すると、レポート対象として選択するイメージまたはメディアを決定する条件が表示されます。イメージに対するこれらのオプションの説明は、メディアレポートの場合は、メディアに置き換えることができます。
- -inter-domain
ターゲットでインポートを保留しているレプリケートイメージとソースからレプリケートしたイメージのプレースホルダのコピーを表示します。
- -json
json 形式で複数行にわたってデータを出力します。
- -json_compact
json 形式で 1 行にデータを出力します。
- -keyword "keyword_phrase"
このオプションでは、検索に使用する NetBackup のキーワード句を指定します。キーワード句は、事前にイメージに関連付けられているキーワード句に一致している必要があります。たとえば、bpbackup または bparchive コマンドに -k オプションを指定すると、イメージの作成時に、イメージにキーワードが関連付けられます。
- -L
詳細形式でレポートを生成します。たとえば、メディアリストレポートの場合、レポートには attribute = value の組み合わせで各メディア ID の情報が表示されます。密度の値は、説明および番号の両方で表示されます。デフォルトの状態は詳細形式です。
- -l
このオプションを指定すると、レポートが簡易形式で生成され、簡易なリストが作成されます。このオプションは、カスタマイズされたレポート形式にリストを再生成するスクリプトまたはプログラムに対して有効です。
- -M master_server,...
このオプションでは、1 台以上の代替マスターサーバーのリストを指定します。このリストは、カンマで区切られたホスト名のリストです。このオプションを指定すると、一覧表示されている各マスターサーバーで bpimagelist が実行されます。マスターサーバーでエラーが発生した場合、その時点で処理が停止します。
レポートは、このリスト内のすべてのマスターサーバーから戻された情報で構成されます。bpimagelist コマンドを実行すると、各マスターサーバーに対して問い合わせが発行されます。マスターサーバーによって、イメージカタログのイメージまたはメディアの情報が戻されます。各マスターサーバーによって、bpimagelist コマンドを発行するシステムからのアクセスが許可されている必要があります。
デフォルトは、bpimagelist を実行するシステムのマスターサーバーです。
- -media
このオプションを指定すると、一連の条件に基づくリムーバブルメディアのレポートが表示されます。コマンドラインに -media を指定しない場合、メディアではなくイメージのレポートが出力されます。
- -min_changelog_key key
指定したキー以降のログのレコードを出力します。変更ログのエントリのキーの値は、新しいものほど大きくなります。
- [-new_images] [-updated_images] [-deleted_images]
変更ログのレポートを新しいイメージ、更新されたイメージ、削除されたイメージのいずれかだけに限定します。デフォルトの状態では、変更ログのすべてのイメージがレポートされます。
- -option option_name,...
このオプションでは、表示するイメージの 1 つ以上の検索条件を指定します。option_name には、次のいずれかの文字列を使用します。大文字でも小文字でも指定できます。
INCLUDE_PRE_IMPORT: インポートのフェーズ 1 が完了したイメージがレポートされます。
INCLUDE_TIR: True Image Recovery のバックアップによって作成されたイメージがレポートされます。
LIST_COMPLETE_COPIES - 実行中の複製コピーのフラグメントはレポートされません。
LIST_OLD_TO_NEW - 古い日付のイメージから順にレポートされます。
ONLY_PRE_IMPORT: インポートのフェーズ 1 が完了したイメージだけがレポートされます。
ONLY_TIR: True Image Recovery のバックアップによって作成されたイメージだけがレポートされます。
デフォルトでは、選択されたイメージに制限はありません。
- -policy name
このオプションを指定すると、指定したポリシー内で、インポートするバックアップが検索されます。デフォルトはすべてのポリシーです。
- -pt policy_type
このオプションでは、ポリシー形式を指定します。デフォルトでは、bpimagelist を実行すると、すべてのポリシー形式が検索されます。
policy_type は、次のいずれかの文字列です。
- -rl retention_level
このオプションでは、retention_level を指定します。retention_level は 0 から 100 の整数で指定します。デフォルトでは、bpimagelist はすべての保持レベルを検索します。
メモ:
このコマンドを NetBackup 8.0 以前のメディアサーバーで実行する場合、0 から 24 の間でのみ保持レベルを指定することができます。
- -server server_name
このオプションでは、NetBackup サーバー名または ALL を指定します。-server にサーバー名を指定する場合、レポートには、そのサーバーに存在するイメージまたはメディアだけが表示されます。イメージは、bpimagelist で指定したその他の基準も満たします。たとえば、-hoursago 2 を指定すると、メディアには、2 時間以内に作成されたイメージが含まれます。
問い合わせは、ローカルマスターサーバー上に存在するイメージカタログに対して発行されます。マスターサーバーでは、bpimagelist を実行するシステムからのアクセスが許可されている必要があります。
デフォルトでは、ローカルマスターサーバー上に存在するイメージカタログ内のすべてのメディアがレポートに表示されます。これは、-server ALL を指定することと同じです。
- -sl sched_label
このオプションでは、イメージを選択するためのスケジュールのラベルを指定します。デフォルトはすべてのスケジュールです。
- -st sched_type
このオプションでは、イメージを選択するためのスケジュール形式を指定します。デフォルトはすべての形式のスケジュールです。次に、有効な値を示します。
FULL (完全バックアップ)
INCR (差分増分バックアップ)
CINC (累積増分バックアップ)
UBAK (ユーザーバックアップ)
UARC (ユーザーアーカイブ)
NOT_ARCHIVE (ユーザーアーカイブ以外のすべてのバックアップ)
- -stl_complete
このオプションを指定すると、ストレージライフサイクルが完了したイメージだけがレポートされます。このオプションを stl_incomplete オプションと同時に使用することはできません。
- -stl_incomplete
このオプションを指定すると、ストレージライフサイクルが完了していないイメージだけがレポートされます。このオプションを stl_complete オプションと同時に使用することはできません。
- -stl_name storage_lifecycle_name
このオプションでは、イメージを選択するときに使用するストレージライフサイクル名を指定します。指定したストレージライフサイクル名のイメージだけが選択されます。
- -tape
このオプションを指定すると、リムーバブルメディアまたはテープベースのメディア上に 1 つ以上のフラグメントが存在するイメージだけがリストに表示されます。これらのイメージ内のディスクベースのフラグメントは無視されます。テープおよびディスクの両方のフラグメントがイメージに存在する場合、このオプションを指定すると、テープベースのフラグメントだけが表示されます。
- -U
このオプションを指定すると、ユーザー形式でレポートが生成されます。レポートは形式化されます。レポートには列タイトルが表示されたバナーが含まれます。また、状態は番号ではなく説明で表示されます。
- -v
このオプションを指定すると、詳細モードが選択されます。このオプションを指定して bpimagelist を実行すると、デバッグに使用するための追加情報がログに書き込まれます。追加情報は NetBackup 管理の日次デバッグログに記録されます。このオプションは、デバッグログ機能が有効になっている場合、つまり次のディレクトリが定義されている場合にだけ有効です。
UNIX システムの場合: /usr/openv/netbackup/logs/admin
Windows システムの場合: install_path\NetBackup\logs\admin
例
例 1 - サーバーで利用可能な各メディア ID において、バックアップイメージが指定した時間内の最後に書き込まれた時刻が表示されます。
# bpimagelist -media -d 01/05/2012 18:00:46 -e 01/06/2012 23:59:59
-U
Media ID Last Written Server
-------- ---------------- ----------
IBM000 01/06/2012 01:06 hatt
AEK800 01/06/2012 03:01 hatt
C0015 01/06/2012 02:01 hatt
143191 01/05/2012 23:00 hatt
例 2 - 今日書き込まれたすべてのイメージが表示されます。
# bpimagelist -U Backed Up Expires Files KB C Sched Type Policy --------------- -------- -------- ------ - ------------ ---------- 01/27/2012 01:08 02/03/2012 1122 202624 N Full Backup 3590Grau 01/27/2012 01:01 02/03/2012 1122 202624 N Full Backup IBM35pol 01/27/2012 03:01 02/03/2012 531 1055104 N Full Backup DELLpol 01/27/2012 02:01 02/03/2012 961 31776 N Full Backup QUALpol 01/27/2012 01:08 02/03/2012 2063 603328 N Full Backup IBM35pol 01/27/2012 01:01 02/03/2012 2063 603328 N Full Backup 3590Grau
例 3 - 今日書き込まれてストレージライフサイクルが完全に処理されていない、すべてのイメージが一覧表示されます。
# bpimagelist -U -stl_incomplete -idonly Time: 12/6/2011 1:03:46 PM ID: escape_1323198226 FULL (0) Time: 12/6/2011 12:48:22 PM ID: gordito19_1323197302 INCR (1) Time: 12/6/2011 1:02:42 PM ID: louisebl8vm1_1323198162 FULL (0) Time: 12/6/2011 1:03:28 PM ID: monterrey_1323198208 FULL (0) Time: 12/6/2011 1:03:10 PM ID: oprahbl14vm3_1323198190 FULL (0) Time: 12/6/2011 1:03:11 PM ID: oprahbl14vm4_1323198191 FULL (0) Time: 12/6/2011 1:03:12 PM ID: oprahbl15vm3_1323198192 FULL (0) Time: 12/6/2011 1:03:17 PM ID: oprahbl15vm4_1323198197 FULL (0) Time: 12/6/2011 1:02:22 PM ID: oprahbl8vm5_1323198142 FULL (0) Time: 12/6/2011 1:02:41 PM ID: thelmabl1vm1_1323198161 FULL (0) Time: 12/6/2011 1:02:54 PM ID: thelmabl1vm2_1323198174 FULL (0) Time: 12/6/2011 1:03:01 PM ID: thelmabl2vm1_1323198181 FULL (0)
例 4 - pem_tort ポリシーに対して今日書き込まれたすべての不完全なイメージが一覧表示されます。
# bpimagelist -U -stl_incomplete -policy pem_torture Backed Up Expires Files KB C Sched Type ... Policy ---------------- ---------- ----- ------- - ------------ --------- 12/06/2011 13:03 12/12/2011 86 1632 N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 12 12512 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3742 95936 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3762 95936 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 8 64 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 9 32 N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 5041 223104 N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 6 32 N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 3559 95808 N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N Full Backup ... pem_tort
例 5 - 変更ログの 2012 年 5 月 2 日以降に追加されたエントリと更新されたエントリが一覧表示されます。
# bpimagelist -changelog -new_images -updated_images -d 05/02/2012 10:18:00 -json Image Change Log Key: 2 Backup ID: jumpmanvm2_1335967123 Client Type: Standard (0) Image Change Log Oper. Id: Updated (2) Image Change Log Time: Wed 02 May 2012 10:39:09 AM CDT (1335973149)
ファイル
UNIX システムの場合:
/usr/openv/netbackup/logs/admin/log.mmddyy /usr/openv/netbackup/db/images
Windows システムの場合:
install_path\NetBackup\logs\admin\log.mmddyyinstall_path\NetBackup\db\images