安装 IBM HTTP Server

Micro Gateway 实例之前,安装 IBM® HTTP Server 作为负载均衡器。

关于此任务

安装和配置以下组件:
  • 安装 IBM HTTP Server
  • 配置 IBM API Connect 控制器
  • 向集合体注册 IBM API Connect 控制器
  • 配置 IBM HTTP Server

安装 IBM HTTP Server

安装 IBM HTTP Server

关于此任务

下载并使用 IBM Installation Manager 来安装 IBM HTTP ServerInstallation Manager 缺省安装目录取决于操作系统:
  • Linux 上,缺省目录为 /opt/IBM/InstallationManager
  • Windows 上,缺省目录为 C:\Program Files\IBM\Installation Manager

过程

  1. IBM 标识注册 Web 站点中创建 IBM 标识。
  2. My IBM profile Web 站点中,单击 IBM Sign in,然后使用您的 IBM 标识登录。
  3. 下载 IBM Installation Manager
    1. 转至 Installation Manager Web 站点的 Download package 部分。
    2. 单击相应操作系统的 IBM Fix Central 链接,并按照提示来完成下载。
    所下载的压缩安装文件具有以下文件名格式:agent.installer.platform_version.zip
  4. 解压缩该压缩文件,然后运行 Installation Manager 安装。
  5. 启动 Installation Manager
    1. Linux 上,运行 /opt/IBM/InstallationManager/eclipse/IBMIM 命令。
    2. Windows 上,单击 IBM Installation Manager 图标。
  6. Installation Manager 中,单击文件 > 首选项 > 存储库
  7. 单击添加存储库,并输入以下 URL:https://www.ibm.com/software/repositorymanager/V85WASIHSILAN
  8. 输入您的 IBM 标识凭证以连接到存储库。
  9. 连接到存储库后,关闭“首选项”对话框。
  10. 单击安装向导。
  11. 选择以下要安装的软件包:IBM HTTP Server for IBM WebSphere®Application Server 和 Web Server Plug-ins for IBM WebSphereApplication Server
  12. 按照提示继续并接受许可协议。
  13. 必需: 软件包组名安装目录对话框中,修改 IBM HTTP Server 和 Web Server Plug-ins 的安装目录,以除去目录路径中的任何空格。 例如,使用您的主文件夹,如 C:\Users\IBM_ADMIN\IBM
  14. 按照提示来完成剩余的对话框,从而完成安装。

配置 IBM API Connect Profile 控制器

IBM API Connect 控制器上,生成 Web Server Plug-ins for IBM WebSphereApplication Server 所需的工件。

关于此任务

使用 wlpn-controller ihsSetup 命令来生成要供 Web Server Plug-in 使用的 plugin-cfg.xmlplugin-key.jks 文件。生成的配置文件包含 <IntelligentManagement> 部分,该部分指定动态路由所需的属性。生成的密钥库文件包含安全通信所需的证书。该命令会将所生成的文件复制到用户主目录中。
wlpn-controller ihsSetup 命令将使用以下选项:
  • --host=HOST:必需。目标集合体控制器的主机名。
  • --port=PORT:必需。目标集合体控制器的 HTTPS 端口号。
  • --user=USER:必需。目标集合体控制器的管理员用户。
  • --password[=PASSWORD]:必需。目标集合体控制器的管理员用户的密码。如果未定义任何值,那么系统将会提示您。
  • --keystorePassword=KEYSTORE_PASSWORD:必需。访问此命令所生成的 Java 密钥库 (JKS) 文件时所用的密码。要保护 IHS 与集合体控制器之间的通信,必须使用此密钥库。
  • --pluginInstallRoot=PATH:必需。Web 服务器主机上 Web Server Plug-ins 的根目录的标准路径。
  • --webServerNames=NAME[,NAME]:必需。 需要为其生成 Web Server Plug-ins 配置文件的 Web 服务器的逗号分隔名称。缺省情况下,IBM HTTP Server 服务器名称为 webserver1。所显示的命令假定使用缺省服务器名称。
  • --certificateSubject=NAME:可选。所生成的 SSL 证书的 DN。缺省 DN 为 CN=<<value of --user argument>>,OU=client,O=ibm,C=us

过程

  1. 运行具有以下选项的 wlpn-controller ihsSetup 命令:
    wlpn-controller ihsSetup --host=HOST --port=PORT --user=USER --password=PASSWORD --keystorePassword=KEYSTORE_PASSWORD --pluginInstallRoot=PATH --webServerNames=NAME[,NAME,...] [--certificateSubject=NAME]

    此命令会在当前目录中生成 plugin-cfg.xmlplugin-key.jks 文件。

  2. IBM HTTP Server 上的 %PLUGIN_PATH%/WebSphere/Plugins/config 中创建名为 webserver1 的目录。如果在 ihsSetup 命令中未使用缺省 Web 服务器名称 webserver1,请使用 Web 服务器名称创建目录。
  3. 将生成的这两个文件从用户主目录复制到新目录(例如,%PLUGIN_PATH%/WebSphere/Plugins/config/webserver1)中。

示例

生成的 plugin-cfg.xml 文件类似于以下 XML:
<?xml version="1.0"  encoding="UTF-8"?>
<Config  ASDisableNagle="false" AcceptAllContent="false"  AppServerPortPreference="HostHeader"  ChunkedResponse="false" FIPSEnable="false" IISDisableNagle="false"  IISPluginPriority="High" IgnoreDNSFailures="false"  RefreshInterval="60" ResponseChunkSize="64"  SSLConsolidate="false" TrustedProxyEnable="false"  VHostMatchingCompat="false">
<Log  LogLevel="DEBUG" Name="C:\Users\IBM_ADMIN\IBM\WebSphere\Plugins\logs\webserver1\http_plugin.log"/>
<Property  Name="ESIEnable" Value="true"/>
<Property  Name="ESIMaxCacheSize" Value="1024"/>
<Property  Name="ESIInvalidationMonitor" Value="false"/>
<Property  Name="ESIEnableToPassCookies" Value="false"/>
<Property  Name="PluginInstallRoot"  Value="C:/Users/IBM_ADMIN/IBM/WebSphere/Plugins/"/>
<!-- Configuration generated  using httpEndpointRef=defaultHttpEndpoint-->
<!-- The default_host  contained only aliases for endpoint defaultHttpEndpoint.
The generated  VirtualHostGroup will contain only configured web server ports:
webserverPort=80
webserverSecurePort=443  -->
<Property  Name="Keyfile"  Value="C:/Users/IBM_ADMIN/IBM/WebSphere/Plugins/config/webserver1/plugin-key.kdb"/>
<Property Name="Stashfile"  Value="C:/Users/IBM_ADMIN/IBM/WebSphere/Plugins/config/webserver1/plugin-key.sth"/>
<IntelligentManagement>
<TraceSpecification  name="default" specification=":DEBUG"/>
<Property  name="webserverName" value="webserver1"/>
<ConnectorCluster  enabled="true" maxRetries="-1" name="default"  retryInterval="60">
<Property  name="uri" value="/ibm/api/dynamicRouting"/>
<Connector  host="localhost" port="9443" protocol="https">
<Property  name="keyring" value="C:/Users/IBM_ADMIN/IBM/WebSphere/Plugins/config/webserver1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
</Config>

向集合体注册 IBM API Connect 控制器

向集合体注册 IBM API Connect 控制器。

关于此任务

使用 wlpn-controller ihsRegister 命令注册已配置的 IHS 实例,以便集合体能够识别该实例。
wlpn-controller ihsRegister 命令将使用以下选项:
  • --host=HOST:必需。目标集合体控制器的主机名。
  • --port=PORT:必需。目标集合体控制器的 HTTPS 端口号。
  • --user=USER:必需。目标集合体控制器的管理员用户。
  • --password[=PASSWORD]:必需。目标集合体控制器的管理员用户的密码。如果未定义任何值,那么系统将会提示您。
  • --ihsIp=IP:必需。IHS 实例的外部可路由 IP 地址。
  • --ihsPort=PORT:必需。IHS 实例的外部可路由端口。

过程

  1. IBM API Connect 控制器上,转至 %LibertyFolder%/wlp/bin 目录。
  2. 运行具有以下选项的 wlpn-controller ihsRegister 命令:
    wlpn-controller ihsRegister --host=HOST --port=PORT --user=USER --password=PASSWORD --ihsIp=IP --ihsPort=PORT

配置 IBM HTTP Server

IBM HTTP Server 上配置 Web Server Plug-in,以使用 IBM API Connect 服务器生成的配置和密钥库文件。

关于此任务

IBM HTTP Server 上的 Web Server Plug-in 使用 plugin-cfg.xml 文件中的配置数据来路由请求。使用 LoadModule 命令启用 Web Server Plug-in,并使用 WebSpherePluginConfig 命令指定 plugin-cfg.xml 文件的位置。

使用 gskcmd 命令将密钥库转换为 Web Server Plug-in 可使用的格式。

过程

  1. 编辑 %IHS_Installed_Path%/HTTPServer/conf/httpd.conf 配置文件,并在文件末尾附加以下行。然后,保存该文件。
    1. 对于 Windows,请附加以下行:
      LoadModule was_ap22_module %PLUGIN_PATH%/WebSphere/Plugins/bin/32bits/mod_was_ap22_http.dll
      WebSpherePluginConfig %PLUGIN_PATH%/WebSphere/Plugins/config/webserver1/plugin-cfg.xml
    2. 对于 IHS 安装在 /opt/IBM/HTTPServer 中且 Web Server Plug-in 安装在 /opt/IBM/WebSphere/Plugins 中的 Linux 环境,请附加以下行:
      LoadModule was_ap22_module /opt/IBM/WebSphere/Plugins/bin/64bits/mod_was_ap22_http.so
      WebSpherePluginConfig /opt/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml
  2. 创建空文件:%PLUGIN_PATH%/WebSphere/Plugins/logs/webserver1/http_plugin.log
  3. %IHS_Installed_Path%/HTTPServer/bin 目录中,运行以下命令以转换密钥库:
    gskcmd -keydb -convert -stash -pw <password> -db %PLUGIN_PATH%/WebSphere/Plugins/config/webserver1/plugin-key.jks -old_format jks -target %INSTALLED_FOLDER%/WebSphere/Plugins/config/webserver1/plugin-key.kdb -new_format cms
    gskcmd -cert -setdefault -pw <password> -db %PLUGIN_PATH%/WebSphere/Plugins/config/webserver1/plugin-key.kdb -label default


    确保当前工作目录位于 PATH 中,否则此命令将返回 Command not found. 错误。在这种情况下,请在 gskcmd 命令前使用 ./ 以在搜索路径中包含当前工作目录。

    对于 <password> 值,请指定密钥库的密码;如果使用了缺省密码,请指定 WebAS。有关更多信息,请参阅 IBM HTTP Server 中的密钥管理实用程序主题。

    这些命令将在 %PLUGIN_PATH%/WebSphere/Plugins/config/webserver1/ 中创建以下文件:
    plugin-key.rdbplugin-key.sthplugin-key.kdb

  4. 启动或重新启动 IBM HTTP Server
    1. 对于 Windows,请使用 httpd.exe 命令,此命令位于 IBM HTTP Server 安装的 bin 目录中:
      httpd.exe -w -n "IBM HTTP Server V8.5" -k [start | restart]
    2. 对于 Linux,请运行以下某个命令来使用 Apachectl 实用程序:
      sudo ./apachectl -k [start | restart]
      sudo %IHS_DIR%/bin/apachectl -k [start | restart]

下一步做什么

如果要在本地安装 Professional 产品和 Micro Gateway,那么接下来需要安装 Micro Gateway
时间戳记图标 上次更新时间:2017-10-24