Installing JasperReports Server through the installer

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).

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

  1. Go to the Installers folder of the WorldServer distribution kit and run the WSReportsSetup.msi installer.
  2. On the Welcome page, select Next.
  3. On the Destination Folder page, specify the folder where you want JasperReports Server to be installed, and then select Next.
  4. 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.
  5. On the Database Platform Selection page, choose a database platform (Microsoft SQL Server or Oracle), and then select Next.
  6. 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.
    • 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.
  7. 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.
  8. 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.
  9. Select Next > Install.
  10. Stop the WorldServer service and start it again.
  11. Start the WorldServer Reports service.