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

名前

tpconfig — テープ構成ユーティリティの実行

概要

UNIX システムの場合: tpconfig [-noverify]

tpconfig -d | -dl | -l

UNIX システムの場合: tpconfig -add -drive -type drvtype -path drivepath [-nh ndmp_hostname] [-asciiname asciidrivename] [-index drvindex]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus UP | DOWN | DISABLED] [-scsi_protection [SPR | SR | NONE] [-robot robnum -robtype robtype] [-noverify] [-robdrnum robdrvnum | -VendorDrvName venddrvname | -ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum] [000-preview]

Windows システムの場合: tpconfig -add -drive -type drvtype -port port -bus bus -target target -lun lun [-asciiname asciidrivename] [-index drvindex]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP | DOWN | DISABLED]] [-scsi_protection [SPR | SR | NONE]] [-robot robnum -robtype robtype] [-noverify] [-robdrnum robdrvnum | -VendorDrvName vendor_drive_name] [-ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum] [preview]

UNIX システムの場合: tpconfig -update -drive drvindex [-type drvtype] [-path drivepath] [-nh ndmp_hostname] [-noverify] [-newasciiname asciidrivename]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP|DOWN|DISABLED]] [-robot robnum -robtype robtype] [-robdrnum robdrvnum | -VendorDrvName venddrvname | -ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum]

Windows システムの場合: tpconfig -update -drive drvindex [-type drvtype] [-port port -bus bus -target target -lun lun ] [-nh ndmp_hostname -path drivepath] [-noverify] [-newasciiname asciidrivename]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP|DOWN|DISABLED]] [-robot robnum -robtype robtype] [-robdrnum robdrvnum | -VendorDrvName vendor_drive_name] [-ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum]

tpconfig -delete -drive drvindex

tpconfig -multiple_delete -drive drvindex1:...:drvindexN

tpconfig -add -disk_array array_hostname -disk_user_id user_ID -arraytype_name "name:displayname" -requiredport IP_port_number [-password password [-key encryption_key]]

tpconfig -update -disk_array array_hostname -disk_user_id user_ID -requiredport IP_port_number [-arraytype_name "name:displayname"] [-password password [-key encryption_key]]

tpconfig -delete -disk_array array_hostname -disk_user_id user_ID [-arraytype_name "name:displayname"]

tpconfig -ddiskarrays

tpconfig -list_array_types [media_server]

UNIX システムの場合: tpconfig -add -robot robnum -robtype robtype -robpath devfile [-nh ndmp_hostname]

Windows システムの場合: tpconfig -add -robot robnum -robtype robtype -port port -bus bus -target target -lun lun

Windows システムの場合: tpconfig -add -robot robnum -robtype robtype [-nh ndmp_hostname] -robpath changername [-bus bus -target target -lun lun]

tpconfig -add -robot robnum -robtype robtype -cntlhost cntlhost

UNIX システムの場合: tpconfig -update -robot robnum [-robtype robtype] [-robpath devfile] [-cntlhost cntlhost]

Windows システムの場合: tpconfig -update -robot robnum [-robtype robtype] [-port port -bus bus -target target -lun lun | -cntlhost cntlhost | -tlh_library_nametlh_library_name]

tpconfig -update -robot robnum [-robtype robtype] [-robpath devfile] [-nh ndmp_hostname] [-bus bus] [-target target] [-lun lun]

tpconfig -update -robot robnum [-robtype robtype]

tpconfig -delete -robot robnum

tpconfig -multiple_delete -robot robnum1:...:robnumN

tpconfig -add -drpath -path drivepath [-nh ndmp_hostname] [-asciiname asciidrivename] [-drstatus [UP|DOWN|DISABLED]] [-noverify]

UNIX システムの場合: tpconfig -update -drpath -old_path drivepath -path drivepath [-nh ndmp_hostname] [-asciiname asciidrivename] [-drstatus [UP|DOWN|DISABLED]] [-scsi_protection SPR|SR|DEFAULT] [-noverify]

Windows システムの場合: tpconfig -update -drpath -old_port port -old_bus bus -old_target target -old_lun lun -port port -bus bus -target target -lun lun -asciiname asciidrvname [-drstatus [UP|DOWN|DISABLED]] [-noverify]

UNIX システムの場合: tpconfig -delete -drpath -path drivepath -asciiname asciidrivename [-nh ndmp_hostname]

Windows システムの場合: tpconfig -delete -drpath -port port -bus bus -target target -lun lun | -path drivepath [-nh ndmp_hostname] -asciiname asciidrvname

tpconfig -dnh

tpconfig -dnh -all_hosts

tpconfig -ddnh

tpconfig -add -nh ndmp_hostname

tpconfig -add -nh ndmp_hostname -user_id | -filer_user_id user ID [-password password [-key encryption_key]] -snap_vault_filer

tpconfig -update -nh ndmp_hostname -user_id | -filer_user_id user ID [[-password password [-key encryption_key]]

tpconfig -delete -nh ndmp_hostname -user_id | -filer_user_id user ID

tpconfig -multiple_delete -nh ndmp_hostname_1:... :ndmp_hostname_N

tpconfig -add -default_user_id user ID [-password password [-key encryption_key]]

tpconfig -update -default_user_id user ID [-password password [-key encryption_key]]

tpconfig -delete -default_user_id

tpconfig -add | -update -disk_array disk_array_host_name -disk_user_id user_ID -arraytype disk_array_type -requiredport IP_port_number [-password password [-key encryption_key]]

tpconfig -delete -disk_array disk_array_host_name -disk_user_id user_ID [-arraytype disk_array_type]

tpconfig -ddiskarrays

tpconfig -add | -update -virtual_machine virtual_machine_name -vm_user_id user_id -vm_type virtual_machine_type -requiredport IP_port_number [-password password [-key encryption_key]]

tpconfig -delete -virtual_machine virtual_machine_name -vm_user_id user_id [-vm_type virtual_machine_type]

tpconfig -dvirtualmachines

tpconfig -add -storage_server server_name -stype server_type -sts_user_id user_ID [-password password] [-st storage_type]

tpconfig -update -storage_server server_name -stype server_type -sts_user_id user_ID [-password password]

tpconfig -delete -storage_server server_name -stype server_type -sts_user_id user_ID

tpconfig -dsh [-stype server_type]

tpconfig -dsh -all_hosts

tpconfig -dev_ping [-drive -path drivepath | -robpath robotpath] [-nh ndmp_hostname]

Windows システムの場合: tpconfig -dev_ping [-drive] -port port -bus bus -target target -lun lun

tpconfig -emm_dev_list [-noverbose]

 

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

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

機能説明

tpconfig を実行すると、NetBackup で使用するロボット、ドライブ、ドライブアレイ、ドライブパス、ホストが構成されます。

UNIX システムでは、tpconfig [-noverify] はメディア管理とデバイス管理のユーティリティを開始します。このメニューベースのユーティリティを使用して、EMM データベース内にデバイスの作成および変更をすることができます。この EMM データベースによって、ltid (Media Manager device デーモン) に制御されているロボットおよびドライブが識別されます。 ltid は、/dev ディレクトリ内のデバイスファイルにオペレータのドライブ状態でのドライブとの関連を表示させるためにこのデータベースを使用します。

たとえば、システムによって 8MM 形式のドライブとして認識されるドライブを構成すると想定します。/dev ディレクトリ内を検索し、クローズ時非巻き戻しデバイスパスを 8MM 形式のドライブに配置します。次に、このデバイスパスをドライブに指定します。 その後、tpconfig によって、そのデバイスパスが適切なデバイスデータベースに記録されます。

tpconfig を実行してデバイスの構成を変更した後、stopltid を実行して ltid デーモンおよび (自動ボリューム認識) デーモン (実行中である場合) を停止します。 その後、ltid コマンドを実行して、デーモンを再起動します。詳しくは、ltid を参照してください。

Windows システムでは、デバイス構成の変更が完了すると、NetBackup Device Manager サービスが停止し、再起動されます。

このユーティリティを実行するには、管理者権限が必要です。

オプション

次の 4 つのオプションは、NetBackup Enterprise Server だけに適用されます。これらのオプションでは、ACS (自動カートリッジシステム) ロボットの構成を指定します。

-ACS acsnum, -LSM lsmnum, -PANEL panelnum, -DRIVE drivenum

acsnum には、ACS ライブラリソフトウェアホスト上で構成されたロボットライブラリ数を指定します。

lsmnum には、そのドライブが存在するライブラリストレージモジュールを指定します。

panelnum には、そのドライブが位置するロボットパネルを指定します。

drivenum には、そのドライブの番号を指定します。

-add
-all_hosts

このオプションを指定すると、メディアサーバー上にクレデンシャルを持つすべてのホストが表示されます。

-arraytype_name "name:displayname"

クレデンシャルを追加、更新、または削除するディスクアレイの形式を指定します。

二重引用符 (") は、name または displayname に 1 つ以上の空白が含まれる場合にのみ必要です。

name:displayname の値は、ディスクアレイベンダーから提供されます。name 部分は、NetBackup で内部的に使用される一意の文字列です。displayname 部分は、NetBackup 管理コンソールの表示とメニューで使用される、さらに読みやすい文字列です。

値は、次に示すように、アレイに使用するディスクアレイベンダーおよびプロバイダ形式によって異なります。

  • アレイ固有のプロバイダの場合、形式は次のとおりです。

    vendorID_productID:displayname

    デフォルトでは、NetBackup には次のような複数のアレイ固有のプロバイダがあります (ただし、限定されるわけではありません)。

    • HP_HSV:HP EVA

    • EMC_CLARIION:EMC CLARiiON

    • EMC_SYMMETRIX:EMC Symmetrix

    • IBM_TOTALSTORAGE:IBM System Storage

    • NETAPP_LUN:NetApp

  • 汎用アレイプロバイダの場合、形式は次のとおりです。

    OPENARRAY::vendorID_productID:displayname

    たとえば、OPENARRAY::HITACHI_HDS:Hitachi HDS DF Series

有効なディスクアレイの形式の名前を確認するには、-list_array_types オプションを使用します。

Flexible Disk または Snapshot Client ライセンスが必要です。

-asciiname asciidrivename

このオプションでは、ドライブ名を指定します。この名前によって、Media Manager でドライブが識別されます。ドライブ名を指定しない場合、Media Manager によって名前が生成されます。共有ドライブを追加または更新する場合 (Shared Storage Option) には、できるかぎりドライブの性質を表す名前を指定します。

-bus bus

このオプションでは、ロボットまたはドライブが接続される SCSI バス番号を指定します。

『NetBackup デバイス構成ガイド』を参照してください。

-cleanfreq hours

このオプションでは、ドライブクリーニングの間隔 (時間) を指定します。ドライブを追加すると、そのドライブへのボリュームのマウント時間の記録が NetBackup によって開始されます。

ドライブがロボット内にあり、そのロボットにクリーニングボリュームが定義されている場合、累積マウント時間がクリーニング間隔に指定した時間を超えると、クリーニングが実行されます。ドライブがクリーニングされると、NetBackup によってマウント時間がリセットされます。

ドライブがスタンドアロンドライブである場合またはクリーニングテープを定義していない場合には、tpclean -L が出力する[コメント (Comment)]フィールドにクリーニングが必要なことを示すメッセージが表示されます。ドライブをクリーニングするには、tpclean コマンドを実行します。

TapeAlert を使用する場合、間隔に基づくクリーニングは不要です。

-cntlhost cntlhost

このオプションは、NetBackup Enterprise Server だけに適用されます。

ロボット制御が他のホスト上に存在するロボットの場合、このオプションでは、そのロボットライブラリを制御するホストを指定します。

このオプションは、別のホスト上に存在するロボット制御が可能な TL8、TLD、および TLH ロボットにのみ適用されます。ACS ロボットと TLM ロボットにも適用されます。

ACS ロボットの場合、ACS ライブラリソフトウェアがインストールされているホスト名を指定します。TLM ロボットの場合、DAS サーバーソフトウェアがインストールされているホスト名を指定します。

-comment comment

このオプションでは、ドライブについてのコメントを追加します。このフィールドは、SCSI 照会データを格納する場合に有効で、ドライブ形式およびファームウェアのレベルを簡単に確認できます。

-d

このオプションを指定すると、現在の構成情報が表示されます。UNIX システムでは、リストは stdout に出力されます。このオプションでは、ドライブ名が 22 文字で切り捨てられる場合があります。

-ddiskarrays

このオプションを指定すると、構成済みのディスクアレイがすべて表示されます。

-ddnh

このオプションを指定すると、メディアサーバー上のデフォルトのクレデンシャルが表示されます。

-default_user_id user_ID

このオプションを指定すると、特定のマスターサーバーのすべてのメディアサーバーおよび NDMP ホストの組み合わせに対して、ユーザー名およびパスワードを設定します。ファイラごとに一度だけユーザー名とパスワードを追加します。このオプションを -add-update または -delete コマンドと組み合わせて使用して、ユーザー名およびパスワードを指定します。

-delete

このオプションを指定すると、同時に指定するオプションに応じて、ドライブ、ロボットまたはホストクレデンシャルが削除されます。

-dev_ping

このオプションを指定すると、デバイスからデバイス情報が取得されます。

-disk_array array_hostname

ディスクアレイのホスト名を指定します。NetBackup Snapshot Client ライセンスがインストールされている場合に限り、このオプションを使用できます。

-disk_user_id user_ID

このオプションでは、ディスクアレイとの通信で NetBackup が使用するユーザー名を指定します。NetBackup Snapshot Client ライセンスがインストールされている場合に限り、このオプションを使用できます。

-dl

このオプションを指定すると、完全なドライブ名が表示されます。

-dnh

このオプションを指定すると、メディアサーバー上にある NDMP ホストのクレデンシャルが表示されます。

-drive

このオプションを -add オプションとともに指定すると、操作の対象がドライブになります。

-drive drvindex

このオプションでは、ドライブインデックスを指定します。このオプションを -update-delete、または -multiple_delete コマンドとともに指定すると、ドライブに対する操作が指定されます。

-drpath

このオプションを指定すると、追加、更新または削除の実行をドライブパスに対して行います。

-drstatus UP|DOWN|DISABLED

このオプションを指定すると、テープドライブの初期状態が UP (起動状態)、DOWN (停止状態) または DISABLED (無効状態) に設定されます。検出されたドライブパスは、デフォルトで起動状態 (UP) になります。管理者またはオペレータは、ドライブパスの起動または停止を無効にしたり、構成することができます。この操作は、[デバイス管理 (Device Management)]ウィンドウのオプションによっても実行できます。

ドライブの状態が DISABLED (無効状態) である場合、パスは格納されますが使用されません。また、このドライブパスがそれ以降に検出されても、使用するようには構成されません。

-dsh

指定したサーバーの種類 (-stype server_type) またはすべてのメディアサーバー (-all_hosts) の OpenStorage クレデンシャルを表示します。

-dvirtualmachines

構成済みの仮想コンピュータがすべて表示されます。

-emm_dev_list [-noverbose]

このオプションを指定すると、EMM データベースの完全なテープデバイス構成が表示されます。この情報には、すべてのメディアサーバー、マスターサーバー、NDMP ホストおよびそのクレデンシャルが含まれます。

-filer_user_id user ID

このオプションを指定すると、ファイラに接続されているすべてのメディアサーバーに対して、ユーザー名およびパスワードを設定できます。ファイラごとに一度だけユーザー名とパスワードを追加します。このオプションを -add-update または -delete コマンドと組み合わせて使用して、ユーザー名およびパスワードを指定します。

-index drvindex

このオプションでは、ドライブインデックス (ドライブを識別するために使用される一意の番号) を指定します。ドライブを追加する場合、Media Manager によって次に利用可能なドライブインデックスが使用されるため、ドライブインデックスを指定する必要はありません。特定のホスト上の各ドライブには、一意のインデックス番号が付けられている必要があります。

-key encryption_key

このオプションを指定すると、暗号化された鍵を作成することができるため、暗号化されたクレデンシャルをネットワークを介して安全に送信することができます。-key オプションを指定した場合、tpconfig では、指定されるパスワードは MD5 暗号化形式として見なされます。

-l

このオプションを指定すると、現行のデバイス構成が stdout に表示されます。Windows システムでは、-l によって Windows デバイスパスが {p,b,t,l} のエンコード形式で表示されます。 p はポート、b はバス、t はターゲット、l は LUN です。

-list_array_types [media_server]

クレデンシャルを追加および管理できるディスクアレイの形式が表示されます。

特定のメディアサーバーに対して有効なディスクアレイの形式に出力を制限するには、そのメディアサーバーを指定します。

コマンド出力は、アレイの形式ごとに name:displayname 形式になります。

name:displayname の値は、ディスクアレイベンダーから提供されます。name 部分は、NetBackup で内部的に使用される一意の文字列です。displayname 部分は、NetBackup 管理コンソールの表示とメニューで使用される、さらに読みやすい文字列です。

値は、次に示すように、アレイに使用するディスクアレイベンダーおよびプロバイダ形式によって異なります。

  • アレイ固有のプロバイダの場合、形式は次のとおりです。

    vendorID_productID:displayname

    デフォルトでは、NetBackup には次のような複数のアレイ固有のプロバイダがあります (ただし、限定されるわけではありません)。

    • HP_HSV:HP EVA

    • EMC_CLARIION:EMC CLARiiON

    • EMC_SYMMETRIX:EMC Symmetrix

    • IBM_TOTALSTORAGE:IBM System Storage

    • NETAPP_LUN:NetApp

  • 汎用アレイプロバイダの場合、形式は次のとおりです。

    OPENARRAY::vendorID_productID:displayname

    たとえば、OPENARRAY::HITACHI_HDS:Hitachi HDS DF Series

-lun lun

このオプションでは、ロボットまたはドライブが接続される論理ユニット番号 (または SCSI ID) を指定します。

デバイスのパスについて詳しくは、『NetBackup デバイス構成ガイド』を参照してください。

-multiple_delete

このオプションを指定すると、同時に指定するオプションに応じて、複数のドライブまたはロボットが削除されます。

-newasciiname asciidrivename

このオプションでは、新しいドライブ名を指定します。

-nh ndmp_hostname | puredisk_hostname

NDMP サーバーまたは PureDisk サーバーのホスト名を指定します。Symantecは NetBackup 5000 シリーズのアプライアンス上の PureDisk オプションのみをサポートします。

-noverify

ドライブパスは検証されません。通常、tpconfig は、クローズ時非巻き戻しドライブパスに、非巻き戻し、変数、Berkeley 形式などに関する正しいマイナー番号のビット数が含まれていることを検証します。このオプションは、標準外のプラットフォームデバイスファイルの使用時には有効な場合があるため、デバイスファイルが正しいことを確認してください。

-old_bus bus

このオプションは Windows システムでのみ使用します。このオプションでは、追加、更新または削除する SCSI バス番号を指定します。

-old_lun lun

このオプションは Windows システムでのみ使用します。このオプションでは、ロボットまたはドライブが接続される論理ユニット番号 (または SCSI ID) を指定します。レジストリにこの情報が表示されます。このコマンドを実行すると、既存の論理ユニット番号を追加、更新または削除できます。

-old_path drivepath

このオプションを -update コマンドとともに使用すると、パスを、データベース内にすでに存在するパスに変更できます。パスが存在しない場合は、エラーが発生します。

-old_port port

このオプションは Windows システムでのみ使用します。このオプションでは、追加、更新または削除する既存の SCSI ポート番号を指定します。

-old_target target

このオプションは Windows システムでのみ使用します。このオプションでは、ロボットまたはドライブが接続される既存のターゲット番号 (または SCSI ID) を指定します。このコマンドを実行すると、既存のターゲットを追加、更新または削除できます。

-password password
-path drivepath

このオプションでは、NDMP ファイラ上のドライブのデバイスパスを指定します。

Windows システムでは、drive_path 変数に非 NDMP のドライブの Windows デバイスパスを指定します。パスは {p,b,t,l} 形式で指定します。p はポート、b はバス、t はターゲット、l は LUN です。この情報はレジストリに表示されます。

-port port

このオプションでは、ロボットまたはドライブが接続される SCSI ポート番号を指定します。レジストリにこの情報が表示されます。

-requiredport IP_port_number
-robdrnum robdrvnum

このオプションでは、ドライブの物理的な場所 (ロボット内) を指定します。不適切な番号を割り当てると、NetBackup によってドライブが検出されません。ロボット制御によってその不適切なドライブへのメディアのマウントが試行されるため、結果的にエラーが発生します。

通常、物理的な場所は、ドライブへのコネクタまたはベンダーが提供するマニュアルを確認することによって判断できます。

-robot robnum

このオプションでは、NetBackup に対する一意のロボット識別番号を指定します。add オプションによってロボット番号を割り当てます。

すべてのロボットのロボット番号は、ロボット形式やロボットを制御するホストに関係なく一意である必要があります。

NetBackup Enterprise Server では、ロボット番号は、同じ EMM サーバーを共有する (同じ EMM データベースを使用する) すべてのロボットで一意である必要があります。この要件は、ロボット形式またはロボットを制御するホストにかかわらず適用されます。たとえば、ホストが異なる同じ EMM サーバーが 2 つの TLD ロボットを制御します。その場合、ロボット番号は異なる必要があります。

-robpath devfile

このオプションでは、NDMP ファイラ上のロボットのデバイスパスを指定します。

Windows システムでは、drive_path 変数に非 NDMP のドライブの Windows デバイスパスを指定します。パスは {p,b,t,l} 形式で指定します。p はポート、b はバス、t はターゲット、l は LUN です。この情報はレジストリに表示されます。

-robtype robtype

このオプションでは、構成するロボット形式を指定します。このオプションでは、NetBackup によってサポートされているすべてのロボット形式を指定できます。特定のロボットライブラリモデルに対して指定するロボット形式を判断するには、サポート Web サイトを参照してください。

NetBackup Enterprise Server では、次のロボット形式のいずれかを指定できます。

acs (自動カートリッジシステム)、tl4 (4MM テープライブラリ)、tl8 (8MM テープライブラリ)、tld (DLT テープライブラリ)、tlh (1/2 インチテープライブラリ)、tlm (マルチメディアテープライブラリ)

NetBackup サーバーでは、次のロボット形式のいずれかを指定できます。

tl4 (4MM テープライブラリ)

tl8 (8MM テープライブラリ)

tld (DLT テープライブラリ)

-scsi_protection SPR | SR | NONE

このオプションでは、NetBackup で使用される SCSI テープドライブのアクセス保護を指定できます。

SPR: SCSI Persistent RESERVE IN または Persistent RESERVE OUT

SR: SCSI RESERVE/RELEASE

NONE - SCSI アクセス保護なし

デフォルトは、SCSI RESERVE/RELEASE (SR) です。

-shared yes|no

このオプションでは、共有ドライブを追加または更新するかどうかを指定します。

-snap_vault_filer

-snap_vault_filer フラグは、NetApp P3 機能とともに使用します。ファイラのユーザー名およびパスワードが格納されている場合、このフラグを設定します。このフラグを設定しないと、ユーザーインターフェースを使用してそのファイラにボリュームを追加することができません。このフラグを設定せずにユーザー名およびパスワードを無効にし、その機能を使用することにした場合は、tpconfig -delete を実行してから、フラグを使用して機能を再度追加する必要があります。このフラグは、次のコンテキストで、NetApp P3 機能とともに使用されます。

tpconfig -add -user_id root -nh mmnetapp2-target target
-snap_vault_filer
-st storage_type

このオプションでは、ストレージサーバープロパティを識別する数値を指定します。この値は、ストレージベンダーによって提供されます。ディスクのフォーマットの状態を示す数値とディスクの接続方法を示す数値をそれぞれから 1 つ選択し、これらの数値を組み合わせて値を指定します。

storage_type で指定可能な値は、次のとおりです。

  • フォーマット済みディスク = 1

  • RAW ディスク = 2

  • ダイレクト接続 = 4

  • ネットワーク接続 = 8

storage_type の値は、ディスクがフォーマットされているかどうかを示す数値 (1 または 2) と、ディスクの接続方法を示す数値 (4 または 8) の合計です。デフォルトの値は、9 (ネットワーク接続されたフォーマット済みディスク) です。

-storage_server server_name

このオプションでは、ストレージサーバーのホスト名を指定します。

-sts_user_id user_id

このオプションでは、ストレージサーバーにログインするために必要なユーザー名を指定します。ストレージサーバーでログオンクレデンシャルが不要な場合は、仮のクレデンシャルを入力します。

-stype server_type

このオプションでは、ストレージサーバー形式を識別する文字列を指定します。server_type の値は次のいずれかから指定できます。

  • Symantec提供のストレージ。指定可能な値は、AdvancedDiskPureDisk です。

  • サードパーティのディスクアプライアンス。ベンダーから server_type の文字列が提供されます。

  • クラウドストレージ。有効な値は、amazonattazurerackspace です。クラウドの stype 値はクラウドストレージプロバイダを反映します。クラウドストレージの stype 値は、接尾辞も含めることができます (amazon_crypt など)。可能性のある接尾辞は次の通りです。

    • _raw: NetBackup バックアップイメージは raw 形式でクラウドに送信されます。クラウドストレージに送信する前にデータを圧縮したり暗号化したりしたくない場合、このオプションを使用します。

    • _rawc: クラウドストレージに書き込む前にデータを圧縮します。

    • _crypt: クラウドストレージにデータを書き込む前に、AES-256 暗号化を使ってデータを暗号化します。このオプションを使用するには、NetBackup で KMS を構成する必要があります。

    • _cryptc: クラウドストレージに書き込む前に、データを圧縮して暗号化します。

ストレージサーバー形式は大文字と小文字を区別します。

-target target

このオプションでは、ロボットまたはドライブが接続されるターゲット番号 (または SCSI ID) を指定します。

この情報は、レジストリ (Windows システム) または『NetBackup デバイス構成ガイド』で確認できます。

-tlh_library_name tlh_library_name

このオプションでは、TLH のロボットライブラリ名を指定します。

-type drvtype

このオプションでは、構成するドライブ形式を指定します。

NetBackup Enterprise Server では、次のドライブ形式のいずれかを指定できます。

4mm (4MM テープドライブ)、8mm (8MM テープドライブ)、8mm2 (8MM テープドライブ 2)、8mm3 (8MM テープドライブ 3)、dlt (DLT テープドライブ)、dlt2 (DLT テープドライブ 2)、dlt3 (DLT テープドライブ 3)、dtf (DTF テープドライブ)、qscsi (QIC テープドライブ)、hcart (1/2 インチカートリッジドライブ)、hcart2 (1/2 インチカートリッジドライブ 2)、hcart3 (1/2 インチカートリッジドライブ 3)。NetBackup サーバーでは、次のドライブ形式のいずれかを指定できます。4mm (4MM テープドライブ)、8mm (8MM テープドライブ)、dlt (DLT テープドライブ)、hcart (1/2 インチカートリッジドライブ)、qscsi (QIC テープドライブ)。

-update

このオプションを指定すると、ドライブまたはロボットの構成情報が変更されます。たとえば、ドライブをロボットに追加できます。

-user_id user_ID

このオプションでは、クレデンシャルを追加するメディアサーバーの特定の NDMP ホストのユーザー ID を指定します。

メモ:

メディアサーバーには、NDMP ホスト名ごとにユーザー ID を 1 つだけ設定できます。1 つの NDMP ホスト名に対して 2 つ目のユーザー ID を追加することはできません。

-VendorDrvName venddrvname

このオプションは、NetBackup Enterprise Server だけに適用されます。このオプションでは、TLH ロボットドライブの IBM デバイス名、または TLM ロボットドライブの DAS ドライブ名を指定します。

-virtual_machine virtual_machine_name

このオプションでは、クレデンシャルの追加、更新または削除の対象となる仮想マシンのホスト名を指定します。NetBackup Snapshot Client ライセンスがインストールされている場合に限り、このオプションを使用できます。

-vm_type virtual_machine_type

このオプションでは、仮想マシンの形式を指定します。指定可能な値は、次のとおりです。

1 - VMware VirtualCenter サーバー

2 - VMware ESX Server

3 - VMware Converter サーバー

NetBackup Snapshot Client ライセンスがインストールされている場合に限り、このオプションを使用できます。

-vm_user_id user_id

このオプションでは、仮想マシンのディスクアレイとの通信で NetBackup が使用するユーザー名を指定します。NetBackup Snapshot Client ライセンスがインストールされている場合に限り、このオプションを使用できます。

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

注意事項

tpconfig -d では、ドライブ名が 22 文字で切り捨てられる場合があり、tpconfig -l ではドライブ名が 32 文字で切り捨てられる場合があります。完全なドライブ名を表示するには、tpconfig -dl を指定します。

複数の NDMP ホストクレデンシャルの削除は、このホストと指定のファイラに固有のクレデンシャルにのみ適用されます。デフォルトのクレデンシャルまたはファイラのクレデンシャルには適用されません。

次の例では、ページ制限のため、入力するコマンドを複数の行で示します。実際のコマンドは 1 行で入力します。

例 1 - Windows ローカルサーバーでのロボット制御

次の例では、直接 Windows ホストに接続されるロボットを追加し、そのロボットにドライブを追加します。

次の手順は、NetBackup サーバーだけに適用されます。

  • 次のコマンドを実行して、ロボットを追加します。

    # tpconfig -add -robot 7 -robtype tld -port 0 -bus 0 -target 2 lun 0
  • 構成されていないロボットにドライブが存在する場合、ドライブを追加します。

    次のコマンドを実行すると、手順 1 で構成したロボットに制御されている Tape0 というシステム名を持つドライブが構成されます。 (Tape0 はサーバーによって接続および認識されています。)

    # tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3  /
    -lun 4 -comment "DEC  DLT2000 8414" -index 0 -drstatus up  /
    -robot 7 -robtype tld -robdrnum 1 -asciiname DLT2000_D1

    この例のコマンドでは、[コメント (Comment)]フィールドを使用します。このフィールドは、ドライブの SCSI 照会データを格納する場合に有効で、ドライブ形式およびファームウェアのレベルを簡単に確認できます。

  • 現在、ロボットにスタンドアロンドライブとして構成されているドライブが存在する場合には、ドライブ構成を更新して、これらのドライブをロボットで制御します。

    次のコマンドを実行すると、ドライブ 1 および 2 の構成が更新されます。

    # tpconfig -update -drive 1 -type dlt -robot 7 -robtype tld 
    -robdrnum 1
    # tpconfig -update -drive 2 -type dlt -robot 7 -robtype tld 
    -robdrnum 2

メモ:

ドライブに適切なロボットドライブ番号を割り当てます。ロボットドライブ番号が不適切な場合、テープのマウントまたはバックアップが実行されない場合があります。

例 2 - リモートホストでのロボット制御

この例は、NetBackup Enterprise Server だけに適用されます。

現在デバイスを管理している Windows ホストに、ロボットに存在する 1 台以上のテープドライブを接続すると想定します。

別のホストに接続されるロボットを追加する、tpconfig 操作のシーケンスを次に示します。

  • 次のコマンドを実行して、ロボットを追加します。

    # tpconfig -add -robot 9 -robtype tld -cntlhost perch

    ロボット番号が制御ホスト上のロボット番号と一致することを確認します。

  • 現在、ロボットにスタンドアロンとして構成されているドライブが存在する場合には、ドライブ構成を更新して、これらのドライブをロボットで制御します。

    次のコマンドを実行すると、ドライブ 1 および 2 の構成が更新されます。

    # tpconfig -update -drive 1 -type dlt -robot 9 -robtype tld 
    -robdrnum 1
    # tpconfig -update -drive 2 -type dlt -robot 9 -robtype tld 
    -robdrnum 2

    メモ:

    適切なロボットドライブ番号を割り当てます。ロボットドライブ番号が不適切な場合、テープのマウントまたはバックアップが実行されない場合があります。

  • 構成されていないドライブがロボットに存在する場合、ドライブを追加します。

    次のコマンドを実行すると、手順 1 で構成したロボットに制御されている Tape0 というシステム名を持つドライブが構成されます。 (Tape0 は Windows サーバーによって接続および認識されています。)

    # tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3 -lun 4 
    -comment 'DEC   DLT2000 8414' -index 3 -drstatus up -robot 9 
    -robtype tld -robdrnum 3 -asciiname DLT2000_D3

例 3 - 新しいスタンドアロンドライブの構成

次の例では、ドライブをインストールした後にスタンドアロンドライブを追加する方法を示します。

# tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3 -lun 4 
-comment 'DEC   DLT2000 8414' -index 6 -asciiname DLT2000_standalone

例 4 - Windows デバイスパスの表示

次に、-l オプションによって {p,b,t,l} 形式で表示される Windows デバイスパスの例を示します。

C:\Program Files\VERITAS\Volmgr\bin>tpconfig -l
Device Robot Drive       Robot                    Drive                Device
Type     Num Index  Type DrNum Status  Comment    Name                 Path
robot      0    -    TLD    -       -  -          -                    {3,1,0,1}
robot      1    -    TLD    -       -  -          -                    {3,1,0,3}
robot      2    -    TLD    -       -  -          -                    {3,1,2,0}
drive      -    0    pcd    -  DISABL  -          SONY.SDX-400V.000    {1,0,0,0}
drive      -    1 hcart2    2      UP  -          IBM.ULTRIUM-TD2.001  {3,1,0,2}
drive      -    1 hcart2    2      UP  -          IBM.ULTRIUM-TD2.001  {3,1,1,2}
drive      -    2 hcart2    1      UP  -          IBM.ULTRIUM-TD2.002  {3,1,0,5}
drive      -    2 hcart2    1      UP  -          IBM.ULTRIUM-TD2.002  {3,1,1,5}
drive      -    3  hcart    1    DOWN  -          IBM.ULTRIUM-TD1.003  {3,1,0,6}
drive      -    3  hcart    1      UP  -          IBM.ULTRIUM-TD1.003  {3,1,1,6}
drive      -    4  hcart    2      UP  -          IBM.ULTRIUM-TD1.004  {3,1,0,7}
drive      -    4  hcart    2      UP  -          IBM.ULTRIUM-TD1.004  {3,1,1,7}
drive      -    5 hcart2    2      UP  -          IBM.ULTRIUM-TD2.005  {3,1,2,1}
drive      -    6 hcart2    1      UP  -          IBM.ULTRIUM-TD2.006  {3,1,2,2}