The startNode script

The startNode script starts the node agent process for a node that is part of a Network Deployment cell.

Product

The startNode script is available in the WebSphere Application Server product only.

Authority

To run this script, your user profile must have *ALLOBJ and *JOBCTL authority. For information on setting explicit authorities for a user profile that does not have *ALLOBJ authority, see Set explicit authorities for the startServer and stopServer scripts.

Syntax

The syntax of the startNode script is:

startNode [ -instance instance ] [ -nowait ]
 [ -timeout seconds ] [ -trace ] [ -help | ? ]

Parameters

The parameters of the startNode script are:

• -instance
  Optional. The value instance specifies the name of the instance for which you want to start the node agent. The default value for this parameter is default.

• -nowait
  Optional. If you specify this parameter, the script returns control to the user without waiting for successful initialization of the server. The default is to wait for successful initialization.

• -timeout
  Optional. The value seconds specifies the amount of time in seconds to wait for successful initialization of the server. The script returns control to the user at the end of the timeout value. The default is to wait until the server initialization is complete.

• -trace
  Optional. If you specify this parameter, the trace function is turned on. The trace output is written to the JOBNAME.JOBUSER.JOBNUMBER file in the /QIBM/UserData/WebAS5/service/trace directory, where JOBNAME, JOBUSER, and JOBNUMBER are taken from the application server job. The job name is output when the job is submitted by the script.

• -help or -?
  This optional paramter prints the usage statement for the script.

Examples

These examples demonstrate correct syntax:

startNode

This example starts the node agent for the default instance.

startNode -instance devinst

This example starts the node agent for the devinst instance.

startNode -nowait

Starts the node agent for the default instance. The script returns control to the user immediately, without waiting for the node agent server to successfully initialize.