<book_title> を検索 ...

NetBackup™ コマンドリファレンスガイド

Last Published: 2024-11-12

Product(s): NetBackup & Alta Data Protection (10.5)

概要
付録 A. NetBackup コマンド
1. acsd
2. backupdbtrace
3. backuptrace
4. bmrc
5. bmrconfig
6. bmrepadm
7. bmrprep
8. bmrs
9. bmrsrtadm
10. bp
11. bparchive
12. bpbackup
13. bpbackupdb
14. bpcatarc
15. bpcatlist
16. bpcatres
17. bpcatrm
18. bpcd
19. bpchangeprimary
20. bpcleanrestore
21. bpclient
22. bpclimagelist
23. bpclntcmd
24. bpclusterutil
25. bpcompatd
26. bpconfig
27. bpdbjobs
28. bpdbm
29. bpdgclone
30. bpdown
31. bpduplicate
32. bperror
33. bpexpdate
34. bpfis
35. bpflist
36. bpgetconfig
37. bpgetdebuglog
38. bpimage
39. bpimagelist
40. bpimmedia
41. bpimport
42. bpinst
43. bpkeyfile
44. bpkeyutil
45. bplabel
46. bplist
47. bpmedia
48. bpmedialist
49. bpminlicense
50. bpnbat
51. bpnbaz
52. bppficorr
53. bpplcatdrinfo
54. bpplclients
55. bppldelete
56. bpplinclude
57. bpplinfo
58. bppllist
59. bpplsched
60. bpplschedrep
61. bpplschedwin
62. bppolicynew
63. bpps
64. bprd
65. bprecover
66. bprestore
67. bpretlevel
68. bpschedule
69. bpschedulerep
70. bpsetconfig
71. bpstsinfo
72. bpstuadd
73. bpstudel
74. bpstulist
75. bpsturep
76. bptestbpcd
77. bptestnetconn
78. bpup
79. bpverify
80. cat_convert
81. cat_export
82. cat_import
83. configureCerts
84. configureMQ
85. configureWebServerCerts
86. create_nbdb
87. csconfig cldinstance
88. csconfig cldprovider
89. csconfig meter
90. csconfig reinitialize
91. csconfig throttle
92. duplicatetrace
93. importtrace
94. jbpSA
95. jnbSA
96. ltid
97. mklogdir
98. msdpcldutil
99. nbauditreport
100. nbcallhomeproxyconfig
101. nbcatsync
102. NBCC
103. NBCCR
104. nbcertcmd
105. nbcertupdater
106. nbcldutil
107. nbcmdrun
108. nbcomponentupdate
109. nbcplogs
110. nbcredkeyutil
111. nbdb_admin
112. nbdb_backup
113. nbdb_move
114. nbdb_ping
115. nbdb_restore
116. nbdb_unload
117. nbdb2adutl
118. nbdbms_start_server
119. nbdbms_start_stop
120. nbdc
121. nbdecommission
122. nbdelete
123. nbdeployutil
124. nbdevconfig
125. nbdevquery
126. nbdiscover
127. nbdna
128. nbemm
129. nbemmcmd
130. nbepicfile
131. nbfindfile
132. nbfirescan
133. nbfp
134. nbftadm
135. nbftconfig
136. nbgetconfig
137. nbhba
138. nbholdutil
139. nbhostidentity
140. nbhostmgmt
141. nbhypervtool
142. nbidpcmd
143. nbimageshare
144. nbinstallcmd
145. nbjm
146. nbkmiputil
147. nbkmscmd
148. nbkmsutil
149. nblogparser
150. nbmariadb
151. nbmysql
152. nbmlb
153. nboraadm
154. nborair
155. nboracmd
156. nbpem
157. nbpemreq
158. nbmariadb
159. nbmlb
160. nbperfchk
161. nbpgsql
162. nbplupgrade
163. nbrb
164. nbrbutil
165. nbreplicate
166. nbrepo
167. nbrestorevm
168. nbseccmd
169. nbserviceusercmd
170. nbsetconfig
171. nbshvault
172. nbsmartdiag
173. nbsnapimport
174. nbsnapreplicate
175. nbsqladm
176. nbsqlcmd
177. nbsqlite
178. nbstl
179. nbstlutil
180. nbstop
181. nbsu
182. nbsvrgrp
183. netbackup_deployment_insights
184. resilient_clients
185. restoretrace
186. stopltid
187. tldd
188. tldcd
189. tpautoconf
190. tpclean
191. tpconfig
192. tpext
193. tpreq
194. tpunmount
195. verifytrace
196. vltadm
197. vltcontainers
198. vlteject
199. vltinject
200. vltoffsitemedia
201. vltopmenu
202. vltrun
203. vmadd
204. vmchange
205. vmcheckxxx
206. vmd
207. vmdelete
208. vmoprcmd
209. vmphyinv
210. vmpool
211. vmquery
212. vmrule
213. vmupdate
214. vnetd
215. vssat
216. vwcp_manage
217. vxlogcfg
218. vxlogmgr
219. vxlogview
220. 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 | -image_dtemode Off|On] [-option INCLUDE_PRE_IMPORT | INCLUDE_TIR | LIST_COMPLETE_COPIES | LIST_OLD_TO_NEW | ONLY_PRE_IMPORT | ONLY_TIR | INCLUDE_DELETE_PENDING] [-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] [-oracle_copilot_ir][-copy_dtemode Off|On] [-hierarchical_dtemode Off|On]

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]

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is 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 NAS 管理者ガイド』のアクセラレータに関するトピックを参照してください。

オプション

bpimagelist のオプションは次のとおりです。

-backupid backup_id

このオプションでは、適用可能なイメージの検索に使用するバックアップ ID を指定します (イメージの表示だけに適用されます)。

-changelog

イメージ変更ログのレコードがレポートされます。

-class_id class_guid

このオプションでは、イメージの選択に使用するクラス識別子を指定します。この識別子は、GUID (グローバル一意識別子) です。bpimagelist コマンドを使用すると、指定したクラス識別子を持つイメージのみがレポートされます。

-client client_name

このオプションでは、表示するバックアップまたはアーカイブの検索に使用するクライアント名を指定します。bpimagelist で検索するクライアント名は大文字と小文字が区別されません。たとえば、bpimagelist では、client、cLiEnT、CLIENT のいずれを指定してもイメージが表示されます。デフォルトでは、bpimagelist を実行すると、すべてのクライアントが検索されます。

-copy_dtemode Off|On

このイメージコピーの作成時に DTE モードが有効になっていた場合、コピー DTE モードが On になります。それ以外の場合、値は Off になります。コピー DTE モードに基づいてイメージを表示およびフィルタ処理するには、bpimagelist -copy_dtemode Off|On コマンドを使用します。

-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 インストールのロケールの指定について」を参照してください。

-hierarchical_dtemode ON|OFF

このイメージコピーと階層内のそのすべての親コピーを作成したときに DTE モードが有効になっていた場合、コピー階層モードは ON になります。それ以外の場合、値はオフになります。コピー階層 DTE モードに基づいてイメージを表示およびフィルタ処理するには、bpimagelist -hierarchical_dtemode Off|On コマンドを使用します。

-hoursago hours

このオプションを指定すると、指定する時間までに書き込まれたイメージが含まれます。このオプションは、開始時刻 (-d) を現在の時刻からのマイナスの時間で指定することと同じです。hours. hours には 1 以上を指定する必要があります。

-idonly

このオプションを指定すると、省略されたリストが生成されます。イメージを表示する場合、リストには各イメージの作成時間、バックアップ ID およびスケジュール形式が含まれます。たとえば、表示の条件が時間の範囲である場合、イメージのリストには、この時間の範囲内に作成されたイメージごとに、そのイメージの作成時間、バックアップ ID およびスケジュール形式だけが含まれます。

メディアリストを表示する場合、リストには適切なメディア ID だけが含まれます。たとえば、表示の条件が時間の範囲である場合、リストにはこの時間の範囲内に書き込まれたメディア ID だけが含まれます。

次のオプションを指定すると、レポート対象として選択するイメージまたはメディアを決定する条件が表示されます。イメージに対するこれらのオプションの説明は、メディアレポートの場合は、メディアに置き換えることができます。

-image_dtemode Off|On

バックアップイメージの DTE モードを指定します。DTE モードに基づいてイメージを表示およびフィルタ処理するには、bpimagelist -image_dtemode Off|On コマンドを使用します。

-inter-domain

ターゲットでインポートを保留しているレプリケートイメージとソースからレプリケートしたイメージのプレースホルダのコピーを表示します。

-json

json 形式で複数行にわたってデータを出力します。

-json_compact

json 形式で 1 行にデータを出力します。

-keyword "keyword_phrase"

このオプションでは、検索に使用する NetBackup のキーワード句を指定します。キーワード句は、事前にイメージに関連付けられているキーワード句に一致している必要があります。たとえば、bpbackup または bparchive コマンドに -k オプションを指定すると、イメージの作成時に、イメージにキーワードが関連付けられます。

-L

詳細形式でレポートを生成します。たとえば、メディアリストレポートの場合、レポートには attribute = value の組み合わせで各メディア ID の情報が表示されます。密度の値は、説明および番号の両方で表示されます。デフォルトの状態は詳細形式です。

-l

このオプションを指定すると、レポートが簡易形式で生成され、簡易なリストが作成されます。このオプションは、カスタマイズされたレポート形式にリストを再生成するスクリプトまたはプログラムに対して有効です。

bpimagelist -l コマンドからの出力について詳しくは、次のリンクを参照してください。

https://www.veritas.com/support/ja_JP/article.100017904

-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 - 古い日付のイメージから順にレポートされます。
NO_VALIDATION - まだ処理中であること、またはジョブのエラーが発生したこと原因で検証されていない場合でもイメージを報告します。
ONLY_PRE_IMPORT: インポートのフェーズ 1 が完了したイメージだけがレポートされます。
ONLY_TIR: True Image Recovery のバックアップによって作成されたイメージだけがレポートされます。
INCLUDE_DELETE_PENDING - ストレージから正常に削除された後に期限切れになるように設定されたイメージコピーを含めて、イメージコピーがレポートされます。

デフォルトでは、選択されるイメージに制限はありません。

-oracle_copilot_ir

このオプションでは、Oracle Copilot インスタントリカバリに使用される可能性があるイメージが検索されて表示されます。

-policy name

このオプションを指定すると、指定したポリシー内で、インポートするバックアップが検索されます。デフォルトはすべてのポリシーです。

-pt policy_type

このオプションでは、ポリシー形式を指定します。デフォルトでは、bpimagelist はすべてのポリシー形式を検索します。

policy_type は、次のいずれかの文字列です。

BigData
DataStore
DataTools-SQL-BackTrack
DB2
Enterprise-Vault
FlashBackup
FlashBackup-Windows
Hyper-V
Informix-On-BAR
LotusNotes
MS-Exchange-Server
MS-SharePoint
MS-SQL-Server
MS-Windows
NDMP
Oracle
SAP
Split-Mirror
Standard
Sybase
Universal-share
Vault
VMware

-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 ICA Sched Type  On Hold Policy  Image DTE Mode
---------------- ---------- ----- --- - --- ----------- ------- ------- --------------
01/03/2022 13:14 01/17/2022    3  416 N N   Full Backup  0      test_fs            Off
01/03/2022 13:13 01/17/2022    3  416 N N   Full Backup  0      test_fs             On

例 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_tort

Backed Up         Expires    Files      KB  C  ICA Sched Type  ... Policy
----------------  ---------- ----- -------  -  --- ------------   ---------
12/06/2011 13:03  12/12/2011    86    1632  N  Y   Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011    12   12512  N  Y   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     5      32  N  N   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011  3742   95936  N  Y   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011  3762   95936  N  Y   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     8      64  N  N   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     9      32  N  N   Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011  5041  223104  N  Y   Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011     6      32  N  N   Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011  3559   95808  N  Y   Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     5      32  N  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.mmddyy
install_path\NetBackup\db\images

NetBackup™ コマンドリファレンスガイド

名前

概要

説明

オプション

例

ファイル

関連項目