Follow this procedure to install JasperReports Server using the WAR file distribution. The js-install shell scripts, supported on Windows, Linux, and Mac, do most of the work for you.
Prerequisites for installing the WAR file:
1. | Install a supported version of the Java Development kit (JDK). See the TIBCO Jaspersoft Supported Platforms Datasheet document on the Documentation section of the Jaspersoft Community website for a list. |
2. | Create and set the JAVA_HOME system environment variable to point to the Java JDK location. |
3. | Locate or install one of the following application servers. See the TIBCO Jaspersoft Platform Support Guide for supported versions: |
• | Apache Tomcat |
• | JBoss EAP or Wildfly (additional steps may be required for JBoss EAP or Wildfly. Please see Additional Steps for Using JBoss EAP or Wildfly ) |
4. | Locate or install the PostgreSQL, MySQL, Oracle, SQL Server, or DB2 database. If you use DB2, follow the steps in Additional Steps for Using DB2 and js-install Scripts. |
The target database can be on a remote server. The application server should reside on the local machine. |
For an optional pre-install validation test, run js-install.bat/sh test. See js-install Script Test Mode for more information.
To install the WAR file using js-install scripts:
The scripts are intended for the bash shell.
If installing to non-Linux Unix platforms such as IBM AIX, FreeBSD, or Solaris, the bash shell is required for using the js-install scripts. |
1. | Extract all files from TIB_js-jrs_7.9.0_bin.zip. Choose a destination, such as C:Jaspersoft on Windows, /home/<user> on Linux, or /Users/<user> on Mac. |
The directory, TIB_js-jrs_7.9.0_bin, appears in the file location you choose.
2. | Copy the <dbType>_master.properties file for your database from sample_conf and paste it to buildomatic: |
• | Copy from — <js-install>/buildomatic/sample_conf/ |
• | Paste to — <js-install>/buildomatic |
For example, if your database is PostgreSQL, copy postgresql_master.properties to <js-install>/buildomatic.
3. | Rename the file you copied to default_master.properties. |
4. | Edit the default_master.properties file to add the settings for your database and application server. “Sample Values for the default_master.properties File” lists sample property values for each supported database. |
Sample Values for the default_master.properties File
Database
Sample Property Values
PostgreSQL
appServerType=tomcat [jboss-eap-7, wildfly, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 9.0dbHost=localhostdbUsername=postgresdbPassword=postgres[/code]
MySQL
appServerType=tomcat [jboss-eap-7, wildfly, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 9.0dbUsername=rootdbPassword=passworddbHost=localhost[/code]
appServerType=tomcat [jboss-eap-7, wildfly, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 9.0dbUsername=jasperserverdbPassword=passwordsysUsername=systemsysPassword=password dbHost=hostname[/code]Additional options for Oracle CDB with common users
If you are using Oracle CDB and you want you want tuse a common Jaspersoft user, then use the settings for Oracle with the following changes:
If you are using sample databases:
Additional options for Oracle CDB with common users and TIBCO driverIf you are using the TIBCO driver for Oracles, use the settings for Oracle and Oracle CDB, and also set SupportLinks
to true in the AddtionalAdminOptions
section, for example:
AdditionalAdminOptions=;SupportLinks=true[/code]
Do not set this property if you are using the vendor's Oracle driver. For more information, seehttp://media.datadirect.com/download/docs/jdbc/alljdbc/index.html#page/jdbcconnect/supportlinks.html
DB2
appServerType=tomcat [jboss-eap-7, wildfly, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 9.0dbUsername=db2inst1dbPassword=passworddbHost=localhost[/code]
If you use DB2, follow the steps in Additional Steps for Using DB2 and js-install Scripts
SQL Server
appServerType=tomcat [jboss-eap-7, wildfly, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 9.0dbUsername=sadbPassword=sadbHost=localhost[/code]
On Linux, if Tomcat is installed using apt-get, yum, or rpm, see Tomcat Installed Using apt-get/yum. |
5. | Run the js-install scripts: |
a. | Start your database server. |
b. | Stop your application server. |
c. | Open Command Prompt as Administrator on Windows or open a terminal window on Linux and Mac OSX. |
d. | Run the js-install script for the version and files you want, as shown in the following table. |
Commands | Description |
cd <js-install>/buildomatic |
|
js-install.bat (Windows) ./js-install.sh (Linux and Mac OSX) | Installs JasperReports Server, sample data, and sample databases (foodmart and sugarcrm) |
js-install.bat minimal (Windows) ./js-install.sh minimal (Linux and Mac OSX) | Installs JasperReports Server, but not the sample data and sample databases |
If you encounter errors during the js-install script execution, see Error Running js-install Scripts (js-install.bat/sh).
6. | Set Java JVM Options (required), as described in Setting JVM Options for Application Servers. |
7. | Set up the license (required) as described in Setting Up the JasperReports Server License. |
To view the output log, look in: <js-install>/buildomatic/logs/js-install-<date>.log |
Installing JasperReports Server automatically generates encryption keys that reside on the file system. These keys are stored in a dedicated TIBCO TIBCO keystore. Make sure this keystore is properly secured and backed up, as described in the TIBCO JasperReports Server Security Guide. |
Installing Chrome/Chromium
You need to install and configure Chrome/Chromium to export the reports and dashboards to PDF and other output formats.
For information about configuring Chrome/Chromium in JasperReports Server, see the TIBCO JasperReports Server Administrator Guide.
Recommended Comments
There are no comments to display.