IBM Support

INTEGRATION between IBM APM and Tivoli Common Reporting FAILED

Troubleshooting


Problem

INTEGRATION between IBM APM 8.1 and Tivoli Common Reporting (TCR) FAILED

Symptom

On the Tivoli Common Reporting server running the installation script 'installReports.sh' with root user privileges, It failed at the prompt to enter the password of a Cloud APM administrator.

We use the user 'smadmin' and the valid password 'apmpass' but it is not working.

The error message we got is:

The provided Cloud APM administrator password is not correct. Do you want to try again? [ 1-yes or 2-no ; "yes" is the default ] ?

The Step where the script failed:

Step 6 Enter the password of a Cloud APM administrator

To see all the steps, follow this link:

https://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/cognos_installreports.html 

Cause

Java™ program is not installed on the Common Reporting server (TCR).

Diagnosing The Problem

On APM Server side the /opt/ibm/wlp/usr/servers/server1/logs/messages.log file shows:

00008fa3 y.authentication.jaas.modules.UsernameAndPasswordLoginModule A CWWKS1100A: Authentication did not succeed for user ID smadmin. An invalid user ID or password was specified.

00008942 com.ibm.tivoli.monitoring.provider.events.AlarmConsumer     I Processing 1 messages...

This above message seems to indicate that an incorect password was received by the APM Server.

Resolving The Problem

- For reference:
The installReports.sh script does not expect to use the APM UI usernames (that is to say LDAP user names) to authenticate with the APM server on port 9443.  
Instead, it is using the internal APM smadmin user that is used to authenticate on port 8091.  

The smadmin user always exists (even if you are using LDAP to authenticate APM UI users). And it is its password that must be specified when the installReports.sh script prompts you for the password of a Cloud APM administrator. This password was entered when you run the configure_reports_images.sh script on the APM server.
This password is the password of the Internal Cloud APM 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.
https://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/cognos_prec.htm
Then, rerun configure_reports_images.sh when the script prompt "Enter the password of the Cloud APM smadmin user.
The url to test the smadmin password is:
 "https://<TCR host>:16311/tarf/servlet/reporting/secured"
With smadmin user, and its password.
==============================================
If the installReport.sh doesn't work, the actions that can be done on the Common Reporting server (TCR) Server are the following:
- Check the connectivity between Tivoli Common Reporting server and APM server (with command like ping, nslookup and also check that the hosts file is complete).
If the password is not accepted, then there can be a firewall blocking HTTP requests from the Tivoli Common Reporting server to the APM server. So ensure that network connectivity exists between the Tivoli Common Reporting server and the Cloud APM server. The install_reports.sh script uses port 8091 to send HTTPS requests to the Cloud APM server.
- Check whether the Tivoli Common Reporting server is an AIX server. If yes refer to the "Installing Reports", it's specific condition for AIX.
If you want to install reports packages on an AIX system with the Korn shell set as default, you must ensure that the Bash shell is available. You must also edit the ./installReports.sh script to change the line
#!/bin/sh
To
#!/bin/bash
 
- Check the Java™ version running the command:
java -version
(use the Java8 runtime).
- If you don't have Java™ on the Tivoli Common Reporting server, you also got this error:

In file /tmp/apm_reports_installer,

---------------------------------------------------------

-------------- Install Report Packages ----------------

---------------------------------------------------------

java not found

Using a supported Java version

Get JazzSM installation path

JazzSM installation path is: /opt/IBM/JazzSM

 

Get JazzSM Administrator credentials

JazzSM Administrator username is: smadmin

 

-----> Package is configured <-----

Document Location

Worldwide

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"IBM APM Server","Platform":[{"code":"PF016","label":"Linux"}],"Version":"APM 8.14 => Integration IBM APM with TCR","Edition":"APM 8.14 IF9 \nTivoli Common Reporting (TCR) Server on redhat7","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
24 January 2020

UID

ibm11274968