Websphere服务器部署

1.1 版本

注：部署前请先确认服务器环境的 JDK 版本。

1.2 功能简介

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

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

2.1 准备服务器

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

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

2.2 安装JDK和WebSphere

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

2.3 其他操作

6.0.10版本新增参数安全校验，因此改动了 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 工程文件。技术支持联系方式：服务平台>在线支持。

2）免费用户请参考 FineBI安装与启动，安装本地FineBI后，%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。

3）将两个 JAR 包上传至/webroot/WEB-INF/lib目录下。

hibernate-validator-4.3.2.Final.jar

jboss-logging-3.1.0.CR2.jar

4）处理好的webroot 文件夹即为所需的工程文件。

3.2 创建工程目录

此处采用ear包的方式部署 BI 。

1）在was工程节点目录下创建 webroot.ear 目录，参考如下命令（根据自己的 was 工程节点目录修改）

cd  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/
mkdir  webroot.ear

2）将上节 %FineBI%/webapps/webroot文件夹拷贝至目录 webroot.ear 下，参考如下命令：

cp -r /opt/FineBI/webapps/webroot        
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear

3）进入 webroot.ear 目录，将 webroot 文件夹重命名为 webroot.war，参考如下命令：

cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear
mv webroot webroot.war

3.3 参数配置

FineBI工程部署到应用服务器上时，对应用服务器有一定的配置要求。

如果应用服务器不能满足工程使用时，会出现宕机风险。

建议在部署工程前，对参数进行配置，详情请参见：WebSphere服务器配置修改

3.4 部署FineBI

1）使用管理员账户登录WebSphere管理控制台。

2）在WebSphere控制台中，选择左侧「应用程序>新建应用程序」菜单，点击「新建企业应用程序」按钮。

3）选择「远程文件系统」，手动输入3.2节的webroot.war文件的路径,如 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/webroot.ear ，点击「下一步」。

4）选择「详细-显示所有的安装选项和参数」，点击「下一步」，点击「继续」，进入安装企业应用程序和模块的选项。

5）在安装企业应用程序和模块的选项中

步骤1：选择安装选项：使用默认设置，直接进入「下一步」。

步骤2：将模块映射至服务器：勾选「复选框」，进入「下一步」。

步骤3：为Web模块提供JSP重新装入选项：使用默认设置，直接进入「下一步」。

步骤 4: 映射共享库：勾选全部「复选框」，进入「下一步」。

步骤5：映射共享库关系：勾选全部「复选框」，进入「下一步」。

步骤 6: 为 Web 模块映射虚拟主机：勾选「复选框」，进入「下一步」。

步骤 7: 为 Web 模块映射上下文根：将上下文根改为工程名，进入「下一步」。

步骤 8: 映射 JASPI 提供程序：勾选全部「复选框」，进入「下一步」。

步骤 9: 模块的元数据：使用默认设置，直接进入「下一步」。

步骤 10: 显示模块构建标识：使用默认设置，直接进入「下一步」。

步骤 11: 摘要：：使用默认设置，点击「完成」。

6）进入自动安装界面，等待部署完成之后，点击「保存」。

7）保存结束之后，WebSphere中的帆软应用就部署好了。

3.5 启动工程

1）使用管理员账户登录WebSphere管理控制台。

2）在WebSphere控制台中，选择左侧「应用程序>应用程序类型>WebSphere企业应用程序」菜单。

3）查看应用程序状态。绿色为已启动，红色为未启动。

4）若程序未启动，可勾选工程，点击「启动」，等待应用程序状态变更为绿色即可。

3.6 访问FineBI系统

在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineBI初始化配置页面，即部署成功。如下图所示：

注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。

       可在「服务器>服务器类型>WebSphere Application Server>通信>端口>WC_defaulthost」查看端口号

注2：平台登录的用户名和密码是3.1节工程的。若该工程从未登录过，则直接进入初始化配置界面。