1.1 版本

1.2 应用场景

有时用户需要将工程部署在 WebSphere 中使用。

1.3 功能介绍

FineReport 支持将工程部署在 WebSphere 中使用。本文以 Linux 系统为例部署 WebSphere8.5 服务器。

注：目前 Windows+Websphere8.5 及以上版本不支持部署 FineReport11.0 报表工程。

本例配置为：CentOS8.0+WebSphere8.5+JDK1.8，其他版本步骤基本相同，可能每个版本功能位置不同。

2.1 环境准备

需参考 部署环境准备 文档，准备相关环境。

2.2 引入 tools.jar

服务器部署 FineReport11.0 工程时，需要引入 JDK下 tools.jar，引入方法参见：服务器部署需引入 tools.jar

但要注意的是，WebSphere 要引入的是 WAS 自带 JDK 的 tools.jar，路径为：%WEBSPHERE_HOME%/AppServer/java/lib/tools.jar。

2.3 打 war 包

1）使用命令 cmd 进入%FineReport_HOME%\webapps\webroot所在的目录，在出现的命令提示符窗口中键入jar cvf webroot.war *，把 webroot 这个文件夹压缩成 webroot.war 包。命令如下所示：

cd %FineReport_HOME%\webroot
jar cvf webroot.war *

注1：系统中需要安装 JDK 才能使用命令 jar cvf webroot.war *

2）得到 war 包如下图所示：

注：war 包即为要部署到 WebSphere 服务器上的工程，可根据需要重命名，如：可改为"FineReport"，"websphereweb"等等。访问报表时路径中的工程名也要随之更改。

2.4 Websphere部署

将 webroot.war 拷贝至 WebSphere 所在的服务器，这里将其拷贝到%FR_HOME%\webapps\webroot\webroot.war

1）启动 WebSphere 服务器，登录管理控制台

WebSphere 的部署是在管理控制台进行部署，跟 Tomcat 等差别很大，如下图所示，进入管理控制台登录界面，输入用户名密码：

2）打开左侧目录树的应用程序，点击「新建应用程序」，选择右侧显示框中的「新建企业应用程序」。如下图所示：

3）添加 war 包

如下图所示操作，选择 war 包所在文件夹，将 war 包添加进行，点击「下一步」，如下图所示：

选择「详细-显示所有的安装选项和参数」，点击「下一步」，如下图所示：

然后点击「继续」进入企业应用程序和模块的选项，如下图所示：

4）企业应用程序和模块的选项

点击「下一步」，进入步骤2:将模块映射至服务器，勾选「复选框」，如下图所示：

点击「下一步」，进入步骤3:按照默认设置，如下图所示：

继续点击「下一步」至步骤 4， 映射共享库，勾选步骤 4 下的所有「复选框」，如下图所示：

点击「下一步」，进入步骤 5，映射共享库关系，勾选下面的「复选框」，如下图所示：

点击「下一步」，进入步骤 6，将资源引用至映射至资源，勾选「复选框」，如下图所示：

点击「下一步」，进入步骤 7，为 Web 模块映射虚拟主机，勾选「复选框」，如下图所示：

点击「下一步」，进入步骤 8，为  Web 模块映射上下文根，将上下文根改为工程名，如下图所示：

点击「下一步」，进入步骤 9， 映射 JASPI 提供程序，勾选「复选框」，如下图所示：

继续点击「下一步」，直至最后一个步骤，点击完成进入自动安装界面，等待部署完成之后，点击保存，如下图所示：

保存结束之后，WebSphere 就部署好了，如下图所示：

2.5 检测是否部署成功

1）点击「保存」之后，界面会跳回到文件选择界面，选择左侧目录树中的「应用程序>应用程序类型>WebSphere 企业应用程序」，勾选部署的工程名，点击「启动」，底部应用程序状态变为绿色时表示启动成功。如下图所示：

2.6 效果查看

启动完成之后，在网址栏中输入http://ip地址:端口号/工程名/decision，如下图所示：

注：查看端口号的路径为：Servers > Application servers > server1 > Communications > Ports 中的 WC_defaulthost。

2.7 服务器宕机风险参数配置

FineReport 报表工程部署到其他应用服务器上时，对应用服务器有一定的配置要求，因此当应用服务器不能满足报表工程使用时，会出现宕机风险。相关参数配置详情参见：修改FineReport配置参数

部署问题排查请参见：问题排查索引