1. 概述
1.1 版本
WebLogic 版本 | 对应 JDK 版本 |
---|---|
Weblogic12c 及以上 | JDK 1.8 且小版本需在 JDK8u102 以上 |
1.2 注意事项
WebLogic下 war 包部署时,默认是压缩部署的,因此只支持插件的使用,不支持插件的安装、删除、更新。
2. 环境搭建
用户需要提前在 Linux 系统下安装 JDK 和 weblogic,具体的安装方法可以自行查阅资料,技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度,准备合适的服务器环境:单机工程部署支持环境及配置
2.2 安装JDK和Weblogic
用户需要提前在服务器下安装 JDK 和 Weblogic,具体的安装方法可以自行查阅资料。
内容 | 版本要求 |
---|---|
JDK | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配,64 位操作系统可以安装 32 位的 JDK ,但是 FineReport 不支持这样的操作,必须保持统一 |
Weblogic | 支持Weblogic12c及以上版本 由于安全限制问题,在一个域下只能部署一个FineReport的工程,否则会报错 |
3. 部署步骤
Windows、Linux、Unix下的 Weblogic 管理控制台界面是一样的,即实现步骤是一样的。
本文示例环境为Linux+Weblogic12c+jdk1.8,其他版本步骤基本相同,但功能位置可能略有不同,请自行调整。
3.1 获取工程文件
1)付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式:服务平台>在线支持。
2)免费用户请参考 设计器安装,安装设计器后,%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 确认插件xml文件
进入上一节webroot/WEB-INF/plugins目录,查看是否存在pluginconfig.xml文件。
如果没有该文件,需要启动一下设计器,即可自动生成该文件。
3.3 打war包
1)使用命令 cmd 进入上一节webroot所在的目录。
2)键入命令jar cvf webroot.war *,将webroot文件夹压缩成webroot.war包。
注:系统中需要安装 JDK 才能使用命令 jar cvf webroot.war *
3.4 拷贝工程文件
将上一节webroot下生成的webroot.war上传至WebLogic服务器任意目录下。
本文示例:E:\weblogic2目录下
3.5 参数配置
FineReport工程部署到应用服务器上时,对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时,会出现宕机风险。
建议在部署工程前,对参数进行配置,详情请参见:WebLogic服务器配置修改
3.6 部署工程
1)使用管理员账户登录WebLogic管理控制台。
2)在WebLogic控制台中,选择左侧「部署」菜单,点击「安装」按钮。
3)选择3.3节拷贝的webroot.war包文件位置,选定 webroot.war,点击「下一步」。
4)选择安装类型为「将此部署安装为应用程序」,点击「下一步」。
5)直接点击「完成」按钮,进行部署。
注:在部署 WebLogic 过程中,无需更改编码方式,FineReport 在定义数据连接时已经对编码进行了处理。
6)看到「已激活所有更改,不需要重新启动信息」时,表示已经部署完毕。
3.7 启动工程
1)使用管理员账户登录WebLogic管理控制台。
2)在WebLogic控制台中,选择左侧「部署」菜单,查看工程状态和健康状况。
若工程状态为「活动」,健康状况为「正常」,代表工程已启动。
若工程未启动,状态为「准备就绪」,则代表工程未启动,需要手动启动。
点击「控制」,勾选「webroot」点击「启动>为所有请求提供服务器」,如下图所示:
3.8 访问FineReport系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision,打开FineReport初始化配置页面,即部署成功。如下图所示:
注1:访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
默认端口号为 7001,工程名默认为webroot。
注2:平台登录的用户名和密码是3.2节拷贝的工程的。若该工程从未登录过,则直接进入初始化配置界面。
4. 注意事项
4.1 数据连接
在weblogic容器下部署的工程,如需使用JNDI方式连接数据库,必须先在 WebLogic 中配置数据源,然后工程直接调用该数据源即可。
详情请参见:WebLogic 配置 JNDI 连接
4.2 finedb
war包压缩部署weblogic,第一次解压出来的时候会读取不到解压的FineDB,会自动生成新的。
如需使用系统自带的内置FineDB,需要在 缓存文件夹 下把新生成的FineDB删掉,然后手动替换成%FR_Home%/webapps/WEB-INF/embed目录下的FineDB。
如需使用外接数据库,请在部署完成后,重启两遍工程,因为第一步部署后启动的时候解压出来的config无法读取。