applysoftware

使用 applysoftware 命令可将系统更新到新的代码级别。

语法

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

参数

-force
(可选)指定即使系统缺少冗余,仍继续执行更新或异常终止操作。 禁用冗余校验可能会导致数据丢失或丢失对数据的访问。 如果一个或多个节点脱机,请同时使用 force 参数和 abort 参数。
Important: 使用 force 参数可能会导致访问权丢失。 仅在 IBM 支持人员的指导下使用。
-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 以指示将更新定步调更新的下一个节点。 指定 -resume 以恢复更新过程。
-pacednext
(如果指定了 -paced,并且希望更新下一个节点,那么为必需)指定将更新作为定步调更新一部分的下一个节点。
-delayminutes
(可选)指定客户可以在 CCU 半途中覆盖缺省的 30 分钟延迟。

描述

该命令启动将系统更新到新代码级别的过程。 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

调用示例

applysoftware -resume -delay 20

生成的输出:

No feedback