nbemmcmd | 附录 A. NetBackup 命令 | 附录 A. NetBackup 命令 | Veritas NetBackup™ 命令参考指南 | Veritas™

Veritas NetBackup™ 命令参考指南

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

名称

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 或 -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(默认值为 1 或 no)

用于指定 NetBackup 选择用于 NDMP 还原的驱动器的方式。默认情况下,NetBackup 按所示顺序选择驱动器:

  • NetBackup 查找 NDMP 文件系统本地设置为接收还原数据的 NDMP 磁带服务器。

  • NetBackup 查找任何 NDMP 磁带服务器,包括不在还原客户端本地的 NDMP 磁带服务器。

  • NetBackup 查找任何要充当 NDMP 磁带服务器的 NetBackup 介质服务器。

如果指定 -PREFER_NDMP_PATH_FOR_RESTORE 0-PREFER_NDMP_PATH_FOR_RESTORE yes,则 NetBackup 使用的顺序如下:

  • NetBackup 查找 NDMP 文件系统本地设置为接收还原数据的 NDMP 磁带服务器。

  • NetBackup 查找任何要充当 NDMP 磁带服务器的 NetBackup 介质服务器。

  • NetBackup 查找任何 NDMP 磁带服务器,包括不在还原客户端本地的 NDMP 磁带服务器。

-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 或 -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.