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

名前

vxlogcfg — 統合ログ機能の構成設定の変更

概要

vxlogcfg -a -p ProductID -c ConfigPath -n Names [-q]

vxlogcfg -a -p ProductID -o OriginatorID -s keyname=value [-q]

vxlogcfg -a -p ProductID -g LogSet -s keyname=value [-q]

vxlogcfg -d -p ProductID

vxlogcfg -l [-p ProductID [-o OriginatorID]] [-q]

vxlogcfg -l [-p ProductID [-g LogSet]] [-q]

vxlogcfg -r -p ProductID [-o OriginatorID] [-s keyname] [-q]

vxlogcfg -r -p ProductID [-g LogSet] [-s keyname] [-q]

vxlogcfg -v

 

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\

説明

vxlogcfg コマンドは NetBackup の統合ログ機能のログの設定の変更に使用します。このコマンドによって、インストールおよびアンインストール時に製品のログ構成の登録または登録解除が行われます。

統合ログ機能では、ログファイルに次の共通の命名形式が使用されます。

productID-originatorID-hostID-date-rotation.log

統合ログ機能の命名形式およびオリジネータ ID について詳しくは、『NetBackup ログリファレンスガイド』を参照してください。

オプション

このオプションは、製品のログ構成の登録または登録解除を指定します。すべてのディレクトリパスには、フルパス名を使用します。ディレクトリ名に空白が含まれる場合は、そのディレクトリのパス名を二重引用符で囲みます ("Program Files" ディレクトリなど)。

-a, --add

このオプションを指定すると、製品のログ構成の設定が登録または作成されます。既存のログ設定は上書きされます。このオプションを使用して、統合ログ機能を使用する製品をリストに追加しないでください。代わりに、このオプションは、統合ログ機能の既存の設定を変更するためだけに使用してください。詳しくは、例を参照してください。

-c, --config ConfigPath

このオプションでは、製品のログ構成設定の読み込み元の絶対パスを指定します。

UNIX システムでは、製品のログ構成ファイルへの絶対パスを使います (たとえば、/opt/vrts/ProductA/log.conf)。

Windows システムでは、製品のログ設定レジストリへのパスを使用します (たとえば、\\SOFTWARE\VERITAS\PRODUCTA\)。

-d, --delete

このオプションを指定すると、製品用に構成されたオリジネータ ID がない場合に、メインログ構成ファイルから製品のログ構成設定が登録解除され、削除されます。対応する製品のログ構成ファイルも削除されます。

-g, --logset LogSet

指定した LogSet のログ構成設定を作成または修正します。LogSet は、テキスト文字列「Default」またはテキスト文字列「ALL」で指定されます。LogSet に Default を指定すると、-s の構成設定がデフォルト設定になります。LogSet に ALL を指定すると、-s の構成設定は、指定したプロダクト ID のすべてのオリジネータに適用されます。

-l, --list

次のいずれかが表示されます。

  • 構成されたすべての製品。

  • すべてのオリジネータ ID と LogSet

  • プロダクト ID とオリジネータ ID のペアまたはプロダクト ID と LogSet のペアに定義されているすべての設定

-n, --names Name

製品の略称または短縮名が指定されます。複数の名前はカンマで区切ります。

-o, --orgid OrgID

指定したオリジネータ ID のログ構成設定が作成または修正されます。オリジネータ ID には有効なオリジネータ ID (番号)、テキスト文字列「Default」またはテキスト文字列「ALL」を指定できます。オリジネータ ID に Default を指定すると、-s の構成設定がデフォルト設定になります。オリジネータ ID に ALL を指定すると、-s の構成設定は、指定したプロダクト ID のすべてのオリジネータに適用されます。

-p, --prodid ProductID

このオプションを指定すると、productID のログ構成設定を作成または変更できます。

-q, --quiet

このオプションを指定すると、エラーメッセージまたは情報メッセージが表示されなくなります (抑止モード)。

-r, --remove

製品のログ構成ファイルから、指定された OID および製品用のログ構成設定が登録解除され、削除されます。個々の設定は "-s, --setting keyname=value" オプションを使用して削除できます。

注意:

-r オプションは常に -o オプションと組み合わせて使用します。そのようにしないと、既存のすべての NetBackup ログ設定が削除され、その後 NetBackupのすべてのログが実行されなくなります。

-s, --setting keyname=value

このオプションを指定すると、-a (追加オプション) と組み合わせるときの個々の構成設定が設定されます。keyname には構成設定の名前を、value には設定する値を指定します。コマンドラインで、複数の -s keyname=value 引数を使用できます。

-s, --setting keyname

このオプションを -r オプションと組み合わせて使用すると、構成設定が削除されます。-r オプションでは 1 つのキー名のみを使用します。複数の設定を削除するには、複数の -s オプションを指定します。特定のキーの名前については、「キーの名前および値」の項を参照してください。

-v, --version

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

キーの名前および値

次に、-s オプションで指定できるキーの名前および値を示します。NetBackup の場合は、vxlogcfg コマンドを実行すると、UNIX の /usr/openv/netbackup/nblog.conf ファイルおよび Windows の install_path\NetBackup\nblog.conf にキーの名前および値が格納されます。PBX の場合は、UNIX の /etc/vx/VxICS/icsul.conf および Windows のレジストリエントリ SOFTWARE\Veritas\VxICS\logcfg にキーの名前および値が格納されます。

UNIX および Windows のキーの名前および値

LogDirectory

ディレクトリへの絶対パスまたは相対パスを指定します。デフォルト値は存在しません。オリジネータ ID に相対パスを指定する場合は、ログ構成ファイルの Default.LogDirectory に指定されているプロダクト ID のログディレクトリの相対パスを指定します。

注意:

LogDirectory キー名を使って統合ログを代替ディレクトリにリダイレクトする場合は、NetBackup サービスを停止してから再起動します。この操作によってリダイレクトが有効になります。

DebugLevel

デバッグログメッセージの詳細レベルを設定します(デバッグログは、Veritas の技術者が使用します)。有効な値は、0 から 6 です。

DiagnosticLevel

診断ログメッセージの詳細レベルを設定します(診断ログは、NetBackup の管理者およびユーザーが使用します)。有効な値は 0 から 6 です。0 (ゼロ) はデバッグメッセージがないことを意味します。

DynaReloadInSec

デバッグおよび診断設定が動的に再ロードされます。0 から 60 までの整数を指定した場合は、60 秒後に再ロードされます。60 を超える整数を指定した場合は、指定した秒数で再ロードされます。

LogToStdout

すべてのログメッセージが、標準出力 (デフォルトでは端末) とログファイルに送信されます。有効な値は、true および false (デフォルト値) です。

LogToStderr

アプリケーションログメッセージが、Stderr (デフォルトでは端末) とログファイルに送信されます。有効な値は、true および false (デフォルト値) です。

LogToOslog

アプリケーションログメッセージをオペレーティングシステムのログ (UNIX の場合は syslog、Windows の場合はイベントログ) に送信します。有効な値は、true および false (デフォルト値) です。

RolloverMode

ログファイルをロールオーバータイミングを指定します。ログファイルを切り替えると、現在のログファイルが閉じて、新しいログファイルが開きます。これによって、保持するログファイルのサイズを小さくして、古いログファイルを削除またはアーカイブできます。有効な値は、FileSize、LocalTime、Periodic、FileSize | LocalTime、FileSize | Periodic、None です。

FileSize を指定すると、MaxLogFileSizeKB で設定したサイズに達したときにログファイルが切り替えられます。デフォルト値は、FileSize です。

LocalTime を指定すると、日に 1 回、RolloverAtLocalTime で指定した時間にログファイルをロールオーバーします。

Periodic を指定すると、RolloverAtLocalTime で指定した秒数が経過したときにログファイルをロールオーバーします。

FileSize | LocalTime を指定すると、FileSize または LocalTime のいずれかの値に達したときにログファイルが切り替えられます。

FileSize | Periodic を指定すると、FileSize または Periodic のいずれかの値に達したときにログファイルが切り替えられます。

None を指定すると、ログファイルはロールオーバーされません。

MaxLogFileSizeKB

RolloverModeFileSize を設定した場合に、ログファイルが切り替えられる最大サイズを指定します。有効な値は、1 から 4294967295 です。デフォルト値は 51200 (51.2 MB) です。

RolloverPeriodInSeconds

RolloverMode に Periodic を設定した場合に、ログファイルがロールオーバーされるまでの時間を秒数で指定します。有効な値は、1 から 2147483648 です。デフォルト値は 43200 (12 時間)です。

RolloverAtLocalTime

RolloverMode に LocalTime を設定した場合に、ログファイルがロールオーバーされる時刻を指定します。有効な値は 00:00 から 23:59 です。デフォルト値は 00:00 (ローカル時間の午前 0 時) です。

NumberOfLogFiles

統合ログ機能の各オリジネータのログディレクトリ内に保持するファイルの最大数を指定します。有効な値は、1 から 4294967295 です。

vxlogmgr --auto コマンドでは、NumberOfLogFiles を使用して、削除または移動するログファイルの数を決定します。最も古いファイルから削除または移動されます。たとえば、ログディレクトリに特定のオリジネータが作成したファイルが 7 つあり、NumberOfLogFiles が 5 に設定されている場合、vxlogmgr --auto --del コマンドはオリジネータが作成した最も古い 2 つのファイルを削除します。

LogRecycle

有効な値は、true および false です。デフォルト値は false です。true を設定した場合には、ログファイルの数は NumberOfLogFiles を超えません。

OIDNames

-o オプションで指定した統合ログ機能のオリジネータの代替名を 1 つ以上指定します。これらの名前は、vxlogview コマンドを使用した検索の実行時に、オリジネータ ID の代わりとして使用できます。各名前は、最大 80 文字で指定できます。複数の名前を、空白で区切って指定できます。

L10nLib

外部ローカライゼーションライブラリの絶対パスおよびファイル名を指定します。このオプションは Veritas 内でのみ使用されます。このオプションを使用すると、統合ログ機能が無効になる場合があります。

L10nResource

統合ログ機能を使用する製品またはオリジネータに関連付けるローカライゼーションリソースの名前を指定します。このオプションは Veritas 内でのみ使用されます。このオプションを使用すると、統合ログ機能が無効になる場合があります。

L10nResourceDir

統合ログ機能を使用する製品またはオリジネータに関連付けるローカライゼーションリソースディレクトリの名前を指定します。このオプションは Veritas 内でのみ使用されます。このオプションを使用すると、統合ログ機能が無効になる場合があります。

次の 4 つのキー名は UNIX システムでのみ動作します。

LogFilePermissions

UNIX ファイルの権限を 8 進数で指定します。この権限は、-o オプションで指定したオリジネータによって作成されたログファイルに割り当てられます。多くの場合、このオプションを使用する必要はありません。

SyslogIdent

LogToOslog を true に設定した場合は、各 syslog メッセージの最初に付加する文字列を指定します。SyslogIdent には、80 文字までの任意の文字列を指定できます。多くの場合、このオプションを使用する必要はありません。

SyslogOpt

syslog openlog 関数に渡される syslog オプションの値を指定します。LogToOslog が有効な場合には、ログメッセージを UNIX の syslog に送信します。有効な値は、0 から 4294967295 です。多くの場合、このオプションを使用する必要はありません。

SyslogFacility

syslog に送信されたログメッセージに関連付ける syslog 機能値を指定します。LogToSyslog が有効な場合には、ログメッセージを syslog に送信します。多くの場合、このオプションを使用する必要はありません。

有効な値は、LOG_KERN、LOG_USER、LOG_MAIL、LOG_DAEMON、LOG_AUTH、LOG_LPR、LOG_NEWS、LOG_UUCP、LOG_CRON、LOG_LOCAL0、LOG_LOCAL1、LOG_LOCAL2、LOG_LOCAL3、LOG_LOCAL4、LOG_LOCAL5、LOG_LOCAL6、LOG_LOCAL7 です。デフォルトは LOG_USER です。

次の 3 つのキー名は Windows システムでのみ動作します。

NtEventLogCategory

LogToOslog が有効な場合に、Windows のイベントログに送信するログメッセージに関連付けるカテゴリ番号を指定します。多くの場合、このオプションを使用する必要はありません。

LogFileSDDL

Windows セキュリティ記述子定義言語 (SDDL) 文字列を指定します。この文字列は、-o オプションで指定したオリジネータによって作成されたログファイルのアクセス制御リスト (ACL) を設定します。多くの場合、このオプションを使用する必要はありません。

NtEventLogSourceName

Windows で LogToOslog オプションが有効な場合に、ログメッセージを送信する Windows イベントログを指定します。このオプションは、内部だけで使用されます。このオプションを使用すると、統合ログ機能が無効になる場合があります。

例 1 - UNIX で NetBackup の LogDirectory およびオリジネータ ID 111 を設定します。

# vxlogcfg -a --prodid 51216 --orgid 111 -s 
LogDirectory=/usr/openv/logs

例 2 - NetBackup内の統合ログ機能を使用しているすべてのオリジネータに DebugLevel および DiagnosticLevel を設定します。

# vxlogcfg -a --prodid 51216 -o ALL -s DebugLevel=3 -s 
DiagnosticLevel=3

例 3 - プロダクト ID 1 にデフォルトの RolloverMode を設定します。

# vxlogcfg -a --prodid 1 -o Default -s RolloverMode=FileSize

例 4 - プロダクト ID 1 のオリジネータ 2 の構成設定を表示します。

# vxlogcfg -l --prodid 1 --orgid 2

例 5 - プロダクト ID 1 に構成されたすべてのオリジネータをリスト表示します。

# vxlogcfg -l --prodid 1

例 6 - すべての構成された製品をリスト表示します。

# vxlogcfg -l

ファイル

UNIX システムの場合:

/usr/openv/netbackup/nblog.conf
/etc/vx/VxICS/icsul.conf

関連項目

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

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