startNode command

The startNode command reads the configuration file for the node agent process and constructs a launch command.

[AIX Solaris HP-UX Linux Windows] Depending on the options that you specify, the startNode command creates a new Java virtual machine (JVM) API to run the agent process, or writes the launch command data to a file.

[AIX Solaris HP-UX Linux Windows] If you are using the Windows® platform and the you have the node agent running as a Windows service, the startNode command will start the associated Windows service and it will be responsible for starting the node agent.

You do not have to use a user name and password with the startNode command because this command launches a server process but does not invoke an MBean method.

For more information about where to run this command, see the Using command line tools article.

Syntax

The command syntax is as follows:
startNode [options]

Parameters

The following options are available for the startNode command:

-?
Prints a usage statement.
-help
Prints a usage statement.
-logfile <fileName> [AIX Solaris HP-UX Linux Windows] [z/OS]
Specifies the location of the log file to which trace information is written. By default, the log file is named startServer.log and is created in your profile_root/logs directory.
-nowait [AIX Solaris HP-UX Linux Windows]
Tells the startNode command not to wait for successful initialization of the launched node agent process.
-profileName [AIX Solaris HP-UX Linux Windows]
Defines the profile of the Application Server process in a multi-profile installation. The -profileName option is not required for running in a single profile environment. The default for this option is the default profile.
-quiet [AIX Solaris HP-UX Linux Windows] [z/OS]
Suppresses the progress information that the startNode command prints in normal mode.
-replacelog [AIX Solaris HP-UX Linux Windows] [z/OS]
Replaces the log file instead of appending to the current log.
-script [<script fileName>] -background [AIX Solaris HP-UX Linux Windows]
Generates a launch script with the startServer command instead of launching the node agent process directly. The launch script name is an optional argument. If you do not supply the launch script name, the default script file name is
  • [Linux] [HP-UX] [Solaris] [AIX] start_node_agent.sh
  • [Windows] start_node_agent.bat
node_agent is the name of the node agent.The -background parameter is an optional parameter that specifies that the script will run in the background when you run it.
-statusport <portNumber> [AIX Solaris HP-UX Linux Windows] [z/OS]
An optional parameter that allows an administrator to set the port number for node agent status callback. The tool opens this port and waits for status callback from the node agent indicating that the node agent has started. If the parameter is not set, an unused port is automatically allocated.
-trace
[AIX Solaris HP-UX Linux Windows] [z/OS] Generates trace information to the log file for debugging purposes.
-timeout <seconds>
Specifies the waiting time before node initialization times out and returns an error.

Usage scenario

The following examples demonstrate correct syntax:

[AIX Solaris HP-UX Linux Windows]
startNode 

startNode -script (produces the start_node.bat or .sh file)

startNode -trace (produces additional trace statements in the startnode.log file)
[z/OS]
startNode 

startNode -trace (produces additional trace statements in the startnode.log file)



Related tasks
Using command line tools
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=rxml_startnode
File name: rxml_startnode.html