syncNode 命令

syncNode 命令强制在节点和配置此节点所在的单元的 Deployment Manager 之间发生配置同步。

Node Agent 服务器运行配置同步服务,使节点配置与主单元配置保持同步。 如果 Node Agent 由于节点配置中存在问题而无法运行,那么您可以在 Node Agent 未运行时使用 syncNode 命令来执行同步,以强制使节点配置再次与单元配置同步。 如果 Node Agent 正在运行并且您要运行 syncNode 命令,那么必须首先停止该 Node Agent。

syncNode.log 文件位于 profile_root/logs 目录中。

要了解有关从何处运行此命令的更多信息,请参阅“使用命令行工具”。

语法

命令语法如下所示:
syncNode <deploymgr host> <deploymgr port> [options]
  • The <deploymgr 主机> argument is required.
  • The <deploymgr 港口> is the Java™ Management Extensions (JMX) port number that corresponds to the connector type on the -conntype parameter.

参数

以下选项可用于 syncNode 命令:

-stopservers
指示 syncNode 命令在执行单元配置同步之前停止节点上的所有服务器,包括 Node Agent。
-restart
指示 syncNode 命令在配置同步完成后启动 Node Agent 进程。 如果 Node Agent 正在运行并且您要运行 syncNode 命令,那么必须首先停止该 Node Agent。
-nowait
指示 syncNode 命令不要等待启动的 Node Agent 进程成功初始化。
-quiet
阻止 syncNode 命令以正常方式打印的进度信息。
-logfile <fileName>
指定写入跟踪信息的日志文件的位置。 缺省情况下,日志文件名为 syncNode.log,并在所同步的节点的概要文件的 logs 目录中创建。
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]在多概要文件安装中定义 Application Server 进程的概要文件。 在单概要文件环境中运行不需要 -profileName 选项。 此选项的缺省值为缺省概要文件。
-replacelog
替换日志文件,而不是附加到当前日志。
-trace
将跟踪信息生成文件以用于调试。
-timeout <seconds>
指定 Node Agent 初始化超时并返回一个错误之前的等待时间。
-username <name>
指定启用安全性时认证的用户名。 等同于 -user 选项。
-user <name>
指定启用安全性时认证的用户名。 等同于 -username 选项。
-password <password>
指定启用安全性时认证的密码。
-conntype <type>
指定用于与 Deployment Manager 进行连接的 Java 管理扩展 (JMX) 连接器类型。 有效类型有 SOAP 或远程方法调用 (RMI)。 缺省类型为 SOAP。
-help
显示用法说明。
-?
显示用法说明。

使用方案

以下示例说明正确的语法:

[AIX Solaris HP-UX Linux Windows][IBM i]
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)
[z/OS]
syncNode.sh testhost 8879

syncNode.sh deploymgr 8879 -trace (produces the syncNode.log file)

syncNode.sh host25 4444 -stopservers -restart 
(assumes that the deployment manager JMX port is 4444)
[HP-UX][Solaris]注:
  1. 在 HP-UX 或 Solaris 操作系统上,大型复杂任务执行期间可能会发生 java.lang.OutOfMemoryError: PermGen 空间问题。 例如,在具有大型应用程序的节点上运行 syncNode 一类的命令时,可能会遇到此问题。 如果资源的需求超出了缺省存储大小,那么任务可能失败,并出现 java.lang.OutOfMemoryError: PermGen 空间错误。 要解决此问题,请增加永久区域的最小大小。 将 -XX:PermSize Java 虚拟机 (JVM) 选项设置为诸如 128MB 的值,对于发生此问题的多种情况,该值已足够:
    XX:PermSize=128m
  2. 运行 syncNode 脚本时,请确保以作为服务器的 WebSphere 管理组成员的用户身份运行该脚本。 syncNode 脚本可能会将某些配置文件的所有权更改为启动该脚本的用户的所有权。

    通常,配置文件由服务器的用户标识拥有,但这不是必需的。 确保配置文件仍可由单元的 " WebSphere 管理" 组读取和写入。