Install Jasper Tomcat Server

Note: Before installing any third-party or compatible software that is not included with the EnterWorks installation files, check that the version of the application is supported by consulting EnterWorks 10.3 System Requirements.

To install Jasper Tomcat server:

Set the appropriate permissions on the SQL server login ewsys to allow it to create a database on the target server. The Jasper server installer will require these permissions because the installer will create the database along with the schema.
On the web server, unzip the file: apache-tomcat-<version>-windows-x64.zip to a new directory called:
```
<drive>:\Enterworks\Jasper.
```
The result should be the directory:
```
<drive>:\Enterworks\Jasper\apache-tomcat-<version>
```

Unzip the file:

jasperreports-server-<version>-bin.zip

to:

<drive>:\temp

The result should be a directory called:

<drive>:\temp\jasperreports-server-<version>-bin

Copy:

<drive>:\temp\jasperreports-server-<version>-bin\service.bat

to:

<drive>:\Enterworks\Jasper\apache-tomcat-<version>\bin

overwriting the existing file.

Copy:

<drive>:\temp\jasperreports-server-<version>-bin\default_master.properties

to:

<drive>:\temp\jasperreports-server-<version>-bin\buildomatic\

Edit the file:
```
<drive>:\temp\jasperreports-server-<version>-bin\buildomatic\default_master.properties
```
and set the appropriate environment-specific settings for:
```
dbHost
dbInstance
dbUsername
dbPassword
```
The screenshot below is an example. Use your own target environment settings.
Open the command prompt as administrator and run the following commands:
1. Move to the buildomatic directory:
```
cd <drive>:\temp\jasperreports-server-<version>-bin\buildomatic
```
2. Run the command: js-install.bat minimal
The installer will perform a series of steps that will be displayed in the command window. It may take more than 20 minutes to complete.
Successful installation will display the following message on the command window:
Close the cmd prompt.
Install the jasperReportsTomcat Windows service by executing the following commands on a new cmd prompt:
```
cd <drive>:\Enterworks\Jasper\apache-tomcat-<version>\bin
service.bat install jasperReportsTomcat
```

Rename tomcat6w.exe in:

<drive>:\Enterworks\Jasper\apache-tomcat-<version>\bin

to:

jasperReportsTomcat.exe.

Copy:

<drive>:\temp\jasperreports-server-<version>-bin\jasperserver.license

to:

<drive>:\Enterworks\Jasper\apache-tomcat-<version>\webapps\jasperserver-pro

From:

<drive>:\temp\jasperreports-server-<version>-bin

copy the following jar files:

jasperreports-htmlcomponent-<version>.jar
jtds-<version>.jar

to:

<drive>:\Enterworks\Jasper\apache-tomcat-<version>\webapps\jasperserver-pro\WEB-INF\lib

Open for editing:

<drive>:\Enterworks\Jasper\apache-tomcat-<version>\webapps\jasperserver\WEB-INF\classes\esapi\security-config.properties

Set the following property to false: security.validation.sql.on=false
Go to the services console and set the jasperReportsTomcat service to run as the SVC-PIM-QA network service account.
Start the jasperReportsTomcat service.
Confirm the server is accessible by opening up a web browser and going to:
```
http://<servername>:8080/jasperserver-pro/
```
The Jaspersoft login window should appear. Note that upon initial startup, it may take a few minutes to see the login screen.
In the Jaspersoft login window, log in as:
- User ID: superuser
- Password: superuser
Uncheck the Heartbeat Data Collection Opt-in checkbox.
A successful installation will display the following page upon login:
The JasperReports server is now installed.