JasperReport Server 6.2 Install on Windows 2012 with Integration with CA Identity Manager 12.6.8

Document ID : KB000010592
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

This guide introduces how to install JasperReport Server 6.2 and integration with Identity Manager 12.6.8. In addition, there is a section describing possible errors a user could potentially encounter when installing or configuring the integration with Identity Manager 12.6.8

Environment:
Windows 2012Tomcat 7Java JDK 1.8.0_111JasperReport Server 6.2
Instructions:

For simplicity, this guide will use locations in the root directory of the C:\ drive.

 

Tomcat 7 would be located in C:\Tomcat7

Java would be located in C:\Java\jdk1.8.0_111

 

After downloading JasperReport Server 6.2 from the CA Support website, move the zip folder onto your Desktop of the Windows server that will host the Report Server. Extract the folder contents and change the folder name to CABI. (Note: The reason this is done is because the installer complains about the folder name being too long)

Afterwards, navigate to the folder ...\CABI_JasperReports_Server_6_2_Windows\ca_install.

 

In the folder, "...\CABI_JasperReports_Server_6_2_Windows\ca_install" should have 2 types of files:

 

sample.properties and sample_Oracle.properties

 

The sample.properties file is used for a MS SQL Server Database versus the sample_Oracle.properties for an Oracle Database.

 

In the below example, sample.properties is used for MS SQL Server 2012. On this guide is a sample to use, please replace information in <BRACKETS> to the requested information to have the installer proceed successfully.

 

Sample Properties File

 

jasperSample.png

 

 

In the same folder, run this command: install.bat -r CA_sample.properties -l <<install.log>>

 

This will launch the installer for the JasperReport Server product.

 

Configuring JasperReport Server 6.2 for use with CA Identity Manager

 

Once the product is installed, perform the following steps using the CA Business Intelligence JasperReports® Server UI:

Note: The navigation mentioned in the following procedure is applicable for Jaspersoft version 6.2 only.

Follow these steps:

  1. Log in to the CA Business Intelligence JasperReports® Server UI as a Superuser.
  2. Create an organization with name as IAM.
    1. Navigate to Manage, Organizations.
    2. Under root organization, create an organization with name as IAM
  3. Create a user under the newly created organization.
    1. Navigate to Manage, Users.
    2. Select the newly created IAM organization.
    3. Click Add User.
    4. Specify the user details.
    5. Click Add User to IAM.
  4. Import the CA Identity Manager Reports zip file. The reports zip file is available in the following location, depending upon the CA Identity Manager Report database type:
    • <CA_Identity_Manager_Install_Home>\IAM Suite\Identity Manager\tools\imrexport\ReportDefinitions\IM Standard Reports\Ms-SQL_Reports
    • Navigate to Manage, Server Settings.
    • Under Settings, click Import.
    • Click Choose File to select the appropriate zip file from your local computer.
    • Click Import.
  5. Set the permissions to the newly created user.
    1. Navigate to View, Repository, root, Organizations, IAM.
    2. Right-click the IAM folder and click Permissions.
    3. In the Permissions dialog, click User.
    4. Select Read+Write+Delete permission for the user created under IAM organization.
    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.

Additional Information:

Possible Errors on Install / Configuration

Invocation of init method failed; nested exception is net.sf.ehcache.config.InvalidConfigurationException: There are 6 errors in your configuration: 
* CacheManager configuration: You've assigned more memory to the on-heap than the VM can sustain, please adjust your -Xmx setting accordingly

 

Fix:

In the setenv.bat file the xms and xmx may be set too high. A recommended settings would be to set it as:

set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m

 

License is expired

 

002-Apached Tomcat 8.0 Properties.png

Fix:

1. Go to the Jasper Reports Server

2. Go into the Tomcat Installation bin directory (Example. C:\Tomcat8\bin)

3. Execute Tomcat8w.exe

4. Add the license parameter to the Java tab as shown below:

-Djs.license.directory=<tomcat_home>/webapps/jasperserver-pro