JasperReport Server 6.3 install on RHEL 7.2 with Oracle 12c

Document created by Andrew Nguyen Employee on Sep 18, 2017Last modified by Andrew Nguyen Employee on Nov 17, 2017
Version 7Show Document
  • View in full screen mode

What this Guide Covers:

 

Benefits of Version 6.3

  • This version of JasperReports Server is faster and use less memory
  • Implements a new Cross-Site Request Forgery (CSRF) protection mechanism that is more effective and less intrusive

 

Platform Support Matrix

Certification Matrix - CA Business Intelligence JasperReports® Server - 6.2.0 - CA Technologies Documentation 

 

Video on How to Install CABI 6.3 JasperaReports on Linux

Installing CABI 6.3 JasperReports on Linux 

 

Environment Details

RHEL 7.2

Tomcat 8 (Download link: Apache Tomcat® - Apache Tomcat 8 Software Downloads  )

Java JDK 1.8.0_121 (Download link: Java Archive Downloads - Java SE 8 )

JasperReport Server 6.3

Oracle Database 12c

 

In this example, we are going to use sample.properties for our Oracle 12c. I have attached a sample one onto the document to use. Please replace information in <BRACKETS> to your reqested information to have the installer proceed successfully. For configuration of Oracle Database 12c, this guide is making the assumption the database is setup and configured already.

 

In the same folder run this command: install.sh -r sample_oracle.properties -l <<install.log>>

 

Using the sample.properties file provided in this guide, notice how the dbUsername attribute uses the "c##jasperserver". No matter what version of Oracle 12c you are using c## must be added to the beginning of the username. Everything else you can provide as guided in the properties file.

 

Average install is 1 hour and 40 minutes

 

If needed please follow the guide here for integration with CA Identity Manager 14.1:

Install and Configure CA Business Intelligence JasperReports® Server - CA Identity Manager - 14.1 - CA Technologies Docu… 

 

Configuring JasperReport Server 6.3 for use with CA Identity Manager

 

For Oracle, the Jasper_oracle_reports.zip file is available in the following location:

<CA_Identity_Manager_Install_Home>\\IAM Suite\Identity Manager\tools\imrexport\ReportDefinitions\IM Standard Reports\Oracle Reports

 

Please follow these instructions to adjust the permission:

Set the permissions to a created user.

  • Set user permissions for the IAM organization.
    1. Navigate to ViewRepositoryrootOrganizationsIAM.
    2. Right-click the IAM folder and click Permissions.
    3. In the Permissions dialog, click User.
    4. Select Read Only to assign a user read-only permission to the IAM organization. 
    5. Click Apply.
  • Set user permissions for the datasources folder.
    1. Navigate to ViewRepositoryrootOrganizationsIAM, IM, datasources.
    2. Right-click the datasources folder and click Permissions.
    3. In the Permissions dialog, click User.
    4. Select Read + Write to assign a user read and write permission to the datasources folder.
    5. Click Apply.

 

Copy the Required Files to CA Business Intelligence JasperReports® Server

During CA Identity Manager installation, the installer creates the Jaspersoft token authentication key file (iam.jks) and the iam.properties in the following folder:

\CA\Identity Manager\IAM Suite\Identity Manager\tools\JasperKeyGen\keystore\

The installer copies these files to the following corresponding folders based on the application server type:

JBoss:

<JBOSS_HOME>/modules/com/ca/iam/cajasper/main/

WebSphere:

<WAS_HOME>/properties/

WebLogic:

<WEBLOGIC_HOME>/config/cajasper/

Follow these steps:

  1. Copy the iam.properties file and iam.jks file to the config folder under the WEB-INF folder, in the CA Business Intelligence JasperReports® Server computer. 
    Example:

    <TOMCAT_HOME>\webapps\<web_application_name>\WEB-INF\config\

    <web_application_name>
            Specifies the name of the web application mentioned in the sample-properties file while installing the JasperReports Server.
    Restart the Tomcat server in the CA Business Intelligence JasperReports® Server computer.

 

Possible Errors

First be sure to clear the /temp folder in the Tomcat directory.

 

This could either be a permission issue or the folder simply does not exist. To resolve the folder issue make sure to import the folder and follow the steps from the section "Configuring JasperReport Server 6.3 for use with CA Identity Manager".

1 person found this helpful

Outcomes