applysoftware

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

语法

 applysoftware    [  -force  ]   {  -file  filename_arg  [  -pause  ]   [  -all  ]   [  -continue  ]   [  -prepare  ] |   | [  -abort  ] |   | [  -complete  [ -paced ] ] |   | [  -resume  [ -paced ] ] | [  -pacednext  ] }      

参数

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

描述

该命令启动将系统更新到新代码级别的过程。applysoftware 命令作为服务操作(自定进度的更新)对节点应用代码级别以更新特定节点,或作为自动更新过程更新系统上的所有节点。

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

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

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

如果指定 prepare 参数,那么该参数必须成功,更新才会成功。 建议使用与实际更新相同的软件包进行准备。只要 lsupdate 命令报告状态为 prepared,那么可以通过使用 abort 参数取消 prepare 参数,即使系统已处于 prepared 状态,也是如此。
Important: prepare 参数可能超时。如果发生超时,那么 prepare 参数会导致出现异步情况,lsupdate 命令会将准备状态报告为 preparing。如果发生这种情况,请耐心等待,直至 lsupdate 报告更新为“prepared”,然后再继续手动更新过程。
一旦更新过程成功,即表示该命令完成。如果发生以下情况,该命令将失败并且会删除更新包:
  • 指定的包由于损坏导致完整性检查失败。
  • 系统中的任何节点都具有不受新代码支持的硬件类型。
  • 新代码级别不支持从当前安装代码的更新。
  • 远程系统的代码级别与新代码不兼容。
  • 存在依赖于节点状态的卷。
    Note: 如果已经为在更新期间丢失对数据的访问权做好了准备,那么可以使用 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

调用示例

applysoftware -file jvardee1 -pause

生成的输出:

No feedback

调用示例

applysoftware -file zibrav22 -all

生成的输出:

No feedback

调用示例

applysoftware -continue

生成的输出:

No feedback