IBM Performance Management

Installing reports

Install the reports package on the Tivoli® Common Reporting server.

Before you begin

Before you install reports, you must complete the following steps:

Configure the reports installation image. If you configured the reports installation image, you see one of the following reports installation packages in the directory that you specified during configuration. The default folder for the reports installation package is /opt/ibm/ccm/depot.
- ipm_apm_reports_8.1.3.zip
- ipm_apm_advanced_reports_8.1.3.zip
- ipm_app_diag_reports_8.1.3.zip
- ipm_monitoring_reports_8.1.3.zip
For more information, see Configuring the reports installation image.
Ensure that network connectivity exists between the Tivoli Common Reporting server and the Performance Management server. The install_reports.sh script uses port 8090 to send HTTP requests to the Performance Management server.

Procedure

Copy the reports installation package from the Performance Management server to the Tivoli Common Reporting server and extract the reports installation package.
On the Tivoli Common Reporting server, run the installation script with root user privileges:
```
./installReports.sh
```
Select packages to install from the following reports packages by entering the corresponding numbers:
- Response Time Monitoring Agent Reports (not available in Application Diagnostics)
- Monitoring Agent for WebSphere® Applications Reports
- Monitoring Agent for Synthetic Playback Reports (not available in Application Diagnostics or IBM® Monitoring)
Enter the installation path for Jazz™ for Service Management.
Enter the user name and password for a Jazz for Service Management user with administrator privileges.
Enter the password of a Performance Management administrator.
Important: This password is the password of the Performance Management smadmin user. The smadmin password is the same as the apmadmin user password that you specified at installation. The default value is apmpass. If you cannot remember the smadmin password, you can change it using the script that is described in the following topic: Default users and passwords.
Enter the Tivoli Common Reporting IP address. For more information about Tivoli Common Reporting, see Downloading and installing Tivoli Common Reporting.
Verify Cognos Application Firewall and Cross Site Scripting (XSS) settings in IBM Cognos and Performance Management to allow access to reports from the Application Performance Dashboard.
1. Navigate to the installation location of Tivoli Common Reporting and run Cognos Configuration. The default location is
  - C:\Program Files\IBM\JazzSM\reporting\cognos\bin64\tcr_cogconfig.bat
  - /opt/IBM/JazzSM/reporting/cognos/bin64/tcr_cogconfig.sh
2. In the Component Properties table, ensure that Enable CAF validation? and Is third party XSS checking enabled? are set to True. For more information, see Configure IBM Cognos Components to Use IBM Cognos Application Firewall.
3. Restart the Tivoli Common Reporting server. For more information, see Restarting Jazz for Service Management application servers.
4. In the Performance Management Console, click Advanced Configuration > UI Integration > Parameters and set Cognos Reporting Requires XSS Validation as True.

Results

The reports packages are installed successfully. The Tivoli Common Reporting URL is added to the Cognos Reporting URL field in Advanced Configuration > UI Integration > Parameters in the Performance Management console. The Cognos Reporting URL format is https://<reporting-server-hostname>:<port>/tarf/servlet/dispatch/secured. For Tivoli Common Reporting 3.1.1, the Cognos Reporting URL format is https://<reporting-server-hostname>:<port>/tarf/servlet/reporting/secured.

Important: If the installation script does not complete successfully, review the error messages in the /tmp/apm_reports_installer file.

What to do next

You are now ready to view reports in the Application Dashboard. For more information, see Reports.