可以向 Liberty 集合体控制器注册主机、更新主机信息或者注销主机。通过注册,使得集合体控制器能够访问主机上的应用程序、命令文件和其他资源。已注册的主机是集合体的成员。
关于此任务
主机不必安装任何 WebSphere Application Server 产品。除了操作系统之外,主机没有其他软件需求。主机可以是安装产品的计算机,也可以是另一计算机。
要向集合体控制器注册主机、更新主机信息和注销主机,请分别使用
registerHost、
updateHost 和
unregisterHost 命令。使用以下其中一种格式来指定主机名称:
- 标准域名服务器 (DNS) 主机名字符串,例如 xmachine.ibm.com
- 缺省的短 DNS 主机名字符串,例如 xmachine
- 数字 IP 地址,例如,127.1.255.3
注: 使 Liberty 服务器加入集合体时,如果关联的主机尚未注册,那么系统会自动向集合体控制器注册该主机。
可以用不同的名称向集合体注册主机。请确保对 registerHost、updateHost 和
unregisterHost 指定的主机名与所注册集合体成员使用的主机名一致。所注册服务器成员的 server.xml 文件中的 defaultHostName 变量控制服务器认为其自身所属的主机名。
- 向集合体控制器注册主机。
要注册当前主机(集合体控制器主机和远程目标主机为同一计算机),请在集合体实用程序脚本上运行
registerHost 命令并且不指定任何显式主机目标。指定集合体控制器的主机名、端口以及管理用户名和密码。例如:
wlp/bin/collective registerHost --host=controllerHost --port=controllerHTTPSPort
--user=controllerAdmin --password=controllerAdminPassword
此示例命令将生成唯一 SSH 密钥对,以向指定主机的 SSH 服务器进行认证。如果要注册已对其生成 SSH 密钥对的远程主机,那么可指定 SSH 专用密钥文件的路径。以下
registerHost 命令假定 SSH 专用密钥存储在本地控制器计算机上的
/home/user1/.ssh/id_rsa 中。SSH 密钥对中的另一文件是远程目标主机上的
/home/user1/.ssh/authorized_keys
公用密钥文件。
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--sshPrivateKey=/home/user1/.ssh/id_rsa
如果远程目标主机不支持 SSH 或者您不想使用 SSH 密钥,那么您可以对
rpcUser 指定操作系统登录用户,并对
rpcUserPassword 指定登录密码。如果包含
rpcUser 和
rpcUserPassword,请不要包含
sshPrivateKey。用于指定操作系统登录用户和密码的命令类似如下所示:
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUserForRemoteHost --rpcUserPassword=osUserPasswordForRemoteHost
要将文件传输至主机或从主机传输文件,必须指定主机读写路径。在
registerHost 命令指定了路径的情况下,才可将 Liberty 归档部署到主机。
hostReadPath 指定集合体控制器可读取的目录。
hostWritePath 指定集合体控制器可写入的目录。
hostWritePath 所指定的路径也是可读的。例如,要将归档上载到
/opt/wlp,必须指定
--hostWritePath=/opt。为多个路径多次指定一个参数。
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/opt --hostWritePath=/dir1 --hostWritePath=/dir2
要使用 WebSphere Liberty Administrative Center ("Admin Center") 的部署工具,必须将
hostWritePath 设置为要将服务器软件包部署到的路径。要将文件传输至多个目录,请在命令中包含
hostWritePath 参数的多个实例。例如:
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin
--password=controllerAdminPassword --rpcUser=osUser --rpcUserPassword=osUserPassword--hostWritePath=c:\was\liberty\brokerageAppTest --hostWritePath=c:\wlp_backup
在使用 Admin Center 的部署工具部署服务器软件包之前,请完成设置 RXA 以执行 Liberty 集合体操作 中与您的主机操作系统对应的步骤。
(可选)使用 -hostJavaHome 参数指定指向主机 Java 主目录的路径。例如:-hostJavaHome=c:\java\jre
- 更新已注册的主机认证信息。
在集合体实用程序脚本中运行 updateHost 命令,以更改已注册的主机的认证信息。例如,如果用户密码更改,那么以下命令会更新集合体所使用的主机密码:
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=newOsUserPassword
- 更新注册的主机读路径或写路径。
在集合体实用程序脚本上运行 updateHost 命令,以更改主机读路径和写路径。此命令中的路径会覆盖先前为 hostReadPath 和 hostWritePath 设置的路径,请不要添加到现有路径。
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/optNew --hostWritePath=/opt --hostWritePath=/home/osUser
- 从集合体控制器注销主机。
在集合体实用程序脚本中运行 unregisterHost 命令;例如:
wlp/bin/collective unregisterHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
注销主机将移除该主机上的所有已注册的服务器,并从集合体控制器中移除任何其他基于主机的信息。
下一步做什么
有关 registerHost、updateHost 和 unregisterHost 命令的所有参数的信息,请参阅有关 CollectiveRegistration MBean 的 API 文档。