1. 概述
1.1 版本
| 版本 | 功能变更 |
|---|---|
FineReport 信创版 11.0 FineBI 信创版 6.0 FineDataLink4.0.19信创版 | - |
1.2 功能简介
本文简单介绍，在国产化专用机中，如何在中间件中部署FineReport/FineBI/FineDataLink工程。
示例环境：国产化专用机，东方通中间件，部署FineReport11.0工程。
注：请参考文档 国产化专用机简介，确认为专用机环境。
2. 获取安装材料
获取以下文件，并上传到专用机电脑桌面。
1）用户需提前联系东方通，获取东方通部署相关材料，包括：
东方通涉密机版本安装包
东方通签名文件
2）若您是帆软的合作客户，请前往「服务平台」，选择「在线支持」。
请向在线技术支持人员获取fineassist安装包：fineassist.deb
3）帆软工程war包
参考设计器部署概述部署工程
在 FineReport 或者 FineBI 安装目录%FR_HOME%/webapps/webroot 下执行以下语句打 war 包
jar cvf webroot.war *
3. 安装东方通签名
1）使用安全用户登录国产化专用机
2）拷贝东方通签名文件到服务器上，签名文件是以.q7结尾的文件。
3）在开始菜单中找到「配置管理」，点击打开，如下图所示：
4）点击「签名文件」Tab页，点击「添加」按钮，选中东方通签名文件，点击「打开」按钮，导入签名。如下图所示：
5）签名文件导入成功后，签名列表文件中可以看到TongWeb产品信息，如下图所示：
4. 安装东方通
4.1 添加白名单
1）切换到root用户
2）拷贝东方通安装包文件到服务器上，安装包文件一般是以.deb、.rpm结尾的文件。
3）在开始菜单中找到「配置管理」，点击打开，选中「可信软件管理>可信软件白名单库」，如下图所示：
4）点击上图的「添加」按钮，找到东方通安装包，选中，并点击「打开」按钮，将东方通添加到白名单。如下图所示：
注：如果打开的目录是/var/softmanager/soft且不允许选择其他文件夹，那么必须先将东方通安装包文件拷贝到该文件夹中。
5）白名单添加成功后，可以在白名单列表中找到东方通产品，如下图所示：
4.2 安装东方通
1）切换到root用户
2）在开始菜单中找到「配置管理」，点击打开。选中「可信软件管理>本地安装与卸载」。
在可安装列表中，可以看到TongWeb相关产品，点击「安装」，即可进行东方通中间件的安装。
如下图所示：
3）安装完成后，安装路径默认为/opt/Tongweb，如下图所示：
4.3 创建域
1）进入/opt/Tongweb/bin目录，创建域
./startdomain.sh create /gmp/opt/FR/domain_FR
2）启动域domain_FR
nohup ./startdomain.sh/gmp/opt/FR/domain_FR
5. 安装fineassist
1）添加安装包文件
打开安全「配置管理」，选择「软件管理」，点击「添加」按钮，选择桌面的 fineassist.deb 文件。
输入管理员密码，勾选软件，点击保存即可。
注：若出现报错，提示没有自签信息，则代表签名为必填项，可手动填写任意值。
2）安装文件
添加成功后，点击「安装」，即可安装fineassist。
安装成功后，在/opt目录下，生成assist文件夹。
注1：不可移动文件夹位置。
注2：若未安装成功，可点击「审计信息」查看失败提示。
6. 启动东方通
6.1 配置启动参数
在%Tongweb_HOME%/bin/external.vmoptions文件中里添加参数配置，如下：
-Dfineassist=/opt/assist/FineAssist.xxx#需要填入可信软件安装后的路径，和对应架构的完整名字FineAssist_x86_64.so
-Dfineassist.copy=disable#无需修改
-Dfineprivacy=/opt/assist/FinePrivacy.xxx#同上
-Dfineprivacy.copy=disable#同上
注1：参数中 D 为大写，其他全部小写，而文件名称中的 F、A、P 均为大写。
注2：该文件在不同中间件中不同，例如 Tomcat 的catalina.sh，tongweb 的external.vmoption，apusic的vm.option。
注3：在不同中间件中，参数配置不同，例如在 apusic 的 vm.option 的配置中，不需要 -D 前缀，只需要 key=value 键值对即可.
注4：以上参数的设置位置，必须设置到 #jvm_options 以下、#server_options 以上的位置。
如果写在#java_home后面，会被当作 java_home 加载，导致服务器虽然可以起来，但是访问系统地址出现 tools.jar 问题。
6.2 启动东方通
1）进入/opt/Tongweb/bin目录下，使用startserver.bat启动东方通服务器
2）访问 http://ip:9060/console 进入控制台首页，9060为默认端口，默认系统管理员用户名及初始密码为：thanos/thanos123.com。点击登录，如下图所示：
6.3 修改东方通参数
1）修改URL编码格式
WEB容器配置>HTTP通道管理>tong-http-listenser>其他设置处，修改「URL编码格式」为「UTF-8」。
不修改会导致FineReport/FineBI工程中无法匹配中文名，服务器数据集处上传Excel后名称乱码。
2）修改编解码字符集
容器配置中，修改「默认请求参数解码字符集」和「默认应答编码字符集」为「UTF-8」。
不修改会导致FineReport/FineBI工程中无法匹配中文名，服务器数据集处上传Excel后名称乱码。
3）添加服务器启动参数
启动参数配置>服务器参数设置处，添加服务器启动参数-DWebModuleOnly=true
添加后必须重启TongWeb（交互界面提示会自动重启服务器，但实际并不会，必须手动重启）
不修改会导致TongWeb启动报错：
[2022-11-08 15:21:56 275] [SEVERE] [http-nio2-0.0.0.0-9060-exec-74] [core] [ContainerBase.addChild: start: ]
com.tongweb.tomee.catalina.TomEERuntimeException: com.tongweb.tongejb.OpenEJBException: Unable to create annotation scanner for web module webroot: null
4）修改tongweb.xml文件
修改 conf/tongweb.xml 文件， <protocol not-allow-HTTP-methods 字段后的PUT和DELETE删除。
一共有三处，均需修改
不修改会导致tongweb容器的PUT/DELETE不可以使用。
7. 部署FineReport
1）将帆软webroot工程war包拷贝到/gmp/home/FR目录下
2）在控制台处点击「应用管理>部署应用」，如下图所示：
3）选择 webroot.war 所在的位置，点击「开始部署」，如下图所示：
4）默认设置，点击「下一步」，如下图所示：
5）选择虚拟主机位置，点击「下一步」，如下图所示：
6）点击「完成」，提示正在部署中，如下图所示：
7）如果部署成功，应用的状态会显示已启动。工程在%Tongweb_HOME%/deployment文件夹下
8. 登录数据决策系统
访问http://ip:8088/webroot/decision（8088为默认端口，可自行修改），如下图所示：
注：第一次登录数据决策系统，会进行初始化设置，设置管理员及密码。
9. 注意事项
9.1 tools.jar不匹配
问题描述：
前端报错tools.jar不匹配，后台可以看到Fine assist start failed的报错。
排查步骤：
1）查看产品 JAR 包版本是否为 2020-11-02 及以后。
2）可能环境有缓存或者其他应用路径，实际运行的是其他路径下的webroot等。
3）如果看到copy fineassist has be disable，说明成功阻止了 fineassist 拷贝。
4）如果看到 Fine assist start successfully ，说明成功地加载到了信任软件中的 so 文件。
9.2 fontconfig相关问题
使用openJDK，所以可能会报错 fontconfig 相关问题，处理方案如下：
1）安装 fontconfig，百度查找 fontconfig 的 rpm 安装包，放到专用机安装软件里安装。
2）需要把java/jdk/jre/lib下的 font 字体包和 fontconfig 的依赖拷贝到/tomcat-linux使用的 jre 的对应目录下。
