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

Last Published:
Product(s): NetBackup (8.1)
  1. 概要
    1.  
      NetBackup コマンドについて
    2.  
      複数階層のメニューの操作
    3.  
      NetBackup のコマンドの表記規則
    4.  
      NetBackup Media Manager コマンドの注意事項
  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.  
      bppolicynew
    62.  
      bpps
    63.  
      bprd
    64.  
      bprecover
    65.  
      bprestore
    66.  
      bpretlevel
    67.  
      bpschedule
    68.  
      bpschedulerep
    69.  
      bpsetconfig
    70.  
      bpstsinfo
    71.  
      bpstuadd
    72.  
      bpstudel
    73.  
      bpstulist
    74.  
      bpsturep
    75.  
      bptestbpcd
    76.  
      bptestnetconn
    77.  
      bptpcinfo
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configurePorts
    84.  
      create_nbdb
    85.  
      duplicatetrace
    86.  
      importtrace
    87.  
      jbpSA
    88.  
      jnbSA
    89.  
      ltid
    90.  
      mklogdir
    91.  
      nbauditreport
    92.  
      nbcatsync
    93.  
      NBCC
    94.  
      NBCCR
    95.  
      nbcertcmd
    96.  
      nbcertupdater
    97.  
      nbcomponentupdate
    98.  
      nbcplogs
    99.  
      nbdb_admin
    100.  
      nbdb_backup
    101.  
      nbdb_move
    102.  
      nbdb_ping
    103.  
      nbdb_restore
    104.  
      nbdb_unload
    105.  
      nbdbms_start_server
    106.  
      nbdbms_start_stop
    107.  
      nbdc
    108.  
      nbdecommission
    109.  
      nbdelete
    110.  
      nbdeployutil
    111.  
      nbdevconfig
    112.  
      nbdevquery
    113.  
      nbdiscover
    114.  
      nbdna
    115.  
      nbemm
    116.  
      nbemmcmd
    117.  
      nbexecute
    118.  
      nbfindfile
    119.  
      nbfirescan
    120.  
      nbftadm
    121.  
      nbftconfig
    122.  
      nbgetconfig
    123.  
      nbhba
    124.  
      nbholdutil
    125.  
      nbhypervtool
    126.  
      nbjm
    127.  
      nbkmsutil
    128.  
      nboraadm
    129.  
      nbpem
    130.  
      nbpemreq
    131.  
      nbperfchk
    132.  
      nbplupgrade
    133.  
      nbrb
    134.  
      nbrbutil
    135.  
      nbregopsc
    136.  
      nbreplicate
    137.  
      nbrestorevm
    138.  
      nbseccmd
    139.  
      nbsetconfig
    140.  
      nbsnapimport
    141.  
      nbsnapreplicate
    142.  
      nbsqladm
    143.  
      nbstl
    144.  
      nbstlutil
    145.  
      nbsu
    146.  
      nbsvrgrp
    147.  
      resilient_clients
    148.  
      restoretrace
    149.  
      stopltid
    150.  
      tl4d
    151.  
      tl8d
    152.  
      tl8cd
    153.  
      tldd
    154.  
      tldcd
    155.  
      tlhd
    156.  
      tlhcd
    157.  
      tlmd
    158.  
      tpautoconf
    159.  
      tpclean
    160.  
      tpconfig
    161.  
      tpext
    162.  
      tpreq
    163.  
      tpunmount
    164.  
      verifytrace
    165.  
      vltadm
    166.  
      vltcontainers
    167.  
      vlteject
    168.  
      vltinject
    169.  
      vltoffsitemedia
    170.  
      vltopmenu
    171.  
      vltrun
    172.  
      vmadd
    173.  
      vmadm
    174.  
      vmchange
    175.  
      vmcheckxxx
    176.  
      vmd
    177.  
      vmdelete
    178.  
      vmoprcmd
    179.  
      vmphyinv
    180.  
      vmpool
    181.  
      vmquery
    182.  
      vmrule
    183.  
      vmupdate
    184.  
      vnetd
    185.  
      vxlogcfg
    186.  
      vxlogmgr
    187.  
      vxlogview
    188.  
      W2KOption

名前

vltrun — NetBackup Vault セッションの実行

概要

vltrun -haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-version]

 

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

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

説明

vltrun では、Vault エンジンに一連の呼び出しを発行することによって NetBackup Vault セッションが実行されます。必要に応じて、このセッションにユーザー指定の通知スクリプトへの呼び出しを含めることができます。

オプション

profile|robot/vault/profile

このオプションでは、プロファイル名、または Vault パラメータファイル内でネストしたロボット番号、Vault およびプロファイルの名前を指定します。robot および vault を指定しないで profile を指定する場合、そのプロファイルは Vault パラメータファイル内で一意である必要があります。このオプションは必須です。

-vjob vault_jobid

このオプションでは、現在複製が実行されている Vault ジョブのジョブ ID を指定します。

-haltdups

このオプションを指定すると、関連付けられているすべての実行中の Vault 複製ジョブが終了します。

-preview

このオプションを指定すると、Vault セッションで Vault 処理が行われるイメージのプレビューのリストが生成されます。結果は、セッションディレクトリ内の preview.list ファイルに記録されます。

-verbose|-v

このオプションを指定すると、セッションについての詳細なレポートが Vault デバッグログに出力されます。

-version

このオプションを指定すると、vltrun のバージョンが表示されます。

使用例

vltrun セッションは、次の順序で実行されます。

  • vlt_start_notify スクリプトを実行する。

  • メディアのインベントリを実行する。

  • ロボットに返却された Vault メディアの Media Manager データベースを初期化する。

  • Vault 処理を行うイメージのプレビューのリストを生成する。

  • イメージを複製する。

  • Media Manager データベースのインベントリを実行する (1 回目)。

  • NetBackup カタログバックアップ用のメディアを割り当てる。

  • Media Manager データベースのインベントリを実行する (2 回目)。

  • イメージのインベントリを実行する。

  • メディアを一時停止状態にする。

  • vlt_end_notify スクリプトを実行する。

  • イメージのインベントリを再実行する。

  • スロット ID を割り当てる。

  • NetBackup カタログをバックアップする。

  • Media Manager データベースのインベントリを実行する (3 回目で最終回)。

  • vlt_ejectlist_notify スクリプトを実行する。

  • 取り出しリストを生成する。

  • vlt_starteject_notify スクリプトを実行する。

  • 取り出しおよびレポートを実行する。

  • vlt_end_notify スクリプトを実行する。

vltrun は、次のいずれかの方法で実行できます。

  • コマンドラインから直接実行する。

  • NetBackup ポリシースケジュールを使用する。この場合、ポリシー形式が Vault で、ポリシーのファイルリストに vltrun コマンドが含まれている必要があります。

  • Vault インターフェースの[セッションの開始 (Start Session)]コマンドを実行するか (プロファイルの場合)、または vltadm を実行する。

Vault セッションを実行するには、profile|robot/vault/profile オプションを指定して vltrun を実行します。Vault の構成内に同じ名前を持つプロファイルが他に存在しない場合は、オプションに profile の形式を指定できます。この場合、プロファイル名だけで構成情報を一意に識別できます。

同じ名前を持つプロファイルが複数存在する場合は、構成を一意に識別するために robot/vault/profile の形式を使用します。

Vault セッションの実行中は、Vault の構成を変更しないでください。

セッションが開始されると、セッション中に vltrun および Vault エンジンによって作成されるファイルを保持するためのディレクトリが作成されます。

Vault セッションでは次のディレクトリを使用します。

UNIX システムの場合:

/usr/openv/netbackup/vault/sessions/vault_name/sidxxx

Windows システムの場合:

install_path\NetBackup\vault\sessions\vault_name\sidxxx

xxx 変数は、このセッションに一意に割り当てられる整数です。Vault 名ごとにセッション識別子が 1 から順番に割り当てられます。

Vault プロパティに電子メールアドレスを構成している場合は、セッションの終了時にこのアドレスに電子メールが送信されます。電子メールによって結果が報告されます。デフォルトでは、電子メールは root ユーザーに送信されます。

vltrun を実行すると、セッションディレクトリ内にセッションの概略 (summary.log) が作成されます。

NetBackup バイナリ用のディレクトリ /usr/openv/netbackup/bin に通知スクリプトをインストールして、Vault の処理をセッション中のいくつかの時点で制御します。通知スクリプトについて詳しくは、『NetBackup Vault 管理者ガイド』を参照してください。

vltrun セッションの進捗状況は、NetBackup アクティビティモニターで監視できます。

アクティビティモニターのメインウィンドウ内の[操作 (Operation)]フィールドに、次の状態を使用して Vault セッションの進捗状況が表示されます。

  • イメージを選択しています (Choosing Images)

  • イメージを複製しています (Duplicating Images)

  • メディアを選択しています (Choosing Media)

  • カタログバックアップ (Catalog Backup)

  • 取り出しおよびレポート (Eject and Report)

  • 完了 (Done)

すべてのユーザーによる書き込みを許可して、次のディレクトリを作成した場合、vltrunを実行すると、そのディレクトリに日次デバッグログファイルが作成されます。

UNIX システムの場合:

usr/openv/netbackup/logs/vault

Windows システムの場合:

install_path\netbackup\logs\vault

ログの名前は log.DDMMYY (DDMMYY は現在の日付) です。このファイルをトラブルシューティングに使うことができます。

このファイルに書き込みを行うすべての実行可能ファイルが管理者または root ユーザーによって実行されるわけではないため、すべてのユーザーによる書き込みを許可する必要があります。

ログファイルに記録されるログ情報の量を調整するには、NetBackup 管理コンソールの[ホストプロパティ (Host Properties)]からマスターサーバーのプロパティの[ログ (Logging)]ページでログレベルのパラメータを調整します。

実行中の Vault 複製ジョブを終了するには、vltrun -haltdups コマンドを使用します。-haltdups スクリプトを開始すると、現在複製中のメイン Vault ジョブに SIGUSR2 シグナルが送信されます。その後、現在の複製ジョブインスタンスの終了を待機することなく、すべての Vault 複製インスタンスにシグナルが自動的に伝達されます。この処理が完了すると、メイン Vault ジョブで残りの処理が続行されます。

SIGUSR2 シグナルが受信されると、終了した Vault 複製ジョブのジョブの詳細が次のメッセージで表示されます: 管理者から終了が要求されました (150)

このコマンドを実行するには、管理者権限が必要です。

例 1 - プロファイル my_profile を Vault 処理します。

# vltrun my_profile

例 2 - ロボット 0 のイメージを Vault 処理し、会計報告およびプロファイル Weekly を Vault 処理します。

# vltrun 0/Financials/Weekly

例 3 - ID が 1 のアクティブな Vault 複製ジョブを終了します。

# vltrun -haltdups -vjob 1

戻り値

UNIX システムでは、Vault は 255 より大きい状態コードで終了する場合があります。これらの拡張終了状態コードでは、システムに戻される状態は 252 です。実際の終了状態は標準エラー出力 (stderr) に、[EXIT status = exit status]という形式で書き込まれます。

ファイル

UNIX システムの場合:

/usr/openv/netbackup/vault
/usr/openv/netbackup/bp.conf
/usr/openv/netbackup/logs/bpcd/log.mmddyy
/usr/openv/netbackup/logs/vault/log.mmddyy
/usr/openv/netbackup/db/vault/vault.xml
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/summar
y.log
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/detail
.log

Windows システムの場合:

install_path\NetBackup\vault
install_path\NetBackup\bp.conf
install_path\NetBackup\logs\bpbrmvlt\mmddyy.log
install_path\NetBackup\logs\bpcd\mmddyy.log
install_path\NetBackup\logs\vault\mmddyy.log
install_path\NetBackup\db\vault\vault.xml
install_path\NetBackup\vault\sessions\vault_name\sidxxxinstall_path\NetBackup\vault\sessions\vault_name\sidxxx\summ
ary.log
install_path\NetBackup\vault\sessions\vault_name\sidxxx\deta
il.log