3.帆软运行环境配置
frReport2自带一个嵌入式的帆软运行环境,根据业务系统的需求,可能有如下配置.以下设置所需的信息由业务系统提供或指定
3.1设置报表访问权限配置 - fr_app_mapping.properties (必须)
在ROOT目录下,必须有fr_app_mapping.properties文件,否则访问任何报表时都会报无权限错误。详细功能请参考帆软报表功能说明书。
3.2帆软授权文件 - FineReport.lic(必须)
位于frReport2\WEB-INF\resources目录
3.3业务数据源配置 - datasource.xml(必须)
位于frReport2\WEB-INF\resources目录,帆软报表需要直接访问业务系统的数据,必须在datasource.xml中指定数据库访问信息。
3.4外部cpt文件目录设置 - JZReportletConfig.xml(可选)
位于frReport2\WEB-INF\resources目录,由业务系统在设计器中制作的cpt文件,可以放置在frReport2目录之外,通过JZReportletConfig.xml中路径设置来指定。
3.5集群配置 - 使用nginx方式部署(集群环境必须)
配置文件在WEB-INF\resource文件下的cluster.xml文件,如没有则新增加(不要用记事本或者写字板等编辑此文件)。我们一般是共享目录方式部署,使用的是帆软的新的集群部署插件;帆软集群新部署插件方法见帆软的帮助文档(帆软集群)
http://www.finereporthelp.com/help/15/2/21.html
鉴于在使用帆软集群,在项目现场大并发量时单机环境比集群环境效率更高的现象,报表应用可以不使用帆软的集群,更改为通过nginx来做负载均衡配置(代码不需要做出改动),具体修改方法为:
1.删除掉帆软的集群配置xml文件(报表应用的frReport2\WEB-INF\resources\cluster.xml文件);
- kill掉所有使用帆软集群配置的应用,要杀掉所有进程的原因是因为帆软的集群代码如何工作不清楚,防止一些不明因素的cache影响,要杀掉所有已经使用帆软集群的应用,而且是用杀进程的方式,而不是重启wl部署。这个只在切换配置的过程中需要,后续不再需要这么做
3.不要使用weblogic的集群做负载均衡配置,去掉现有的weblogic集群;0
4.额外部署一个节点做报表访问,该节点和集群中的其他节点一模一样(如有可能,这个节点使用尽可能高的cpu配置);
5.若条件有限制,也可使用集群中的现有节点之一做报表访问,参考下面例子中蓝色框中部分
6.使用nginx设置将所有帆软的访问导向到固定的报表服务器。
示例如下:

配置文件应注意以下几项:
1.upstream hrms_server中配置集群的机器ip及端口要正确;
2.upstream hrms_report_server中配置一个节点做报表访问的二种方式只能选择一种;
3.location ~/hrms/sys/frReport/show.do中的内容应该和location /hrms中的内容应该保持一致(除了最后一行);
4.nginx的配置需与实际报表访问地址一致;如下图所示:

5、为防止一些cache效果,可能需要重启整个节点而不是单个应用
3.6自定义函数配置 - function.xml(可选)
某些报表文件中会用到自定义的函数。
1.将编译好的class文件放到报表应用下(frReport应用或者是帆软的安装目录)下的WEB-INF目录下的classes文件夹下的对应包名下,如果WEB-INF目录下没有classes文件夹就新建一个
2.如果是帆软设计器,“服务器”菜单下有个“函数管理器”,在里面注册你刚才写的函数,注册好之后就可以在设计器中的文件中使用这个函数了,服务器上使用的话在服务器上重复1的操作,然后就帆软安装目录下的functions.xml文件考到服务器上对应目录下覆盖原来的,也就可以使用了
3.7警告信息配置(log级别设置) - config.xml
在我们访问报表服务器时,服务器会将执行的信息输出到日志文件中。这些输出的信息有4个级别,报表集成到服务器之后,这些信息全输出在服务器日志文件中,和其他应用信息是混在一起的,不方便查看,对我们不使用帆软决策系统的还可能会产生一些大量无用的告警信息或者数据库sql异常信息。我们可通过设置修改配置文件来控制帆软的log级别设置。
Log输出级别分为四种:SEVERE,WARNING、INFO和DEBUG,SEVERE是导出服务器的严重报错日志,WARNING 输出执行报表时的错误或警告信息,INFO则是导出所有报错信息,DEBUG是指在INFO输出的日志基础上,增加输出一些系统信息日志以及sql执行的更加详细日志,一般是需要二次开发的程序员前期开发调试模板中使用。设计器默认的日志log级别为INFO,服务器默认日志级别WARNING。
注:8.0以下版本DEBUG日志级别只有在设计器日志下面才有,服务器日志没有DEBUG这个级别。
设计器中修改方法为:“文件”菜单——“选项”——“高级”

服务器修改,如果带有数据决策系统的,可以在数据决策系统中修改

没有数据决策系统的,可以通过直接修改配置文件来实现。配置文件为报表应用下的%frReport2%/WEB-INF/resources目录下的config.xml
