Wednesday, June 19, 2013

Tivoli Performance Analyzer -Some best practices.

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


     
 
 
 
 
 

No comments:

Post a Comment