Summary

When troubleshooting the behaviors of Laserfiche client applications, it may sometimes be necessary to configure LFSO tracing on the workstation on which the application is installed. LFSO Tracing is one of several types of tracing that can be used to log the communication between Laserfiche Server and client workstations.

Resolution 1

In Laserfiche Client 8.3 and later, use the Laserfiche Client to enable tracing.

1. Open the Laserfiche Client and log into the repository you want to trace.
2. From the Help menu, select About Laserfiche.
3. In the About Laserfiche dialog box, click Tracing.
4. In the Tracing dialog box, select from the following:
   • Select the Enable LFSO tracing check box to turn on tracing for Laserfiche Server Objects (LFSO), and specify which versions of the LFSO you want to trace (8.0, 8.1, 8.2 and/or 8.3). In the Path text box, specify or select the file path where you want to store the trace logs.

   Note: Depending on what Laserfiche products you want to create trace logs for, you may need to select more than one version of the Laserfiche Server Object. For example, your Laserfiche Client 8.3 may be using LFSO 8.3 while your Audit Trail 8.1 may be using LFSO 8.0. For more information about your specific LFSO versions, ask your Laserfiche administrator.

   • Select the Enable WinHTTP tracing check box to turn on tracing for the WinHTTP protocol. In the Path text box, specify or select the file path where you want to store the trace logs.
   • Select the Enable DocumentProcessor tracing check box to turn on tracing for the DocumentProcessor. In the Path text box, specify or select the file path where you want to store the trace logs. Use the Level drop-down menu to specify the type of trace log.
5. Click OK.
6. In the About Laserfiche dialog box, click OK.

Resolution 2

To manually enable LFSO tracing through the registry

1. Go to Start Menu and select Run.
2. In the Run dialog box, type the following and click OK to load the Windows Registry Editor:

regedit

3. Expand HKEY_CURRENT_USER.
4. Expand Software.
5. Expand Laserfiche.
6. Create a new key under Laserfiche and name it LFSO.
7. Under the LFSO key, create another key:
• If you are troubleshooting an 8.0.x client, name the key 8.0.
• If you are troubleshooting an 8.1.x client, name the key 8.1.
• If you are troubleshooting an 8.2.x client, name the key 8.2.
• If you are troubleshooting an 8.3.x client, name the key 8.3.
8. Under that key, create a new String (REG_SZ)
9. Name the new value (case sensitive):

TraceLog

10. Double-click the TraceLog string you created in the previous step and set the value to C:\LFSOLog.
11. Restart the client application and reproduce the issue.
12. In the c:\ directory you will find a log file in the format lfsolog-...log.
13. The file name contains the application name, timestamp, and process id.

To disable LFSO Tracing, you can delete the TraceLog string you created above.

More Information

LFSO Tracing is often used in conjunction with Laserfiche Server Tracing.

[KB:1012172]1012172[/KB] Creating Event Trace Logs For Laserfiche 8