Veritas 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
- bpplschedwin
- 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
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- 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
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- 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
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名前
bplist — NetBackup ホストにバックアップおよびアーカイブされたファイルの表示
概要
bplist [-A | -B] [-C client] [-S master_server] [-k policy] [-t policy_type] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-flops options] [-Listseconds] [-T] [-Translateownership] [-unix_files] [-nt_files] [-s date] [-e date] [-I] [-PI] [-keyword keyword_phrase] [filename] [-Listpolicy] [-nboptimized | -nbnormal]
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\ です。
説明
bplist コマンドを実行すると、指定したオプションに従って、以前にアーカイブまたはバックアップされたファイルのリストが表示されます。 リストに含めるファイルやディレクトリ、および時間を選択することができます。ディレクトリは、指定した階層まで再帰的に表示されます。 bplist では、ユーザーが読み込み権限を取得しているファイルだけが表示されます。 ファイルが表示されるのは、管理者アカウントによってユーザーバックアップが実行された場合だけです。
また、指定したファイルパス内のすべてのディレクトリに対する読み込み権限を取得しているか、そのディレクトリを所有している必要があります。 他のクライアントによってバックアップまたはアーカイブされたファイルを表示できます。ただし、NetBackup 管理者によってその権限が付与されている必要があります。
すべてのユーザーによる書き込みを許可して次のディレクトリを作成した場合、bplist を実行すると、このディレクトリにデバッグログファイルが作成され、トラブルシューティングに使用できます。
UNIX システムの場合: usr/openv/netbackup/logs/bplist/
Windows システムの場合: install_path\NetBackup\logs\bplist\
オプション
- -A | -B
このオプションでは、リストを、アーカイブから作成するか (-A)、バックアップから作成するか (-B) を指定します。 デフォルトは -B です。
- -b | -c | -u
このオプションでは、-l オプションで出力に使用される代替日時を指定します。
-b を指定すると、各ファイルをバックアップした日時が表示されます。
-c を指定すると、各ファイルの inode を最後に変更した日時 (UNIX システム) または最後に作成した日時 (Windows システム) が表示されます。
-u を指定すると、各ファイルに最後にアクセスした日時が表示されます。
デフォルトでは、各ファイルを最後に変更した日時が表示されます。
- -C client
このオプションでは、表示するバックアップまたはアーカイブの検索に使用するクライアント名を指定します。 この名前は、NetBackup 構成ファイルに表示される名前と一致している必要があります。 デフォルトは現在のクライアント名です。
- -F
このオプションを指定すると、リストの出力で、シンボリックリンク (UNIX クライアントだけに適用) の後には @ が付き、実行ファイルの後には * が付きます。
- filename
このオプションでは、表示するファイルまたはディレクトリを指定します。 すべてのファイルまたはディレクトリは、他のすべてのオプションに続いて、最後に指定する必要があります。 パスを指定しない場合、現在作業中のディレクトリがデフォルトになります。
Windows システムでは、ドライブ文字に大文字を使います。 次に例を示します。
C:\NetBackup\log1
ディレクトリに -R オプションを指定しない場合、次のようにパスに後続するセパレータを指定する必要があります。
UNIX システムの場合:
bplist -l "/home/user1/*"Windows システムの場合:
bplist -l "D:\WS_FTP.LOG\*"メタ文字のアスタリスク (*) を使用する場合、コマンドを正常に実行するにはファイル名を引用符で囲みます。
- -flops options
NetBackup ファイルをリスト表示します。
- -I
大文字と小文字の区別がない検索を指定します。 大文字と小文字の区別は名前を比較するとき考慮されません (たとえば、Cat は cat と一致します)。
- -k policy
このオプションでは、リストの生成時に検索するポリシーを指定します。 このオプションを指定しない場合、すべてのポリシーが検索されます。
- -keyword keyword_phrase
このオプションでは、ファイルのリストア元のバックアップまたはアーカイブを検索するときに NetBackup で使用されるキーワード句を指定します。 キーワード句は、以前 bpbackup または bparchive の -k オプションでバックアップまたはアーカイブに関連付けられた句と一致している必要があります。
このオプションを、他のリストアオプションの代わりに、または他のオプションと同時に指定すると、バックアップおよびアーカイブのリストアが簡単になります。 次のメタ文字を使用して、句の中のキーワードまたはキーワードの一部を一致させることができます。
* は、任意の文字数の文字列に一致します。
? は、任意の 1 文字に一致します。
[ ] は、この角カッコの中で連続する文字の 1 つに一致します。
[ - ] は、この［-］で区切られた範囲の文字の 1 つに一致します。
キーワード句は、最大 128 文字で指定できます。 空白 (「 」) およびピリオド (「.」) を含むすべての印字可能な文字列を指定できます。
キーワード句は、二重引用符 ("...") または一重引用符 ('...') で囲む必要があります。
デフォルトのキーワード句は NULL (空) 文字列です。
メモ:
ポリシー形式 DB2、Informix-On-BAR、Oracle、SAP、MS-SQL-Server、Sybase を使用した場合は、キーワード句が無視されます。
- -l
Windows システムでは、-l を指定すると、ファイルの詳細が表示されます。
UNIX システムでは、-l を指定すると、ファイルの詳細 (各ファイルに指定されたモード、所有者、グループ、サイズ (バイト単位)、最終更新日時) が詳細形式で表示されます (「例」を参照)。 リストには、各ファイルのモードが 10 文字で表示されます。この文字は、標準の UNIX ファイル権限を表します。先頭の文字は、次のいずれかです。
d(ディレクトリを表します)
l (リンクを表します)
m(Veritas Storage Migrator for UNIX または Veritas Data Lifecycle Manager によって移行されたファイルを表します)
- (ファイルを表します)
次に続く 9 文字は、3 つの権限のセットを 3 文字で 1 セットとして表します。 最初のセットは、所有者の権限を表します。次のセットはユーザーグループの権限を、最後のセットはその他すべてのユーザーの権限を表します。 各セットでは、次のとおり、読み込み、書き込みおよび実行権限を表します。
r = ファイルは読み込み可能です。
w = ファイルは書き込み可能です。
x = ファイルは実行可能です。
x = 権限が付与されていません。
- -Listpolicy
このオプションを指定すると、スケジュール形式およびポリシー名がコマンド出力で示されます。
- -Listseconds
このオプションでは、-l オプションを指定する場合のタイムスタンプを秒単位で指定します。
- -nboptimized
Windows 重複排除用に最適化されたフラグを使用してバックアップされた Windows イメージのみを表示する出力をフィルタするコマンドを指定します。
- -nbnormal
Windows 重複排除用に最適化されたフラグを使用してバックアップされなかった Windows イメージのみを表示する出力をフィルタするコマンドを指定します。
- -nt_files
このオプションを指定すると、ファイルおよびディレクトリが Windows 形式で表示されます。 このオプションは、Windows だけに適用されます。 例:
C:\users\test- -PI
このオプションを指定すると、パスに依存せずに検索されます。この場合、NetBackup では、指定したファイルまたはディレクトリがパスに関係なく検索されます。 たとえば、test という名前のファイルが、次に示す 3 つのディレクトリ内に存在するとします。 test を検索すると、ファイルの 3 つのインスタンスがすべて検出されます。
UNIX システムの場合:
/tmp/junk/test /abc/123/xxx/test /abc/123/xxx/yyy/zzz/test
Windows システムの場合:
\tmp\junk\test \abc\123\xxx\test \abc\123\xxx\yyy\zzz\test
- -r
Windows システムでは、-r を指定すると、バックアップされたディスクイメージが表示されます。 デフォルトでは、ファイルシステムが表示されます。
UNIX システムでは、-r を指定すると、バックアップされた raw パーティションが表示されます。 デフォルトでは、ファイルシステムが表示されます。
- -R [n]
このオプションを指定すると、n 番目の階層まで、サブディレクトリが再帰的に表示されます。 n のデフォルトは 999 です。
- -s date, -e date
表示の対象とする開始日時 (-s) と終了日時 (-e) を指定します。
-s では、表示の対象とする開始日時を指定します。 結果のリストには、指定した日時以降に実行されたバックアップまたはアーカイブ内のファイルだけが表示されます。
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 です。デフォルトは、現在の日付の 6 カ月前です。
-e では、表示の対象とする終了日時を指定します。 結果のリストには、指定した日時以前に実行されたバックアップまたはアーカイブ内のファイルだけが表示されます。 開始日時と同じ形式を使用します。デフォルトは、現在の日時です。
- -S master_server
UNIX システムの場合: -s では、NetBackup サーバー名を指定します。デフォルトは、/usr/openv/netbackup/bp.conf ファイルで最初に検索された
SERVERエントリです。Windows システムの場合: -s では、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
8 = MS-SharePoint
11 = DataTools-SQL-BackTrack
13 = MS-Windows
15 = MS-SQL-Server
16 = MS-Exchange-Server
17 = SAP
18 = DB2
19 = NDMP
20 = FlashBackup
21 = Split-Mirror
25 = Lotus Notes
29 = FlashBackup-Windows
35 = NBU-Catalog
39 = Enterprise-Vault
40 = VMware
41 = Hyper-V
44= BigData
- -T
このオプションを指定すると、True Image Backup のディレクトリが表示されます。 デフォルトでは、True Image Backup 以外が表示されます。
メモ:
合成完全バックアップに TIR 情報は使用されますが、合成完全バックアップの TIR 情報は表示されません。
- -Translateownership
Linux VMware バックアップでの Linux システム上のみ: ファイルを所有する個人のユーザー ID (UID) とグループ ID (GID) をユーザー名とグループ名に変換します。 Linux VMware バックアップでのデフォルトでは、bplist が UID と GID を示します。
bplist コマンドと -Translateownership オプションを実行するクライアントは、 -C オプションで指定するクライアントと同じである必要があります。
Linux 以外のオペレーティングシステムでは、このオプションは無効です。
- -unix_files
このオプションを指定すると、ファイルおよびディレクトリが UNIX 形式で表示されます。 このオプションは、UNIX だけに適用されます。 例:
/C/users/test
例
例 1 - /home/usr1 (UNIX) または D:\WS_RTP.LOG (Windows) でバックアップされたファイルを詳細形式で再帰的に表示します。
UNIX システムの場合:
# bplist -l -R /home/usr1 lrwxrwxrwx usr1;usr@ eng;None 0 Apr 28 12:25 /home/usr1/dirlink drwxr-xr-x usr1;usr@ eng;None 0 Apr 04 07:48 /home/usr1/testdir drwxr-x--- usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir -rwxr----- usr1;usr@ eng;None 1002 Apr 02 09:59 /home/usr1/dir/file lrwxrwxrwx usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir/link
Windows システムの場合:
# bplist -l -R D:\WS_FTP.LOG
-rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG
-rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG
-rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG例 2 - バックアップされたファイルのうち、キーワード句 "MyHomeDirectory" のすべてまたは一部と関連するファイルを表示します。
UNIX: # bplist -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows: # bplist -keyword "*MyHomeDirectory*" -l C:\home\kwc\
例 3 - アーカイブされたファイルのうち、キーワード句 "MyHomeDirectory" のすべてまたは一部と関連するファイルを表示します。
UNIX: # bplist -A -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows: # bplist -A -keyword "*MyHomeDirectory*" -l C:\home\kwc\
例 4 - Windows クライアントから Windows マスターサーバーの bplist の出力を詳細形式で再帰的に表示します。 次のコマンドを入力して、Windows クライアント slater のドライブ D にバックアップされたファイルのうち、キーワード句 "Win NT"のすべてまたは一部と関連するファイルを表示します。
# bplist -keyword "*Win NT*" -C slater -R -l C:\client_data_2 drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt
Windows イメージのユーザー列 (root;usr@) には、ファイルをバックアップしたユーザーと owner@domain がセミコロンで区切られて表示されます。 Windows イメージのグループ列 (root;None) では、ファイルをバックアップしたグループと group@domain がセミコロンで区切られています。
例 5 - Linux VMware バックアップからのファイルのリストを表示して UID と GID をユーザー名とグループ名に変換する:
# bplist -Translateownership -S host0.example.com -C client0.example.com -R 1 -l -t 40 -E -unix_files -b /user1_home drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/user_data/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data/ drwxr-xrwx root root 0 Sep 09 10:39 /user1_home/root_data_write/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data.orig/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/444.txt/
ファイル
UNIX システムの場合: /usr/openv/netbackup/logs/bplist/logmmddyy
Windows システムの場合: install_path\NetBackup\logs\bplist\*.log