Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbinstallcmd — 用于创建和启动部署作业
大纲
-policy policy -schedule schedule {-hosts filename | -host_filelist host1, host2, hostN} [-master_server name]
-i -policy policy_name -schedule schedule_name [-master_server name]
-operation_type {precheck | stage | install} -package item... -media_server name [-limit_jobs max_concurrent_jobs] [-master_server name]
-operation_type (precheck | stage | install) -package item -media_server name -unix_eca_cert_path path -unix_eca_crl_check_level (use_cdp |use_path | disabled) -unix_eca_trust_store_path path -unix_eca_private_key_path path [-host_filelist client] [-limit_jobs max_concurrent_jobs] [-master_server name] [-unix_eca_crl_path path] [-unix_eca_key_passphrasefile path]
-operation_type (precheck | stage | install) -package item -media_server name -win_eca_cert_path path -win_eca_crl_check_level (use_cdp |use_path | disabled) -win_eca_trust_store_path path -win_eca_private_key_path path [-host_filelist client] [-limit_jobs max_concurrent_jobs] [-master_server name] [-win_eca_crl_path path] [-win_eca_key_passphrasefile path]
-operation_type (precheck | stage | install) -package item -media_server name -win_eca_cert_store path -win_eca_crl_check_level (use_cdp |use_path | disabled) [-host_filelist client] [-limit_jobs max_concurrent_jobs] [-master_server name] [-win_eca_crl_path path]
-operation_type (precheck | stage | install) -package item -media_server name -use_existing_certs [-host_filelist client] [-limit_jobs max_concurrent_jobs] [-master_server name]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin
在 Windows 系统上,此命令的目录路径为 install_path\netbackup\bin
描述
使用 nbinstallcmd 命令可创建和启动 VxUpdate 作业。此命令可启动客户端和介质服务器更新作业。您可以从客户端、介质服务器和主服务器启动此命令。您启动的作业可以是策略的一部分,但启动更新作业不要求使用策略。如果从主服务器启动非基于策略的作业,则可以升级客户端或介质服务器。从客户端或介质服务器,只能升级启动作业的主机。该命令可用的选项取决于启动的作业。与策略相关联的作业具有一组选项,与策略不相关的作业具有另一组选项。有关详细信息,请查看命令摘要。
nbinstallcmd 命令的日志位于旧式日志记录目录中。对于 UNIX 和 Linux,日志位于 /usr/openv/netbackup/logs
中。在 Windows 上,日志位于 install_path\Veritas\NetBackup\logs
中。
选项
- -host_filelist host1,host2,hostN
用于指定多个主机名。名称以逗号分隔。逗号前后不要添加空格,否则列表将在指定的空格处截断。指定的所有主机必须都是客户端或介质服务器。不能既指定客户端,又指定介质服务器。
- -hosts filename
用于指定包含要更新的所有主机的名称的文件名。每个主机名单独显示在一行中。指定的所有主机必须都是客户端或介质服务器。不能既指定客户端,又指定介质服务器。
- -i
强制立即运行策略作业。如果未指定此选项,则下次在指定的策略中有可用日程表时段时启动策略。使用 -i 选项将防止预定启动相同的策略和日程表。此行为可防止作业重复。
- -limit_jobs max_concurrent_jobs
每个主机允许的最大作业数。默认值为“无限制”。
- -media_server name
与客户端通信的介质服务器的名称。文件缓存到指定的介质服务器。存储库驻留在主服务器上。文件缓存到介质服务器可防止主服务器上的通信过载。升级介质服务器时,-media_server 选项必须指定主服务器的名称。如果指定其他介质服务器,作业将失败。
- -master_server name
如果客户端或介质服务器有多台主服务器,指定的 master_name 为包含存储库的主服务器。升级介质服务器时需要使用此选项。
- -operation_type {precheck | stage | install}
指定要启动的操作类型。有效的选项包括:
precheck:执行各种预检查操作,包括确认主机上是否有足够的空间用于更新。
stage:将更新软件包移至主机,但不进行安装。同时执行 precheck 操作。
install:安装指定的软件包。同时执行 precheck 和 stage 操作。如果已执行 stage 操作,则 install 命令不会再次移动软件包。
- -package item
要安装的软件包的名称。使用 nbrepo -l 命令检索软件包 ID 值,该值是一个整数。然后,使用该整数和 nbrepo -p 命令确定 值。此值是 nbinstall -package 命令中使用的 item 值。有关更多详细信息和示例,请查看 nbrepo 命令。
- -policy policy_name
要启动的部署策略的名称。
- -schedule schedule_name
要启动的日程表的名称。
- -unix_eca_cert_path path
使用此选项可为 UNIX 和 Linux 主机指定证书文件路径和证书文件名称。
- -unix_eca_crl_check_level (use_cdp | use_path | disabled)
指定要在 UNIX 和 Linux 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。
- -unix_eca_crl_path path
使用此选项可为 UNIX 和 Linux 主机指定外部证书颁发机构文件的路径。如果使用 -unix_eca_crl_check_level use_path 选项,则需要使用此选项。
- -unix_eca_key_passphrasefile path
使用此选项可提供 UNIX 和 Linux 主机上的密码文件路径。此选项不是必需的。
- -unix_eca_private_key_path path
使用此选项可指定 UNIX 和 Linux 主机上的私钥文件路径和私钥文件名。
- -unix_eca_trust_store_path path
您可以使用此选项指定 UNIX 和 Linux 主机上的信任存储区路径和信任存储区文件名。
- -use_existing_certs
此选项指示 NetBackup 在升级时使用现有的 NetBackup CA 证书或外部 CA 证书(如果可用)。请注意,如果指定此选项,而证书不可用,则升级将失败。
- -win_eca_cert_path path
使用此选项可为 Windows 主机指定证书文件路径和证书文件名。
- -win_eca_cert_store path
使用此选项可指定 Windows 证书存储库路径。必须以 Certificate_Store_Name\Issuer_Distinguished_Name\Subject_Distinguished_Name 方式输入证书位置。
- -win_eca_crl_check_level (use_cdp | use_path | disabled)
指定要在 Windows 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。
- -win_eca_crl_path path
使用此选项可为 Windows 主机指定外部证书颁发机构文件路径。如果使用 -win_eca_crl_check_level use_path 选项,则需要使用此选项。
- -win_eca_key_passphrasefile path
使用此选项可提供 Windows 主机上的密码文件路径。此选项不是必需的。
- -win_eca_private_key_path path
使用此选项可指定 Windows 主机上的私钥文件路径和私钥文件名。
- -win_eca_trust_store_path path
您可以使用此选项指定 Windows 主机上的信任存储区路径和信任存储区文件名。
示例
示例 1:启动 policy-deployment20 策略中的 sched-precheck 日程表,并立即启动它。
nbinstallcmd -policy policy-deployment20 -schedule sched-precheck -i
示例 2:从 media1 介质服务器启动 8.2 客户端软件包的安装。
nbninstallcmd -h client1 -operation _type install -package nbclient_8.2 -media_server media1
示例 3:在无关联策略的情况下,从主服务器的命令行手动启动单个介质服务器 (media1) 的升级操作。media_server 选项必须设置为主服务器 (master1)。升级介质服务器时,必须指定 master_server 选项。
nbinstallcmd -operation_type install -package nbserver_8.2 -media_server master1 -master_server master1 -host_filelist media1
注意:
在无关联策略的情况下,可从主机的命令行手动启动主机升级操作。使用上述命令并忽略 -host_filelist 选项。不需要此选项,因为客户端和介质服务器只能在本地启动作业。
示例 4:显示对 myclient.veritas.com 客户端的预检查,使用了指定的 Windows 证书存储库中的安全证书和证书中定义的证书吊销列表。
nbinstallcmd -operation_type precheck -package nbclient_8.2 -media_server mymediaserver.veritas.com -win_eca_cert_store MyCertStore\ MyIssuer\MyClient -win_eca_crl_check_level use_cdp -host_filelist myclient.veritas.com
示例 5:显示将 myclient.veritas.com 客户端升级到 NetBackup 8.2 软件的命令,使用了 mymediaserver.veritas.com 介质服务器和通过指定路径定义的证书吊销列表。
nbinstallcmd -operation_type install -package nbclient_8.2 -media_server mymediaserver.veritas.com -unix_eca_cert_path /usr/local/cert.pem -unix_eca_crl_check_level use_path -unix_eca_trust_store_path /usr/local/truststore.pem -unix_eca_private_key_path /usr/local/key.pem -host_filelist myclient.veritas.com -unix_eca_crl_path /usr/local/crl
另请参见
请参见nbrepo(1m)。