本章节提供了将 Virtualize 服务器部署到 WebSphere 的示例说明。有关更新到新版本的 SOAtest 和 Virtualize 服务器的说明,请查阅 升级 WebSphere 部署 。

  1. 下载 parasoft_soavirt_server_<version>.zip ,提取 soavirt.war 文件。
  2. 安装 WebSphere 并创建服务器。查看安装说明文档:  安装、更新和配置 WebSphere 8.5 和 8.5.5
    您可以从开发人员资源库的 WebSphere 中下载 WebSphere:  https://developer.ibm.com/wasdev/downloads/#asset/WAS_traditional_for_Developers 
  3. 在 Profile Creation Summary 中,选择位置 (<WEBSPHERE_HOME>) 和服务器名称 (<SERVER_NAME>)。
  4. 验证您的 WebSphere 安装是否使用 Java 8。下面的文章描述了如何做到这一点:  我的 WebSphere Application Server V8.5 使用的是哪个 Java 版本?

    如果需要为 WebSphere 安装 Java 8,下面的文章提供了说明:使用 GUI 安装 IBM WebSphere SDK Java Technology Edition Version 8.0
     
  5. 运行以下命令以验证该服务器是否在运行:

    <WEBSPHERE_HOME>/bin/serverStatus.bat <SERVER_NAME>

    如果服务器没有运行,则运行 startServer.bat 脚本以启动它:

    <WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME>
  6. 登录 WebSphere 管理控制台: http://localhost:9060/ibm/console.您可以将用户 ID 字段保留为空,或者使用安装 WebSphere 时创建的 ID。
  7. 选择 Applications> Application Types> WebSphere enterprise applications ,卸载默认应用程序。
  8. 选择 Applications> New Application> New Enterprise Application ,选择 soavirt.war 文件。
  9. 单击 Next
  10. 选择 Fast Path ,然后单击 Next
  11. 将 Directory 设置来安装 <SERVER_HOME> 的选项,然后单击 Next
  12. 选择 SOAVirt 模块,然后单击 Next
  13. 保留 “default_host”,单击 Next
  14. 验证上下文根是否设置为 “/”,然后单击 Next
  15. 验证配置,然后单击 Next。
  16. 安装完成后,单击 Save directly to the master configuration
  17. 选择 Applications> Application Types> WebSphere enterprise applications ,然后单击 SOAVirt
  18. 在 Module 设置组中,选择 Manage Modules 然后选择 SOAVirt 模块。
  19. 将类加载器顺序更改为 parent last,然后单击 OK
  20. 在详细属性设置组中,选择 Class loading and update detection
  21. 将类加载器顺序更改为 parent last,然后单击 OK
  22. 单击 OK ,然后单击 Save directly to the master configuration
  23. 在位于 <SOAVIRT_HOME>/<SOAVIRT_WAR>.ear/<SOAVIRT_WAR>/WEB-INF/config.properties 的 config.properties 文件中指定端口和适当的许可证。
  24. (可选)如果希望在 HTTPS 上部署 WAR 文件,请执行以下步骤来配置 SSL:
    1. 选择 Security> SSL certificate and key management> Key stores and certificates> NodeDefaultKeystore> Personal certificates ,然后单击 Import/Create SSL certificate
    2. 选择 Security> SSL certificate and key management> SSL configurations> NodeDefaultSSLSettings ,设置默认服务器证书别名选项以使用新证书。
    3. 选择 Servers> Server Types> WebSphere Application Servers> <SERVER_NAME>> Ports 并更改 Wc_defaulthost_secure 端口以匹配 config.properties 文件中配置的 server.port.https 端口设置。
    4. 选择 Environment> Virtual Hosts> default_host> Host Aliases 并添加新的主机别名:

      Host Name = *
      Port = SSL port
    5. 单击 Save directly to the master configuration
  25. 使用以下命令重新启动服务器:

    <WEBSPHERE_HOME>/bin/stopServer.bat <SERVER_NAME>
    <WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME>
  26. 打开 http://localhost:<WEB_PORT>。<WEB_PORT> 配置的端口应该与 Servers> Server Types> WebSphere Application Servers> <SERVER_NAME>> Ports中 Wc_defaulthost 端口相同。

如果出现以下信息,则表示应用程序安装正确:

此服务器上没有部署。无法响应该请求:/。

如果安装成功,则将在以下位置创建工作空间目录:

<SOAVIRT_HOME>/<SOAVIRT_WAR>.ear/<SOAVIRT_WAR>/workspace

关于有效查询参数

查询参数的预期格式为 name=value。不包含等号(=)的查询的默认行为是返回空值。您可以配置 WebSphere(版本8.5.5.2+)以在请求仅在查询参数中包含字符串名称时返回空字符串作为值。

在 web 容器自定义属性设置中设置以下属性:

com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual=true

有关更多详情,请参考 WebSphere 文档。

https://www.ibm.com/support/knowledgecenter/en/SSAW57_8.5.5/com.ibm.websphere.nd.multiplatform.doc/ae/rweb_custom_props.html

  • No labels