applysoftware

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

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svcservicemodetask -- -- applysoftware -- -- --------------->

>-- -file -- filename_arg -- --+------------+------------------><
                               '- -ignore  -'   

Parameters

-file filename_arg
(Required) Specifies the filename of the new software package.
-ignore
(Optional) Specifies that all prerequisite checking be bypassed and that all hardened data be deleted. Use this parameter with caution.

Description

This command starts the upgrade process of the node to a new level of software. The applysoftware command can be used to apply 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 service mode. In nonservice mode, the command is applied to the complete cluster.

The software package as specified by the file name must first be copied on to the current configuration node/node in service mode 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 old software.
  • The software level of a remote cluster is incompatible with the new software.

The actual upgrade completes asynchronously.

You can view the contents of the /home/admin/upgrade directory by using the svcinfo/svcservicemodeinfo lssoftwaredumps command.

An invocation example

svcservicemodetask applysoftware -file newsoftware

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.