Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbinstallcmd — 用于创建部署作业
大纲
-policy policy_name -schedule schedule [-master_server hostname] [{-hosts hostname1,hostname2,... | -host_filelist path}]
-operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -use_existing_certs [-components javagui_jre=(include|exclude|match)]
-operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -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 [-unix_eca_key_passphrasefile path] [-unix_eca_crl_path path] [-components javagui_jre=(include|exclude|match)]
-operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -win_eca_cert_store path -win_eca_crl_check_level {use_cdp | use_path | disabled} [-win_eca_crl_path path] [-components javagui_jre=(include|exclude|match)]
-operation_type {precheck | stage | install} -package package_name [-master_server hostname] [-media_server hostname] {-hosts hostname1,hostname2,... | -host_filelist path} [-limit_jobs max_concurrent_jobs] -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 [-win_eca_crl_path path] [-win_eca_key_passphrasefile path] [-components javagui_jre=(include|exclude|match)]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin
描述
使用 nbinstallcmd 命令可创建 VxUpdate 作业。VxUpdate 支持客户端和介质服务器的更新。如果从主服务器启动作业,则该作业可能将主服务器已知的任何客户端或任何介质服务器作为目标。如果从客户端或介质服务器启动作业,则仅将该客户端或介质服务器作为目标。
使用 -policy 和 -schedule 选项可以根据现有部署策略来执行作业。如果 -hosts 或 -host_filelist 选项与 -policy 一起使用,则仅在部署策略中配置的部分目标主机上执行该作业。如果不使用 -hosts 和 -host_filelist,则会在部署策略中配置的所有目标主机上执行该作业。
使用 -operation_type 和 -package 选项可在没有部署策略的情况下启动作业。此命令形式要求您提供有关安全配置的信息。此命令要求您指定 VxUpdate 处理安全性的方式:
在升级过程中,使用基于文件的证书为 UNIX 和 Linux 主机配置外部安全证书。
在升级过程中,使用证书存储库中的证书为 Windows 主机配置外部安全证书。
在升级过程中,使用基于文件的证书为 Windows 主机配置外部安全证书。
在配置正确的情况下,不要修改安全性。
有关这些安全选项的更多详细信息,请参见《NetBackup 安装指南》和《NetBackup 安全和加密指南》。
nbinstallcmd 命令的日志位于旧式日志记录目录中。对于 UNIX 和 Linux,日志位于 /usr/openv/netbackup/logs
中。在 Windows 上,日志位于 install_path\NetBackup\logs
中。
注意:
如果参数中的任何文件路径包含必须转义的空格或特殊字符,请使用特定于 shell 的注释。
选项
- -components javagui_jre=(include | exclude | match)
使用此选项可指定在部署作业运行后,目标系统上是否应存在 Java GUI 和 JRE。
值为 include 指示您希望在目标系统上安装或升级这些组件。
值为 exclude 指示您不希望目标系统上存在这些组件。任何已有的 Java GUI 和 JRE 组件都将被删除。
值为 match 指示您希望保留 Java GUI 和 JRE 组件的当前状态。如果预升级的系统上存在这些组件,则会升级这些组件。如果预升级的系统上不存在这些组件,则不会安装这些组件。
- -hosts [host1,host2,...]
以逗号分隔的主机名列表,这些条目之间不含空格。此选项不能与 -host_filelist 结合使用。如果指定了 -policy,则必须在策略中包括列出的主机。如果未指定 -policy 并在主服务器上执行命令,则指定的主机必须是主服务器已知的主机。如果未指定 -policy 并在目标主机上执行命令,则此值必须与目标主机的名称相匹配。不能在单个作业中混合指定客户端和介质服务器。作业中列出的所有主机必须全部是客户端或全部是介质服务器。
- -host_filelist [path]
主机名文件的路径,该文件分行指定了主机名。此选项不能与 -hosts 结合使用。如果指定了 -policy,则必须在策略中包括指定的主机。如果未指定 -policy 并在主服务器上执行命令,则指定的主机必须是主服务器已知的主机。如果未指定 -policy 并在目标主机上执行命令,则此值必须与目标主机的名称相匹配。不能在单个作业中混合指定客户端和介质服务器。文件中列出的所有主机必须全部是客户端或全部是介质服务器。
- -limit_jobs [max_concurrent_jobs]
允许的最大并行作业数。仅当未指定 -policy 时,此选项才适用。如果未指定,则默认值为“无限制”。
- -master_server hostname
VxUpdate 存储库所在的主服务器的主机名。此选项不是必需的。
- -media_server hostname
与客户端通信的暂存服务器的主机名。此服务器必须是介质服务器。仅当未指定 -policy 时,此选项才适用。如果未指定,则主服务器充当暂存服务器。当使用介质服务器进行暂存时,这些软件包会缓存到该介质服务器,以便可以在 VxUpdate 操作中为这些软件包提供服务。此选项可帮助优化 NetBackup 主服务器的效率。
- -operation_type {precheck | stage | install}
要启动的部署操作的类型。如果未指定 -policy,则必须设置此选项。有效的选项包括:
precheck:执行各种预检查操作,包括确认主机上是否有足够的空间用于更新。
stage:将更新软件包移至主机,但不进行安装。同时执行 precheck 操作。
install:安装指定的软件包。同时执行 precheck 和 stage 操作。如果已执行 stage 操作,则 install 命令不会再次移动软件包。
- -package item
要安装的软件包的名称。如果未指定 -policy,则必须设置此选项。该软件包必须存在于存储库中。使用 nbrepo 命令查看和管理软件包。
- -policy policy_name
现有部署策略的名称。如果未指定 -operation_type,则必须设置此选项。
- -schedule schedule_name
要执行的部署策略的日程表。如果指定了 -policy,则必须设置此选项。
- -unix_eca_cert_path path
使用此选项可为 UNIX 和 Linux 主机指定证书文件的路径。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs。
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -unix_eca_crl_check_level {use_cdp | use_path | disabled}
指定要在 UNIX 和 Linux 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。适用于以下情况:
未指定 -policy 和 -use_existing_certs。
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -unix_eca_crl_path path
使用此选项可为 UNIX 和 Linux 主机指定外部证书颁发机构文件的路径。如果使用 -unix_eca_crl_check_level use_path,则必须设置此选项。如果尝试在不使用 -unix_eca_crl_check_level use_path 的情况下使用此选项,则作业将失败。
未指定 -policy 和 -use_existing_certs。
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -unix_eca_key_passphrasefile path
使用此选项可提供 UNIX 和 Linux 主机上的密码文件路径。此选项不是必需的。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -unix_eca_private_key_path path
使用此选项可指定 UNIX 和 Linux 主机上的私钥文件路径和私钥文件名。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -unix_eca_trust_store_path path
使用此选项可在 UNIX 和 Linux 主机上指定信任存储区文件的路径。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -use_existing_certs
如果希望作业使用现有安全证书,请指定此选项。仅当未指定 -policy 时,此选项才适用。此选项不能与任何 *eca* 选项结合使用。请在以下情况下指定此选项:
目标主机具有现有的外部证书。
目标主机具有要继续使用的现有 NetBackup 安全证书。
- -win_eca_cert_path path
使用此选项可为 Windows 主机指定证书文件路径。此选项不能与 -win_eca_cert_store_path 结合使用。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -win_eca_cert_store path
使用此选项可指定 Windows 证书存储库路径。此选项不能与 -win_eca_cert_path、-win_eca_key_passphrasepath、-win_eca_private_key_path 和 -win_eca_trust_store_path 结合使用。必须以 Certificate_Store_Name\Issuer_Distinguished_Name\Subject_Distinguished_Name 方式输入证书位置。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -win_eca_crl_check_level {use_cdp | use_path | disabled}
指定要在 Windows 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -win_eca_crl_path path
使用此选项可为 Windows 主机指定外部证书颁发机构文件路径。如果使用 -windows_eca_crl_check_level use_path,则需要提供此选项。如果尝试在不使用 -windows_eca_crl_check_level use_path 的情况下使用此选项,则作业将失败。
- -win_eca_key_passphrasefile path
使用此选项可提供 Windows 主机上的密码文件路径。此选项不是必需的。此选项不能与 -win_eca_cert_store 结合使用。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -win_eca_private_key_path path
使用此选项可指定 Windows 主机上的私钥文件路径和私钥文件名。此选项不能与 -win_eca_cert_store 结合使用。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
- -win_eca_trust_store_path path
您可以使用此选项指定 Windows 主机上的信任存储区路径和信任存储区文件名。此选项不能与 -win_eca_cert_store 结合使用。此选项适用于以下情况:
未指定 -policy 和 -use_existing_certs
主服务器支持外部安全证书。
目标主机尚未配置外部安全证书。
您希望在升级过程中进行配置。
示例
示例 1:启动指定策略中配置的所有主机的预检查操作。
nbinstallcmd -policy policy-deployment20 -schedule sched-precheck -master_server master.domain.com
示例 2:从主服务器启动不基于部署策略的暂存作业。作业应:暂存 NetBackup 8.2 客户端,以多台主机为目标,将单独的介质服务器用作暂存服务器,并且不包括任何安全证书配置。
nbinstallcmd -operation_type stage -package nbclient_8.2 -master_server master.domain.com -media_server media_staging.domain.com -hosts client01.domain.com,client02.domain.com -use_existing_certs
示例 3:从目标主机启动不基于部署策略的安装操作。该操作会将主机升级到 NetBackup 8.3,并提供在升级过程中配置外部安全证书的说明。
nbinstallcmd -operation_type install -package nbserver_8.3 -master_server master.domain.com -hosts media01.domain.com -unix_eca_cert_path /usr/home/cert.pem -unix_eca_trust_store_path /usr/home/cacert.pem -unix_eca_private_key_path /usr/home/private_key.pem -unix_eca_key_passphrasefile /usr/home/passphrase_file -unix_eca_crl_check_level use_path -unix_eca_crl_path /usr/home/crl_dir
示例 4:从目标主机启动不基于部署策略的安装操作。该操作使用单独的介质服务器作为暂存服务器,将主机升级到 NetBackup 8.3。还包括配置源自证书存储库的外部安全证书的说明。
nbinstallcmd -operation_type install -package nbclient_8.3 -master_server master.domain.com -media_server media_staging.domain.com -hosts client01.domain.com -win_eca_cert_store MyCertStore\MyIssuer\MyClient -win_eca_crl_check_level use_cdp
示例 5:从主服务器启动不基于部署策略的安装操作。该操作将应用 NetBackup 8.2 Windows EEB,并以多台主机为目标。该作业使用主服务器作为暂存服务器,并且不包括任何安全证书配置。
nbinstallcmd -operation_type install -package nbeeb_1234567.1_8.2 -master_server master.domain.com -host_filelist path_to_file.txt -use_existing_certs
另请参见
请参见nbrepo(1m)。