本章节提供了将 Virtualize 服务器部署到 WebSphere 的示例说明。有关更新到新版本的 SOAtest 和 Virtualize 服务器的说明,请查阅 升级 WebSphere 部署 。
- 下载 parasoft_soavirt_server_<version>.zip ,提取 soavirt.war 文件。
- 安装 WebSphere 并创建服务器。查看安装说明文档: 安装、更新和配置 WebSphere 8.5 和 8.5.5。
您可以从开发人员资源库的 WebSphere 中下载 WebSphere: https://developer.ibm.com/wasdev/downloads/#asset/WAS_traditional_for_Developers - 在 Profile Creation Summary 中,选择位置 (<WEBSPHERE_HOME>) 和服务器名称 (<SERVER_NAME>)。
- 验证您的 WebSphere 安装是否使用 Java 8。下面的文章描述了如何做到这一点: 我的 WebSphere Application Server V8.5 使用的是哪个 Java 版本?
如果需要为 WebSphere 安装 Java 8,下面的文章提供了说明:使用 GUI 安装 IBM WebSphere SDK Java Technology Edition Version 8.0
- 运行以下命令以验证该服务器是否在运行:
<WEBSPHERE_HOME>/bin/serverStatus.bat <SERVER_NAME>
如果服务器没有运行,则运行 startServer.bat 脚本以启动它:<WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME>
- 登录 WebSphere 管理控制台: http://localhost:9060/ibm/console.您可以将用户 ID 字段保留为空,或者使用安装 WebSphere 时创建的 ID。
- 选择 Applications> Application Types> WebSphere enterprise applications ,卸载默认应用程序。
- 选择 Applications> New Application> New Enterprise Application ,选择 soavirt.war 文件。
- 单击 Next。
- 选择 Fast Path ,然后单击 Next。
- 将 Directory 设置来安装 <SERVER_HOME> 的选项,然后单击 Next。
- 选择 SOAVirt 模块,然后单击 Next。
- 保留 “default_host”,单击 Next。
- 验证上下文根是否设置为 “/”,然后单击 Next。
- 验证配置,然后单击 Next。
- 安装完成后,单击 Save directly to the master configuration。
- 选择 Applications> Application Types> WebSphere enterprise applications ,然后单击 SOAVirt。
- 在 Module 设置组中,选择 Manage Modules 然后选择 SOAVirt 模块。
- 将类加载器顺序更改为 parent last,然后单击 OK。
- 在详细属性设置组中,选择 Class loading and update detection。
- 将类加载器顺序更改为 parent last,然后单击 OK。
- 单击 OK ,然后单击 Save directly to the master configuration。
- 在位于 <SOAVIRT_HOME>/<SOAVIRT_WAR>.ear/<SOAVIRT_WAR>/WEB-INF/config.properties 的 config.properties 文件中指定端口和适当的许可证。
- (可选)如果希望在 HTTPS 上部署 WAR 文件,请执行以下步骤来配置 SSL:
- 选择 Security> SSL certificate and key management> Key stores and certificates> NodeDefaultKeystore> Personal certificates ,然后单击 Import/Create SSL certificate。
- 选择 Security> SSL certificate and key management> SSL configurations> NodeDefaultSSLSettings ,设置默认服务器证书别名选项以使用新证书。
- 选择 Servers> Server Types> WebSphere Application Servers> <SERVER_NAME>> Ports 并更改 Wc_defaulthost_secure 端口以匹配 config.properties 文件中配置的
server.port.https
端口设置。 - 选择 Environment> Virtual Hosts> default_host> Host Aliases 并添加新的主机别名:
Host Name = *
Port = SSL port
- 单击 Save directly to the master configuration。
- 使用以下命令重新启动服务器:
<WEBSPHERE_HOME>/bin/stopServer.bat <SERVER_NAME>
<WEBSPHERE_HOME>/bin/startServer.bat <SERVER_NAME>
- 打开 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 文档。