| • | 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 |
| | 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)
Recommended Comments
There are no comments to display.