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，登陸便可訪問。