IBM Support

How to Troubleshoot Planning Analytics Administration Alerts

Troubleshooting


Problem

You have configured Planning Analytics Administration Alerts however the alerts are not working as expected.

Environment

Planning Analytics Administration alerts use the Planning Analytics Administration Agent service (located where your TM1 Servers are running) for alerting. 

  -The Agent will assist in gathering TM1 Server related detail. 
  -The Agent is also responsible for the email notifications. 
  -The Agent is configurable via the <install dir>\tm1_64\paa_agent\wlp\usr\servers\kate-agent\bootstrap.properties file. 

See: https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_install_paa_sample_bootstrap_properties_file.html

Diagnosing The Problem

Should you encounter any problems with Planning Analytics Administration Alerts, please review the following log file:
<install dir>\tm1_64\paa_agent\wlp\usr\servers\kate-agent\logs\messages.log
This log file may contain errors related to your notifications.  For example, if your SMTP server has not been configured correctly you may see:
[6/6/19 14:21:31:622 EDT] 000001da com.ibm.pa.kate.agent.util.PAKateNotificationEmailUtil       E Exception occurred while sending smtp email com.sun.mail.util.MailConnectException: Couldn't connect to host, port: servername.domain.com, 25; timeout -1;
  nested exception is:
    java.net.UnknownHostException: servername.domain.com

Resolving The Problem

To resolve the specific example in this document, you would need to update the <install dir>\tm1_64\paa_agent\wlp\usr\servers\kate-agent\bootstrap.properties file.  You would need to ensure that the SMTP_EMAIL_PORT and SMTP_EMAIL_HOST settings are correct.  

Document Location

Worldwide

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSCTEW","label":"IBM Planning Analytics Local"},"Component":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
06 June 2019

UID

ibm10886985