Jasper-Reports-Publisher/docs/wizard.rst

.. _wizard-label:

************
Wizard
************

Once the module is installed, the Wizard is used to configure the components.

Go to Servers > JRI Publisher:

.. image:: _static/3.png

The main Wizard screen will a link for completing each step.

While most steps are self-explanatory, we will cover Tomcat, JDK, and JRI selection below:

Install Java/JDK:
================

.. image:: _static/4-java.png

Select the JDK you wish to use.  We have tested with JDK 8

.. image:: _static/5-java.png

JRI Publihsher has been tested with OpenJDK 8 and Oracle JDK 8.


Apache Tomcat 
================

.. image:: _static/8-tomcat.png

JRI Publihsher has been tested with Apache Tomcat 8.x and 9.x:

.. image:: _static/9-tomcat.png


JasperReportsIntegration
========================

.. image:: _static/13-jri.png

JRI Publihsher has been tested with JasperReportsIntegration 2.5.1 and 2.6.2:

.. image:: _static/14-jri.png

.. note::
    If you wish to use a Beta version of JasperReporsIntegration, tick the "Show Beta Versions" select box 

JNDI Entries
========================

JRI Publihsher allows you to add JNDI templates, and associated JARS for PostgreSQL, MySQL, and MSSQL as shown below:

.. image:: _static/JRI-JNDI.png

The JNDI entries are optional.

.. note::
    JNDI entries are created at /home/tomcat/tomcat-version/conf/context.xml
    
The JNDI elements added are shown below.  These defaults and must be edited with your own host, username, etc...

.. code-block:: xml
   :linenos:


    <Resource name="jdbc/postgres" auth="Container" type="javax.sql.DataSource"
    driverClassName="org.postgresql.Driver"
    maxTotal="20" initialSize="0" minIdle="0" maxIdle="8"
    maxWaitMillis="10000" timeBetweenEvictionRunsMillis="30000"
    minEvictableIdleTimeMillis="60000" testWhileIdle="true"
    validationQuery="select user" maxAge="600000"
    rollbackOnReturn="true"
    url="jdbc:postgresql://localhost:5432/xxx"
    username="xxx"
    password="xxx"
    />

    <Resource name="jdbc/MySQL" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="30" maxWaitMillis="10000"
    driverClassName="com.mysql.jdbc.Driver"
    username="xxx" password="xxx"  url="jdbc:mysql://localhost:3306/xxx"/>
    
    <Resource name="jdbc/MSSQL" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="30" maxWaitMillis="10000"
    driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    username="xxx" password="xxx"  url="jdbc:sqlserver://localhost:1433;databaseName=xxx"/>

    
Completing Installation
========================
 
Once each step of the Wizard is completed, the Wizard can be removed:

.. image:: _static/19-donei.png

With the Wizard completed, your module should appear as below:

.. image:: _static/JRI-Publisher-Main.png



.. note::
    The JRI application is deployed at this point.  You can proceed to create data sources, publish reports, etc..
    

About Haveged
===================

Haveged is an entropy generator that will provide markedly faster JVM startup times.
The caveat is that it will use much higher CPU load (although for shorter duration due
to decreased JVM start up time).  Bear this in mind if deploying on VM with limited CPU
or other critical applications.