Jump to content
JasperReports Library 7.0 is now available ×
  • This documentation is an older version of JasperReports Server Community Project Release Notes. View the latest documentation.
    Installation
    Login
    Starting and Stopping

    Installation

    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:

    TIB_js-jrs_cp_6.4.0_installer-<osType>-<arch>.<ext>
    TIB_js-jrs_cp_6.4.0_bin.zip

    For more information on JasperReports Server installation, see the installation guide, which is 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.0_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:

    PostgreSQL
    MySQL

    And the following application servers:

    Apache Tomcat
    JBoss
    Glassfish
    WildFly

    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.0_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.

    Login

    To login after installation, use the following URL:

    http://<hostname>:8080/jasperserver

    The following default users are created during installation:

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

    warning-icon-ns.png.c7a7837783a1c1a4dc276462c6429295.png

    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.

    Windows

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

    Linux

    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:

    /Applications/jasperreports-server-cp-6.4.0/jasperServerStart.app

    /Applications/jasperreports-server-cp-6.4.0/jasperServerStop.app

    /Applications/jasperreports-server-cp-6.4.0/jasperServerLogin.app

    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.



    Guest
    This is now closed for further comments

×
×
  • Create New...