Use the installer to speed up the JasperReports Server installation process considerably. The JasperReports Server installer is available only for Windows.
Before you begin
Make sure you have installed Microsoft SQL Management Studio (MSSQL DB) or Oracle SQL Developer (Oracle DB) on your local machine. You also need a working instance of
WorldServer 11.x (with Java 17 and Tomcat 9).
Important: WorldServer 11.8 uses Java 17; however, JasperReports Server 8.0.3 (delivered in WorldServer 11.8.0 and 11.8.1) is not compatible with this version of Java. See
Setting up JasperReports Server to use Java 11 on Windows or
Setting up JasperReports Server to use Java 11 on Linux for information about configuring JasperReports Server 8.0.3 to use Java 11.
JasperReports Server 9.0.0 (delivered in WorldServer 11.8.2) is compatible with Java 17; you do not need to configure it to use Java 11. Note that JasperReports Server 9.0.0 does not work with earlier WorldServer versions, nor does WorldServer 11.8.2 work with a different version of JasperReports Server.
If possible, place WorldServer and JRS on different Java virtual machines. If you already have an instance of Tomcat on your machine, make sure that it is stopped before you start to install JRS.
In case a previous version of JasperReports Server has been installed on the same machine, make sure that you delete the .jrsks and .jrsksp files from the Users folder: C:\Users\<name>.
Procedure
- Go to the Installers folder of the WorldServer distribution kit and run the WSReportsSetup.msi installer.
Tip: If you do not have sufficient permissions to run the installer directly, run it from the command line as an administrator.
- On the Welcome page, select Next.
- On the Destination Folder page, specify the folder where you want JasperReports Server to be installed, and then select Next.
Important: Do not specify
Program Files (x86) as the destination folder. Also, make sure that there are no spaces in the path; otherwise, the installation will not be successful. For example,
C:\ProgramData\WorldServerReports\ is a valid path, but
D:\My Programs\WorldServer Reports\ is not.
If the destination folder does not exist, the installer will create it. Make sure that the name of the drive is valid and that you have enough permissions to access that location.
- On the Tomcat Configuration page, enter the name or the IP address of the machine where you want JasperReports Server to be installed, enter the ports used by JasperReports Server, and then select Next.
Important: If you want JasperReports Server to run on the same machine as WorldServer, make sure that the Tomcat ports used by JasperReports Server are different from the ports used by the WorldServer Tomcat server.
- On the Database Platform Selection page, choose a database platform (Microsoft SQL Server or Oracle), and then select Next.
- Do one of the following, depending on the database platform you chose earlier:
- If you chose Microsoft SQL Server, enter the name or the IP address of the JasperReports Server database server, the number of the port it is running on, the name of the database that will be used by JasperReports Server, as well as the name and password of the admin user that will be used to create the JasperReports Server database.
Note: The installer will create a new SQL Server database from scratch. Make sure there are no databases with the same name on your environment. You cannot use existing databases for this installation.
- If you chose Oracle, enter the name or the IP address of the JasperReports Server database server, the number of the port it is running on, the SID or the service name of the database (depending on how it was configured), the name and the password of the existing system account that will be used to create the JasperReports Server database user, as well as the name and the password of the database user that will be created for JasperReports Server.
- Encrypt database passwords in configuration files: The value you select here determines how the admin database password is stored in the default-master.properties file when installing JasperReports Server. If you want the password to be encrypted, select True; otherwise, select False.
- On the Configurations page, specify the path where the WorldServer configuration files are installed, and then select Next:
- If WorldServer is installed on the same machine, browse and select the existing WorldServer configuration folder.
- If WorldServer is installed on a different machine, the installer will create a file called reports.properties in the specified folder. Make sure that you copy this file to the WorldServer configuration folder on the machine where WorldServer is installed.
Note: If the folder you specify does not exist, it will be created. Make sure that the name of the drive is valid and that you have enough permissions to access that location.
- On the second Configurations page, enter the host name or the IP address of the machine on which WorldServer is installed and the number of the port on which WorldServer is running.
- Select .
- Stop the WorldServer service and start it again.
- Start the WorldServer Reports service.