Logging and Troubleshooting

TA Logging

TA supports logging of all actions by all TA components. This section provides the location of the log files, and describes how to control the logging levels for each.

Log Files and Location

Here is the location of the log files for

  • TA components: <master install dir>\logs.

  • Client Manager process logs: <CM install dir>\logs\.

  • Client Manager sync logs (for information between the CM and it's cache DB): <CM install dir>\plugins\tes-6.0\logs.

  • Adapter Host logs: <master install dir>\logs.

  • Adapter logs: <master install dir>\services\<GUID of adapter name, found in the adapter button in the client>\log\.

  • Agent logs: <agent install dir>\<agent instance name>\logs\ES_<name of master>_<date optional>.log.

Controlling the Logging Levels

Logging is controlled in different ways depending on the TA component as described in these sections.

Setting the Logging Level for the Master

To set the logging level for the Master:

  1. Open the TA Web.

  1. Navigate to Activities > System Configuration.

  1. Open the Logging tab.

  1. Choose the logging level from the drop down menus for each of the objects listed below. Logging levels include: None, Severe, Warning, Info, Low Debug, Medium Debug, or High Debug.

    • Schedule Log

    • Client Manager Log

    • Agent Manager Log

    • Compiler Log

    • Job Manager Log

    • Event Manager Log

    • Queue Manager Log

    • Database Log

    • Communication Log

Setting the Logging Level for the Client Manager

To set the logging level for the Client Manager:

  1. Add this to the bottom of the ClientManager/config/tesXXX.dsp: #AND clientmgr.props files

    DspLog=FINEST 
    CacheLog=FINER 
    RequestLog=FINE 
    RpcLog=WARNING
    ClientLog=SEVERE 
    MaxLogFiles=1000 #allocates a gig

  1. Restart the Client Manager.

Setting the Logging Level for Agents

To set the logging level for Windows agents:

  1. Open the TA Service Manager on the agent machine.

  1. Click the agent on the drop down list.

  1. Click on the dots [...].

  1. Change the path in the Service tab to include the DEBUG option to read "DEBUG=HIGH".

  1. Click OK to save changes.

  1. Restart the agent.

To set the logging level for Unix agents:

  1. Navigate to the agent machine and go to the directory the agent is installed in.

  1. Navigate to "Bin/" and edit "tagent.ini".

  1. Under "[config]" put "ovb=tidaldebug".

  1. Restart the agent.

Setting the Logging Level for Adapters

To set the logging level for adapters:

  1. Open the TA Web.

  1. Click Connections in the Navigation pane.

  1. Locate and double-click the Master connection (Type=Master) to open its editor.

  1. Choose the logging level for Host Environment Log.

Setting the Logging Level for Transporter

To set the logging level for Transporter:

  1. Edit transporter.props in the Transporter’s config directory:

    XPORTER_DEBUG=YES
    TransporterLog=FINEST 
    TransporterUILog=FINEST 
    TransporterJobLog=FINEST 
    TransporterDataLog=FINEST

Setting the Logging Level for Fault Monitor

To set the logging level for Fault Monitor:

  1. Edit Primary Master and Backup Master master.props file:

    FaultToleranceLog=INFO

  1. Edit Fault Monitor master.props file:

    FaultMonitorLog=INFO 
    FaultToleranceLog=INFO