applysoftware

Use the applysoftware command to update the system to a new level of code.

Syntax

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

Parameters

-force
(Optional) Specifies that the update or abort must proceed even if there is a lack of redundancy in the system. Disabling redundancy checking might cause loss of data, or loss of access to data. Use the force parameter with the abort parameter if one or more nodes are offline.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM support personnel.
-file filename_arg
(Required) Specifies the file name of the installation update package. Copy the update package onto the configuration node before you run the applysoftware command.
Note: The file parameter cannot be used with the abort parameter.
-pause
(Optional) Specifies that the concurrent upgrade of a node is paused at the halfway point. This parameter must be specified with -file.
-all
(Optional) Specifies that the concurrent upgrade of a node is paused before the node is offline for an upgrade. This parameter must be specified with -file.
-continue
(Optional) Specifies that the concurrent upgrade continue.
-prepare
(Optional) Prepares the system for a manual code level update.
Note: You can:
  • Use the prepare parameter with the file parameter
  • Not use the prepare parameter with the abort parameter
  • Not use the force parameter with the prepare parameter to go to prepared status
-abort
(Required for stopping an update) Specifies that a stalled or prepared update is stopped, returning the system to the original code level.
Note: The abort parameter can be used with the force parameter, but not the file or prepare parameters.
The abort parameter can also be used when the lsupdate command reports a status of:
  • prepare_failed
  • prepared (if all nodes are online)
-complete
(Required for completing an update) Specifies that the update completion process is started. Specify -paced for the update completion process to be paced. (This process is either automatic or paced.)
-resume
(Required for resuming an update) Resumes a stalled automatic update, update cancel, or update completion process by retrying the step that stalled. Specify -paced for the update process to be paced.
-paced
(Optional) Specifies that the update completion is paced. The system does not automatically take any nodes offline - you must specify -pacednext to indicate that the next node of the paced update is updated. Specify -resume for the update process to be resumed.
-pacednext
(Required if -paced is specified and you want the next node to be updated) Specifies that the next node that is part of a paced update be updated.
-delayminutes
(Optional) Specifies that customers can overwrite the default 30-minute delay at the half way point of a CCU.

Description

This command starts the update process of the system to a new level of code. The applysoftware command applies a level of code to the node as a service action (Paced update) to update the specific node, or as an automatic update process that update all of the nodes on a system.

The applysoftware command cannot be used in service state, which means the system must be running in order for the command to be used and be successful. This command is synchronous and therefore reports success or failure.

The code package as specified by the file name must first be copied onto the current configuration node in the /home/admin/update directory; use the PuTTy secure copy (scp) application to copy the file.

If the applysoftware command is successful, the lsupdate command reports the status is prepared. If the applysoftware command fails, the lsupdate command reports the status is inactive.

If specified, the prepare parameter must succeed in order to successfully update. It is recommended to use the same package for the prepare as the actual update. The prepare parameter can be canceled by using the abort parameter (even after the system is prepared) as long as the lsupdate command reports the status as prepared.
Important: The prepare parameter might time out. If a time-out occurs, the prepare parameter causes an asynchronous condition, and the lsupdate command reports the prepare status as preparing. If this happens, wait until lsupdate reports the update as prepared before you proceed with the manual update process.
The command completes as soon as the update process is successful. The command fails and the update package is deleted if:
  • The specified package fails an integrity check due to corruption.
  • Any node in the system has a hardware type that is not supported by the new code.
  • The new code level does not support updates from the currently installed code.
  • The code level of a remote system is incompatible with the new code.
  • There are volumes-dependent on the status of a node.
    Note: The force parameter can be used to override these scenarios if you are prepared to lose access to data during the update. Before proceeding, use the lsdependentvdisks command with the node parameter to list the node-dependent volumes at the time the command is run. If the command returns an error, move the quorum disks to MDisks that are accessible through all nodes. Rerun the command until no errors are returned.

The actual update completes asynchronously.

An invocation example

applysoftware -file filename_arg

The resulting output:

No feedback

An invocation example

applysoftware -prepare -file INSTALL_6.4.0.0

The resulting output:

No feedback

An invocation example

applysoftware -abort

The resulting output:

No feedback

An invocation example

applysoftware -file softwareupdate

The resulting output:

No feedback

An invocation example

applysoftware -complete -force

The resulting output:

No feedback

An invocation example

applysoftware -resume -paced

The resulting output:

No feedback

An invocation example

applysoftware -pacednext -force

The resulting output:

No feedback

An invocation example

applysoftware -file jvardee1 -pause

The resulting output:

No feedback

An invocation example

applysoftware -file zibrav22 -all

The resulting output:

No feedback

An invocation example

applysoftware -continue

The resulting output:

No feedback

An invocation example

applysoftware -resume -delay 20

The resulting output:

No feedback