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 System Requirements.

To install Jasper Tomcat server:

  1. 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.
  2. 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>
  3. Unzip the file: 
    jasperreports-server-<version>-bin.zip
    to:
    <drive>:\temp
    The result should be a directory called: 
    <drive>:\temp\jasperreports-server-<version>-bin
  4. Copy: 
    <drive>:\temp\jasperreports-server-<version>-bin\service.bat
    to:
    <drive>:\Enterworks\Jasper\apache-tomcat-<version>\bin
    overwriting the existing file.
  5. Copy: 
    <drive>:\temp\jasperreports-server-<version>-bin\default_master.properties
    to:
    <drive>:\temp\jasperreports-server-<version>-bin\buildomatic\
  6. 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
    Below is an example. Use your own values instead of the values shown below.
    dbHost=WQ00148D
dbInstance=PIM
dbUsername=ewsys
dbPassword=password
  7. 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
  8. 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. Upon completion, a success message will be displayed.
  9. Close the cmd prompt.
  10. 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
  11. Rename tomcat6w.exe in: 
    <drive>:\Enterworks\Jasper\apache-tomcat-<version>\bin
    to:
    jasperReportsTomcat.exe.
  12. Copy: 
    <drive>:\temp\jasperreports-server-<version>-bin\jasperserver.license
    to:
    <drive>:\Enterworks\Jasper\apache-tomcat-<version>\webapps\jasperserver-pro
  13. 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
  14. Open for editing: 
    <drive>:\Enterworks\Jasper\apache-tomcat-<version>\webapps\jasperserver\WEB-INF\classes\esapi\security-config.properties
  15. Set the following property to false: security.validation.sql.on=false
  16. Go to the services console, open the properties for the jasperReportsTomcat service, go to the Log On tab, and set the service to run as the SVC-PIM-QA network service account.
  17. Start the jasperReportsTomcat service.
  18. 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.
  19. In the Jaspersoft login window, log in as:

    • User ID: superuser

    • Password: superuser

  20. Uncheck the Heartbeat Data Collection Opt-in checkbox.
  21. A successful installation will display the following page upon login:
  22. The JasperReports server is now installed.