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

Last Published:
Product(s): NetBackup (10.3)
  1. 概要
    1.  
      NetBackup コマンドについて
    2.  
      複数階層のメニューの操作
    3.  
      NetBackup のコマンドの表記規則
    4.  
      NetBackup Media Manager コマンドの注意事項
    5.  
      IPV6 の更新
  2. 付録 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.  
      nbfindfile
    131.  
      nbfirescan
    132.  
      nbfp
    133.  
      nbftadm
    134.  
      nbftconfig
    135.  
      nbgetconfig
    136.  
      nbhba
    137.  
      nbholdutil
    138.  
      nbhostidentity
    139.  
      nbhostmgmt
    140.  
      nbhypervtool
    141.  
      nbidpcmd
    142.  
      nbimageshare
    143.  
      nbinstallcmd
    144.  
      nbjm
    145.  
      nbkmiputil
    146.  
      nbkmscmd
    147.  
      nbkmsutil
    148.  
      nboraadm
    149.  
      nborair
    150.  
      nbpem
    151.  
      nbpemreq
    152.  
      nbmariadb
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbreplicate
    159.  
      nbrepo
    160.  
      nbrestorevm
    161.  
      nbseccmd
    162.  
      nbserviceusercmd
    163.  
      nbsetconfig
    164.  
      nbshvault
    165.  
      nbsmartdiag
    166.  
      nbsnapimport
    167.  
      nbsnapreplicate
    168.  
      nbsqladm
    169.  
      nbsqlite
    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

名前

nbinstallcmd — 配備ジョブを作成するために使用します。

概要

nbinstallcmd -policy policy_name -schedule schedule [-master_server hostname] [{-hosts hostname1,hostname2,... | -host_filelist path}]

nbinstallcmd -operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -use_existing_certs [-components javagui_jre=(include|exclude|match)]

nbinstallcmd -operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -unix_eca_cert_path path -unix_eca_crl_check_level {use_cdp | use_path | disabled} -unix_eca_trust_store_path path -unix_eca_private_key_path path [-unix_eca_key_passphrasefile path] [-unix_eca_crl_path path] [-components javagui_jre=(include|exclude|match)]

nbinstallcmd -operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -win_eca_cert_store path -win_eca_crl_check_level {use_cdp | use_path | disabled} [-win_eca_crl_path path] [-components javagui_jre=(include|exclude|match)]

nbinstallcmd -operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -win_eca_cert_path path -win_eca_crl_check_level {use_cdp | use_path | disabled} -win_eca_trust_store_path path -win_eca_private_key_path path [-win_eca_crl_path path] [-win_eca_key_passphrasefile path] [-components javagui_jre=(include|exclude|match)]

 

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

On Windows systems, the directory path to this command is install_path\NetBackup\bin\

説明

nbinstallcmd コマンドを使用すると、VxUpdate ジョブを作成できます。VxUpdate は、クライアントとメディアサーバーの更新をサポートします。マスターサーバーからジョブを起動すると、マスターサーバーが認識するすべてのクライアントまたはメディアサーバーをターゲットにできます。クライアントまたはメディアサーバーからジョブを起動すると、そのクライアントまたはメディアサーバーのみがターゲットになります。

-policy および -schedule オプションを使用すると、既存の配備ポリシーに基づいてジョブが作成されます。-hosts または -host_filelist スイッチを -policy とともに使用すると、ジョブは配備ポリシーで構成されているターゲットホストのサブセットに制限されます。-hosts-host_filelist を使用しない場合、ジョブは配備ポリシーで構成されているすべてのターゲットホストに対して実行されます。

-operation_type-package オプションを使用すると、配備ポリシーなしでジョブを開始します。この形式のコマンドでは、セキュリティ構成に関する情報を入力する必要があります。このコマンドでは、VxUpdate がセキュリティを処理する方法を指定する必要があります。

  • ファイルベースの証明書を使用して、アップグレード中に UNIX および Linux ホストの外部セキュリティ証明書を構成する

  • 証明書ストアを使用して、アップグレード中に Windows ホストの外部セキュリティ証明書を構成する

  • ファイルベースの証明書を使用して、アップグレード中に Windows ホストの外部セキュリティ証明書を構成する

  • 正しく設定されているため、セキュリティを変更しない

これらのセキュリティオプションについて詳しくは、『NetBackup インストールガイド』と『NetBackup セキュリティおよび暗号化ガイド』を参照してください。

nbinstallcmd コマンドのログは、レガシーのログディレクトリにあります。UNIX と Linux の場合、ログは /usr/openv/netbackup/logs にあります。Windows の場合、ログは install_path\NetBackup\logs にあります。

メモ:

エスケープする必要があるスペースまたは特殊文字が引数のファイルパスに含まれている場合は、シェル固有の注釈を使用してください。

オプション

-components javagui_jre=(include | exclude | match)

このオプションは、配備ジョブを実行した後、ターゲットシステムに Java GUI と JRE が存在する必要があるかどうかを指定する場合に使用します。

include の値は、これらのコンポーネントをターゲットシステムでインストールまたはアップグレードすることを示します。

exclude の値は、これらのコンポーネントがターゲットシステムで不要であることを示します。既存の Java GUI および JRE コンポーネントは削除されます。

match の値は、Java GUI および JRE コンポーネントの現在の状態を維持する必要があることを示します。アップグレード前のシステムにコンポーネントが存在する場合、コンポーネントはアップグレードされます。アップグレード前のシステムにコンポーネントが存在しない場合、コンポーネントはインストールされません。

-hosts [host1,host2,...]

エントリ間にスペースを含まない、ホスト名のカンマ区切りリスト。このオプションは -host_filelist と併用できません。-policy を指定する場合、リスト内のホストがポリシーに含まれている必要があります。 -policy を指定せず、コマンドをマスターサーバーで実行する場合、指定されたホストがマスターサーバーに認識されている必要があります。-policy を指定せず、コマンドをターゲットホストで実行する場合、この値はターゲットホストの名前と一致する必要があります。1 つのジョブで、クライアントとメディアサーバーを組み合わせて指定することはできません。ジョブのリスト内のすべてのホストは、すべてクライアントか、すべてメディアサーバーのどちらかにする必要があります。

-host_filelist [path]

1 行ごとにホスト名を指定したファイルのパス。このオプションは -hosts と併用できません。-policy を指定する場合、指定されたホストがポリシーに含まれている必要があります。-policy を指定せず、コマンドをマスターサーバーで実行する場合、指定されたホストがマスターサーバーに認識されている必要があります。-policy を指定せず、コマンドをターゲットホストで実行する場合、この値はターゲットホストの名前と一致する必要があります。1 つのジョブで、クライアントとメディアサーバーを組み合わせて指定することはできません。ファイルに記載されたすべてのホストは、すべてクライアントか、すべてメディアサーバーのどちらかにする必要があります。

-limit_jobs [max_concurrent_jobs]

許可されている並列実行ジョブの最大数。このオプションは、-policy を指定しない場合にのみ適用されます。指定しない場合、デフォルト値は無制限です。

-master_server hostname

VxUpdate リポジトリが存在するマスターサーバーのホスト名。このオプションは必須ではありません。

-media_server hostname

クライアントが通信するステージングサーバーのホスト名。このサーバーはメディアサーバーである必要があります。このオプションは、-policy を指定しない場合にのみ適用されます。指定しない場合、マスターサーバーがステージングサーバーとして機能します。メディアサーバーがステージングに使用されていると、パッケージはメディアサーバーにキャッシュされ、VxUpdate 操作でメディアサーバーからそれらのパッケージが提供されるようになります。このオプションは、NetBackup マスターサーバーの効率を最適化するために役立ちます。

-operation_type {precheck | stage | install}

開始する配備操作の種類。-policy を指定しない場合は必須です。有効なオプションは次のとおりです。

  • precheck: 更新のための十分な領域がホストにあるかどうかの確認など、さまざまな事前チェック操作を実行します。

  • stage: 更新パッケージをクライアントに移動します。インストールは行いません。precheck 操作も実行します。

  • install: 指定したパッケージをインストールします。precheck 操作と stage 操作も実行します。stage 操作をすでに実行している場合に install コマンドを実行しても、パッケージが再度移動されることはありません。

-package item

インストールするパッケージの名前。-policy を指定しない場合は必須です。パッケージは、リポジトリ内に存在する必要があります。nbrepo コマンドを使用して、パッケージを削除します。

-policy policy_name

既存の配備ポリシーの名前。-operation_type を指定しない場合は、このオプションを指定する必要があります。

-schedule schedule_name

実行する配備ポリシーのスケジュール。-policy を指定する場合は必須です。

-unix_eca_cert_path path

このオプションは、UNIX および Linux ホストの証明書ファイルへのパスを指定する場合に使用します。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません。

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-unix_eca_crl_check_level {use_cdp | use_path | disabled}

UNIX および Linux ホストで証明書失効リストを処理する方法を指定します。証明書に定義されている CRL を使用するには、use_cdp を指定します。CRL へのパスを指定するには、use_path を指定します。CRL を使用しないようにするには、disabled を指定します。次の場合に適用されます。

  • -policy-use_existing_certs は指定されません。

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-unix_eca_crl_path path

このオプションは、UNIX および Linux ホストの外部認証局ファイルへのパスを指定する場合に使用します。-unix_eca_crl_check_level use_path を使用する場合、このオプションは必須です。-unix_eca_crl_check_level use_path を指定せずにこのオプションを使用しようとすると、ジョブは失敗します。

  • -policy-use_existing_certs は指定されません。

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-unix_eca_key_passphrasefile path

このオプションは、UNIX および Linux ホストのパスフレーズファイルへのパスを指定する場合に使用します。このオプションは必須ではありません。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-unix_eca_private_key_path path

このオプションは、UNIX および Linux ホストの秘密鍵ファイルへのパスと秘密鍵ファイル名を指定する場合に使用します。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-unix_eca_trust_store_path path

このオプションを使用すると、UNIX および Linux ホストのトラストストアファイルへのパスを指定できます。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-use_existing_certs

ジョブで既存のセキュリティ証明書を使用する場合は、このオプションを指定します。このオプションは、-policy を指定しない場合にのみ適用されます。このオプションは *eca* オプションと併用できません。次の場合に、このオプションを指定します。

  • ターゲットホストに既存の外部証明書がある

  • ターゲットホストに引き続き使用する NetBackup のセキュリティ証明書が存在する

-win_eca_cert_path path

このオプションは、Windows ホストの証明書ファイルへのパスを指定する場合に使用します。このオプションは -win_eca_cert_store_path と併用できません。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-win_eca_cert_store path

このオプションは、Windows 証明書ストアへのパスを指定する場合に使用します。このオプションは -win_eca_cert_path-win_eca_key_passphrasepath-win_eca_private_key_path-win_eca_trust_store_path と併用できません。証明書の場所は、Certificate_Store_Name\Issuer_Distinguished_Name\Subject_Distinguished_Name のように入力する必要があります。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-win_eca_crl_check_level {use_cdp | use_path | disabled}

Windows ホストで証明書失効リストを処理する方法を指定します。証明書に定義されている CRL を使用するには、use_cdp を指定します。CRL へのパスを指定するには、use_path を指定します。CRL を使用しないようにするには、disabled を指定します。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-win_eca_crl_path path

このオプションは、Windows ホストの外部認証局ファイルへのパスを指定する場合に使用します。-windows_eca_crl_check_level use_path を使用する場合、このオプションは必須です。-windows_eca_crl_check_level use_path を指定せずにこのオプションを使用しようとすると、ジョブは失敗します。

-win_eca_key_passphrasefile path

このオプションは、Windows ホストのパスフレーズファイルへのパスを指定する場合に使用します。このオプションは必須ではありません。このオプションは -win_eca_cert_store と併用できません。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-win_eca_private_key_path path

このオプションは、Windows ホストの秘密鍵ファイルへのパスと秘密鍵ファイル名を指定する場合に使用します。このオプションは -win_eca_cert_store と併用できません。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

-win_eca_trust_store_path path

このオプションを使用すると、Windows ホストのトラストストアへのパスとトラストストアファイル名を指定できます。このオプションは -win_eca_cert_store と併用できません。このオプションは次の場合に適用されます。

  • -policy-use_existing_certs は指定されません

  • マスターサーバーが外部セキュリティ証明書をサポートしている

  • ターゲットホストで外部セキュリティ証明書が構成されていない

  • アップグレード中にこの構成を適用したい

例 1: 指定したポリシーで構成されているすべてのホストの事前チェック操作を開始します。

nbinstallcmd -policy policy-deployment20 -schedule sched-precheck 
-master_server master.domain.com

例 2: マスターサーバーから、配備ポリシーに基づいていないステージングジョブを開始します。このジョブでは、NetBackup 8.2 クライアントをステージングし、複数のホストをターゲットにして、ステージングサーバーとして別のメディアサーバーを使用し、セキュリティ証明書の構成は含まないようにする必要があります。

nbinstallcmd -operation_type stage -package nbclient_8.2 -master_server 
master.domain.com -media_server media_staging.domain.com -hosts 
client01.domain.com,client02.domain.com -use_existing_certs

例 3: ターゲットホストから、配備ポリシーに基づいていないインストール操作を開始します。この操作では、アップグレードの一部として外部セキュリティ証明書を構成する手順を使用して、ホストを NetBackup 8.3 にアップグレードします。

nbinstallcmd -operation_type install -package nbserver_8.3 
-master_server master.domain.com -hosts media01.domain.com 
-unix_eca_cert_path /usr/home/cert.pem -unix_eca_trust_store_path 
/usr/home/cacert.pem -unix_eca_private_key_path 
/usr/home/private_key.pem -unix_eca_key_passphrasefile 
/usr/home/passphrase_file -unix_eca_crl_check_level use_path 
-unix_eca_crl_path /usr/home/crl_dir

例 4: ターゲットホストから、配備ポリシーに基づいていないインストール操作を開始します。この操作では、ステージングサーバーとして個別のメディアサーバーを使用して、ホストを NetBackup 8.3 にアップグレードします。また、証明書ストアから取得する外部セキュリティ証明書を構成する指示も含まれています。

nbinstallcmd -operation_type install -package nbclient_8.3 
-master_server master.domain.com -media_server media_staging.domain.com 
-hosts client01.domain.com -win_eca_cert_store 
MyCertStore\MyIssuer\MyClient -win_eca_crl_check_level use_cdp

例 5: マスターサーバーから、配備ポリシーに基づいていないインストール操作を開始します。この操作では、NetBackup 8.2 Windows EEB が適用され、複数のホストがターゲットになります。このジョブは、ステージングサーバーとしてマスターサーバーを使用し、セキュリティ証明書の構成は含まれていません。

nbinstallcmd -operation_type install -package nbeeb_1234567.1_8.2 
-master_server master.domain.com -host_filelist path_to_file.txt 
-use_existing_certs

関連項目

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