SiteMinder Agent for SharePoint Guide › Agent for SharePoint Log Files › Agent for SharePoint Logging › Federation Trace Logging › Configure Federation Trace Logging

Configure Federation Trace Logging

To collect federation transaction trace messages for the Agent for SharePoint, configure the federation trace logging.

Follow these steps:

1. Open the federationtrace.conf file. This file can be found in the directory Agent-for-SharePoint_home/proxy-engine/conf/defaultagent/federationtrace.conf.
2. Do one of the following:
   • Make a copy of the default template, federationtrace.conf and modify the file to include only the data you want to monitor.
   • Copy one of the preconfigured templates and assign a new name to it.

   Note: Do not edit the template directly.

3. Open the LoggerConfig.properties file in the directory Agent-for-SharePoint_home/Tomcat/webapps/affwebservices/WEB-INF/classes, and set the following parameters:
   • Set TracingOn to Yes. This option instructs the trace facility to write messages to a file.
   • Set the TraceFileName parameter to the full path of the trace log file. The default location is in Agent-for-SharePoint_home/proxy-engine/logs/federationtrace.log.
   • Set the TraceConfigFile parameter to the full path of the trace configuration file, either the default template, federationtrace.conf or another template. The default location is in Agent-for-SharePoint_home/proxy-engine/conf/defaultagent/federationtrace.conf.
4. Optionally, you can format the trace log file, the file that contains the log output. The following parameters are the Web Agent configuration parameters that dictate the format of the trace log file:
   • TraceRollover
   • TraceSize
   • TraceCount
   • TraceFormat
   • TraceDelim

   The LoggerConfig.properties file contains descriptions of all these settings.

   Note: Restart the Agent for SharePoint if you change the LoggerConfig.properties file.