applysoftware

The applysoftware command upgrades the cluster to a new level of software.

Syntax


>>- svctask -- -- applysoftware -- --+----------+-- ------------>
                                     '- -force -'      

>-- -file -- filename -- --+---------+-------------------------><
                           '- -abort '

Parameters

-force: (Optional) Forces continuation of the command even though any node-dependent VDisks will be taken offline. Use the force parameter with caution; access to data on node-dependent VDisks will be lost. If you use this parameter, you are prompted to confirm that you want to continue.; In addition, the force parameter must be used if one or more nodes are offline when you stop the upgrade with the abort parameter. The force parameter is not required when applying an upgrade to a cluster with errors in the error log.
-file filename: (Required) Specifies the file name of the new software package.
-abort: (Optional) Stops the upgrade and backs out to where the application was before you started the upgrade.
Note: The force parameter can be used with the abort parameter. If one or more nodes are offline, you must use the force parameter with the abort parameter.

Description

This command starts the upgrade process of the cluster to a new level of SAN Volume Controller software. The applysoftware command applies a level of software to the node in both service and nonservice modes. In service mode, the applysoftware command is applied to the specific node. In nonservice mode, the applysoftware command is applied to the entire cluster.

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

The command completes as soon as the upgrade process has successfully begun. The command fails and the upgrade package is deleted if:

The given package fails an integrity check due to corruption.
Any node in the cluster has a hardware type not supported by the new software.
The new software level does not support upgrades from the currently installed software.
The software level of a remote cluster is incompatible with the new software.
There are any VDisks that are dependent on the status of a node.
Note: The force parameter can be used to override this if you are prepared to lose access to data during the upgrade. Before proceeding, use the svcinfo lsnodedependentvdisks command to list the node-dependent VDisks at the time the command is run. If the command returns an error, you must move your quorum disks to MDisks that are accessible through all nodes. Rerun the command until no errors are returned.

The actual upgrade completes asynchronously.

The svcinfo lssoftwaredumps command allows you to view the contents of the /home/admin/upgrade directory.

An invocation example

svctask applysoftware –file softwareupdate

The resulting output

No feedback