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

Last Published:
Product(s): NetBackup (9.0)
  1. 概要
    1.  
      NetBackup コマンドについて
    2.  
      複数階層のメニューの操作
    3.  
      NetBackup のコマンドの表記規則
    4.  
      NetBackup Media Manager コマンドの注意事項
    5.  
      IPV6 の更新
  2. 付録 A. NetBackup コマンド
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    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.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCerts
    85.  
      configureCertsForPlugins
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      manageClientCerts
    101.  
      mklogdir
    102.  
      nbauditreport
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_restore
    118.  
      nbdb_unload
    119.  
      nbdb2adutl
    120.  
      nbdbms_start_server
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    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.  
      nboraadm
    150.  
      nborair
    151.  
      nbpem
    152.  
      nbpemreq
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbregopsc
    159.  
      nbreplicate
    160.  
      nbrepo
    161.  
      nbrestorevm
    162.  
      nbseccmd
    163.  
      nbsetconfig
    164.  
      nbsnapimport
    165.  
      nbsnapreplicate
    166.  
      nbsqladm
    167.  
      nbstl
    168.  
      nbstlutil
    169.  
      nbstop
    170.  
      nbsu
    171.  
      nbsvrgrp
    172.  
      resilient_clients
    173.  
      restoretrace
    174.  
      stopltid
    175.  
      tldd
    176.  
      tldcd
    177.  
      tpautoconf
    178.  
      tpclean
    179.  
      tpconfig
    180.  
      tpext
    181.  
      tpreq
    182.  
      tpunmount
    183.  
      verifytrace
    184.  
      vltadm
    185.  
      vltcontainers
    186.  
      vlteject
    187.  
      vltinject
    188.  
      vltoffsitemedia
    189.  
      vltopmenu
    190.  
      vltrun
    191.  
      vmadd
    192.  
      vmchange
    193.  
      vmcheckxxx
    194.  
      vmd
    195.  
      vmdelete
    196.  
      vmoprcmd
    197.  
      vmphyinv
    198.  
      vmpool
    199.  
      vmquery
    200.  
      vmrule
    201.  
      vmupdate
    202.  
      vnetd
    203.  
      vssat
    204.  
      vwcp_manage
    205.  
      vxlogcfg
    206.  
      vxlogmgr
    207.  
      vxlogview
    208.  
      W2KOption
  3.  
    索引

名前

bpplinclude — NetBackup ポリシーによって自動バックアップが行われたファイルのリストの管理

概要

bpplincludepolicy_name [-v] [-M master_server,...] -L | -l [-generation generation] [-exclude_volumes]

bpplincludepolicy_name [-v] [-M master_server,...] [-generation generation] -add pathname or directive ... | -add -f filename | -addtoquery query_string... -addtoquery -f filename | -delete pathname or directive ... | -delete -f filename | -deletefromquery query_string... | -deletefromquery -f filename | -modify old_pathname new_pathname ... [-reason "string"] [-exclude_volumes]

 

UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。

Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\ です。

説明

bpplinclude を実行すると、NetBackup ポリシーのポリシーのファイルリストを管理できます。このポリシーのファイルリストには、NetBackup によってポリシーの自動バックアップが実行されたときにバックアップされたファイルが含まれます。ユーザーバックアップまたはユーザーアーカイブの場合、ユーザーが操作を開始するときにファイルを選択するため、このポリシーのファイルリストは適用されません。

bpplinclude では、次のいずれかの操作が実行されます。

  • ポリシーのファイルリストにパス名を追加します。

  • ポリシーのファイルリストからパス名を削除します。

  • ポリシーのファイルリスト内のパス名を変更します。

  • ポリシー用のファイルリストを表示します。

  • 指定されたボリュームをポリシーから除外します。このオプションは NAS データ保護ポリシー形式にのみ適用できます。

ほとんどのポリシーの場合、-add-delete および -modify オプションの指定には、パス名のリストを含めます。パス名のリストは、bpplinclude コマンドラインの最後に指定する必要があります。このパス名には、ファイルシステムのルートから目的の場所への絶対パスを指定する必要があります。

クライアント形式別のパス名の構文については、次を参照してください。『NetBackup 管理者ガイド Vol. 1』

パスの最後の部分には、ファイル名、ディレクトリ名またはワイルドカードを指定できます。パス名は、引用符で囲むことができます。パス名に特殊文字が含まれる場合、またはパス名をワイルドカードで指定した場合は、引用符で囲みます。

ファイルパスの規則では、入力したディレクトリまたはファイルが存在するかどうかは検証されません。NetBackup では、検出されたファイルだけがバックアップされるため、すべてのクライアント上に、リスト内のすべてのエントリが存在する必要はありません。

ほとんどのデータベースエージェントでは、入力エントリがスクリプトまたは指示句になります。詳しくは、データベースエージェント製品に付属する NetBackup のマニュアルを参照してください。-add pathname オプションも参照してください。

特定のポリシー属性 ([複数のデータストリームの許可 (Allow Multiple Data Streams)]など) およびそのアドオン製品 (NetBackup for NDMP など) では、ポリシーのファイルリストに追加されたエントリは、パス名でなく指示句である場合があります。

拡張製品については、『NetBackup 管理者ガイド Vol. 1』または NetBackup のガイドを参照してください。

-l オプションおよび -L オプションを指定すると、ポリシーのファイルリストとほぼ同じ内容の表示が生成されます。

bpplinclude のエラーメッセージは、標準エラー出力 (stderr) に送信されます。また、bpplinclude のデバッグログは、現在の日付の NetBackup 管理ログファイルに送信されます。

このコマンドは、認可済みユーザーが開始できます。

NetBackup による認可について詳しくは、『NetBackup セキュリティおよび暗号化ガイド』を参照してください。

メモ:

自動管理ポリシーの変更または削除は推奨されません。

ポリシーを変更する場合、ユーザーは、そのポリシーが、保護計画で定義されているサービスレベル目標をその後も満たすようにする必要があります。

ポリシーを削除する場合、ユーザーは、サービスレベル目標を満たす別の保護計画に資産が追加されるようにする必要があります。

オプション

-add pathname ...

ポリシーのファイルリストに指定した pathname を追加します。pathname には、ディレクトリ、ファイル名、スクリプト、指示句を指定できます。

パス名に、空白 (" ") やワイルドカードなどの特殊文字が含まれる場合、パス名を引用符 (") で囲む必要があります。2 つのパス名を区切るには、カンマではなく空白を使用します。bpplinclude では、カンマはパス名の一部であると解釈され、カンマで区切られた複数のパス名が、カンマが埋め込まれた 1 つのパス名に連結されます。このコマンドでは、構文またはパス名の存在が検証されません。

MS-SQL-Server インテリジェントポリシーの場合にこのオプションを指定すると、SQL Server オブジェクトがバックアップ対象に追加されます。有効な値は WHOLE_DATABASE、ファイルグループの名前、ファイルの名前のいずれかです。WHOLE_DATABASE は SQL Server インスタンスにあるすべてのデータベースをバックアップします。ファイルグループやファイルを追加すると、そのオブジェクトはその名前のファイルグループまたはファイルを含むポリシー内のすべてのデータベースに含まれます。bpplclients コマンドを使用して、ポリシー用に設定されるデータベースやインスタンスのリストを設定します。

NAS データ保護ポリシーの場合、次の形式でバックアップ対象を指定できます。

nfs:<array>StorageArrayIPAddress</array><nas_head>Filer_or_NAS_Server
</nas_head><nas_share./volume_name</nas_share>"

例:

NetApp: 
nfs:<array>10.0.0.1</array><nas_head>ExampleNAS</nas_head><nas_share>
/nas_share_01</nas_share>

Nutanix AFS:
nfs:<array>Example.company.com</array><nas_head>EXAMPLE_AFS</nas_head>
<nas_share>/afs_share_01</nas_share>
-add -f filename

このオプションを指定すると、ポリシーのファイルリストに、filename で指定したファイルがすべて追加されます。

-addtoquery query_string...

指定したクエリー文字列をポリシーのクエリー規則の最後に追加します。存在しない場合はクエリーを作成します。引用符 (") はバックスラッシュ (\) を使ってエスケープする必要があります。

詳細と例については、『NetBackup for VMware ガイド』を参照してください。

-addtoquery -f filename

指定したファイルからクエリー規則にエントリを追加します。存在しない場合はクエリーを作成します。ファイルにある引用符 (") はエスケープする必要はありません。

詳細と例については、『NetBackup for VMware ガイド』を参照してください。

-delete pathname ...

ポリシーのファイルリストから、指定したパス名、ファイル名、スクリプト、指示句を削除します。パス名のリストの構文については、-add オプションを参照してください。ポリシーのファイルリストから項目を削除しても、その項目に対するすべてのバックアップまたはアーカイブのリカバリを実行できます。このオプションを指定する場合、コマンドラインの最後に指定する必要があります。

-delete -f filename

ポリシーのファイルリストから、filename に指定したファイルを削除します。

-deletefromquery query_string...

ポリシーのクエリー規則から指定したクエリー文字列を削除します。

詳細と例については、『NetBackup for VMware ガイド』を参照してください。

-deletefromquery -f filename

クエリー規則からファイルエントリを削除します。

詳細と例については、『NetBackup for VMware ガイド』を参照してください。

-exclude_volumes

ポリシーの実行時に、指定されたボリュームをバックアップ対象から除外します。現在、NAS データ保護ポリシーにのみ適用されます。

-generation generation

このオプションを指定すると、コマンドがポリシーの特定の世代またはバージョンに対して機能することが確認されます。世代の値は、ポリシーが保存されるたびに大きくなります。bpplinfo または bppllist を使用すると、現在の世代の値を表示できます。世代が示されない場合は、コマンドは現在のバージョンに対して実行されます。

-L

このオプションを指定すると、ポリシーのファイルリストの内容が詳細形式で表示されます。

-l

このオプションを指定すると、ポリシーのファイルリストの内容が簡易形式で表示されます。

メモ:

-l-L の表示は類似しています。

-modify {old_path_name new_path_name}

このオプションを指定すると、ポリシーのファイルリスト内のエントリが変更されます。値は、パス名の対 ({old_path_name new_path_name}) のリストとして指定します。ポリシーのファイルリスト内で、それぞれの対のパス名が old_path_name から new_path_name に置換されます。old_path_name と一致するリストのエントリが存在しない場合、new_path_name で指定した名前はポリシーのファイルリストに追加されません。パス名の構文については、「-add path_name」を参照してください。リストのエントリを区切るには、パス名の対内およびパス名とパス名の間のいずれにも、空白を使用します。このオプションを指定する場合、コマンドラインの最後に指定する必要があります。

-M master_server,...

このオプションでは、マスターサーバーのリストを指定します。このリストは、カンマで区切られたホスト名のリストです。このオプションを指定すると、一覧表示されている各マスターサーバーでコマンドが実行されます。マスターサーバーでは、コマンドを発行するシステムからのアクセスが許可されている必要があります。マスターサーバーにエラーが発生した場合、その時点でリスト内の処理が停止します。デフォルトは、コマンドが入力されるシステムのマスターサーバーです。

policy_name

ポリシーのファイルリストを設定するポリシーを指定します。

-reason "string"

このコマンド処理を選択する理由を示します。入力する理由の文字列は取得され、監査レポートに表示されます。この文字列は二重引用符 ("...") で囲んでください。文字列が 512 文字を超えないようにしてください。ダッシュ文字 (-) を先頭にしたり、一重引用符 (') を含めることはできません。

-v

このオプションを指定すると、ログの詳細モードが選択されます。このオプションは、デバッグログ機能が有効になっている場合、つまり次のディレクトリが定義されている場合にだけ有効です。

UNIX システムの場合:

/usr/openv/netbackup/logs/admin

Windows システムの場合:

install_path\NetBackup\logs\admin

例 1- 別のマスターサーバー kiwi でバックアップを実行中に、マスターサーバー plim 上のポリシー oprdoc_policy のポリシーファイルリストを表示します。

# bpplinclude oprdoc_policy -L -M plim
Include:    /oprdoc   (UNIX systems)
Include:    c:\oprdoc (Windows systems)

例 2 - ワイルドカードのエントリを 1 つ含むパス名の追加と削除を行い、bpplinclude がどのようにワイルドカードを解釈するかを示します。

UNIX システムの場合:

# bpplinclude mkbpolicy -add /yap /y*
# bpplinclude mkbpolicy -L
     Include: yap
     Include: /y*
# bpplinclude mkbpolicy -delete /y*
# bpplinclude mkbpolicy -L
     Include: /yap

Windows システムの場合:

# bpplinclude mkbpolicy -add C:\yap C:\y*
# bpplinclude mkbpolicy -L
     Include: C:\yap
     Include: C:\y*/y*
# bpplinclude mkbpolicy -delete C:\y*
# bpplinclude mkbpolicy -L
     Include: C:\yap

メモ:

-delete にワイルドカードエントリ y* を指定しても、bpplinclude では yapy* の両方を削除することとは解釈されません。mkbpolicy のインクルードリストからは、y* だけが削除されます。このワイルドカードの解釈は、実際のバックアップで NetBackup によってバックアップを作成するファイルが選択されるときに実行されます。

例 3 - ポリシーのポリシーファイルリストに 2 つのエントリを追加し、その後それらのエントリを変更します。

UNIX システムの場合:

# bpplinclude mkbpolicy -add "/ima file" "/ura file"
# bpplinclude mkbpolicy -L
     Include: /ima file
     Include: /ura file
bpplinclude mkbpolicy -modify "/ima file" "/ima file 2" "/ura file" 
"/ura file 2"
bpplinclude mkbpolicy -L
  Include: /ima file 2
  Include: /ura file 2

Windows システムの場合:

# bpplinclude mkbpolicy -add "C:\ima file" "C:\ura file"
# bpplinclude mkbpolicy -L
     Include: C:\ima file
     Include: C:\ura file
# bpplinclude mkbpolicy -modify "C:\ima file" "C:\ima file 2" 
"C:\ura file" "C:\ura file 2"
# bpplinclude mkbpolicy -L
  Include: C:\ima file 2
  Include: C:\ura file 2

例 4 - ポリシー rc (UNIX クライアント) のポリシーファイルリストに raw パーティションを追加します。デバイスへのフルパス名を使用します (コマンドは、改行せずにすべてを 1 行で入力します)。

bpplinclude rc -add /devices/sbus@2,0/dma@2,81000/esp@2,80000/ 
sd@6,0:h,raw

UNIX raw パーティションについて詳しくは、次を参照してください。『NetBackup 管理者ガイド Vol. 1』

例 5 - ポリシー mkb_policy のポリシーファイルリストを表示します。

# bpplinclude mkb_policy -l

UNIX システムの場合:

INCLUDE /etc/services
    INCLUDE /etc/aliases
    INCLUDE /usr/bin

Windows システムの場合:

INCLUDE C:\services
    INCLUDE C:\aliases
    INCLUDE C:\Programs

例 6 - ポリシー 1 のクエリー規則の値リストに vm17 を追加します。

# bpplinclude policy1 -addtoquery ,\"vm17\"

例 7 - ポリシーからクエリーを削除します。

# bpplinclude policy1 -deletefromquery -f qfile1

例 8 - ポリシーファイルのリストに SQL Server のファイルグループを追加します。

# bpplinclude sql_policy -add FG1

ファイル

UNIX システムの場合:

/usr/openv/netbackup/logs/admin/*
/usr/openv/netbackup/db/policy/policy_name/includes

Windows システムの場合:

install_path\NetBackup\logs\admin\*
install_path\NetBackup\dv\policy\policy_name\includes

関連項目

bpplclients(1m)を参照してください。

bpplinfo(1m)を参照してください。

bpschedule(1m)を参照してください。

bppldelete(1m)を参照してください。

bppllist(1m)を参照してください。