The World's Most Widely Used Business Intelligence Software
​
linkedin share button
0

Using Buildomatic to Build and Deploy Source Tutorial

Introduction

When customizing JasperServer, it is necessary to build and deploy the source. Buildomatic is the JasperServer framework, built on Ant, which simplifies that process.

Product Versions

This tutorial works with JasperServer CE version 3.5 and later.

User

Developer

Objectives

This guide will enable you to:

Pre-Requisites

  • Successfully installed JasperServer using Buildomatic (WAR file distribution)
  • Created JasperServer database
  • Supported application server successfully configured and running the JasperServer application

Note: See JasperServer Install Guide Chapter 5 for instructions on the above pre-requisites.

 

Downloading and Extracting Source Code

Step Action
1
2 Login, register or skip to go to the JasperServer releases page .
3

Click on the latest release to go to the release contents page

Example: JasperServer 3.5.0 – NEW 
4 Click on JasperServer-<rel>-src.zip to download 
5 Extract files from the zip archive to a folder on your machine, which we will refer to as  <js-src> 

Return to top

 

Setting Up Maven

Follow these steps to set up Maven.

Step Action
1 You can download and install Maven2 version 2.0.9 from the Maven website.
2

Put the maven binary mvn (path to /bin) or mvn.exe on your environment PATH so that you can execute mvn from the command line. To test your maven setup, run the following from a new command window:

mvn –version
3

You should see something like this:

Note: See section B.3 in the JaspersServer Source Build Guide for Maven troubleshooting information.

Return to top

 

Building and Deploying Source Code

Follow these steps to build and deploy source code.

Step Action
1 First, you will need to unzip the source. Then, go to Buildomatic scripts folder, <js-src>/jasperserver/buildomatic 
2

Edit js-build.properties file to set the following:

Property Description/Example
maven The location of your Maven executable (mvn.bat or mvn)

Examples:
C:\\bin\\apache-maven-2.0.9\\bin\\mvn.bat
/usr/local/bin/mvn 
js-base-path The location of the <js-src>/jasperserver directory

Examples:
C:\\jasperserver-<ver>-src\\jasperserver
/home/<user>/jasperserver-<ver>-src/jasperserver 
js-repo-path The location of the <js-src>/jasperserver-repo directory

Examples:
C:\\jasperserver-<ver>-src\\jasperserver-repo
/home/<user>/jasperserver-<ver>-src/jasperserver-repo 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 3

 

 

 

 

From the command line, run the following commands:

Commands Description
cd <js-src>/jasperserver/buildomatic Sets directory to Buildomatic 
js-ant add-jdbc-driver  Installs JDBC driver to mvn local repository 
js-ant build-ce  Builds the source code 
js-ant deploy-webapp-ce  deploy to the application server 

 

 

 

 

 

 

 

 

 

Return to top

What's Next?

You should now be able to run the application.

Written by

This tutorial was written by Veronica Bykin, Engineering Program Manager, June 2009.