IBM E027SLL-H - Tivoli Monitoring - PC Troubleshooting Manual page 65

Setting the trace option for the universal agent
About this task
Use the universal agent trace facility to diagnose problems . The universal agent
uses RAS1 tracing. By default, universal agent trace data is written to a file in the
logs subdirectory. The default RAS1 trace level is ERROR for all universal agent
components and modules. On Windows, the kumras1.log is overwritten each time
the universal agent starts and there is no method for archiving previous RAS1 log
files. Therefore, you must obtain the RAS1 log that matches the problem
occurrence before contacting IBM Software Support. You can set tracing options for
individual universal agent components and modules in the KUMENV file on
Windows or the um.ini file on UNIX-based systems.
RAS1 supports pattern matching. For example, (UNIT:kums options) traces all
SNMP data provider modules because they all begin with kums. Detailed RAS1
tracing can degrade universal agent performance due to high CPU usage and I/O
overhead. Therefore, set the universal agent RAS1 tracing to KBB_RAS1=ERROR after
problem diagnosis. If a module produces excessive error messages and fills the
RAS1 log, set (UNIT:modulename None) to suppress the module until you resolve the
errors. If you discover an old Windows RAS1 log file, the KBB_RAS1 environment
was erased or commented out in the KUMENV file, add KBB_RAS1=ERROR to the
install_dir\logs\hostname_um_timestamp.log to reactivate universal agent RAS1
tracing.
Set the universal agent trace from Manage Tivoli Enterprise Monitoring Services:
1. Right-click the universal agent.
2. Select Advanced > Edit Trace Parms.
3. Select the RAS1 filters. The default setting is ERROR
4. Accept the defaults for the rest of the fields.
5. Click OK to set the new trace options.
6. Click Yes to recycle the service.
Setting the trace option for the Warehouse Proxy agent
Procedure
1. On Windows systems, on the computer where the Tivoli Enterprise Monitoring
Server is installed, select Start > Programs > IBM Tivoli Monitoring > Manage
Tivoli Enterprise Monitoring Services.
2. Right-click Warehouse Proxy.
3. Select Advanced > Edit Trace Parms.
4. Select the RAS1 filters. The default setting is ERROR.
5. Accept the defaults for the rest of the fields.
6. Click OK to set the new trace options.
7. Click Yes to recycle the service.
Warehouse Proxy agent trace configuration:
You can edit the handler configuration file $CANDLEHOME%\Config\
ITMConfigRAS.properties for UNIX systems and the %CANDLEHOME%\Config\
ITMConfigRAS.properties file for Windows systems, and set the handler99 as the
configuration handler and set the debug tracing to the maximum DEBUG_MAX as
shown below:
Handler99.name=config
Handler99.scope=*
Handler99.scopeName=Config
47
Chapter 4. Tools