可以使用 addNode 命令的 -asExistingNode 选项来恢复和移动 Deployment Manager 的节点。使用 -asExistingNode 选项将新的定制节点作为现有节点联合到 Deployment Manager 中。在联合期间,该产品使用 Deployment Manager 主配置中的信息将该定制节点变换为现有节点。
开始之前
本主题假定 WebSphere® Application Server Network Deployment 产品具有 Deployment Manager 和一个或多个受管节点。
关于此任务
可以使用 addNode 命令的 -asExistingNode 选项来快速恢复已损坏的节点、将节点移至另一台计算机上位于相同路径的产品安装版本、将节点移至另一操作系统上或者具有不同路径的产品安装版本、或者根据模板单元来创建单元。
下列过程描述了如何使用 -asExistingNode 选项:
避免故障: 节点配置的其他
addNode 选项与此
-asExistingNode 选项不兼容。请勿将
-asExistingNode 与下列不兼容的选项一起使用:
- -includeapps
- -includebuses
- -startingport
- -portprops
- -nodeagentshortname
- -nodegroupname
- -registerservice
- -serviceusername
- -servicepassword
- -coregroupname
- -excludesecuritydomains
gotcha
附带 -asExistingNode 选项来运行 addNode 命令时,该产品不会检查或解决端口之间的冲突。必须验证与某个节点相关联的端口与目标主机上已经在使用的端口不发生冲突。
过程
- 恢复 Deployment Manager 的现有受管节点。
可以使用 addNode 命令的 -asExistingNode 选项来恢复已损坏的现有节点。例如,如果计算机故障导致节点不可用,但是节点信息仍保留在 Deployment Manager 中,那么您可以使用 -asExistingNode 选项来重新创建此不可用的节点。
- 确保现有已损坏节点未在运行。请停止 Node Agent 以及该节点上的任何应用程序服务器。
- 移除原始概要文件,然后创建概要文件以替换已损坏的节点,并为其指定与不可用的节点相同的概要文件路径、概要文件名称和节点名。或者,如果原始计算机不可用,而您已经配置了具有相同主机名的新计算机,那么您可以在原始节点所在计算机之外的计算机上创建概要文件。
例如,假定概要文件名为 AppSrv01 的 myNode01
节点已停止工作。要将其替换为新节点,请为节点 myNode01 创建名为 AppSrv01 的应用程序服务器概要文件。
- 在已损坏的应用程序服务器概要文件的 bin 目录下,从命令行运行附带 -asExistingNode 选项的 addNode 命令。
新节点的名称必须与运行带有 -asExistingNode
选项的 addNode 命令的位置的节点的名称相匹配。
- 打开命令提示符,并切换到应用程序服务器概要文件 bin 目录。例如,对于应用程序服务器概要文件 AppSrv01,请切换到 profile_root/AppSrv01/bin 目录。
- 运行附带 -asExistingNode 选项的 addNode 命令以将应用程序服务器节点替换为新节点。以下示例命令假定启用了安全性,并且该产品要求您输入用户名和密码。对于 dmgr_host 和 dmgr_port,请指定 Deployment Manager 的主机名和端口号。
addNode dmgr_host dmgr_port -asExistingNode -username user_name -password password
限制: 先前安装的 JCA 适配器未作为 WebSphere 配置的一部分进行存储。替换节点之后,请重新安装 JCA 适配器以使它们能够在新环境中运行。
- 使单元中的所有其他活动节点同步。
要使用 Deployment Manager 管理控制台来恢复受管节点,请参阅有关添加、管理和移除节点的主题。
- 将节点移至另一台计算机上位于相同路径的产品安装版本。
可以使用 -asExistingNode 选项将节点移至另一台计算机,前提是另一台计算机上的下列设置相同。
- WebSphere Application Server 安装目录
- 概要文件名称
- 概要文件目录
- 节点名
此过程涉及到三个不同的概要文件:
- deployment manager profile 是 Deployment Manager 的概要文件。从 Deployment Manager 概要文件运行 changeHostName 命令。
- source profile 是您要从其进行移动的原始概要文件。
- destination profile 是您要移至另一计算机上的概要文件。
- 请确保您要移动的节点和源概要文件未运行。请停止 Node Agent 以及该节点上的任何应用程序服务器。
- 请更改存在于 Deployment Manager 中的主配置中的节点的主机名。
请执行下列步骤,这些步骤涉及到 Deployment Manager 概要文件:
- 打开命令提示符,并切换到 Deployment Manager 概要文件 bin 目录。例如,如果 Deployment Manager 概要文件名为 Dmgr01,那么切换到 profile_root/Dmgr01/bin 目录。
- 运行用于更改节点的主机名的 wsadmin Jython 命令。下列示例命令假定启用了安全性,并且该产品要求您输入用户名和密码。对于 new_host_name,请指定目标计算机的主机名。
wsadmin -lang jython -userName user_name -password password
AdminTask.changeHostName('[-hostName new_host_name -nodeName node_name]')
AdminConfig.save()
quit
- 将节点从源计算机上的产品安装版本移至目标计算机上的产品安装版本。
请在目标计算机上执行下列步骤,这些步骤涉及到目标概要文件:
- 在与源计算机上的产品安装目录同名的目录中安装 WebSphere Application Server。
- 创建一个与您要移动的节点的概要文件具有相同概要文件名称、概要文件目录和节点名的定制概要文件。创建此定制概要文件时,请选择稍后联合节点。请勿选择在创建概要文件期间联合节点。
- 打开命令提示符,并切换到应用程序服务器概要文件 bin 目录。例如,如果应用程序服务器概要文件名为 AppSrv01,那么切换到 profile_root/AppSrv01/bin 目录。
- 运行附带 -asExistingNode 选项的 addNode 命令以将应用程序服务器节点替换为您要移动的节点。以下示例命令假定启用了安全性,并且该产品要求您输入用户名和密码。对于 dmgr_host 和 dmgr_port,请指定目标 Deployment Manager 的主机名和端口号。
addNode dmgr_host dmgr_port -asExistingNode -username user_name -password password
限制: 先前安装的 JCA 适配器未作为 WebSphere 配置的一部分进行存储。移动节点之后,请重新安装 JCA 适配器以使它们能够在新环境中运行。
- 使用目标 Deployment Manager 的管理控制台或者 wsadmin 使节点上的服务器能够正常运行。
- 启动该节点。此步骤涉及到目标概要文件。
- 更新虚拟主机(主机别名)以包括应用程序服务器节点的目标主机名。
- 启动该节点的应用程序服务器。
- 如果该节点使用安全套接字层 (SSL) 证书,请更改缺省证书以包含该节点的主机名。
请参阅有关创建 SSL 证书以替换节点中的现有证书的主题。
- 使单元中的所有其他活动节点同步。
您可能需要更新静态配置为使用位于特定主机上的应用程序服务器的其他基础架构组件(例如,Web 服务器)的配置。
- 将节点移至另一操作系统上或者具有不同路径的产品安装版本。
可以使用 -asExistingNode 选项将节点移至具有相同操作系统,但是主机名和路径不同的另一台计算机上的产品安装版本。您还可以使用此选项将节点移至具有不同操作系统、但是具有兼容的配置文件的另一台计算机上的产品安装版本;例如,从 AIX 操作系统移至 Windows 操作系统。
限制: - 使用调度程序的应用程序只有在使用同一主机名的情况下才能正常运行。因为主机名嵌入在已调度的每项任务中,因此,在您移动节点之前就已存在的任务将不能正常运行,而在移动之后创建的任务将正常运行。在移动节点之后,请重新调度在您移动该节点时就已存在的任何已调度的任务。
- 无法在 z/OS 上的产品安装版本与非 z/OS 操作系统上的产品安装版本之间移动节点。
- 先前安装的 JCA 适配器未作为 WebSphere 配置的一部分进行存储。移动节点之后,请重新安装 JCA 适配器以使它们能够在新环境中运行。
此任务假定具有您要移动的节点的计算机(源计算机)上的 WebSphere Application Server 安装目录和概要文件目录与目标计算机上的相应目录不同。但是,源计算机和计算机上的节点概要文件名和节点名必须相同。
要完成此任务,请执行将节点移至另一台计算机上位于相同路径的产品安装版本任务中的步骤,但是,在将此节点移至目标计算机之前,在 Deployment Manager 配置的变量映射中更改每个节点的产品安装版本和概要文件路径除外。例如:
- 在 Deployment Manager 管理控制台中,单击。
- 在“WebSphere 变量”页面上,选择节点范围,然后单击 WAS_INSTALL_ROOT 变量。
- 在 WAS_INSTALL_ROOT 变量的设置页面上,更改值设置以指定新的产品安装路径并保存更改。
- 在“WebSphere 变量”页面上,选择节点范围之后,单击 USER_INSTALL_ROOT 变量。
- 在 USER_INSTALL_ROOT 变量的设置页面上,更改值设置以指定新的概要文件安装路径并保存更改。
- 根据需要重复执行这些步骤以更改产品安装版本以及每个节点的概要文件路径,以使这些路径对于目标计算机正确。
对于此任务,目标计算机和源计算机上的产品安装版本和概要文件目录不需要相同。
- 根据模板单元来创建单元。
可以使用 addNode 命令的 -asExistingNode 选项根据现有单元来快速创建单元。新单元必须与模板单元同名。
限制: - 调度程序应用程序在多种环境中不能正常运行。因为主机名嵌入在已调度的每项任务中,因此,在您移动节点之前就已存在的任务将不能正常运行,而在移动之后创建的任务将正常运行。在移动节点之后,请重新调度在您移动该节点时就已存在的任何已调度的任务。
- 您必须评估每种环境是否需要不同的资源(例如,数据源)。
- 先前安装的 JCA 适配器未作为 WebSphere 配置的一部分进行存储。移动节点之后,请重新安装 JCA 适配器以使它们能够在新环境中运行。
如果启用了安全性,您可能必须为新单元重新生成新的密钥和令牌。
- 创建一个单元,并将其配置为要用于新的产品安装版本的模板单元。
- 使用 backupConfig 命令生成 Deployment Manager 概要文件配置的副本。您将使用此配置副本来复原新安装版本中的 Deployment Manager 配置。
- 将模板单元复制到新的产品安装版本。
要配置每种新环境,请完成下列步骤:
- 安装 WebSphere Application Server。
- 创建 Deployment Manager 概要文件和应用程序服务器节点概要文件。应用程序服务器概要文件必须与模板单元具有相同的节点名。
- 使用 restoreConfig 命令复原 Deployment Manager 概要文件配置。使用 wsadmin 以本地方式更新 Deployment Manager 主机名。如果概要文件路径或者产品安装路径已更改,请修改 Deployment Manager 节点的 variables.xml 文件以反映新路径。根据需要更新其他属性文件。您可能需要更新诸如 wsadmin.properties 和 soap.client.props 等属性文件。
- 定制 Deployment Manager 概要文件上的每个节点配置。例如,更改下列设置:
- 主机名
- 端口
- 产品安装目录
- 概要文件目录
- 安全性配置
- 对每个节点运行 addNode –asExistingNode。您可以从每个节点同时运行此命令。
- 打开命令提示符,并切换到应用程序服务器概要文件 bin 目录。例如,如果应用程序服务器概要文件名为 AppSrv01,那么切换到 profile_root/AppSrv01/bin 目录。
- 运行附带 -asExistingNode 选项的 addNode 命令以将应用程序服务器节点替换为目标单元上的节点。以下示例命令假定启用了安全性,并且该产品要求您输入用户名和密码。对于 dmgr_host 和 dmgr_port,请指定目标 Deployment Manager 的主机名和端口号。
addNode dmgr_host dmgr_port -asExistingNode -username user_name -password password
- 使用新的 Deployment Manager 的管理控制台或者 wsadmin 使每个节点的服务器能够正常运行。
- 启动该节点。从节点概要文件运行 startNode 命令。
- 更新虚拟主机(主机别名)以包括应用程序服务器节点的主机名。
- 启动该节点的应用程序服务器。
- 如果该单元使用安全套接字层 (SSL) 证书,请替换根密钥库 DmgrDefaultRootStore 中的自签名根证书。
请参阅有关创建 SSL 证书以替换单元中的现有证书的主题。
- 使单元中的所有其他活动节点同步。
下一步做什么
检查目标安装版本中的节点,以确保节点配置正常运行。必要时,请删除源安装版本的概要文件。