Often I have come across an installation where the end user has not configured the Performance Analyzer, and hence is not functional.
Here I will discuss some points about validating if the Tivoli Performance Analyzer component of IBM is installed and configured and is operational.
This blog mainly describes about detecting that the PA Report and Domain Definitions is not installed.
Here are some symptoms:
First , during the configuration, the Manage TEMS might show the Performance Analyzer in the window, however will complain that the PA tables are not installed.
This usually signals the the end user has *NOT installed the "Performance Analyzer Domain and Report Support", however has only installed the Base ITM component where the Performance Analyzer infrastructure is installed .
So cancel the operation and let's look at some background on this.
[[ I have described the Tivoli 6.3.0 which is the last released version of ITM ]]
The Base ITM 6.3.0 for a platform for ITM installs the Performance Analyzer infrastructure, if selected during the installation.
Next,install the agent (s) application support that we are interested in doing the Performance Analysis. ( i.e the OS Agent, ITCAM, DB2, SystemP and Oracle ), since these are the agents that the Performance Analyzer supports.
Followed by the Performance Analyzer 'Report and Domain definitions' component.
This installs the final piece required for the Base ITPA component for full functionality.
Other symptoms are listed below.
2. cinfo -t ( redirect this output to an external file and view it)
There are two paragraphs to the output.
One is the "PRODUCT DESCRIPTION" and another is the 'APPLICATION SUPPORT DESCRIPTION'.
In the Product Description paragraph you will see that the 'pa' agent is installed.
In the APPLICATION SUPPORT paragraph, if the lines mentioned in red (i.e p3, p0 and others ) is missing - this is clear indication that the 'Report and Domain support" for the Performance Agent is not installed.
At this point I'd assume that you have installed the
OS Agent and application support for them , or other agents ( like the
ITCAM, DB2, Oracle, or SystemP) before installing the PA 'Report and
Domain support' component.
When I mention 'application support - I mean the TEPS, TEMS application support.
This "Report and Domain Support for Performance Analyzer" component is critical for the Performance Analyzer agent for full functionality, and has to be installed.
So, if this is not installed - then stop PA, reinstall the 'Report and Domain support', and watch for these lines in the cinfo output. If the agents application support ( and/or ) agent is **not installed, then the 'PA Report and Domain installer will complain that it is not installed and if you wish to continue the installation. This might install the 'Report and Domain support' but might have other undesirable effects, which I'd recommend not to do..
*********** Tue Jun 18 16:18:01 IST 2013 ******************
User: root Groups: system bin sys security cron audit lp
Host name : taddm234 Installer Lvl:06.23.01.00
CandleHome: /opt/IBM/ITM623FP1
Version Format: VV.RM.FF.II (V: Version; R: Release; M: Modification; F: Fix; I: Interim Fix)
***********************************************************
...Product inventory
PC PRODUCT DESC PLAT VER BUILD INSTALL DATE
ax IBM Tivoli Monitoring Shared Libraries aix526 06.23.01.00 d2050a 20130612 1622
ax IBM Tivoli Monitoring Shared Libraries aix533 06.23.01.00 d2050a 20130612 1442
ax IBM Tivoli Monitoring Shared Libraries aix536 06.23.01.00 d2050a 20130612 1418
cq Tivoli Enterprise Portal Server aix536 06.23.01.00 d2050a 20130612 1429
cw Tivoli Enterprise Portal Browser Client aix536 06.23.01.00 d2050a 20130612 1420
gs IBM GSKit Security Interface aix523 07.40.27.00 d2031a -
gs IBM GSKit Security Interface aix526 07.40.27.00 d2031a -
hd Warehouse Proxy aix536 06.23.01.00 d2050a 20130612 1443
iu IBM HTTP Server aix536 07.00.00.00 d2031a 20130612 1423
iw IBM Tivoli Enterprise Portal Server Extensions aix536 07.00.19.00 d2031a 20130612 1426
jr Tivoli Enterprise-supplied JRE aix523 06.09.02.00 d2031a -
jr Tivoli Enterprise-supplied JRE aix526 06.09.02.00 d2031a -
kf IBM Eclipse Help Server aix533 06.23.01.00 d2031a 20130612 1428
ms Tivoli Enterprise Monitoring Server aix536 06.23.01.00 d2050a 20130612 1419
pa Tivoli Performance Analyzer aix533 06.23.01.00 20551 20130612 1443
sh Tivoli Enterprise Monitoring SOAP Server aix536 06.23.01.00 d2050a 20130612 1419
sy Summarization and Pruning Agent aix536 06.23.01.00 d2047a 20130612 1418
t1 File Transfer Enablement aix536 07.30.00.00 20100000-0000 -
ue Tivoli Enterprise Services User Interface Extensions aix536 06.23.01.00 d2050a 20130612 1419
ui Tivoli Enterprise Services User Interface aix526 06.23.01.00 d2050a 20130612 1622
ui Tivoli Enterprise Services User Interface aix533 06.23.01.00 d2050a 20130612 1442
ui Tivoli Enterprise Services User Interface aix536 06.23.01.00 d2050a 20130612 1418
ux Monitoring Agent for UNIX OS aix526 06.23.01.00 20541 20130612 1622
PC APPLICATION SUPPORT DESC PLAT APP VER BUILD INSTALL DATE
a4 Monitoring Agent for i5/OS tms 06.23.01.00 20511 20130612 1443
a4 Monitoring Agent for i5/OS tps 06.23.01.00 20511 20130612 1450
a4 Monitoring Agent for i5/OS tpw 06.23.01.00 20511 20130612 1448
hd Warehouse Proxy tms 06.23.01.00 d2050a 20130612 1443
hd Warehouse Proxy tps 06.23.01.00 d2050a 20130612 1450
hd Warehouse Proxy tpw 06.23.01.00 d2050a 20130612 1448
it TEC GUI Integration tps 06.23.01.00 d2031a 20130612 1450
p3 Performance Analyzer Domain for OS agent tms 06.23.01.00 20552 20140108 0206
p3 Performance Analyzer Domain for OS agent tpa 06.23.01.00 20552 20140108 0206
p3 Performance Analyzer Domain for OS agent tpd 06.23.01.00 20552 20140108 0205
p3 Performance Analyzer Domain for OS agent tps 06.23.01.00 20552 20140108 0205
p3 Performance Analyzer Domain for OS agent tpw 06.23.01.00 20552 20140108 0205
p4 Performance Analyzer Domain for Oracle tpa 06.23.01.00 20552 20140108 0206
p6 Performance Analyzer Domain for System p tpa 06.23.01.00 20552 20140108 0206
pa Tivoli Performance Analyzer tms 06.23.01.00 20551 20140107 1055
pa Tivoli Performance Analyzer tpd 06.23.01.00 20551 20140107 1057
pa Tivoli Performance Analyzer tps 06.23.01.00 20551 20140107 1056
pa Tivoli Performance Analyzer tpw 06.23.01.00 20551 20140107 1057
pi Performance Analyzer Domain for ITCAM RT tpa 06.23.01.00 20552 20140108 0206
Clicking on the Performance Analyzer Configuration icon on the TEPS GUI and getting the below message is another indication that the " Report and Domain Definitions" for PA is not installed.
So,the best practice is to install the Base ITM and choose the ITPA components, (i.e select the Performance Analyzer), followed by installing agent applicaiton support for the agents that we are interested in, followed by the the " Report and Domain Definitions for the Performance Analyzer as shown in one of the snapshots above.
This has to be followed by
- Configuring the TEPS "itmcmd config -A cq" on Unix or 'Reconfigure TEPS' using the MTEMS and
- Configure the Performance Analyzer agent.
=============================================================
The Performance Analyzer supports these following six agents
p0 Performance Analyzer Domain for DB2
p3 Performance Analyzer Domain for OS agent
p4 Performance Analyzer Domain for Oracle
p6 Performance Analyzer Domain for System p
pi Performance Analyzer Domain for ITCAM RT
pu Performance Analyzer Domain for VMware
If these agents are to be supported - install the agents first, followed by
installing the Performance Analyzer Report and Domain component.
Check that the Application support paragraph in the " cinfo -t " have these respective
paragraphs.
This ensures that you will see the correct naming convention for the agent
in the TEPS GUI - Performance Analyzer navigation bar, and also when you bring up
the Performance Analyzer Configuration Java panel, for configuring the tasks.
=============================================================
Best Practices Installation :Install ITM
Intall Agent ( like OS etc )
Install PA
Configure the TEPS ( CQ ) so that the respective domains are understood by the ITM.
Best Practices Debugging :
- Check if the ITM is installed. ( cinfo -t )
- Check if the ITPA Report and Domain component is installed ( i.e the PA,P3 , P3 etc show up in the
Application Support paragraph.
- Enable tracing in the agent.cfg which will load more debug information in the
kpacma.log .Change Info to Debug, Restart PA and watch for the kpacma.log debug messages.
AgentIdUniqueId__file=local.cfg
ConsolePassword__file=local.cfg
DisableVACM=true
EngineBoots__file=local.cfg
LogCount=3
LogFile=/opt/IBM/ITM/logs/kpacma.log
LogLevel=Debug <<<<<<<<<<<<<<<<=======================
LogSize=10000000
NotificationQueueLimit=50
UdpPort=-1
If DB2 - then this line ( change it appropriately ) should show up
2014-04-02 04:17:08: Using jvm classpath /opt/IBM/ITM/li6263/pa/bin/kpaxjdbc.jar:/opt/ibm/db2/V9.7/java/db2jcc_license_cu.jar:/opt/ibm/db2/V9.7/java/db2jcc.jar
