Enabling console logging - PingFederate - 11.3

PingFederate Server

bundle
pingfederate-113
ft:publication_title
PingFederate Server
Product_Version_ce
PingFederate 11.3 (Latest)
category
Administrator
Administratorguide
Audience
Capability
ContentType
DeploymentMethod
Guide
Product
Productdocumentation
SingleSignonSSO
Software
SystemAdministrator
pf-113
pingfederate
ContentType_ce
Guide
Guide > Administrator Guide
Product documentation

You can edit the <pf_install>/pingfederate/server/default/conf/log4j2.xml file to enable console logging.

For troubleshooting purposes, you can enable console logging or verbose messages.
Important:

When you no longer require console logging or verbose messages, turn them off. On Windows, never highlight the console output because it might slow or stop PingFederate from processing requests.

To enable console logging:

  1. Edit the <pf_install>/pingfederate/server/default/conf/log4j2.xml file.
  2. Look for the Set up the Root logger section as shown in the following example.
    ...
    <!-- ======================= -->
    <!-- Set up the Root logger  -->
    <!-- ======================= -->
    ...
    <AsyncRoot level="INFO" includeLocation="false">
        <!-- <AppenderRef ref="CONSOLE" /> -->
        <AppenderRef ref="FILE" />
    </AsyncRoot>

    Then, update as shown in bold in the following snippet.

    ...
    <!-- ======================= -->
    <!-- Set up the Root logger  -->
    <!-- ======================= -->
    ...
    <AsyncRoot level="INFO" includeLocation="false">
        <AppenderRef ref="CONSOLE" />
        <AppenderRef ref="FILE" />
    </AsyncRoot>
    Important:

    When you no longer require console logging, comment out the <AppenderRef ref="CONSOLE" /> entry for the AsyncRoot logger.

  3. Save any changes made.
  4. In a clustered PingFederate environment, repeat these steps on each applicable node.

PingFederate activates the changes within half a minute. You don't need to restart PingFederate.