Configuring and Managing the Reporting Server

This page guides you through the configuration of the Reporting Server. It also provides tips for managing the Reporting Server.

This page includes the following:

Configuring the Reporting Server

Follow the instructions below to configure the Reporting Server.

  1. Log in to Automic Automation Intelligence from a web browser as an Automic Automation Intelligence user with Administrator permissions. Specify terma in the path.

    Example

    http://<Automic_Automation_Intelligence>:8080/aai

  2. Click System Tools on the right side in the MY PAGES section.

  3. Click the tab labeled Reporting Configuration.

  4. Update the Reporting Server location details, if needed. Make sure you save each panel.

    • Protocol: Reporting Server protocol (http or https)

      For more information on how to set up TLS authentication, see Configuring the Reporting Server for TLS Authentication.

    • Host: Reporting Server hostname

      It is recommended using the fully qualified domain name, rather than the short name, when defining the reporting server hostname.

    • Port: 8080 (Default)

    • User: superuser (Default)

    • Password: TermaPassword (Default)

    Notes:

    Change the port number if Automic Automation Intelligence is already using port 8080 and runs on the same physical server.

  5. Provide the AAI user that will be used to communicate from the Reporting Server to the Automic Automation Intelligence Server. This is used to log into the Automic Automation Intelligence application.

    • User: admin (Default)

    • Password: password (Default)

    • AAI User for Reporting Server

  6. To configure the database access, provide the location of the Reporting Server Database.

    • Database Type: <Oracle or SQL Server>

    • Host: <Database Server hostname>

    • Port: Oracle <1521> or SQL Server <1433>

    • Database Name: <Oracle SID/Service Name or SQL Server Database Name>

    • Database Name Type: <Service Name or SID (Oracle Only)>

    • User: <Database user with Read permissions>

    • Password: <Password for Database User>

    Note:

    Hover the mouse over the fields for hints.

Tips for the Reporting Server on Windows

Find the Tomcat version:

$INSTALLDIR\apache-tomcat\bin\version.bat

$INSTALLDIR\apache-tomcat\bin\catalina.bat version

Find the Reporting Server version:

dir $INSTALLDIR\apache-tomcat\webapps\jasperserver-pro\WEB-INF\lib\*JasperPatch*.jar

Control Reporting Server in Task Manager:

Open the Windows Task Manager and go to the Services Tab. The following services can be Started, Stopped, or Restarted:

jasperreportsTomcat

jasperreportsPostgreSQL

Tips for the Reporting Server on Linux

Find the Apache Tomcat version:

$INSTALLDIR/apache-tomcat/bin/version.sh

$INSTALLDIR/apache-tomcat/bin/catalina.sh version

Find the Reporting Server version:

ls –l $INSTALLDIR/apache-tomcat/webapps/jasperserver-pro/WEB-INF/lib/*JasperPatch*.jar

Control Reporting Server from the command line:

sudo systemctl start bi-server.service

sudo systemctl stop bi-server.service

sudo systemctl status bi-server.service

sudo systemctl restart bi-server.service

Update memory settings:

  1. $INSTALLDIR/apache-tomcat/scripts/ctl.sh

    Remove the following JAVA_OPTS line in the start_tomcat() function:

    export JAVA_OPTS="-Xms1024m -Xmx2048m -XX:PermSize=32m -XX:MaxPermSize=512m -Xss2m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -Djava.awt.headless=true"

  2. $INSTALLDIR/apache-tomcat/bin/setenv.sh

    Remove the following lines:

    JAVA_OPTS="-Djava.awt.headless=true -Djs.license.directory=/opt/Insight $JAVA_OPTS"

    JAVA_OPTS="-Xms1024m -Xmx2048m -Xss2m $JAVA_OPTS " # java-memory-settings

    Add the following line and set Xms and Xmx to the desired values:

    CATALINA_OPTS="-Xms1024m –Xmx2048m -Xss2m -XX:PermSize=32m -XX:MaxPermSize=512m -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -Djava.awt.headless=true -Djs.license.directory=/opt/Insight"

    Change the following line:

    export JAVA_OPTS to export CATALINA_OPTS

  3. Once the above changes are made, please restart the Reporting server:

    sudo systemctl restart bi-server.service

See also: