Jump to content
JasperReports Library 7.0 is now available ×
  • This documentation is an older version of JasperReports Server Community Edition Release Notes. View the latest documentation.
    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 the Jaspersoft community site (http://community.jaspersoft.com); download:


    For more information, see the installation guide found at <js-install-ce>/docs/JasperReports-Server-CP-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_cp_6.4.2_installer-<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:


    And the following application servers:

    Apache Tomcat

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

    To install:

    1. Go to the buildomatic folder, create and edit a default_master.properties file, and run js-install-ce.sh/bat:

    cd <js-install>/buildomatic

    cp sample_conf/<dbType>_master.properties default_master.properties

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

    ./js-install.sh (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/setclasspath.sh 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 -XX:MetaspaceSize=128m"

    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, see the JasperReports Server Installation Guide.


    To login after installation, use the following URL:


    The following default users are created during installation:

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


    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.2 CP > Start and Stop > Start Service or Stop Service.


    You can start and stop from the command line:

    ./<js-install>/ctlscript.sh (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>/ctlscript.sh (start|stop)

    User Feedback

    Recommended Comments

    There are no comments to display.

    This is now closed for further comments

  • Create New...