JasperReports Server requires a license and comes with an evaluation license valid for 30 days. Please contact Technical Support or your sales representative to get your commercial license.

The license file is in the following location:

<js-install>/jasperserver.license

The license file specifies the terms of your license, such as the following:

Jaspersoft receives information about your system periodically. The information is used only to monitor compliance with your license. No personal information is collected or transmitted.

Default License Configuration for All Application Servers

At startup JasperReports Server automatically looks for the jasperserver.license file in the home directory of the system user running the application server. “License Locations” lists the application server user home directories for supported operating systems.

To configure the license:

License Locations

Operating System

Linux

/home/<user>/

Mac OSX

/Users/<user>/

Windows 7 installed from WAR file

C:Users<user>

Windows 7 installed from the binary installer

C:Users

Windows 2003

C:Documents and Settings<user>

Windows 2008

C:Documents and Settings<user>

User-Defined License Location

If you prefer to put your license in another directory, modify your application server startup script to set a JAVA_OPT value to explicitly point to that directory.

Alternate License Setup for Tomcat

If your license is not located in the home directory of the application server user, you can set a JAVA_OPT value to explicitly point to your license.

On Windows:

set JAVA_ENDORSED_DIRS=%BASEDIR%commonendorsed

Alternatively, create an empty file called <tomcat>/bin/setenv.bat.

set JAVA_OPTS=%JAVA_OPTS% -Djs.license.directory="<js-install>"

For example:

set JAVA_OPTS=%JAVA_OPTS% -Djs.license.directory="C:jasperserver-bin"

On Linux and Mac OSX:

JAVA_ENDORSED_DIRS="$BASEDIR"/common/endorsed

Alternatively, create an empty file called <tomcat>/bin/setenv.sh.

export JAVA_OPTS="$JAVA_OPTS -Djs.license.directory=<js-install>"

For example:

export JAVA_OPTS="$JAVA_OPTS -Djs.license.directory=/home/user/jasperserver-bin"

Alternate License Setup for Bundled Tomcat as a Windows Service

The Windows binary installer installs the bundled Tomcat component as a Windows Service by default. The steps to specify a specific folder to hold the jasperserver.license are:

cd <js-install>/apache-tomcat/bin/service.bat

Update the line above to point to this example license location:

-Djs.license.directory=C:MyLicenses

Because Tomcat is installed as a service, you need to re-install the service. From a Windows Command shell, enter these commands (Note: the cmd shell will disappear when these commands are run. You need to open a new cmd shell for each command.). To open a cmd shell: Start Menu > Run... > cmd:

The Tomcat service is removed and then installed. After execution of these commands, the service is running.

Alternate License Location for Existing Tomcat as a Windows Service

Windows 7:

If you have an existing Tomcat as a Windows Service under Windows 7, copy your license to the root of the C: drive. This is the home folder for the SYSTEM user. The location is:

C:jasperserver.license

Alternate License Setup for JBoss

If your license is not located in the home directory of the application server user, you can set a JAVA_OPT value to explicitly point to your license.

On Windows:

set JAVA_OPTS=%JAVA_OPTS% -Dprogram.name=%PROGNAME%

set JAVA_OPTS=%JAVA_OPTS% -Djs.license.directory="<js-install>"

For example:

set JAVA_OPTS=%JAVA_OPTS% -Djs.license.directory="C:jasperserver-bin"

On Linux and Mac OSX:

export JAVA_OPTS="$JAVA_OPTS -Dprogram.name=$PROGNAME"

export JAVA_OPTS="$JAVA_OPTS -Djs.license.directory=<js-install>"

For example:

export JAVA_OPTS="$JAVA_OPTS -Djs.license.directory=/home/user/jasperserver-bin"