applysoftware
使用 applysoftware 命令可将系统更新到新的代码级别。
语法
>>-applysoftware--+---------+-----------------------------------> '- -force-' >--+- -file -filename_arg--+---------+--+-------+--+------------+--+-----------+-+->< | '- -pause-' '- -all-' '- -continue-' '- -prepare-' | +- -abort---------------------------------------------------------------------+ +- -complete--+------------------+--------------------------------------------+ | +- -paced----------+ | | '- -delay--minutes-' | +- -resume--+------------------+----------------------------------------------+ | +- -paced----------+ | | '- -delay--minutes-' | '- -pacednext-----------------------------------------------------------------'
参数
- -force
- (可选)指定即使系统缺少冗余,仍继续执行更新或异常终止操作。禁用冗余校验可能会导致数据丢失或丢失对数据的访问。如果一个或多个节点脱机,请同时使用 force 参数和 abort 参数。要点: 使用 force 参数可能会导致访问权丢失。 仅在 IBM® 支持人员的指导下使用。
- -file filename_arg
- (必需)指定安装更新包的文件名。将更新包复制到配置节点,然后再运行 applysoftware 命令。注: file 参数不能与 abort 参数一起使用。
- -pause
- (可选)指定节点的并发升级在中间点暂停。此参数必须与 -file 一起指定。
- -all
- (可选)指定节点的并发升级在节点脱机以进行升级前暂停。此参数必须与 -file 一起指定。
- -continue
- (可选)指定并发升级继续。
- -prepare
- (可选)准备系统以执行手动代码级别更新。注: 您可以:
- 可以同时使用 prepare 参数和 file 参数
- 不可以同时使用 prepare 参数和 abort 参数
- 不可以同时使用 force 参数和 prepare 参数以转变为 prepared 状态
- -abort
- (停止更新时为必需)指定将停止一个已暂停或准备就绪的更新,使系统恢复到原始代码级别。注: abort 参数可以与 force 参数一起使用,但不能与 file 或 prepare 参数一起使用。abort 参数还可以在 lsupdate 命令报告以下状态时使用:
- prepare_failed
- prepared(如果所有节点联机)
- -complete
- (完成更新时为必需)指定更新完成过程已启动。 指定 -paced,以定步调执行更新完成过程。该过程自动或定步调完成。)
- -resume
- (恢复更新时为必需)通过重试已停滞的步骤恢复已停滞的自动更新、更新取消或更新完成过程。指定 -paced,以定步调执行更新过程。
- -paced
- (可选)指定将定步调完成更新。系统不会自动使任何节点脱机 - 您必须指定 -pacednext 以指示将更新定步调更新的下一个节点。指定 -resume 以恢复更新过程。
- -pacednext
- (如果指定了 -paced,并且希望更新下一个节点,那么为必需)指定将更新作为定步调更新一部分的下一个节点。
- -delay minutes
- (可选)指定客户可以在 CCU 半途中覆盖缺省的 30 分钟延迟。
描述
该命令启动将系统更新到新代码级别的过程。applysoftware 命令作为服务操作(自定进度的更新)对节点应用代码级别以更新特定节点,或作为自动更新过程更新系统上的所有节点。
applysoftware 不能在维护状态下使用,这意味着系统必须正在运行才能成功使用该命令。该命令是同步的,因此会报告成功或失败。
由文件名指定的代码包必须首先拷贝到当前配置节点的 /home/admin/update 目录中;然后使用 PuTTy 安全拷贝 (scp) 应用程序拷贝该文件。
如果 applysoftware 命令成功,那么 lsupdate 命令将报告状态为 prepared。如果 applysoftware 命令失败,那么 lsupdate 命令将报告状态为 inactive。
如果指定 prepare 参数,那么该参数必须成功,更新才会成功。
建议使用与实际更新相同的软件包进行准备。只要 lsupdate 命令报告状态为 prepared,那么可以通过使用 abort 参数取消 prepare 参数,即使系统已处于 prepared 状态,也是如此。
要点: prepare 参数可能超时。如果发生超时,那么 prepare 参数会导致出现异步情况,lsupdate 命令会将准备状态报告为 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调用示例
applysoftware -file jvardee1 -pause生成的输出:
No feedback调用示例
applysoftware -file zibrav22 -all生成的输出:
No feedback调用示例
applysoftware -continue生成的输出:
No feedback调用示例
applysoftware -resume -delay 20生成的输出:
No feedback