applysoftware

You can use the applysoftware command to upgrade the cluster to a new level of sofware.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svcservicetask -- -- applysoftware -- --+----------+-- ----->
                                            '- -force -'

>-- -file -- filename_arg -------------------------------------><

Parameters

-force
Optionally specifies the force flag. The -force flag is needed if any node within an I/O group is not paired. The upgrade process forces the first node in each I/O group to shut down and upgrade. If that node is not paired, then the cluster will become degraded and access to the data will be lost.
-file filename_arg
Specifies the file name of the new software package. You must have copied this file to the configuration node before entering this command.

Description

This command starts the upgrade process of the cluster to a new level of software. Note the references above to svcservicetask and svcservicemodetask. The applysoftware command can be used to apply a level of software to the node in both service and non-service modes. This topic addresses applying software when the node is in non service mode.

The software package as specified by the file name must first be copied onto the current (in service mode) node in the /home/admin/upgrade directory. You can use secure copy (scp) on the secure shell (SSH) client to copy the file.

The actual upgrade completes asynchronously.

The contents of /home/admin/upgrade can be viewed by using the svcinfo lssoftwaredumps command.

Internally, the new package will be moved from the /home/admin/upgrade directory and checksumed. If the package fails the checksum, it will be deleted and the upgrade will fail. Otherwise, the package will be extracted from the directory and the software upgrade will begin.

Each node in turn restarts before the new software package is started.

Possible failures

Examples

An invocation example

svcservicetask applysoftware -file sanvolumecontroller_update