Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual

Overview of the node Commands

The node commands perform auto-upgrade tasks on hosts, host sets, and application instances.

Table 9–1 Summary of the node Commands

Command 

Description 

node.au

Performs auto-upgrade tasks 

node.au.la

This command provides a summary of all the completed and currently running auto-upgrade tasks.

Table 9–2 Argument and Result for the node.au.la Command

Argument/Result 

Syntax 

Description 

result 

UpgradeTaskSummaryArray 

The upgrade tasks 

node.au.lo

This command provides the status of a specified auto-upgrade task.

Table 9–3 Argument and Result for the node.au.lo Command

Argument/Result 

Syntax 

Description 

ID 

Required 

UpgradeTaskID 

Lists the detailed or summary status of an auto-upgrade operation given an UpgradeTaskID. Default is detailed status.  

result 

UpgradeTaskStatus 

The upgrade tasks 

node.au.run

To run an auto-upgrade task on a host, host set, application instance, a combination of these three, or all nodes. Combinations of HostIDArray, HostSetIDArray and AppInstanceIDArray can be passed together to this command. However, when using the -all argument, IDs should not be specified.

Table 9–4 Argument for the node.au.run Command

Argument/Result 

Syntax 

Description 

hID 

Required or Optional 

HostIDArray 

The HostID array. The application instances on these hosts are upgraded; required if the argument all OR hsID/ID are not supplied 

hsID 

Required or Optional 

HostSetIDArray 

The HostSetID array. The application instances on the hosts in these host sets are upgraded; required if the argument all OR hID/ID are not supplied 

ID 

Required or Optional 

AppInstanceIDArray 

The AppInstanceID array. The application instances are upgraded; required if the argument all OR hID/hsID are not supplied 

all 

Required of Optional 

Boolean 

True if entire network needs to be upgraded; required if none of the arguments hID/hsID/ID are supplied 

result 

UpgradeTaskID 

The ID of the upgrade task run 

node.au.stop

This command stops an auto-upgrade task.

Table 9–5 Argument and Result for the node.au.stop Command

Argument/Result 

Syntax 

Description 

ID 

Required 

UpgradeTaskID 

The ID of the upgrade task run to stop