FineReport6.2企业版Windows集群配置说明
作者:finereport
浏览:5,479
发布时间:2023.7.31
前述:
windows集群同J2EE的集群不同,因为它是操作系统自带的集群支持,它没有J2EE集群对java的web应用的良好支持,例如session复制以及session粘滞。所以对windows集群,需要特别配置一下,以此来支持集群的功能。
简单原理说明:
Windows集群的均衡负载会根据情况,将外部请求分配给集群内的服务器处理。当一个会话(Session)在A服务器上产生并开始,产生了一部分会话信息将保存到A服务器的内存中。假如这次会话中的一次请求被windows集群的均衡负载调度器分配到了B服务器去处理,那么问题就产生了,B服务器中的内存中并没有这个会话的信息,那么就会报session timeout。
而我们的配置,会在集群的服务器间建立联系。当B服务器收到请求,发现这个请求的会话不是自己产生的,那么它会根据请求中的信息,判断出这个会话是由哪台服务器产生。接着它会将这个请求通过内网转发给相应的那台服务器去处理。这样相当于就实现了J2EE集群的会话粘滞的功能。简单的说,会话粘滞就是保持一个会话中的多次交互都由一台集群中的服务器处理。这样就不会再产生上述的问题。
前提:
集群的服务器间需要有内网间通信的支持。
配置步骤:
集群内的每台安装有报表应用的服务器都需要这样配置。
1.关闭现在的报表服务。
2.更换jar文件。(文件在配置包的resource文件夹中)
A.找到/WebReport?(这个是您的WEB应用的名称)/WEB-INF/lib文件夹(lib文件夹是和存放报表模板文件的repolets文件夹平级的)。拷贝commons-codec-1.2.jar,commons-httpclient-3.1.jar到lib文件夹下。拷贝fr-server-6.2.jar到lib文件夹下覆盖原来的相同名称的jar文件。
B.假如您已经部署了报表应用到tomcat等web服务器下,那么不需要执行这一步。
假如您是直接装了我们的报表设计器,并且是启动我们的内置服务器在做简单测试。那么请将fr-designer-6.2.jar覆盖设计器安装目录下lib文件夹下的相同名称jar文件。
3.增加配置文件。
将配置包resource文件夹下的cluster.xml打开。看见如下内容
<?xml version="1.0" encoding="UTF-8" ?> <ClusterConfig useCluster="true"> //useCluster=”true”表示启用集群配置 <ClusterService isSelf="true"> //这个节点包含一台服务器的相关信息,isSelf=”true”说明这是本机信息 <ServiceName>A</ServiceName> //给这台服务器取一个区别于其他机器的别名 <ip>192.168.0.1</ip> //这台服务器在内网中的IP地址 <port>8080</port> //报表应用的端口 <WebAppName>WebReport</WebAppName> //报表应用的名称 </ClusterService> <ClusterService> //这里没有isSelf=”true”默认就为false,表示这是其它机器的信息 <ServiceName>B</ServiceName> <ip>192.168.0.2</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> </ClusterConfig>
这里的每个ClusterService都是集群中一台服务器的相关信息。假如这个配置文件部署在A服务器下,那么ServiceName为A的那个ClusterService节点后加一个属性 isSelf=”true”,表示下这是本机的信息。相应的,假如是部署在B服务器下的文件,就需要在ServiceName为B的ClusterService节点后加isSelf=”true”,如下所示。
<?xml version="1.0" encoding="UTF-8" ?> <ClusterConfig useCluster="true"> <ClusterService> <ServiceName>A</ServiceName> <ip>192.168.0.1</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> <ClusterService isSelf="true"> <ServiceName>B</ServiceName> <ip>192.168.0.2</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> </ClusterConfig> //这个就是B服务器相应的配置文件了
ServiceName是为一台服务器取的别名,只是为了区别标记一下。最好简单方便,如A、B、C或者A1、A2等。注意不能是中文。
IP、PORT、和WebAppName上面的注释中有介绍。
IP是该台服务器内网中的IP,就是其它服务器能与之通信的IP。Port是报表应用的端口号,假如是部署在tomcat下,那么就是tomcat的端口号,默认是8080.例如我们的内置服务器是8079。WebAppName是报表应用的名称,我们默认的是WebReport。
简单的讲。如上面的那个例子。B服务器的信息如下。
<ClusterService> <ServiceName>B</ServiceName> <ip>192.168.0.2</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService>
那么正确的配置的结果,就是在A服务器上,假如有浏览器,浏览器中输入:
http://192.168.0.2:8080/WebReport/ReportServer?reportlet=xxx.cpt
就能访问到B服务器上的报表应用。这个url中的IP、端口号和web应用名称就是上面配置信息里面的。注:xxx.cpt只是举个例子。
那么综上说明,假如集群中多了一台C服务器,给它取个别名就叫C。内网IP是192.168.0.3。装了tomcat,端口默认是8080。报表应用名称也是默认是WebReport。那么C服务器下的配置文件应该如下所示:
<?xml version="1.0" encoding="UTF-8" ?> <ClusterConfig useCluster="true"> <ClusterService> <ServiceName>A</ServiceName> <ip>192.168.0.1</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> <ClusterService> <ServiceName>B</ServiceName> <ip>192.168.0.2</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> <ClusterService isSelf="true"> <ServiceName>C</ServiceName> <ip>192.168.0.3</ip> <port>8080</port> <WebAppName>WebReport</WebAppName> </ClusterService> </ClusterConfig>
最后,请根据上面的格式,为每一台服务器修改相应的cluster.xml文件,并且将其拷贝到报表应用下WEB-INFresources文件夹下。注意:xml文件的保存格式是 utf-8 no Bom的格式。一般用写字板打开配置包下的cluster.xml文件,修改保存就可以。
4. 测试配置是否生效。
当集群中的服务器都已经按照上述步骤配置好,并且重新启动报表应用后。依次在各台服务器上做如下测试。例如,现在在A服务器下,先本机测试下报表能否访问,测一张简单的模板就行。能正常访问(ie浏览器可能需要将localhost或者127.0.0.1的本机地址添加到信任站点中才能显示页面),接着在浏览器上输入:
http://localhost:8080/WebReport/ReportServer?op=cluster_test
上述url地址前面部分按情况,请换上相应报表应用的端口号和应用名称。然后假如设置正常就能看到如下的信息:(以上述A、B两台服务器的配置文件举例)
Cluster is start
SELF:
ServiceName:A
IP :192.168.0.1
PORT :8080
WebAppName :WebReport
NO1:
ServiceName:B
IP :192.168.0.2
PORT :8080
WebAppName :WebReport
****************************************
RE:
Cluster is start
INFO:
ServiceName:B
IP :192.168.0.2
PORT :8080
WebAppName :WebReport
****************************************
IE中可能没有换行,请见谅。
这样说明,配置生效,A服务器能与B服务器间进行通信。*****中间的是B服务器的回应,说明其也已启动。再次查看下信息是否有误。那么相应的在B服务器下,正确的回应如下:
Cluster is start
SELF:
ServiceName:B
IP :192.168.0.2
PORT :8080
WebAppName :WebReport
NO1:
ServiceName:A
IP :192.168.0.1
PORT :8080
WebAppName :WebReport
****************************************
RE:
Cluster is start
INFO:
ServiceName:A
IP :192.168.0.1
PORT :8080
WebAppName :WebReport
****************************************
假如没有显示Cluster is start,那么说明该机的配置没有生效,请检查配置文件后,重新启动应用,并且再次依照上面步骤测试;假如SELF:下的信息不正确,或者没有信息,也请检查配置文件,看看isSelf属性是否写对;假如下面列出的其它机器的信息不正确,或者有遗漏,也请检查配置信息后,重启报表应用重试;假如其它服务器的回应,就是******中的信息,有问题。请检查下那台服务器的配置信息,检查网络连接,ping下那台机器的ip地址,看看是否能ping通。然后查看那台服务器报表应用的端口和应用名称是否设置正确。
可以在浏览器中输地址直接在内网中访问下那台机上的报表应用,看看设置的ip、端口号等是否设置正确。修改后,重新启动报表应用,重试。
5. 结束
当以上检查步骤结束。所有服务器都检查,发现正确后。恭喜,配置就完成了。
假如您在配置过程中,有无法解决的问题,请与我们联系。
报表工具产品更多介绍:www.finereport.com