Federation Manager Guide › Troubleshooting › Federation Manager Trace and Debug 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 UNIX 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. The settings are:

   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 = 1 MB

   2 = 2 MB

   LogCount

   Defines how many log output files to keep when logs are rolling over.

   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 = 1 MB

   2 = 2 MB

   TraceCount

   Defines how many trace output files to keep when logs are rolling over.

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. If you logged in as a network user and not a local administrator, right-click the shortcut and select Run as administrator.

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

     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.