Activate DSP logs - Procedure

Access configuration interface

  1. Access the Watchdoc administration interface as an administrator ;

  2. from the Main menu> section Configuration section, click on Adavanced configuration:

  1. in the Server interface, click on System configuration:



→ You access System configuration interface. Some of this information was entered during the initial installation of Watchdoc.

Activate the DSP logs

In the System configuration interface,

  1. in the DSPClosed A DSP is a microprocessor optimised to perform DSP applications (filtering, signal extraction, etc.) as quickly as possible. DSPs are used in most real-time DSP applications. They are found in modems (PSTN modem, ADSL modem), mobile phones, multimedia devices (MP3 player), GPS receivers, etc. They are also used in video systems, sound processing chains, wherever a complex signal is received that needs to be modified by filtering. section, logs sub-section Logs, set the parameters:

    • Log all incoming connections... : check the box to save all requests from the devices to the Watchdoc web server;

    • Save all network activity on the disk : check the box to save all the exchanges between the printing devices and the Watchdoc service;

    • Log Path: indicate the folder in which the logs files are saved by default (C:\Program Files\Doxense\Watchdoc\logs). If necesseray, you can indicate an other folder


       

  1. Click on to validate the System Configuration settings.

Increase the Watchdoc logs level

If the level of logs needed to analyze the malfunction is not sufficient, you can change it in 2 different ways: 

  • Either with an online command ;

    1. Open a command line;

    2. go to the Watchdoc installation repository:


    1. launch the following command: wcli LOG /server=localhost /password=changeme /level=DEBUG. 

      In this command:

    • the server parameter is the server on which the Watchdoc.exe service is running;

    • the password is the maintenance password of the Watchdoc target server;

    • the levelis the trace level that you want to apply (DEBUG or INFO).

       

      èThe level of the trace applied after the command is effective until the next restart of the Watchdoc service or until the execution of the same command parsed with the level INFO.

 

  • Either using the configuration file:

    1. Open the Watchdoc.exe.config file (saved by default in the C:\ProgramFiles\Doxense\Watchdoc folder) using a simple text editor (MS Windows Notepad® type)

    2. replace the following line:
      <add key="traceLevel" value="2" />
      by: <add key="traceLevel" value="0" />

    3. save the file, then restart the Watchdoc service ;

Don't forget to reset the initial value (2) once the diagnostics have been completed, as server performance is affected by the level of traces.

Activate the WES traces

When devices are equipped with WES, it may be necessary to enable logging of communications between the device and the Watchdoc server to diagnose an anomaly.

 

In this case, the activation of the logs must be done at the WES level. From then on, all the queues equipped with this WES are traced.

If the traces only concern one or more specific queues, in addition to activating the WES, the traces must be activated on the queue or queues concerned.

 

To activate the WES logs on a queue:

  1. from the Main menu, Production section> Printing queues...;

  2. click on the concerned queue, then on Edit properties;

  3. In the printing queue Properties interface, go to the WES section;

  4. For Diagnosis setting, check WES specific logs and specify Include binary content:

 

è By default, logs are saved on the Watchdoc \logs folder.

 

To activate this logs files:

  1. from the Main menu > Configuration section, click on Web & Wes;

  2. select the WES concerned,

  3. in Miscellaneous section > Log options subsection, select:

    • Destination: All

    • and Level (we recommend you to choose the Info level);

  4. validate the WES profile

  5. go back to the Main Menu > Production section

  6. in the WES section, click on the Reinitialize button.

 

From the Watchdoc Main Menu > Production section, click Printing queues, locations, queue groups & pools:

  1. in the list; select the relevant queue;

  2. In the queue management interface, click on the Properties tab;

  3. in the WES section, click on the Reinit. button .

Remember to disable traces in the diagnostic performed, the server performance being impacted byt the level of traces.

 

Since version 6.1.0.5052, it is also possible to activate WES traces (logs) from the WES print queue:

  1. from the Main Menu > Production section , click on Printing Queues ;

  2. select the queue, then click on the Properties tab;

  3. in the WES section,

    • click on Enable the logs

      The WES Trace setting value informs on the logs status:



      You can check in the WES profile that the Diagnostics and Log options parameters have been ticked:



  4. click on the Download logs button to analyse them.

  5. if you no longer need to trace the WES, click on the Disable logs button.

Collect the advanced logs

To analyse dysfunction thanks to logs,

 

  1. from the Watchdoc Main menu > Production section, select the concerned queue;

  2. click on the Properties tab;

  3. in the WES section> Other options subsection, click on the Enable logs button;

  4. in Watchdoc, replicate the anomaly;

  5. in the WES section> Other options subsection, click on the Download logs button ;

 

èWatchdoc creates a compressed logs archive which you can save in your work space.