Windows Installation Guide

The following guide outlines the process of installing Report Out on Windows.

Java Installation

Report Out requires the latest version of the Java Run time Environment (JRE) 1.8 or later to be installed.  If it is not already installed, you will need to download and install the latest version of Java from https://adoptopenjdk.net/.

Report Out Installation

Download the latest version of Report Out and extract the zip file to a folder.  Report Out doesn’t need to be installed, it should be executed directly from the extracted folder.  There are two components to Report Out which are referred to as the Frontend and the Backend.  Both of these services can be started by executing the batch file titled, start.bat.  Starting this batch file will launch two command prompt windows, one for the frontend and one for the backend.  This batch file does NOT need to be run as administrator.  This file will start the required servers, which may take up to 5 minutes to complete.  After the services have started you can access Report Out by opening a browser and navigating to:

URL:
http://localhost:8080

Username:
admin@localhost.loc

Password:
password

Report out will create a directory called ReportOutData and will store it in the home directory of the user who executed Report Out.  This directory includes settings, email templates, the Report Out database, logs, and database drivers.  This folder should be backed up to ensure recovery of Report Out is possible.

Email Setup

If you would like Report Out to sent data via Email or if you would like to be able to send confirmation emails, you will need to configure Report Out to connect to a SMTP server.  This is done by editing the application.properties file which is located in the ReportOutData directory in your home folder.  After making changes to this file you will need to restart Report Out.

Remote Connections

By default, the frontend service will only connect to localhost, if you would like to allow connections from remote hosts, you will need to modify the following file:

[ReportOutRoot]/reportout-fe/assets/config/config.json

Change:

{
  "apiUrl": "http://localhost:8081"
}

to

{
  "apiUrl": "http://X.X.X.X:8081"
}

where X.X.X.X is the IP address the machine running Report Out.

Upgrading Report Out

Most of the data for Report Out is stored in the ReportOutData directory on your home directory, so upgrading is very simple.  To upgrade perform the following steps.

  1. Stop Report Out
  2. Download and extract the latest version of Report Out
  3. Start the new version of Report Out by executing the start.bat file

Once you upgrade, it is typically not possible to downgrade to a previous version as database modifications can not be rolled back.