JasperReports Server has two main distribution packages.
Distribution Package | Description |
Installer (64-bit) | Runs on Windows, Linux, and Mac OSX. |
WAR File Distribution Zip | Used for manual installation on Windows, Linux, Mac, and other platforms. |
The Installer package installs JasperReports Server, automatically configures the JasperReports Server database, and installs the sample data for working with tutorials — if you choose the Sample Data option.
The WAR file binary distribution contains the JasperReports Server web archive file and the scripts to create and load the database. The WAR file distribution supports additional applications not supported by the installers.
Installer Support
There are native installers for Linux, Macintosh, and Windows. See the JasperReports Server Supported Platform Datasheet for the list of supported operating systems and other components.
Installer Naming
The installers have the following file names:
• | TIB_js-jrs-cp_7.1.0_win_x86_64.exe |
• | TIB_js-jrs-cp_7.1.0_linux_x86_64.run |
• | TIB_js-jrs-cp_7.1.0_macosx_x86_64.zip |
The installer will put 64-bit versions of Java 8 and PostgreSQL 9 onto your system for increased speed and performance.
Note: The installer will not work on a 32-bit system.
Installer Distribution Components
The installer is designed to get JasperReports Server up and running quickly. The server requires the Java environment, an application server, and a database. The installer distribution bundles these components:
Component | Description |
JasperReports Server Application | WAR file and configuration support scripts. |
JasperReports Server Documentation | Found in the <js-install>/docs directory. |
Apache Tomcat 8 | Web application container. You can use the bundled version or an existing version. |
Java 1.8 Runtime | Runs the web application container. |
PostgreSQL 9 Database | Database server. You can use the bundled version or an existing version. |
PhantomJS | Scriptable headless WebKit, required for exporting dashboards. We also recommend configuring JasperReports Server to use PhantomJS for graphicalreports that are run in the background or scheduled. See the JasperReports Server Community Project Administrator Guide for more information. |
Installing with Existing Components
The installer can use either bundled or existing instances of both the Apache Tomcat application server and the PostgreSQL database:
• | If you want to use an existing Tomcat, it must be on the local machine. |
• | If you want to use an existing PostgreSQL, it can be on a local or remote machine. If it’s on a remote Linux machine, configure PostgreSQL to allow remote connections as described in Enabling Connections to a Remote Host. |
For information about specific versions of third-party applications supported by the installer, refer to the JasperReports Server release notes in the root of the installation directory.
Running Components as Windows Services
The Windows installer installs PostgreSQL and Tomcat as Windows Services. You can manage these Services in the Windows Control Panel:
Control Panel > System and Security > Administrative Tools > Services
You'll find the PostgreSQL and Tomcat services by the following names:
• | jasperreportsPostgreSQL |
• | jasperreportsTomcat |
The bundled PostgreSQL and Tomcat applications restart automatically when the host Windows system restarts. If you don't want these components to automatically restart, change the Startup Type from automatic to manual.
You can also start JasperReports Server from the Windows Start menu or by using the Desktop icon. You can shut down using the Desktop icon.
Installer on Windows 7 and Above
Due to a known issue with PhantomJS on Windows 7 and above, you should not install PhantomJS using the bundled installer on Windows 7 and above. Instead, to use PhantomJS, install JasperReports Server without PhantomJS and then install PhantomJS separately and configure JasperReports Server to use PhantomJS. See the JasperReports Server Community Project Administrator Guide for more information on configuring all JasperReports Server with PhantomJS.
WAR File Binary Distribution Support
Use the WAR file binary distribution package to install the JasperReports Server application if you can't use the installer. The WAR file supports additional applications not supported by the installer. If you want to use a database other than PostgreSQL and/or an application server other than Apache Tomcat, install JasperReports Server using the WAR file.
For a complete list of applications supported by the WAR file distribution, refer to the JasperReports Server Supported Platform Datasheet. |
The application server should reside on the local machine, but the target database can be on a remote server. Using a remote PostgreSQL database on some Linux platforms requires a change to its configuration file, as described in Enabling Connections to a Remote Host.
The WAR file distribution includes js-install shell scripts (for Linux and Windows) that automate much of the installation using a single properties file. These scripts are:
• | js-install-ce.bat |
• | js-install-ce.sh |
The main contents of the WAR file binary distribution are shown in the following table.
Content Item | Description |
JasperReports Server js-install Scripts | Found at <js-install>/buildomatic/js-install-ce.bat and js-install-ce.sh. |
JasperReports Server Database Scripts | SQL scripts for each supported database. |
JasperReports Server Documentation | Guides for end users and administrators. |
JasperReports Server Extra Samples | Web Service example applications, sample reports, custom data source examples, and other sample files. |
JasperReports Server Standard Sample Data | Sample data that highlights JasperReports Server features. |
JasperReports Server WAR file archive | All of the JasperReports Server class files and dependent jars. |
About Bundled Apache Ant
The War File Distribution ZIP includes Apache Ant version 1.9.4. The buildomatic Ant scripts come with Windows and Linux batch scripts pre-configured to use the bundled version of Apache Ant. You call the buildomatic Ant scripts from the command line in the following manner:
Windows: | js-ant <target-name> |
Linux and Mac OSX: | ./js-ant <target-name> |
If you want to run your own version of Ant, version 1.8.1 or higher is required.
The bundled Apache Ant has an additional jar (ant-contrib.jar) that enables conditional logic in Ant. If you're running your own Ant, copy this jar to your Ant/lib folder.
On Linux and Solaris, the js-ant commands may not be compatible with all shells. If you have errors, use the bash shell explicitly. For more information, see Bash Shell for Solaris, IBM AIX, HP UX and FreeBSD. |
Recommended Comments
There are no comments to display.