WebSphere服务器部署

1.1 版本

1.2 功能简介

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

用户需要提前在 Linux 系统下安装 JDK 和 WebSphere，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。

2.1 准备服务器

请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置

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

2.2 安装JDK和WebSphere

用户需要提前在服务器下安装 JDK 和 WebSphere，具体的安装方法可以自行查阅资料。

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。

本文示例环境为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

jboss-logging-3.1.0.CR2.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节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。

部署常见问题请参见：Tomcat部署问题汇总

如果想由 root 管理员切换成普通用户去启动 was ，可以直接检索网上 was 非 root 用户方案方案。