Installing the WAR File for Production

For production environments, use the stand-alone WAR file distribution to install the JasperReports Server application. Download the WAR file distribution from Jaspersoft Technical Support (https://www.jaspersoft.com/support) or contact your sales representative.

The WAR file distribution contains the JasperReports Server web archive file and the scripts to create and load the database. With the integration JasperReports Server and JasperReports Web Studio, two application WAR files, jrws-jrio.war and jrws-repository.war, are added to the WAR file distribution.

JasperReports Web Studio is the visual designer for creating and editing report templates for the reporting engine and the whole Jaspersoft family of products. It uses an open-source library to produce dynamic content and rich data visualizations. It comes as a web-based alternative to Jaspersoft Studio, the desktop application, which is the most complete and powerful designer for JasperReports templates.

 

Important Java Development Kit (JDK) 17 note: As of release 8.2, only Tomcat 9.0.x (the latest available) is supported by JasperReports Server on a system with JDK 17. An additional installation step is required on a system with JDK 17, which requires adding the JAVA_OPTS environment variable.

This chapter describes how to install the WAR file on the Apache Tomcat and JBossEAP/Wildfly application servers. For other application servers, see Installing the WAR File for WebLogic or Installing the WAR File for WebSphere. For a list of supported JDK/JVMs, application servers, databases, operating systems, and browsers, refer to the TIBCO JasperReports® Server Supported Platform Datasheet.

This chapter contains the following sections:

WAR File Distribution
Applications Supported by the WAR File Distribution
Installing the WAR File Using js-install Scripts
Additional Steps for Using DB2 and js-install Scripts
Starting the Server
Logging into the Server
Troubleshooting Your Server Configuration
Installing the WAR File Manually