stopNode command

 

+

Search Tips   |   Advanced Search

 

Overview

The stopNode command reads the configuration file for the Network Deployment node agent process and sends a JMX command telling the node agent to shut down.

By default, the stopNode command waits for the node agent to complete shutdown before it returns control to the command line. There is a -nowait option to return immediately.

If you are using the Windows platform and the you have the node agent running as a Windows service, the stopNode command will start the associated Windows service and it will be responsible for starting the node agent.

If you stop the server before stopping the node agent using the stopserver -servers command, the server will not restart when you issue a startserver command.

 

Syntax

The command syntax is as follows

stopNode [options]

 

Parameters

The following options are available for the stopNode command:

-nowait

Do not to wait for successful shutdown of the node agent process.

-quiet

Suppress the progress information that the stopNode command prints in normal mode.

-logfile <fileNname>

Location of the log file to which information gets written.

-profileName

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.

-replacelog

Replace the log file instead of appending to the current log.

-trace

Generate trace information into a file for debugging purposes.

-timeout <seconds>

Waiting time for the agent to shut down before timing out and returning an error.

-statusport <portNumber>

Specify that an administrator can set the port number for server status callback.

-stopservers

Stops all application servers on the node before stopping the node agent.

-conntype <type>

Specify the Java Management Extensions (JMX) connector type to use for connecting to the deployment manager. Valid types are Simple Object Access Protocol (SOAP) or RMI.

-port <portNumber>

Specify the node agent JMX port to use explicitly, so that one can avoid reading configuration files to obtain the information.

-username <name>

Specify the user name for authentication if security is enabled in the node agent. Acts the same as the -user option.

-user <name>

Specify the user name for authentication if security is enabled in the node agent. Acts the same as the -username option.

-password <password>

Specify the password for authentication if security is enabled in the node agent.

Note: If you are running in a secure environment but have not provided a user ID and password, you receive the following error message 

ADMN0022E: Access denied for the stop operation on Server MBean due 
to insufficient or empty credentials.
To solve this problem, provide the user ID and password information.

-help

Prints a usage statement.

Note: When requesting help for the usage statement for the stopNode command, a reference to the stopServer command displays. All of the options displayed for this usage statement apply to the stopNode command.

-?

Prints a usage statement.

Note: When requesting help for the usage statement for the stopNode command, a reference to the stopServer command displays. All of the options displayed for this usage statement apply to the stopNode command.

 

Usage scenario

The following examples demonstrate

correct syntax 

stopNode

stopNode -nowait 

stopNode -trace (produces the stopnode.log file)