1. 概述
1.1 版本
| WebSphere 版本 | JDK 版本 |
|---|---|
| WebSphere8.5 | JDK 1.8 且小版本需在 JDK8u102 以上 |
1.2 功能简介
FineReport 支持将工程部署在 WebSphere 中使用。本文以 Linux 系统为例部署 WebSphere8.5 服务器。
2. 环境搭建
用户需要提前在 Linux 系统下安装 JDK 和 WebSphere，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
注：目前 Windows+Websphere8.5 及以上版本不支持部署 FineReport 工程。
2.2 安装JDK和WebSphere
用户需要提前在服务器下安装 JDK 和 WebSphere，具体的安装方法可以自行查阅资料。
| 内容 | 版本要求 |
|---|---|
| JDK | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineReport 不支持这样的操作，必须保持统一 |
| WebSphere | 支持WebSphere8.5及以上版本 |
2.3 其他操作
11.0.16 版本新增参数安全校验，因此改动了 cbb JAR 包，部分工程升级后，工程所用的WebSphere容器中的JAR包与改动冲突。
如存在JAR包冲突，会导致工程启动失败或部分功能不可用，工程日志中有相关报错关键词「validation」/「validator」
1）下载javax.j2ee.validation.jar：javax.j2ee.validation.jar
2）上传并覆盖%WebSphereHome%/AppServer/plugins目录下的javax.j2ee.validation.jar。
3. 部署步骤
本文示例环境为CentOS8.0+WebSphere8.5+JDK1.8，其他版本步骤基本相同，但功能位置可能略有不同，请自行调整。
3.1 获取工程文件
1）获取webroot
付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
免费用户请参考 设计器安装，安装设计器后，%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
2）将两个 JAR 包上传至/webroot/WEB-INF/lib目录下。
hibernate-validator-4.3.2.Final.jar
3）修改后的 webroot 文件夹即为所需的工程文件。
3.2 打war包
1）使用命令 cmd 进入上一节webroot所在的目录。
2）键入命令jar cvf webroot.war *，将webroot文件夹压缩成webroot.war包。
注：系统中需要安装 JDK 才能使用命令 jar cvf webroot.war *
3.3 拷贝工程文件
1）使用管理员账户登录WebSphere管理控制台。
2）在WebSphere控制台中，选择左侧「应用程序>新建应用程序」菜单，点击「新建企业应用程序」按钮。
3）选择「本地文件系统」，选择上一节webroot下的webroot.war，点击「下一步」。
4）选择「详细-显示所有的安装选项和参数」，点击「下一步」，点击「继续」，进入安装企业应用程序和模块的选项。
5）在安装企业应用程序和模块的选项中
步骤1：选择安装选项：使用默认设置，直接进入「下一步」。
步骤2：将模块映射至服务器：勾选「复选框」，进入「下一步」。
步骤3：为Web模块提供JSP重新装入选项：使用默认设置，直接进入「下一步」。
步骤 4: 映射共享库：勾选全部「复选框」，进入「下一步」。
步骤5：映射共享库关系：勾选全部「复选框」，进入「下一步」。
步骤 6: 为 Web 模块映射虚拟主机：勾选「复选框」，进入「下一步」。
步骤 7: 为 Web 模块映射上下文根：将上下文根改为工程名，进入「下一步」。
步骤 8: 映射 JASPI 提供程序：勾选全部「复选框」，进入「下一步」。
步骤 9: 模块的元数据：使用默认设置，直接进入「下一步」。
步骤 10: 显示模块构建标识：使用默认设置，直接进入「下一步」。
步骤 11: 摘要：：使用默认设置，点击「完成」。
6）进入自动安装界面，等待部署完成之后，点击「保存」。
7）保存结束之后，WebSphere中的帆软应用就部署好了。
3.4 参数配置
FineReport工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在部署工程前，对参数进行配置，详情请参见：WebSphere服务器配置修改
3.5 启动工程
1）使用管理员账户登录WebSphere管理控制台。
2）在WebSphere控制台中，选择左侧「应用程序>应用程序类型>WebSphere企业应用程序」菜单。
3）查看应用程序状态。绿色为已启动，红色为未启动。
4）若程序未启动，可勾选工程，点击「启动」，等待应用程序状态变更为绿色即可。
3.6 访问FineReport系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
可在「服务器>服务器类型>WebSphere Application Server>通信>端口>WC_defaulthost」查看端口号
注2：平台登录的用户名和密码是3.2节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
4. 注意事项
部署常见问题请参见：Tomcat部署问题汇总
如果想由 root 管理员切换成普通用户去启动 was ，可以直接检索网上 was 非 root 用户方案方案。
