| • | Installation |
| • | Evaluation Licenses |
| • | 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
| • | TIB_js-jrs_6.4.3_<osType>_<arch>.<ext> |
| • | TIB_js-jrs_6.4.3_bin.zip |
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:
| • | PostgreSQL |
| • | MySQL |
| • | DB2 |
| • | Microsoft SQL Server |
| • | Oracle |
And the following application servers:
| • | Apache Tomcat |
| • | JBoss |
| • | Glassfish |
| • | WildFly |
| • | IBM WebSphere |
| • | WebLogic |
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_6.4.3_bin.zip.
To install:
| 1. | Go to the buildomatic folder, create and edit a default_master.properties file, and run js-install.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" 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
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.
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 | |
| 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.
Windows
You can start and stop from the Windows menu: click Programs > JasperReports Server 6.4.3 > 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-6.4.3/jasperServerStart.app
/Applications/jasperreports-server-6.4.3/jasperServerStop.app
/Applications/jasperreports-server-6.4.3/jasperServerLogin.app
Alternatively, you can start/stop from the OS X command line:
./<js-install>/ctlscript.sh (start|stop)
