Spotfire Server: How to capture a trace log of an LDAP synchronization without changing the logging level or restarting the Spotfire Server

Summary

When troubleshooting LDAP synchronization, it is sometimes necessary to look at a trace log file to see what is going on. This article describes how to manually start an LDAP synchronization and how to capture the sync in a separate trace log file.

Solution

To set the logging level of the tools.log log file:

1. Open file <Spotfire-Server-home>\tomcat\spotfire-config\log4j2-tools.xml.
2. Change <Logger name="com.spotfire" level="WARN" additivity="false"> at the bottom of the file, to <Logger name="com.spotfire" level="TRACE" additivity="false">
3. Save the file.
4. Now you need to start an LDAP sync manually, so that you can capture a trace log file.
5. Go into <Spotfire-Server-home>\tomcat\logs\ folder and move (or delete) file named "tools.log".

6. Open a command prompt, cd into <Spotfire-Server-home>\tomcat\spotfire-bin\ and run:

   config.bat list-users -f

7. Specify the tool password when prompted.

Wait until the config.bat command finishes successfully, or until it fails. Once the command has finished you'll have a trace log of the whole LDAP sync captured in the tools.log file.