Federation Manager Guide › Troubleshooting › Federation Manager Troubleshooting Using Trace Logging › Federation Web Services Trace Logging

Federation Web Services Trace Logging

You can monitor federation run-time activities by enabling logging and tracing in the LoggerConfig.properties file.

The default name for the log file is affwebserv.log and the default name for the trace log file is FWSTrace.log. You can change the names of these output files in the Loggerconfig.properties file..

To turn on federation web services tracing

1. Navigate to the following directory:

   federation_mgr_home\secure-proxy\proxy-engine\Tomcat\
   webapps\affwebservices\WEB-INF\classes\
   

   Note: Change the back slash character to a forward slash (/) in the paths if Federation Manager is installed on a Solaris operating environment.

2. Open the LoggerConfig.properties file in a text editor.
3. Set the TracingOn parameter to Y.
4. (Optional) Modify the rollover settings for the log and trace files by modifying the following settings:
   • LogRollover

     Defines the type of rollover functionality desired for trace output files. The options are:

     0 = [default] Existing files are overwritten at startup.

     1 = Existing files are appended to at startup.

     2 = Rollover is only performed at startup..

     3 = Files rollover when they grow to the limit set by LogSize.

     4 = Files rollover at startup and then grow to the limit set by LogSize.

   • LogSize

     Dictates the maximum file size in megabytes when rolling over by size. Enter the number equivalent to the MB size you want. The options are:

     0 = off

     1 = 1MB

     2 = 2MB

   • LogCount

     Defines how many log output files to leave around when rollover is enabled.

   • TraceRollover

     Defines the type of rollover functionality desired for trace output files. The options are:

     0 = [default] Existing files are overwritten at startup.

     1 = Existing files are appended to at startup.

     2 = Rollover is only performed at startup.

     3 = Files rollover when they grow to the limit set by TraceSize.

     4 = Files rollover at startup and then grow to the limit set by TraceSize.

   • TraceSize

     Dictates the maximum file size in megabytes when rolling over by size. Enter the number equivalent to the MB size you want. The options are:

     0 = off

     1 = 1MB

     2 = 2MB

   • TraceCount

     Defines how many trace output files to leave around when rollover is enabled.

5. Save and close the file.
6. Restart the Federation Manager services, according to your operating environment.
   • Windows

     Use the Federation Manager stop and start shortcuts as follows:

     1. Start, All Programs, CA, FederationManager, Stop services
     2. Start, All Programs, CA, FederationManager, Start services
   • Solaris

     a. Open a command window.

     b. Run the following scripts:

     federation_mgr_home/fedmanager.sh stop

     federation_mgr_home/fedmanager.sh start

     When you run the fedmanager.sh script, it sources the Federation Manager environment script, ca_federation_env.ksh.

     Note: Do not stop and start the services as the root user. You must be a non-root user.