1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
1.2 应用场景
JBoss AS是 JBoss 的开源版本，JBoss EAP 是 JBoss 的企业版本。为了更好地区分两者，从 JBoss AS8 开始 JBoss AS 更名为 WildFly 。
本文以 Windows + WildFly-10.1.0 + jdk1.8 为例进行演示，其他版本命令可能略有区别，请自行处理。
2. 环境搭建
用户需要提前在 Windows 系统下安装 JDK 和 WildFly，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
2.2 安装JDK
独立部署时，用户需要单独准备 JDK 。
| 操作步骤 | 说明 |
|---|---|
| 版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineReport 不支持这样的操作，必须保持统一 |
| 下载JDK | 下载链接：JDK 将下载的 JDK 安装包上传到 Windows 服务器 |
| 安装JDK | 安装教程请参考 JDK 官方文档 示例：将安装包解压到/data目录即可 |
2.3 下载WildFly
| 操作步骤 | 说明 |
|---|---|
| 版本要求 | JBoss6 及以上 已验证版本： JBoss-EAP-6.4 WildFly--8.2.1 WildFly-10.1.0 WildFly-20.0.1 WildFly-24.0.1 |
| 下载WildFly | 下载链接：wildfly
|
| 安装WildFly | 将下载的压缩包解压到某个文件夹下 |
2.2 配置环境变量
1）新建系统变量JBOSS_HOME，变量值为 WildFly 解压缩路径。如下图所示：
2）编辑变量 Path，新增值%JBOSS_HOME%\bin。如下图所示：
3）启动服务，验证是否配置成功。进入 bin 目录下，双击运行standalone.bat文件，看到如下日志，代表启动成功。如下图所示：
4）浏览器访问http://localhost:8080（WildFly 的 http 协议默认端口是 8080），出现下图所示画面代表服务器配置成功。
5）关闭已打开的 cmd 窗口。
2.4 配置 WildFly 支持 IP 地址访问
修改%JBOSS_HOME%\standalone\configuration\standalone.xml，原始的配置如下：
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>
</interfaces>
改成以下配置，就能通过IP访问了
<interfaces>
<interface name="management">
<any-address/>
</interface>
<interface name="public">
<any-address/>
</interface>
</interfaces>
3. 部署步骤
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 设计器安装，安装设计器后，%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 打war包
1）使用命令 cmd 进入上一节webroot所在的目录。
2）键入命令jar cvf webroot.war *，将webroot文件夹压缩成webroot.war包。
注：系统中需要安装 JDK 才能使用命令 jar cvf webroot.war *
3.3 拷贝工程文件
将上一节webroot下生成的webroot.war上传至JBoss服务器%JBoss_HOME%\standalone\deployments目录下。
3.4 生成dodeploy文件
1）使用命令 cmd 进入%JBoss_HOME%\standalone\deployments下
2）键入命令type nul > webroot.war.dodeploy，生成webroot.war.dodeploy文件。
3.5 参数配置
FineReport工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在部署工程前，对参数进行配置，详情请参见：JBoss服务器内存修改
3.6 访问FineReport系统
1）双击%JBoss_HOME%\bin\standalone.bat，启动服务器。
2）在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
默认端口号为 8080，工程名默认为webroot。
注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
4. 注意事项
4.1 修改端口号
修改 JBoss 服务器端口号请参见：JBoss 服务器端口号修改
4.2 登录失败
问题描述
JBoss 服务器部署成功后，登录平台时输入正确的用户名和密码，提示：登录失败。如下图所示：
原因分析
JBoss 对 JDK 类选择性载入的问题，导致的登录失败。
解决方案
在%JBoss_HOME%\modules\system\layers\base\sun\jdk\main的 module.xml 加上<path name="com/sun/management"/>，重启 FineReport 工程即可。如下图所示：
4.3 一些类找不到
问题描述
服务启动过程中会报一些类找不到，加载出现报错Error：找不到sun.net.www.protocol.file
解决方案
在%JBoss_HOME%\modules\system\layers\base\sun\jdk\main的 module.xml 加上<path name="sun/net/www/protocol/file"/>，重启 FineReport 工程即可。如下图所示：
