使用 addNode 命令将独立的节点添加到单元中。
addNode 命令执行以下操作:
- 将基础 WebSphere® Application Server 单元配置复制到新的单元结构。此新单元结构与 Deployment Manager 的结构相匹配。
- 为单元合并的节点创建新的 Node Agent 定义。
- 将命令发送到 Deployment Manager,以将文档从新节点添加到单元库。
- 执行新节点的第一个配置同步,并验证此节点与此单元同步。
- 为新节点启动 Node Agent 进程。
- 更新 setupCmdLine.bat 或 setupCmdline.sh 文件和
wsadmin.properties 文件以指向新单元。
- 联合节点之后,addNode 命令将
plugin-cfg.xml 文件从 app_server_root/config/cells 目录备份至 config/backup/base/cells 目录。addNode 命令在 Deployment Manger 重新生成新的
plugin-cfg.xml 文件,而 nodeSync 操作将该文件复制到节点级别。
有关端口号的信息,请参阅『端口号设置』主题。
使用
addNode 命令的技巧:
- 如果将节点添加到单元中,那么您要联合的节点的单元名必须与节点所联合至的单元名不相同。否则,您会接收到
ADMU0027E 消息,并且 addNode 命令不会将该节点添加到单元中。
- 验证 Deployment Manager 和节点是否已更新到 WebSphere Application Server 内的同一修订版级别。例如,6.0.1 级别的 Deployment Manager 将无法与 6.0.2 级别的节点联合。
- 不要将 WebSphere Application Server .jar 文件放在整个系统的一般
CLASSPATH 变量(缺省类路径)中。
如果 WebSphere Application Server Network Deployment 产品无法解析服务器的主机名,那么可能是添加或管理节点或者 Node Agent 与应用程序服务器联系时发生了问题。要解析主机名,该产品将打开一个端口或者查询 IP 地址。然后,该产品将等待操作系统返回正确的信息。操作系统可能会在多处查找 IP 地址,但是,如果返回了正确的信息,产品不会关心操作系统的查找顺序。如果不能解析服务器的主机名,请参阅网络管理文档以解决此问题。下列附加信息可帮助您确保解析主机名。
- 缺省情况下,在节点上安装的应用程序将不会复制到单元。如果您在使用 addNode 命令后安装应用程序,那么将在单元上安装应用程序。通过指定 -includeapps 选项,您强制 addNode 命令将应用程序从节点复制到单元。名称重复的应用程序将不会复制到单元。
- 不合并单元级别的文档。使用 addNode 命令前您对独立单元级别文档进行的任何更改都必须在新单元上重复。例如,虚拟主机。
- 如果您在使用 addNode 命令时接收到 OutOfMemory 异常,那么您可能需要增加 Deployment Manager 的堆大小。要增加 Deployment Manager 的堆大小,请调整最大堆大小参数。例如,在管理控制台中,转至,然后增大最大堆大小值。
避免故障: 在
HP-UX 或 Solaris 操作系统上,大型复杂任务执行期间可能会发生
java.lang.OutOfMemoryError: PermGen 空间问题。例如,在具有大型应用程序的节点上运行
addNode 一类的命令时,可能会遇到此问题。如果资源的需求超出了缺省存储大小,那么任务可能失败,并出现
java.lang.OutOfMemoryError: PermGen 空间错误。要解决此问题,请增加永久区域的最小大小。将
-XX:PermSize Java™ 虚拟机 (JVM) 选项设置为诸如
128MB 的值,对于发生此问题的多种情况,该值已足够:
XX:PermSize=128m
gotcha
- 在某些实例中,Deployment Manager 响应 addNode 命令的时间可能比预期的长。缺省超时值(它确定客户机将等待服务器响应多长时间)适合于大多数情况。但是,您可能需要更多时间以便服务器在更繁重的处理条件下响应。例如,如果您包括 -includeapps 选项并具有大量应用程序,或者应用程序非常大,那么缺省值 180 秒可能不够。要更改缺省超时值,请在任何
ASCII 文本编辑器中打开
app_server_root/profiles/profile_name/properties/soap.client.props 文件,并查找以下行(此处显示了缺省值 180 秒):
com.ibm.SOAP.requestTimeout=180
如果需要更改缺省值,您可以更改此行来将超时设置为更适合您的情况的值。注: 将缺省超时值设置为 0 秒将禁用超时检查。
如果将超时值设置得太高,那么您必须等待较长时间才能确定
addNode 命令是否会成功完成它对 Deployment Manager 的请求。如果将该值设置得太短,那么在 addNode 命令断定 Deployment Manager 未在响应之前,Deployment Manager 将没有足够的时间完成请求,并且将以一个错误进行响应。可能影响服务器超时的其他因素包括
Deployment Manager 上的处理负载或过多的页面调度以及网络等待时间。其中某些情况可能是瞬态的。
- 如果接收到关于时钟同步失败的 addNode 错误消息,请确保带有要联合的节点的计算机与要联合该节点的
Deployment Manager 计算机在时间上同步。
- 如果您从已联合至现有 Deployment Manager 的节点使用 addNode 命令,那么该 Deployment Manager 将会损坏。而且,另一个 Deployment Manager 在停止后将无法启动。发生这种情况的原因是
addNode 命令在主配置中创建了 dmgrProfile/config/cells/dmgrCell/dmgrCell 目录。该目录不是一个完整的节点配置目录。
如果您有一个联合的节点并再次对不同的 Deployment Manager 运行 addNode 命令,那么会遇到此问题。此问题会导致 Deployment Manager 损坏,而且因为节点目录不完整,以后您将无法启动该 Deployment Manager。
请执行下列其中一个解决方案以解决此问题:
- 如果该 Deployment Manager 正在运行,您可以在不完整的节点所在的 Deployment Manager 上使用cleanupNode 命令。
- 手动删除在执行 addNode 命令操作期间在不完整的 Deployment Manager 配置上创建的目录。例如:app_server_root/profiles/dmgrProfile/config/cells/dmgrCell/nodeName。