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

Last Published:
Product(s): NetBackup (10.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.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    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.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcallhomeproxyconfig
    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.  
      nbfp
    135.  
      nbftadm
    136.  
      nbftconfig
    137.  
      nbgetconfig
    138.  
      nbhba
    139.  
      nbholdutil
    140.  
      nbhostidentity
    141.  
      nbhostmgmt
    142.  
      nbhypervtool
    143.  
      nbidpcmd
    144.  
      nbimageshare
    145.  
      nbinstallcmd
    146.  
      nbjm
    147.  
      nbkmiputil
    148.  
      nbkmscmd
    149.  
      nbkmsutil
    150.  
      nboraadm
    151.  
      nborair
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmlb
    155.  
      nbperfchk
    156.  
      nbplupgrade
    157.  
      nbrb
    158.  
      nbrbutil
    159.  
      nbregopsc
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      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]

 

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\

説明

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

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

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

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

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

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

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

ほとんどのポリシーの場合、-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-Data-Protection ポリシーの場合、次の形式でバックアップ対象を指定できます。

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-Data-Protection ポリシーにのみ適用されます。

-generation generation

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

-L

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

-l

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

メモ:

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

-modify {old_path_name new_path_name}

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

-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)を参照してください。