How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I enable OpenICF logging for the .NET Connector Server in IDM (All versions) to investigate server crashes?

Last updated Apr 8, 2021

The purpose of this article is to provide information on enabling OpenICF logging for the .NET Connector Server in IDM. Enabling logging is useful for investigating .NET Connector Server crashes.


Enabling OpenICF logging

In the ConnectorServer.exe.Config file (located in the directory in which the Connector Server is installed), you should make the following changes:

  1. Change the value of the add key property from false to true: <add key="logging.proxy" value="true"/>
  2. Change the initializeData type to Error (it is set to Information by default): <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error"/>
Note

There are other logging levels available, which can be set by changing the initializeData type. The available levels are Error, Warning, Information (default) Verbose and All. Verbose and All output very detailed logging; the level of logging has a direct effect on the performance of the .NET Connector Server so care should be taken when changing this setting.

Your file should now look similar to this:

<configuration> <appSettings>   <add key="logging.proxy" value="true"/> </appSettings> <system.diagnostics>   <trace autoflush="true" indentsize="4">     <listeners>       <remove name="Default" />       <add           name="myListener"           type="System.Diagnostics.TextWriterTraceListener"          initializeData="c:\connectorserver.log"           traceOutputOptions="DateTime">          <filter             type="System.Diagnostics.EventTypeFilter"             initializeData="Error"/>       </add>     </listeners>   </trace> </system.diagnostics> </configuration>
Note

You should also enable Microsoft® Windows® crash dumps as described here: Collecting User-Mode Dumps

See Also

How do I enable database logging in IDM (All versions)?

Troubleshooting IDM

Connectors Guide › Install a Remote Connector Server

Related Training

N/A

Related Issue Tracker IDs

N/A


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.