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

名前

vltoffsitemedia — メディアグループのオフサイトパラメータ値の表示、または 1 つのメディアのオフサイトパラメータ値の変更

概要

vltoffsitemedia -list [-W] [-vault vault_name] [-voldbhost host_name]

vltoffsitemedia -change -m media_id [-voldbhost host_name] [-d media_description] [-vltname vault_name] [-vltsent date][-vltreturn date] [-vltslot slot_no] [-vltcid container_id] [-vltsession session_id]

vltoffsitemedia -version

 

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

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

説明

vltoffsitemedia を実行すると、指定されたメディアの Vault 固有のパラメータを変更できます。1 つのコマンドで、1 つ以上のパラメータを変更できます。特定の EMM サーバーまたは Vault 用のすべてのメディアの様々な Vault パラメータを表示することもできます。

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

UNIX の場合: /usr/openv/netbackup/logs/vault

Windows の場合: install_path\netbackup\logs\vault

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

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

オプション

-change

このオプションを指定すると、指定したボリュームの属性が変更されます。

-d media_description

このオプションでは、ボリュームの説明を指定します。

ボリュームがロボットに戻されたときにメディアの説明フィールドが自動的に消去されるように構成するには、EMM に VAULT_CLEAR_MEDIA_DESC パラメータを設定します。

-list

このオプションを指定すると、ローカル EMM データベース内のメディアのオフサイトパラメータが表示されます。リストをローカル EMM データベースの特定の Vault に制限するには、このコマンドで -vault オプションを指定します。特定の EMM データベースのメディアのオフサイトパラメータを表示するには、このコマンドで -voldbhost オプションを指定します。

-m media_id

このオプションでは、Vault パラメータを変更するボリュームのメディア ID を指定します。

-vault vault_name

このオプションでは、すべてのメディア ID とそれらの Vault 固有のパラメータを表示する Vault の名前を指定します。

-version

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

-vltcid container_id

このオプションでは、ボリュームを格納するコンテナを指定します。container_id (29 文字以内の空白文字を含まない英数字の文字列) では、ボリュームを格納する新しいコンテナを指定します。指定するコンテナ ID は既存のものに限ります。異なる EMM サーバー内のメディアは割り当てることはできません。-m オプションでは、ボリュームのメディア ID を指定します。

-vltname vault_name

このオプションでは、ボリュームを取り出したロボットに構成される論理 Vault 名を指定します。

-vltreturn date

このオプションでは、Vault ベンダーからメディアの返却が要求された日時を指定します。カタログバックアップボリュームの場合、日付は Vault ベンダーからメディアの返却が要求される予定の日付になります。

NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。/usr/openv/msg/.conf ファイル (UNIX) と install_path\VERITAS\msg\LC.CONF ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。

詳しくは、『NetBackup 管理者ガイド Vol. 2』の NetBackup インストールのロケールの指定に関する項を参照してください。

-vltsent date

メディアがオフサイト Vault に発送された日時を指定します。

NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。 /usr/openv/msg/.conf ファイル (UNIX) と install_path\VERITAS\msg\LC.CONF ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。

詳しくは、『NetBackup 管理者ガイド Vol. 2』の NetBackup インストールのロケールの指定に関する項を参照してください。

mm/dd/yyyy [hh[:mm[:ss]]]
-vltsession session_id

このオプションでは、このメディアが取り出された Vault セッションの識別子を指定します。

-vltslot slot_no

このオプションでは、目的のボリュームが占有している Vault ベンダーのスロット番号を指定します。

-voldbhost host_name

このオプションでは、EMM サーバーの名前を指定します。

-W

このオプションを指定すると、メディアのオフサイトパラメータの出力が解析可能な形式になります。コンテナの場合、出力には、コンテナの説明の長さ、コンテナの説明およびコンテナ ID が示されます。出力ヘッダー行は空白で区切られたフィールド名の行で、出力データ行は空白で区切られたデータフィールドです。

例 1 - メディア ID が BYQ のメディアの Vault 名および Vault へ発送された日時を変更します。

vltoffsitemedia -change -m BYQ -vltname THISTLE -vltsent 08/01/2012 
12:22:00

例 2 - メディア ID が 000012 のメディアの Vault スロット番号を 100 に変更します。

vltoffsitemedia -change -m 000012 -vltslot 100

例 3 - メディアの Vault 固有フィールドの内容を消去します。

vltoffsitemedia -change -m 000012 -vltname "" -vltsession 0 -vltslot 
0 -vltsent 0 -vltreturn 0

または

vltoffsitemedia -change -m 000012 -vltname - -vltsession 0 -vltslot 
0 -vltsent 00/00/00 -vltreturn 00/00/00

例 4 - ボリューム ABC123 のコンテナ ID とメディアの説明を消去します。

vltoffsitemedia -change -m ABC123 -vltcid - -d ""

または

vltoffsitemedia -change -m ABC123 -vltcid "" -d ""

vltoffsitemedia コマンドは、EMM データベースへの問い合わせまたは EMM データベースの更新に、Media Manager コマンドを使用します。

vltoffsitemedia コマンドが失敗した場合、次のディレクトリのデバッグログで、失敗した Media Manager コマンドの詳細を調べます。

UNIX システムの場合: usr/openv/netbackup/logs/vault

Windows システムの場合: install_path\netbackup\logs\vault

Media Manager コマンドに戻される状態コードについて詳しくは、『NetBackup 状態コードリファレンスガイド』を参照してください。

戻り値

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

拡張終了状態の値については、『NetBackup 状態コードリファレンスガイド』と NetBackup トラブルシューティングウィザードを参照してください。