Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbhostmgmt — 用于管理主机 ID-主机名映射
大纲
-hostid hostid | -host host -mappingname mappingname [-isshared] [-reason reason] [-server master_server]
-host host [-reason reason] [-server master_server]
-hostid hostid | -host host -autoreissue 0|1 [-reason reason] [-server master_server]
-hostid hostid | -host host -mappingname mappingname [-reason reason] [-server master_server]
[-short | -json | -json_compact] [-hostid hostid | -host host | -approved | -pending | -conflict] [-server master_server]
-hostid hostid | -host host -comment comment [-server master_server]
-hostid hostid | -host host [-server master_server]
-hostid hostid | -host host -newhostname newhostname [-reason reason] [-server master_server]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
nbhostmgmt 命令用于管理主机 ID-主机名或 IP 地址映射。可以通过备用名称来标识主机。使用此命令将这些备用名称映射到相应的主机 ID。使用此命令添加、删除和列出映射。只有 root 用户可以运行此命令。
必须先运行 bpnbat -login -loginType WEB 命令,然后再运行 nbhostmgmt 命令。bpnbat 命令将对 Web 服务登录进行身份验证。
选项
- -add | -a
使用此选项可添加和批准指定主机的主机 ID-主机名或 IP 地址映射。
注意:
使用 -add(不带 -isshared 选项)来添加第一个共享。使用 -isshared 选项添加所有其他共享。
- -addcomment | -ac
使用此选项为主主机添加注释。您可以使用 nbhostmgmt -list 选项查看注释。添加的注释仅与主主机关联,而不与已映射的备用主机名关联。不能编辑注释。您仅可以重写或删除现有注释。
- -ah | -addhost
使用此选项在主机数据库中添加主机。
使用该选项可以添加主机条目,以便 NetBackup 管理员能够设置 autoreissue 参数。利用 autoreissue 参数,无需重新发布令牌即可在主机上部署证书。在自动映像复制 (AIR) 设置的 Bare Metal Restore 过程中,必须在目标域的主机数据库中添加主机条目。
除了 Bare Metal Restore AIR 设置等特定情况之外,Veritas 不建议手动添加主机。
- -aa | -allowautoreissuecert
使用此选项可为指定的主机或主机 ID 设置 autoreissue 参数。利用 autoreissue 参数,无需重新发布令牌即可在主机上部署证书。autoreissue 参数仅与主主机名关联,而不与已映射的备用名称关联。
- -approved |-ap
使用此选项可列出已批准的已映射主机名或 IP 地址。
- -comment | -c
使用此选项来指定您要添加到主主机的注释的内容。您必须指定主机或主机 ID 以添加注释。如果注释包含空格,则必须用双引号 ("...") 将注释括起来。comment 字段长度限于 2048 个字符。
- -conflict | -cf
使用此选项可列出其条目与其他映射冲突的已映射主机名或 IP 地址。
- -delete | -d
使用此选项可删除主机 ID-主机名或 IP 地址映射。
- -deletecomment | -dc
使用此选项来删除指定主机或主机 ID 的注释。此选项删除与主主机关联的注释。
如果您尝试使用 nbhostmgmt-deletecomment 选项删除主机不存在的注释,nbauditreport 会针对成功的更新显示一个相应的条目。
- -help | -h
显示命令行用法消息。
- -host | -n
指定主主机名或备用的映射主机名或 IP 地址。对于 add 和 delete 操作,请确保备用的映射主机名或 IP 地址与单个主机 ID 关联。
- -hostid | -i
指定 NetBackup 主机 ID。
- -isshared | -is
表示要将映射名称添加为共享映射。
注意:
使用 -add(不带 -isshared 选项)来添加第一个共享。使用 -isshared 选项添加所有其他共享。
- -json | -j
此选项跨多行以
json
格式生成数据。
- -json_compact | -jc
此选项在单行中以
json
格式生成数据
- -list | -li
使用此选项基于不同的过滤器列出已映射的主机名或 IP 地址。可以基于已批准、待批准和存在冲突的名称或地址列出主机名或 IP 地址。
- -mappingname | -hm
指定要添加或删除的主机名或 IP 地址。
- -newhostname | -nh
指定待更新主机的新的主要主机名。
- -pending | -p
使用此选项可列出待批准的已映射主机名或 IP 地址。
- -reason | -r
使用此选项可指定执行命令操作的原因。输入的字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。reason 字段长度限于 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (') 字符。
- -server | -s
表示需要建立通信的 NetBackup 主服务器的名称。-server 选项的默认值是
bp.conf
文件中列出的第一个服务器名称。
- -short | -l
使用此选项仅列出主机 ID 和已映射的主机名。
- -updatehost | -uh
使用此选项可更新主机的主要主机名。
示例
示例 1:添加主机 ID-主机名映射。
#nbhostmgmt –add -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 –mappingname testhost1 testhost1 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
示例 2:使用主机名添加主机 ID-主机名映射。
#nbhostmgmt -add -host testhost1 -mappingname testhost2 testhost2 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
示例 3:批准待定映射。此示例显示了已映射主机名 host3 的 testhost3 映射的批准过程。
#nbhostmgmt –add -host host3 –mappingname testhost3 testhost3 is successfully updated.
示例 4:使用主机 ID 从主机名映射中删除主机 ID。
#nbhostmgmt –delete -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 –mappingname testhost1 Mapping between testhost1 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
示例 5:使用主机从主机名映射中删除主机 ID。
#nbhostmgmt –delete -host fs001 –mappingname testhost4 Mapping between testhost4 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
示例 6:使用指定主服务器中的主机从主机名映射中删除主机 ID。
#nbhostmgt -delete -server nbmaster01 -host fs001 -mappingname testhost3 Mapping between testhost3 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
另请参见
请参见bpnbat(1m)。