Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbemmcmd — 更新和查看 EMM 数据库中的信息
大纲
[-addhost] [-changesetting] [-deletehost] [-errorsdb] [-getemmserver] [-help] [-listhosts] [-listmedia] [-listsettings] [-machinealias] [-renamehost] [-resethost] [-servercontrol] [-setemmserver] [-updatehost]
-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]
-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]
-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]
-deletehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp | master | media | ndmp-mediaid string
-errorsdb [-brief] [-prune [-days no_of_days] [-hours no_of_hours] [-minutes no_of_minutes]]
-getemmserver [-masterserver string] [-timeout unsigned_integer]
-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]]]
-listmedia [-allrecords] [-mediaid string] [-mediatype unsigned_integer] [-poolname string] [-robotnumber unsigned integer] [-vaultcontainer string]
-listsettings -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]
-machinealias [-addalias -alias string -machinename string] [-deletealias -alias string] [-deleteallaliases -machinename string] [-getaliases -machinename string] -machinetype api | app_cluster | cluster | master | media | ndmp
-releasecache -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]
-renamehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp -newmachinename string
-resethost -machinename string
-servercontrol [-brief] [-resume] [-suspend]
-setemmserver [-brief] -emmservername string [-masterserver string] -newemmservername string [-timeout unsigned_integer]
-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_level 和 minor_level 变量是可选的单数字字段。major_level 和 minor_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_level 和 minor_level 变量是可选的单数字字段。major_level 和 minor_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_level 和 minor_level 变量是可选的单数字字段。major_level 和 minor_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.