CA SiteMinder® Federation Standalone Guide › Logs to Monitor Federation Activities › Federation Web Services (FWS) Logging

Federation Web Services (FWS) Logging

You can monitor the FWS application run-time activities by enabling the following logs:

• Informational logging (affwebserv.log)
• Trace logging (FWSTrace.log)

To manage the log behavior, such as rollover frequency and log size, modify settings in the LoggerConfig.properties file.

Note: Do not confuse the LoggerConfig.properties file with the logger.properties file that configures the server.log file. The names are similar, but the files are different.

Follow these steps:

1. Navigate to the following directory:

   federation_install_dir\secure-proxy\Tomcat\webapps\affwebservices\WEB-INF\classes\
   

   Note: Use a forward slash (/) in the paths for a UNIX operating environment.

2. Open the LoggerConfig.properties file in a text editor.
3. (Optional) Modify the log settings. Review explanations and options for each setting in the LoggerConfig.properties file. The settings are:

   LoggingOn

   Enables or disables informational logging.

   LogFileName

   Default: federation_install_dir\\logs\\fws\\affwebserv.log

   affwebserv.log is the default file name. You can change the name.

   LogLocalTime

   LogRollover

   LogSize

   LogCount

4. (Optional) Modify the trace settings for logging FWS messages. Review the explanations and the options for each setting in the LoggerConfig.properties file.

   TracingOn

   Enables or disables FWS trace logging to the FWSTrace.log file.

   EnableDNSLookUp

   TraceFileName

   The default output file name is FWSTrace.log. You can change this name.

   TraceConfigFile

   Identifies the trace configuration file. The configuration file determines which components and subcomponents the system monitors and logs messages.

   TraceRollover

   TraceSize

   TraceCount

   TraceFormat

   TraceDelim

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

     Use the 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, Federation Standalone, Stop services
     2. Start, All Programs, CA, Federation Standalone, Start services
   • UNIX

     a. Open a command window.

     b. Run the following scripts:

     federation_install_dir/fedmanager.sh stop

     federation_install_dir/fedmanager.sh start

     Note: Do not stop and start the services as the root user.