Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.2)
  1. 介绍
    1.  
      关于 NetBackup 命令
    2.  
      浏览多个菜单级别
    3.  
      NetBackup 命令约定
    4.  
      NetBackup 介质管理器命令说明
    5.  
      IPv6 更新
  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.  
      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.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCertsForPlugins
    85.  
      configureMQ
    86.  
      configurePorts
    87.  
      configureWebServerCerts
    88.  
      create_nbdb
    89.  
      csconfig cldinstance
    90.  
      csconfig cldprovider
    91.  
      csconfig meter
    92.  
      csconfig throttle
    93.  
      csconfig reinitialize
    94.  
      duplicatetrace
    95.  
      importtrace
    96.  
      jbpSA
    97.  
      jnbSA
    98.  
      ltid
    99.  
      manageClientCerts
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcatsync
    103.  
      NBCC
    104.  
      NBCCR
    105.  
      nbcertcmd
    106.  
      nbcertupdater
    107.  
      nbcldutil
    108.  
      nbcloudrestore
    109.  
      nbcomponentupdate
    110.  
      nbcplogs
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdbms_start_server
    118.  
      nbdbms_start_stop
    119.  
      nbdc
    120.  
      nbdecommission
    121.  
      nbdelete
    122.  
      nbdeployutil
    123.  
      nbdevconfig
    124.  
      nbdevquery
    125.  
      nbdiscover
    126.  
      nbdna
    127.  
      nbemm
    128.  
      nbemmcmd
    129.  
      nbfindfile
    130.  
      nbfirescan
    131.  
      nbftadm
    132.  
      nbftconfig
    133.  
      nbgetconfig
    134.  
      nbhba
    135.  
      nbholdutil
    136.  
      nbhostidentity
    137.  
      nbhostmgmt
    138.  
      nbhypervtool
    139.  
      nbimageshare
    140.  
      nbinstallcmd
    141.  
      nbjm
    142.  
      nbkmsutil
    143.  
      nboraadm
    144.  
      nborair
    145.  
      nbpem
    146.  
      nbpemreq
    147.  
      nbperfchk
    148.  
      nbplupgrade
    149.  
      nbrb
    150.  
      nbrbutil
    151.  
      nbregopsc
    152.  
      nbreplicate
    153.  
      nbrepo
    154.  
      nbrestorevm
    155.  
      nbseccmd
    156.  
      nbsetconfig
    157.  
      nbsnapimport
    158.  
      nbsnapreplicate
    159.  
      nbsqladm
    160.  
      nbstl
    161.  
      nbstlutil
    162.  
      nbstop
    163.  
      nbsu
    164.  
      nbsvrgrp
    165.  
      resilient_clients
    166.  
      restoretrace
    167.  
      stopltid
    168.  
      tl4d
    169.  
      tl8d
    170.  
      tl8cd
    171.  
      tldd
    172.  
      tldcd
    173.  
      tlhd
    174.  
      tlhcd
    175.  
      tlmd
    176.  
      tpautoconf
    177.  
      tpclean
    178.  
      tpconfig
    179.  
      tpext
    180.  
      tpreq
    181.  
      tpunmount
    182.  
      verifytrace
    183.  
      vltadm
    184.  
      vltcontainers
    185.  
      vlteject
    186.  
      vltinject
    187.  
      vltoffsitemedia
    188.  
      vltopmenu
    189.  
      vltrun
    190.  
      vmadd
    191.  
      vmchange
    192.  
      vmcheckxxx
    193.  
      vmd
    194.  
      vmdelete
    195.  
      vmoprcmd
    196.  
      vmphyinv
    197.  
      vmpool
    198.  
      vmquery
    199.  
      vmrule
    200.  
      vmupdate
    201.  
      vnetd
    202.  
      vssat
    203.  
      vwcp_manage
    204.  
      vxlogcfg
    205.  
      vxlogmgr
    206.  
      vxlogview
    207.  
      W2KOption

名称

nbemmcmd — 更新和查看 EMM 数据库中的信息

大纲

nbemmcmd [-addhost] [-changesetting] [-deletehost] [-errorsdb] [-getemmserver] [-help] [-listhosts] [-listmedia] [-listsettings] [-machinealias] [-renamehost] [-resethost] [-servercontrol] [-setemmserver] [-updatehost]

nbemmcmd -addhost [-activenodename string] [-brief] [-clustername string] [-displayname string] [-machinedescription string] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows] [-scanability unsigned_integer]

nbemmcmd -changesetting -machinename string [-ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 0|1|no|yes] [-AUDIT DISABLED | ENABLED] [-AUDIT_ RETENTION_PERIOD number_of_days] [-COMMON_SERVER_FOR_DUP default | preferred | required] [-DISABLE_AUTOMATIC_HOST_NAME_ADD 0|1|no|yes] [-DISABLE_BACKUPS_SPANNING_DISK 0|1|no|yes] [-DISABLE_DISK_STU_JOB_THROTTLING 0|1|no|yes] [-DISABLE_STANDALONE_DRIVE_EXTENSIONS 0|1|no|yes] [-DISALLOW_NONNDMP_ON_NDMP_DRIVE 0|1|no|yes] [-DO_NOT_EJECT_STANDALONE 0|1|no|yes] [-DONT_USE_SLAVE 0|1|no|yes] [-DRIVE_ERROR_THRESHOLD unsigned_integer] [-DRIVE_NAME_SEED 0|1|no|yes] [-emmname string] [-emmport unsigned_integer] [-MAX_REALLOC_TRIES unsigned_integer] [-MEDIA_ERROR_THRESHOLD unsigned_integer] [-MEDIA_REQUEST_DELAY unsigned_integer] [-MPMS_DISABLE_EVENTS 0|1|no|yes] [-MPMS_DISABLE_RANK unsigned_integer] [-MUST_USE_LOCAL_DRIVE 0|1|no|yes] [-NBUFS_DESTINATION_DSU string] [-NBUFS_DUP_TSU_TO_DSU 0|1|no|yes] [-NBUFS_RETENTION_LEVEL unsigned_integer] [-NON_ROBOTIC_MEDIA_ID_PREFIX string] [-PREFER_NDMP_PATH_FOR_RESTORE 0|1|no|yes] [-RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL 0|1|no|yes] [-SCSI_PROTECTION NONE | SPR | SR] [-SHAREDISK_MOUNT_POINT string] [-TIME_WINDOW unsigned_integer] [-UNRESTRICTED_SHARING 0|1|no|yes] [-USE_POTENTIAL_FREESPACE_FOR_ALLOCATION 0|1|no|yes] [-VALIDATE_HOST_NAME 0|1|no|yes] [-VAULT_CLEAR_MEDIA_DESC 0|1|no|yes]

nbemmcmd -deletealldevices [-allrecords] | [-machinename string] | [-machinetype api | app_cluster | appliance | client | cluster | disk_array | foreign_media | master | media | nbwss_endpoint | ndmp | remote_master | replication_host | virtual_machine] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -deletehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp | master | media | ndmp-mediaid string

nbemmcmd -errorsdb [-brief] [-prune [-days no_of_days] [-hours no_of_hours] [-minutes no_of_minutes]]

nbemmcmd -getemmserver [-masterserver string] [-timeout unsigned_integer]

nbemmcmd -listhosts [-brief] [-verbose] [-parsable] [-list_snap_vault_filers -machinename string] [-list_snap_vault_media_servers -masterserver string] [-list_sts_hosts -machinename string] [-list_sts_media_servers -masterserver string] [-list_app_clusters -masterserver string] [-servers_in_emm_cluster -clustername string] [-servers_in_app_cluster -clustername string] [-nbservers [-masterserver string]] [-display_server -machinename string -machinetype string] [-netbackupversion level[.major_level[minor_level]]]

nbemmcmd -listmedia [-allrecords] [-mediaid string] [-mediatype unsigned_integer] [-poolname string] [-robotnumber unsigned integer] [-vaultcontainer string]

nbemmcmd -listsettings -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -machinealias [-addalias -alias string -machinename string] [-deletealias -alias string] [-deleteallaliases -machinename string] [-getaliases -machinename string] -machinetype api | app_cluster | cluster | master | media | ndmp

nbemmcmd -releasecache -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -renamehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp -newmachinename string

nbemmcmd -resethost -machinename string

nbemmcmd -servercontrol [-brief] [-resume] [-suspend]

nbemmcmd -setemmserver [-brief] -emmservername string [-masterserver string] -newemmservername string [-timeout unsigned_integer]

nbemmcmd -updatehost [-activenodename string] [-add_server_to_app_cluster] [-brief] [-clustername string] [-delete_server_from_app_cluster] [-displayname string] [-machinedescription string] -machinename string [-machinestateop clr_admin_pause | clr_admin_pause_and_set_active | clr_disk_active | clr_ltid_restart | clr_master_server_connectivity | clr_tape_active | reset_all | set_admin_pause | set_disk_active | set_master_server_connectivity | set_tape_active] [-machinetype pi | app_cluster | cluster | master | media | ndmp] [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows]

 

在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/

在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\

描述

用户可以使用 nbemmcmd 命令更新一组有限的 EMM 数据库信息。此外,还可以使用此命令来管理 EMM 数据库中的主机条目、配置选项和其他杂项。

选项

以下命令包含很多选项,可以使用这些选项来管理 EMM 数据库。这些选项有意使用较长的名称,以使用户更好地了解选项的用途。选项名称很长,不过您只要键入命令的首字母或前几个字母,使该选项成为唯一选项即可。例如,要使用 -changesetting 选项,请键入 -c,原因是没有其他命令选项以字母 c 开头。

-addhost

此选项将指定的主机添加到 EMM 数据库中。可以使用此命令选项来调整以下条目:

-activenodename string

标识群集中的活动节点。

-brief

使命令输出简略一些。

-clustername string

标识计算机所属的群集。

-displayname string

设置计算机的显示名称。

-machinedescription string

描述使用的计算机或系统。

-machinename string

指定要更新的计算机的名称。

-machinetype api | app_cluster | cluster | master | media | ndmp

定义计算机的使用方式。

-masterserver string

在特定的域中定义主服务器主机。

-netbackupversion level[.major_level[minor_level]]

指定添加的主机运行的版本。level 变量的范围是 0-99。major_levelminor_level 变量是可选的单数字字段。major_levelminor_level 变量之间不允许有空格。

例如,可以输入以下信息指定 NetBackup 7.0:

-netbackupversion 7.0 or -netbackupversion 7
-operatingsystem hpux | linux | rs6000 | solaris | windows

添加使用指定操作系统的主机。

-scanability unsigned_integer

该选项仅应用于使用 Shared Storage Option (SSO) 功能的 NetBackup Enterprise Server。

扫描能力系数的范围为从 0 到 9,默认值是 5。此系数用于在更改驱动器的扫描主机时按优先级分配扫描主机。首先选择具有更高扫描能力系数的扫描主机。

小心:

仅在分配了扫描主机后驱动器才可用。如果为特定驱动器注册的所有主机都使用 scan_factor = 0,则该驱动器不可用。该驱动器将保持不可用,直到为该驱动器注册的主机使用不为零的 scan_factor 为止。如果 scan_factor 不为零的所有主机都将该驱动器“关闭”,则该驱动器将再次变得不可用。

将服务器的 scan_factor 设置为零会降低 SSO 配置的弹性级别。请注意可能成为驱动器扫描主机的服务器。如果驱动器丢失了扫描主机,则该驱动器对任何服务器均不可用。

-changesetting -machinename string

更改指定主机的配置设置,并添加以前不存在的设置。

要更改这些配置选项,请将 -changesetting 与选项名称以及启用标识符(1 或 yes)或禁用标识符(0 或 no)一起使用。例如,以下命令会禁用 EMM 自动添加主机名的能力:

# nbemmcmd -changesetting -DISABLE_AUTOMATIC_HOST_NAME_ADD no
-ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 0 | 1 | no | yes

允许 NetBackup 混合使用介质保留级别。默认情况下,每个卷只能包含单个保留级别的备份。

-AUDIT [DISABLED | ENABLED]

启用和禁用 NetBackup 审核。审核跟踪是对 NetBackup 环境中用户启动的操作进行记录。审核收集并记录信息以帮助回答操作的更改者、更改内容以及更改时间。默认情况下会启用审核。

-AUDIT_RETENTION_PERIOD number_of_days

指定要为审核报告保留用户操作的天数。如果没有指定任何保留期限,则审核保留期限默认为 90 天。值为 0(零)表示始终不会清除记录。

-COMMON_SERVER_FOR_DUP default | preferred | required

确定 NetBackup 如何查找复制数据所需的介质服务器。

用于读取映像的介质服务器是“读取介质服务器”。用于写入映像的介质服务器是“写入介质服务器”。默认情况下,当源映像位于磁带设备上时,读取介质服务器就是写入备份映像的介质服务器。此外,当源映像位于多个介质服务器共享的磁盘池上时,其中的任一介质服务器都可以用作读取介质服务器。选择写入介质服务器时仅限于可以访问指定为复制操作目标的存储单元或存储单元组的介质服务器。

以下是此选项可能的设置:

  • 这是默认选项。NetBackup 不执行可能的通用服务器(读取和写入介质服务器相同)的穷举搜索。如果通用介质服务器繁忙或不可用,NetBackup 将使用不同于读取介质服务器的写入介质服务器。如果不希望穷举搜索影响资源代理的性能,请使用此选项。当等待资源变为可用的复制作业队列较大时,可能会发生此种情形。

  • 首选。查找要使用的通用介质服务器。如果找到了一个或多个通用介质服务器,但是它们的资源(例如,DSU 或磁带驱动器和磁带)是繁忙的,请执行以下操作:使用两个不同的介质服务器来运行复制作业(通过网络发送映像)。

  • 必需。NetBackup 执行穷举搜索以查找通用服务器。如果通用介质服务器繁忙,NetBackup 将对资源请求进行排队以等待资源变为可用。如果存在以下情况,则 NetBackup 将使用两个不同的介质服务器运行作业,通过网络发送映像:NetBackup 域中不存在任何通用服务器,或者,如果存在通用服务器但已关闭。

-DISABLE_AUTOMATIC_HOST_NAME_ADD 0|1|no|yes

禁用 EMM 在主机名无效时自动添加主机名的能力。无效主机名的一个示例是与另一台主机重名的名称。

-DISABLE_BACKUPS_SPANNING_DISK 0|1|no|yes

在磁盘存储单元卷文件系统已满的情况下,禁用继续对磁盘执行备份操作的能力。禁用是通过使用多个存储单元卷的映像片段实现的。

-DISABLE_DISK_STU_JOB_THROTTLING 0|1|no|yes

磁盘存储单元接近高位标记时,禁用磁盘存储单元作业限制操作。磁盘存储单元控制会限制同时启动的作业的数量以更准确地接近高位标记。默认值:限制接近高位标记的磁盘存储单元。

-DISABLE_STANDALONE_DRIVE_EXTENSIONS 0|1|no|yes

禁用非机械手驱动器操作。在备份期间,NetBackup 不自动尝试使用在非机械手驱动器中找到的任何已标注或未标注的介质。默认情况下会启用独立驱动器扩展。

-DISALLOW_NONNDMP_ON_NDMP_DRIVE 0|1|no|yes

EMM 服务器上的 MDS 逻辑可以读取此选项。NetBackup 尝试根据请求类型使用可用的驱动器,如下所示:

对于任意类型的非 NDMP 请求,NetBackup 总是试图找到可用的非 NDMP 驱动器。如果非 NDMP 驱动器不可用,而 NDMP 驱动器可用,则将使用较慢的 NDMP 驱动器。非 NDMP 请求包括所有类型的请求,但与存储单元有关的请求(备份和副本的写入端)和 NDMP 映像还原除外。

-DO_NOT_EJECT_STANDALONE 0|1|no|yes

如果启用此条目,完成主机上的备份时将不弹出独立驱动器中的磁带。(如果备份过程中达到介质末尾则弹出磁带)。如果您希望成功执行备份后使独立驱动器保持就绪状态,可以使用此选项。

-DONT_USE_SLAVE 0|1|no|yes

取消选择使用驱动器名称规则以自动为驱动器分配名称。

-DRIVE_ERROR_THRESHOLD unsigned_integer

更改 NetBackup 将驱动器状态更改为“关闭”之前允许出现的驱动器错误的阈值或数量。默认值:2。

-DRIVE_NAME_SEED 0|1|no|yes

选择使用驱动器名称规则以自动为驱动器分配名称。

-emmname string

指定 EMM 数据库服务器的名称。该服务器包含存储介质信息和设备配置信息的数据库。

-emmport unsigned_integer

指定 EMM 端口。

-machinename string

设置发生更改的计算机的名称。

-MAX_REALLOC_TRIES unsigned_integer

指定 NetBackup 尝试重新分配用于将来备份的介质的最多次数。

-MEDIA_ERROR_THRESHOLD unsigned_integer

更改冻结介质前允许出现的介质错误的阈值或数量。默认值:2。

-MEDIA_REQUEST_DELAY unsigned_integer

指定 NetBackup 在驱动器就绪之前等待的秒数。仅适用于非机械手驱动器。默认值:0 秒。例如,假定延迟是 150 秒:

MEDIA_REQUEST_DELAY = 150

将该信息添加到 NetBackup 服务器上的 bp.conf 文件中,或在介质主机属性中为“介质请求延迟”输入一个值。

-MPMS_DISABLE_EVENTS 0|1|no|yes, -MPMS_DISABLE_RANK 0|1|no|yes, -MUST_USE_LOCAL_DRIVE 0|1|no|yes

如果客户端也是一台主服务器并且此选项处于活动状态,则该客户端的备份必须在本地驱动器上进行。如果客户端不是主服务器,则此条目无效。

将该选项添加到主服务器上的 bp.conf 文件中。或者在“常规服务器”主机属性对话框中选中“必须使用本地驱动器”设置。

-NBUFS_DESTINATION_DSU string, -NBUFS_DUP_TSU_TO_DSU 0|1|no|yes, -NBUFS_RETENTION_LEVEL unsigned_integer, -NON_ROBOTIC_MEDIA_ID_PREFIX string

指定创建非机械手介质时使用的介质 ID 前缀。适用于由 -machinename 选项指定的主机。该介质 ID 前缀是一个长度为一到三个字符的字母数字字符串。

-PREFER_NDMP_PATH_FOR_RESTORE 0|1|no|yes, -RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL 0|1|no|yes

此 EMM 全局选项适用于使用 EMM 服务器的每台主机。它不是一个主机选项。

是:介质管理器自动将最初来自临时池的失效的和未分配的介质返回到该临时卷池。

NO:将禁用自动将介质返回临时池的行为。使用其中一个介质管理器管理界面来移动介质。

-SCSI_PROTECTION NONE | SPR | SR

允许进行磁带驱动器的独占访问保护。有了访问保护,其他主机总线适配器就无法在保留期间发出控制驱动器的命令。此选项的三个可能设置如下:

NONE – 无保护

SPR - SCSI 持久保留

SR - SPC-2 SCSI 保留(默认条件)

-TIME_WINDOW unsigned_integer

用于设置与跟踪错误的时间长度相等的值。可以将该值与错误阈值(如 media_error_threshold)一起使用,以监视在该时段内出现的介质错误数。默认设置为 12 小时。

-UNRESTRICTED_SHARING 0|1|no|yes

为所有介质服务器启用无限制的介质共享。

USE_POTENTIAL_FREESPACE_FOR_ALLOCATION 0|1|no|yes

允许对可用空间进行内存分配。高位标记通常会触发 BasicDisk 存储单元和磁盘池上的映像清理。在存储生命周期策略中达到“高位标记”时,这可以防止使用更多内存空间。

例如,“高位标记”为 90%,但是潜在可用空间为 50%。磁盘上剩余的可用空间只有超出“高位标记”的部分可以使用时,备份将失败。打开此参数 (1) 将允许使用潜在可用空间与“高位标记”之间的 40% 可用空间。

默认设置为否 (0)。

-VALIDATE_HOST_NAME 0|1|no|yes

启用基于 NetBackup 标准的主机名字符验证。如果禁用此选项,则您可以使用诸如 _host1 这种不符合标准的名称。

-VAULT_CLEAR_MEDIA_DESC 0|1|no|yes

此选项是应用于使用 EMM 服务器的每台主机的 EMM 全局选项。它不是一个主机选项。当 NetBackup 介质在典型磁带循环期间从场外保管库返回时,它将失效并且可由新备份重复使用。为避免造成混淆,最好在失效的磁带返回到机械手后清除旧的介质描述信息。如果指定了此条目,则在从介质管理器卷数据库清除其他保管库信息时,将清除该介质描述字段。

-deletealldevices

删除所有磁带设备。

-allrecords

删除所有计算机的所有磁带设备。您无法将此选项与 -machinename 选项结合使用。

-emmname string

EMM 服务器的名称。

-emmport unsigned_integer

EMM 服务器的端口号

-machinename string

删除挂接到指定介质服务器的所有磁带设备。您无法将此选项与 -allrecords 选项结合使用。

-machinetype api | app_cluster | appliance | client | cluster | disk_array | foreign_media | master | media | nbwss_endpoint | ndmp | remote_master | replication_host | virtual_machine

指定计算机名称的类型。您无法将此选项与 -allrecords 选项结合使用。

-deletehost

使用所需计算机名和计算机类型删除 EMM 计算机记录。

-brief

生成较为简略的命令输出。

-machinename string

从 EMM 数据库中删除指定的主机。

-Machinetype api | app_cluster | cluster | master | media | ndmp

根据类型标识要删除的计算机。

-errorsdb
-brief

生成较为简略的命令输出。

-prune [-days no_of_days] [-hours no_of_hours] [-minutes no_of_minutes]

从错误数据库中删除该条目。可选的天数、小时数和分钟数参数决定删除哪条数据库条目。它将删除任何早于指定时间的条目。

-getemmserver

显示特定 EMM 域中所有主机的相关信息。可以使用此命令来确保新安装或修改的域中的一致性级别。

-brief

生成较为简略的命令输出。

-masterserver string

指定 EMM 域的主服务器名称。在使用此命令时,如果省略该选项,则假定为当前计算机。

-timeout unsigned integer

指定在执行该命令的过程中使用的临时超时值(以秒为单位)。

-help

通过输入以下内容显示指定命令的用法信息:

nbemmcmd -help command
-listhosts

此选项可以为每个已知主机转储表结构。

-display_server -machinename string -machinetype string

仅显示根据计算机名和计算机类型指定的计算机。

-list_app_clusters -masterserver string

列出指定主服务器的所有应用程序群集。

-list_snap_vault_filers -machinename string

列出指定计算机名的所有 SnapVault 文件服务器(请参见后面的 -machinename 选项介绍)。

-list_snap_vault_media_servers -masterserver string

列出指定主服务器的所有 SnapVault 介质服务器。

-list_sts_hosts -machinename string

列出连接到指定计算机名的所有 OpenStorage 主机。

-list_sts_media_servers -masterserver string

列出连接到指定主服务器的所有 OpenStorage 介质服务器。

-machinename api | app_cluster | cluster | master | media | ndmp

定义要列出的计算机类型。

-nbservers -masterserver string

仅显示介质服务器和主服务器。-listhosts 的默认设置是显示所有服务器。

-netbackupversion level[.major_level[minor_level]]

指定计算机版本。level 变量的范围是 0-99。major_levelminor_level 变量是可选的单数字字段。major_levelminor_level 之间不允许有空格。

例如,可以输入以下信息指定 NetBackup 7.0:

-netbackupversion 7.0 or -netbackupversion 7
-servers_in_emm_cluster -clustername string

列出指定群集中的所有服务器:

-server_in_app_cluster -clustername string

列出指定群集的所有应用程序群集服务器。

-brief

使命令输出简略一些。

-parsable

使命令输出可分析。

-verbose

控制主机信息的显示方式。以多行格式输出,主机的每个参数各一行。

-listmedia
-allrecords

显示所有介质记录。

-mediaid string

指定 EMM 介质记录的介质 ID。

-mediatype unsigned integer

按介质类型查询卷。

NetBackup Enterprise Server 的有效介质类型包括:

4mm、8mm、8mm2、8mm3、dlt、dlt2、dlt3、dtf、hcart、hcart2、hcart3、qcart、4mm_clean、8mm_clean、8mm2_clean、8mm3_clean、dlt_clean、dlt2_clean、dlt3_clean、dtf_clean、hcart_clean、hcart2_clean、hcart3_clean。

NetBackup 服务器的有效介质类型包括:

4mm、8mm、dlt、hcart、qcart、4mm_clean、8mm_clean、dlt_clean、hcart_clean。

-poolname string

按池号(卷池的索引)查询卷。可以使用 vmpool -listall 来确定给定池名称的索引。

-robotnumber unsigned_integer

按机械手编号查询卷。机械手编号是卷所在的机械手的唯一逻辑标识号。

-vaultcontainer string

列出容器中存储的卷。string 变量是 vault_container_id,该字符串最长为 29 个字母数字字符。

-listsettings
-machinename string

指定要列出哪些计算机的设置。

-brief

生成较为简略的命令输出。

-emmname string

指定相关 EMM 服务器的主机名。如果未指定 -emmname,则默认名称位于 bp.conf 文件中。

-emmport unsigned_integer

指定对其执行调用的 EMM 服务器的端口号。如果未指定 -emmport,则会在 bp.conf 文件中指定默认端口。

-machinealias

以下参数用于为特定计算机维护别名列表。可以使用这些参数来查看指定计算机的当前别名、添加新别名或者删除当前别名。

-addalias -alias alias -machinename name -machinetype type

向计算机添加别名。确定要接受别名以及计算机类型的计算机名。

例如,要创建别名为 blue 的介质服务器,请使用以下命令:

machinealias -machinename 10.10.10.1 -machinetype media 
-addalias -alias blue
-deletealias -alias name -machinetype type

删除数据库中的别名。此操作要求使用 -alias string 命令指定要删除的别名,并用此选项指定计算机类型。

-deleteallaliases -alias name -machinetype type

删除特定计算机的所有别名。要执行此操作,必须指定计算机名和计算机类型。

-getaliases

检索某特定计算机的所有别名。要执行此操作,必须指定计算机名和计算机类型。

-alias string

指定标识计算机别名的字符串。

-machinename string

指定计算机的名称。

-Machinetype api | app_cluster | cluster | master | media | ndmp

定义计算机的用途。

-releasecache

释放 EMM 服务器使用的缓存内存。

-brief

生成较为简略的命令输出。

-emmname string

指定相关 EMM 服务器的主机名。如果未指定 -emmname,则默认名称位于 bp.conf 文件中。

-emmport unsigned_integer

指定对其执行调用的 EMM 服务器的端口号。如果未指定 -emmport,则会在 bp.conf 文件中指定默认端口。

-renamehost

此命令与所需的计算机名和新计算机名选项一起,可以将当前计算机名重命名为新计算机名。

-machinename string

定义当前计算机名。

-newmachinename string

定义新计算机名。

-resethost

使用此命令为更新后的主机重置主机属性主机属性部分会显示主机 Web 服务所收集的附加信息。

如果已降级计算机上的 NetBackup 版本或已从 NetBackup 环境中删除主机,请运行此命令。只有在降级到 NetBackup 8.0 或更低版本时才需运行此命令。您可能需要重新启动 NetBackup 管理控制台才能使更改生效。

必须先运行 bpnbat -login -loginType WEB 命令,然后再运行 nbemmcmd –resethost 命令。此命令将验证 Web 服务登录。成功运行 bpnbat 命令后,请运行 nbemmcmd –resethost 命令。

-machinename string

定义已降级或已从 NetBackup 环境中删除的计算机的名称。

-servercontrol

此命令可以暂停和继续执行对指定服务器的控制。可以执行数据库维护而不损坏现有数据,原因是此过程中开始运行了新作业。

-resume

继续执行对指定服务器的控制。

-suspend

暂停对指定服务器的控制。

-setemmserver

此命令可在其名称与旧 EMM 服务器名称匹配的域内更改某些主机的 EMM 服务器名称。此命令具有以下选项:

-emmservername string

指定要更改的 EMM 服务器名。

-newemmservername string

指定 EMM 服务器的新值或替换值。

-masterserver string

指定 EMM 域的主服务器名称。在使用此命令时,如果省略该选项,则假定为当前计算机。

-timeout unsigned integer

指定在执行该命令的过程中使用的临时超时值(以秒为单位)。

-updatehost -machinename string

此命令与下列选项一起使用时,可以对使用所需的 -machinename 选项指定的计算机记录进行更改。

-add_server_to_app_cluster

此选项指定将计算机添加至在 -clustername 选项中指定的应用程序群集。

-activenodename string

标识群集中的活动节点。

-clustername string

标识此计算机所属的群集。

-delete_server_from_app_cluster

指定将计算机从在 -clustername 选项中指定的应用程序群集中删除。

-displayname string

显示为计算机指定的名称,它等效于该计算机的编号标识符。

-machinename string

指定要更新的计算机名。

-machinestateop clr_admin_pause | clr_admin_pause_and_set_active | clr_disk_active | clr_ltid_restart | clr_master_server_connectivity | clr_tape_active | reset_all | set_admin_pause | set_disk_active | set_master_server_connectivity | set_tape_active

设置或清除指定的计算机状态。

-Machinetype api | app_cluster |cluster | master | media | ndmp

定义计算机的用途。

-masterserver string

在域中定义主机的主服务器。

-netbackupversion level[.major_level[minor_level]]

添加主机并指定其运行版本。level 变量的范围是 0-99。major_levelminor_level 变量是可选的单数字字段。major_levelminor_level 变量之间不允许有空格。

例如,输入以下信息将指定 NetBackup 7.0:-netbackupversion 7.0

-operatingsystem hpux | linux | rs6000 | solaris | windows

此选项可以更新计算机的操作系统。

示例

示例 1 - 显示特定 EMM 域中所有主机的相关信息。

# nbemmcmd -getemmserver
These hosts were found in this domain: throttle, upwords
Checking with host: throttle...
Checking with host: upwords...
Server Type   Host Version              Host Name         EMM Server
MEDIA         UNKNOWN RELEASE (0)       throttle          throttle
MASTER        7.6                       upwords           upwords

One or more hosts had mismatched EMM Servers.
Run-time failure: The consistency check either failed or was 
incomplete. Command did not complete successfully.

示例 2 - 更改域中名称与旧 EMM 服务器名称匹配的某些主机的 EMM 服务器名称。

# nbemmcmd -setemmserver -emmservername throttle -newemm upwords
These hosts were found in this domain: throttle, upwords
Checking with host: throttle...
Checking with host: upwords...
Server Type    Host Version             Host Name         EMM Server
MEDIA          UNKNOWN RELEASE (0)      throttle          throttle
EMM server name was changed.
MASTER         7.6                      upwords           upwords
One media hosts had EMM Server name changed. Command was completed 
successfully.

示例 3 - 列出计算机名称 orbitvm1 的设置。

# nbemmcmd -listsettings -machinename orbitvm1
NBEMMCMD, Version:7.1
The following configuration settings were found:
ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA="no"
DISABLE_DISK_STU_JOB_THROTTLING="no"
DISABLE_STANDALONE_DRIVE_EXTENSIONS="no"
MEDIA_REQUEST_DELAY="0"
MUST_USE_LOCAL_DRIVE="no"
NON_ROBOTIC_MEDIA_ID_PREFIX="A"
MAX_REALLOC_TRIES="1000"
DISABLE_BACKUPS_SPANNING_DISK="no"
DISALLOW_NONNDMP_ON_NDMP_DRIVE="no"
DO_NOT_EJECT_STANDALONE="no"
PREFER_NDMP_PATH_FOR_RESTORE="yes"
DONT_USE_SLAVE="no"
DRIVE_ERROR_THRESHOLD="2"
MEDIA_ERROR_THRESHOLD="2"
TIME_WINDOW="12"
SCSI_PROTECTION="SR"
NBUFS_DUP_TSU_TO_DSU="no"
NBUFS_DESTINATION_DSU="NONE"
NBUFS_RETENTION_LEVEL="0"
MPMS_DISABLE_RANK="0"
MPMS_DISABLE_EVENTS="no"
UNRESTRICTED_SHARING="no"
FATPIPE_USAGE_PREFERENCE="Preferred"
FATPIPE_WAIT_PERIOD="15"
FATPIPE_RESTORE_WAIT_PERIOD="5"
FT_MAX_CLIENT_PORTS_PER_SERVER="2"
FT_MAX_CLIENTS_PER_PORT="2"
SHAREDDISK_MOUNT_POINT="/nbushareddisk"
AUDIT="ENABLED"
AUDIT_RETENTION_PERIOD="90"
RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL="yes"
VAULT_CLEAR_MEDIA_DESC="no"
SCSI_PERSISTENT_RESERVE="0"
Command completed successfully.