The syncNode command forces a configuration
synchronization to occur between the node and the deployment manager
for the cell in which the node is configured.
The node agent server runs a configuration synchronization service
that keeps the node configuration synchronized with the master cell
configuration. If the node agent is unable to run because of a problem
in the node configuration, you can use the syncNode command
to perform a synchronization when the node agent is not running in
order to force the node configuration back in sync with the cell configuration.
If the node agent is running and you want to run the syncNode command,
you must first stop the node agent.
The syncNode.log file is located in the profile_root/logs directory.
For more information about where to run this command, see Using
command-line tools.
Syntax
The command syntax is as follows:
syncNode <deploymgr host> <deploymgr port> [options]
- The <deploymgr host> argument is required.
- The <deploymgr port> is the Java Management Extensions (JMX) port number
that corresponds to the connector type on the -conntype parameter.
Parameters
The following options are available
for the syncNode command:
- -stopservers
- Tells the syncNode command to stop all servers
on the node, including the node agent, before performing configuration
synchronization with the cell.
- -restart
- Tells the syncNode command to launch the node
agent process after configuration synchronization completes. If the
node agent is running and you want to run the syncNode command,
you must first stop the node agent.
- -nowait
- Tells the syncNode command not to wait for
successful initialization of the launched node agent process.
- -quiet
- Suppresses the progress information that the syncNode command
prints in normal mode.
- -logfile <fileName>
- Specifies the location of the log file to which trace information
is written. By default, the log file is named syncNode.log and
is created in the logs directory of the profile
for the node that you are synchronizing.
-profileName
- 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.
- -replacelog
- Replaces the log file instead of appending to the current log.
- -trace
- Generates trace information into a file for debugging purposes.
- -timeout <seconds>
- Specifies the waiting time before node agent initialization times
out and returns an error.
- -username <name>
- Specifies the user name for authentication if security is enabled.
Acts the same as the -user option.
- -user <name>
- Specifies the user name for authentication if security is enabled.
Acts the same as the -username option.
- -password <password>
- Specifies the password for authentication if security is enabled.
- -conntype <type>
- Specifies the Java Management Extensions (JMX) connector type
to use for connecting to the deployment manager. Valid types are
SOAP or Remote Method Invocation (RMI). The default type is SOAP.
- -help
- Prints a usage statement.
- -?
- Prints a usage statement.
Usage scenario
The following examples demonstrate
correct syntax:
syncNode testhost 8879
syncNode deploymgr 8879 -trace (produces the syncNode.log file)
syncNode host25 4444 -stopservers -restart
(assumes that the deployment manager JMX port is 4444)