Installation and Basic Usage Information

Evaluation Licenses
Starting and Stopping


You can install JasperReports Server either by running an executable installer or deploying a WAR file. For evaluations, we recommend you use the installer; for most production instances, we recommend you use the WAR file. Both the executable and the WAR file are available from TIBCO Jaspersoft Technical Support (; download:


For more information, see the installation guide found at <js-install>/docs/JasperReports-Server-Install-Guide.pdf.

Binary Installer

To install JasperReports Server, you can use the binary installer, which is available for Windows, Linux, and Mac: TIB_js-jrs_6.4.3_<osType>_<arch>.<ext>

Double-click the installer and accept the default installation type to create a standard installation. Select the custom installation type to configure your instance to specify the application server and RDBMS to use, among other options. The installer can also be run from the command line.

War File Distribution ZIP js-install Script Installation

You can use the js-install command-line shell scripts if you are installing to the following databases:

Microsoft SQL Server

And the following application servers:

Apache Tomcat
IBM WebSphere

For information on the js-install scripts, see the installation guide. The js-install scripts are found in the WAR File Distribution ZIP file:

To install:

1. Go to the buildomatic folder, create and edit a file, and run

cd <js-install>/buildomatic

cp sample_conf/<dbType>

2. Using a text editor, edit to add your application server and database server properties.

./ (or js-install.bat)

3. Then change the JAVA_OPT memory options for your application server following instructions from the installation guide. For example, under Linux with Tomcat running on JDK 1.7, add the following to the top of the <tomcat>/bin/ file:

export JAVA_OPTS="$JAVA_OPTS -Xms1024m -Xmx2048m -XX:PermSize=32m -XX:MaxPermSize=512m"

export JAVA_OPTS="$JAVA_OPTS -Xss2m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled"

For Linux with Tomcat running on JDK 1.8, use:

export JAVA_OPTS="$JAVA_OPTS -Xms1024m -Xmx2048m"

export JAVA_OPTS="$JAVA_OPTS -Xss2m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled"

4. Next, copy your jasperserver.license to your application server user's home folder:

cp <js-install>/jasperserver.license <path-to-home-folder>

For information on JAVA_OPTS configuration and license configuration, see the JasperReports Server Installation Guide.

Evaluation Licenses

The installer includes several 60 day evaluation licenses that allow you to run various editions of JasperReports Server. When the evaluation period expires, you must replace the evaluation license with a commercial license to enable the software. See the JasperReports Server Installation Guide for information on replacing the license.

If you don't already have a commercial license, contact your sales representative. During your evaluation, we invite you to use Jaspersoft Quick Start Guide to learn about our products.


To login after installation, use the following URL:


The following default users are created during installation:

User Password
Always created
superuser superuser
jasperadmin jasperadmin
Only created if you install the sample data
joeuser joeuser
demo demo

For security reasons, always change the default passwords immediately after installing JasperReports Server.

Starting and Stopping

This section describes how to start and stop the server if you installed using the binary installer. If you used another installation method, see the JasperReports Server Installation Guide.


You can start and stop from the Windows menu: click Programs > JasperReports Server 6.4.3 > Start and Stop > Start Service or Stop Service.


You can start and stop from the command line:

./<js-install>/ (start|stop)

Mac OS X

From Finder, double-click the start, stop, or login apps:




Alternatively, you can start/stop from the OS X command line:

./<js-install>/ (start|stop)