JASPERREPORTS服务端安装指导手册（源码编译版）

 

简介

    JasperReport是一款开源、功能强大、用户数量最多的开源报表工具，并有本身的报表设计器 Jaspersoft Studio，本文仅介绍win7 64位系统上服务端的安装和部署方法。

前提准备

1.   JDK

本文使用的jdk是1.8 64位版本，官方要求1.6以上版本

2.   Maven

本文使用的maven是3.3.9版本

3.   Tomcat

本文使用的tomcat是8.0.35 64位版本。另外，服务器还支持Glassfish、JBoss。

4.   Mysql

本文使用的是5.5版本。数据库支持PostgreSQL和Mysql。

   

以上软件须要提早安装并配置好，本文不作相关介绍。

下载和安装

1.   进入官方网站

http://community.jaspersoft.com/download

2.   进入下载页

点击JasperReports Server，进入相关下载页

3.   下载最新版

当前版本最新是v6.2.1，下载对应的源码版本

4.   解压文件

本文减压到了 D:\tools\JasperReports-Server-cp-6.2.1-src

目录或文件	描述
apache-ant	Ant文件夹
jasperserver	JasperReports服务端核心代码
jasperserver-repo	依赖包

 

配置

1.   建立配置文件

1)   进入D:\tools\JasperReports-Server-cp-6.2.1-src\jasperserver\buildomatic目录

2)   拷贝sample_conf\mysql_master.properties文件到buildomatic目录中

3)   修改mysql_master.properties文件名为default_master.properties

2.   修改配置文件

属性	示例
appServerType	appServerType=tomcat8 (or tomcat5/6/7, jboss, or glassfish2/3)
appServerDir	appServerDir=D:\\tools\\apache-tomcat-8.0.35
dbHost	dbHost = localhost
dbUsername	dbUsername = root
dbPassword	dbPassword = password
maven	maven = D:\\apache-maven-3.3.9\\bin\\mvn.cmd
js-path	js-path = D:\\tools\\JasperReports-Server-cp-6.2.1-src\\jasperserver
js-pro-path	js-pro-path=D:\\tools\\JasperReports-Server-cp-6.2.1-src\\jasperserver-pro
repo-path	repo-path=D:\\tools\\JasperReports-Server-cp-6.2.1-src\\jasperserver-repo
maven-localrepo-path	maven-localrepo-path=D:\\tools\\JasperReports-Server-cp-6.2.1-src\\jasperserver-repo

*注：须要修改源码中对应mariadb的版本为1.1.7版本，由于maven仓库的最低版本是1.1.7，而jasperreport使用的版本是1.1.2。必须改的是jasperserver-repo/com/jaspersoft/jasperserver/jdbc-dep/1.0/jdbc-dep-1.0.pom，这个文件不改会编译不过去，其余的最好也改下。

3.   编译源代码

1)   确保上述的default_master.properties配置文件已经配置完毕

2)   启动mysql数据库

3)   在buildomatic目录底下依次运行以下cmd命令

命令	描述
js-ant clean-config	清除 buildomatic/build_ conf/default 目录
js-ant gen-config	重建 buildomatic/build_ conf/default 目录
js-ant add-jdbc-driver	加载数据库驱动
js-ant build-ce	构建源码
js-ant create-load-js-db-ce	建立并加载jasperserver数据库，并导入核心引导数据
js-ant deploy-webapp-ce	将jasperserver的war包打包至tomcat服务器中

 

4.   设置tomcat参数

Jasperreport Server所须要的tomcat内存比默认的设置大，因此须要修改内存参数。

Tomcat 8 内存修改 在Catalina.bat文件中找到以下行 所在的位置： :noJuliConfig set JAVA_OPTS=%JAVA_OPTS% %LOGGING_CONFIG% 在其下方添加如下两行配置代码： JAVA_OPTS="-Xms1024m -Xmx2048m" JAVA_OPTS="$JAVA_OPTS -server -XX:PermSize=32M -XX:MaxPermSize=512m"

 

*注：须要在 D:\tools\apache-tomcat-8.0.35\webapps\jasperserver\WEB-INF\classes 目录底下新建文件 resfactory.properties ，并在其中添加以下代码：

tbeller.usejndi=false

 

5.   启动tomcat

访问 localhost:8080/jasperserver ，默认用户名密码都为jasperadmin，登陆便可访问。