applysoftware

使用 applysoftware 命令将集群系统(系统)更新到新的系统代码(代码)级别。

语法

阅读语法图跳过直观语法图
>>- applysoftware -- --+----------+-- -------------------------->
                       '- -force -'      

>--+- -file -- filename_arg --+------------+-+-- -- -- --------><
   |                          '- -prepare -' |            
   +- -abort --------------------------------+            
   +- -complete --+----------+---------------+            
   |              '- -paced -'               |            
   +- -resume --+----------+-----------------+            
   |            '- -paced -'                 |            
   '- -pacednext ----------------------------'            

参数

-force
(可选)指定即使系统缺少冗余,仍继续执行更新或异常终止操作。禁用冗余校验可能会导致数据丢失或丢失对数据的访问。如果一个或多个节点脱机,请同时使用 force 参数和 abort 参数。
要点: 使用 force 参数可能会导致访问权丢失。仅当产品支持信息指示时使用该参数
-file filename_arg
(必需)指定安装更新包的文件名。 将更新包拷贝到配置节点,然后再运行 applysoftware 命令。
注: file 参数不能与 abort 参数一起使用。
-prepare
(可选)准备系统以进行手动代码级别更新
注: 您:
  • 可以同时使用 prepare 参数和 file 参数
  • 不可以同时使用 prepare 参数和 abort 参数
  • 不可以同时使用 force 参数和 prepare 参数以转变为 prepared 状态
-abort
(停止更新所必需)指定应停止处于 stalled 或 prepared 状态的更新,使系统恢复为原始代码级别。
注: abort 参数可以与 force 参数一起使用,但不能与 fileprepare 参数一起使用。
abort 参数还可以在 lsupdate 命令报告以下状态时使用:
  • prepare_failed
  • prepared(如果所有节点联机)
-complete
(可选)启动更新完成过程。当未设置 paced 选项时,为自动,设置 paced 选项时,为定步调。
-resume
(可选)通过重试已停滞的步骤恢复已停滞的自动更新、更新取消或更新完成过程。更新完成过程变为 paced(如果设置了该选项)。
-paced
(可选)指定更新完成应定步调。 系统不会自动使任何节点脱机,并且等待用户使用 -pacednext
-pacednext
(可选)更新属于定步调更新的下一个节点。

描述

该命令会启动将系统更新到新的代码级别的过程。applysoftware 命令以维护操作 (定步调的更新)的形式对节点应用代码的某个级别以更新特定节点,或以自动更新过程的形式更新系统上的所有节点。

applysoftware 不能在维护状态下使用,这意味着系统必须正在运行才能成功使用该命令。该命令是同步的,因此会报告成功或失败。

由文件名指定的代码包必须首先拷贝到当前配置节点的 /home/admin/update 目录中;然后使用 PuTTy 安全拷贝 (scp) 应用程序拷贝该文件。

如果 applysoftware 命令成功,那么 lsupdate 命令将报告状态为 prepared。如果 applysoftware 命令失败,那么 lsupdate 命令将报告状态为 inactive。

如果指定 prepare 参数,那么该参数必须成功,更新才会成功。 在实际更新时,建议对 prepare 使用相同的包。 只要 lsupdate 命令报告状态为 prepared,那么可以通过使用 abort 参数取消 prepare 参数,即使系统已处于 prepared 状态,也是如此。
要点: prepare 参数可能超时。如果发生这种情况,那么 prepare 参数会导致出现异步情况,lsupdate 命令会将 prepare 报告为“preparing”。如果发生这种情况,请耐心等待,直至 lsupdate 报告更新为“prepared”,然后再继续手动更新过程。
更新过程成功后,命令立即完成。如果发生以下情况,该命令将失败并且会删除更新包:
  • 指定的包由于损坏导致完整性检查失败。
  • 系统中有任何节点具有新代码不支持的硬件类型。
  • 新代码级别不支持从当前安装代码的更新
  • 远程系统的代码级别与新代码不兼容。
  • 存在任何依赖于节点状态的卷。
    注: 如果已经为在更新期间丢失对数据的访问权做好了准备,那么可以使用 force 参数来覆盖此限制。继续之前,将 lsdependentvdisks 命令与 node 参数一起使用,在该命令运行时列出依赖于节点的卷。如果该命令返回错误,请将定额磁盘移到可通过所有节点访问的 MDisk。重新运行该命令,直至不返回任何错误。

实际的更新将异步完成。

调用示例

applysoftware –file filename_arg

生成的输出:

No feedback

调用示例

applysoftware -prepare -file INSTALL_6.4.0.0

生成的输出:

No feedback

调用示例

applysoftware -abort

生成的输出:

No feedback

调用示例

applysoftware -file softwareupdate

生成的输出:

No feedback

调用示例

applysoftware -complete -force

生成的输出:

No feedback

调用示例

applysoftware -resume -paced

生成的输出:

No feedback

调用示例

applysoftware -pacednext -force

生成的输出:

No feedback