Operating Systems: i5/OS
Personalize the table of contents and search results
syncNode command
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.
The syncNode.log file is located in the profile_root/logs directory.
For more information about where to run this command, see the Using
command tools article.
Syntax
The command syntax is as follows:
syncNode <deploymgr host> <deploymgr port> [options]
where the <deploymgr host> argument is required.
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.
- -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>
-
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.
- -statusport <portnumber>
-
Specifies that an administrator can set the port number for node agent
status callback.
- -username <name>
-
User name for authentication if security is enabled. Acts
the same as the -user option.
- -user <name>
-
User name for authentication if security is enabled. Acts
the same as the -username option.
- -password <password>
-
Password for authentication if security is enabled.
- -conntype <type>
-
Specifies the JMX connector type to use for
connecting to the deployment manager. Valid types are SOAP or Remote Method
Invocation (RMI).
- -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)
Related concepts
Remote file services
Related tasks
Synchronizing nodes with the wsadmin tool
Reference topic