动态路由选择功能部件允许将 HTTP 请求路由至 Liberty 集合体的成员而不必在环境变化时重新生成 WebSphere®
插件配置文件。添加、移除、启动、停止或修改服务器、集群成员、应用程序或虚拟主机时,系统会将新信息动态传送至 WebSphere 插件。系统将根据最新信息路由请求。此功能部件提供动态路由选择服务,此服务从集合体存储库动态检索路由信息并将其传送至
WebSphere 插件。此功能部件还提供了三个新的集合体命令操作。系统将这些操作放在一起使用以生成在插件与动态路由选择服务之间进行安全通信时所需的密钥库,以及用于在
WebSphere 插件中启用智能管理的插件配置文件。
开始之前
要点: 使用动态路由选择功能部件时,需要 Web 服务器插件中对应 WebSphere Application
Server APAR 编号 PI27023 的智能管理电子修订。启用动态路由选择功能部件前,必须安装 WebSphere Application
Server 的 Web 服务器插件支持的 Web 服务器(例如,IBM HTTP Server),为 WebSphere Application
Server 安装 8.5.5 或更高版本的 Web 服务器插件,然后安装电子修订。
- 下载并安装最新版本的 IBM Installation Manager。有关安装 IBM Installation Manager
的更多信息,请参阅安装
Installation Manager 并准备安装产品。
- 使用 Installation Manager 访问在线产品存储库,以便安装用于 WebSphere Application Server
的 Web 服务器插件及动态路由选择功能部件所需的电子修订。通过选择文件 > 首选项打开 Installation Manager GUI 首选项页面。使用 Installation Manager
从基于 Web 的存储库安装该产品,该存储库位于以下网址:
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLGILAN.v85
注: 您需要 IBM 标识来访问该存储库。此存储库仅适用于分布式平台。
- 使用安装向导安装 Web 服务器插件和必需电子修订。
- 向导提示时,指定安装位置并继续安装。
观看: The 启用 IHS 以实现 Liberty 动态路由选择视频显示如何安装 IHS、安装用于 WebSphere Application Server 的 Web 服务器插件并应用动态路由选择电子修订。[抄本]
关于此任务
要使用智能管理将 HTTP 请求路由至 Liberty 集合体,用户必须在集合体内的一个或多个集合体控制器上启用动态路由选择功能部件。
过程
- 通过将以下代码添加至控制器的 server.xml 中的 featureManager 标记以在该控制器中启用动态路由选择。
<feature>dynamicRouting-1.0</feature>
- 启动已启用动态路由选择功能部件的所有控制器。
- 在其中一个控制器上运行 dynamicRouting setup 命令以生成密钥库和插件配置文件。例如:
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=passw0rd --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1
有关动态路由选择命令的更多信息,请参阅
动态路由选择命令。
注: 请确保所指定用户名(--user 自变量的值)在用户注册表中存在并且已被分配为管理角色。
- 将所生成 plugin-key.jks 和 plugin-cfg.xml 文件复制到 Web 服务器主机上的临时目录。
- 在 Web 服务器主机上,运行 gskcmd(包含在 IHS 软件包中)以将密钥库转换为 CMS 格式并将个人证书设置为缺省值。WebSphere 插件支持 CMS 格式。例如:
gskcmd -keydb -convert -pw webAS -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
gskcmd -cert -setdefault -pw <<password>> -db /tmp/plugin-key.kdb -label default
- 将 gskcmd 从临时目录创建的 plugin-key.kdb、plugin-key.rdb 和
plugin-key.sth 文件复制到 <value of the
--pluginInstallRootargument>/config/<web server name>/ 目录
- 将 plugin-cfg.xml 复制到 IBM HTTP Server (IHS) httpd.conf 文件的 WebSpherePluginConfig 伪指令中指定的目录。将生成带有 <IntelligentManagement>
节的 plugin-cfg.xml。如果在集合体中启用了动态路由选择,那么每个集合体控制器有一个 <Connector> 节。
例如:
<IntelligentMangement>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="-1" name="default" retryInterval="60">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
- 启动 Web 服务器并开始路由至集合体中安装的应用程序。
(可选)可将
<dynamicRouting> 标记添加至控制器的
server.xml 以指定
<ConnectorCluster>
属性,例如,
maxRetries 和
retryInterval。例如:
<dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
<TraceSpecification name="default" specification=":DEBUG"/>
</dynamicRouting>
所生成
plugin-cfg.xml 看起来如下所示:
<IntelligentMangement>
<TraceSpecification name="default" specification=":DEBUG"/>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="4" name="collective1" retryInterval="20">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webServer1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
结果
启用
动态路由选择功能部件后,智能管理现在可将 HTTP 请求动态路由至 Liberty 集合体。