Ricoh WES - Troubleshoot the WES

General troubleshooting rules

What? What procedure can be used to reproduce the incident?
When? What date and time did the incident occur?
Where? On which printer did the incident occur?
Who? On which user account did the incident occur?
Watchdoc.log: thank you for providing the Watchdoc.log file;a
config.xml file: thank you for providing the Watchdoc.log file;
server/device communication logs: please activate the trace files on each file.

Once this information has been gathered, you can send a resolution request from the Connect portal, the incident management tool dedicated to partners.

To obtain the best possible record of the data required for diagnosis, use the Watchdoc DiagTool® supplied with the Watchdoc installation program (cf. Creating a log report with DiagTool).

Scan, fax and photocopying are not in Watchdoc

If the scan, fax and photocopy jobs are not counted by Watchdoc, verify that the address (host name or IP) of the Watchdoc server configured in the device is correct:

Iin the configuration interface of the queue, in the WES section, click on the button Application status (displayed when the WES is properly installed);
Click the Download button to download the log files and WES configuration;
In the downloaded .zip file, open the Config.json file using a text editor and check the information corresponding to the address of the server (Address) and ports;
If the configuration of the address and / or ports is not correct, click on the Configure button on the queue configuration interface.
Verify that the procedure has resolved the problem.

Activating WES Traces

To diagnose a problem with WES applications, you need to activate the log files specific to WES communications :

in the Watchdoc web administration interface, from the Main Menu, Production section, click Printing queues, queues groups & pools;
In the list of queues, click on the name of the queue with the WES for which you want to activate the trace files;
in the queue management interface, click on Properties;
in the WES section, click on the Edit the settings button:

in the WES>Diagnostics section, tick the Enable traces box;
in the Trace level list, select:
- Auto: retains standard traces;
- Include binary content: retains detailed traces.
In the Path field, enter the path of the folder in which the trace files should be saved. If you leave the field blank, the trace files will be saved by default in the Watchdoc_install_dir/Logs/Wes_Traces/QueueId installation folder:

Activating the logs may slow down the server, so it is strongly recommended that you deactivate this option once the problem has been resolved.

Renewal of the Access Token before expiration

Context

When Watchdoc uses a Ricoh WES, it may occur that an alert message indicates that the access token will soon expire and invite you to contact your retailer:

Resolution

This issue can be solved by the update of Watchdoc.

If the Watchdoc update is not possible, the issue can be solved by the manual modification of the Watchdoc configuration file.

Since this procedure requires a service interruption, be sure to perform it when it will have the least impact on printing activity. Depending on the size of your print fleet, this service interruption can take between 15 seconds and 20 minutes.

Procedure

To modify the Watchdoc configuration file:

log in to the server that hosts Watchdoc as an administrator and shut down the Watchdoc service;
search the config.xml file (saved by default in C:\Program Files\Doxense\Watchdoc\Data\config.xml);
copy the config. xml file to save it;
open the config. xml with a text editor and seach the tag <ricoh-web-api>.
If this tag doesn't exist, create it under the <instances><default-instance> tag;

modify the tags included in this tag as follows:

<ricoh-web-api>

<remote> <token>/yRUEU9p0bcbIoN5wA3BTxPAAITn+8LXqRCmNpzb7zHjvk6QcxQqZyKragYFtX9qgisDrak4lTi1EjQYncukK9cMwxi1jShy5fN9qCUy9HRdL8qIYr4mU6aQrJhVVUwE8sWIRaaZG/3aZA07ybuJvUEoTf/OA66ja2I8Cf+9N4oGvErB3D6ZZh3GJ+kYcUZ0</token>

<valid-until>20260123</valid-until>

</remote>

<browser>

<token>/yRUEU9p0bcbIoN5wA3BTxPAAITn+8LXqRCmNpzb7zHUG08Fn3losZyFihRFrLgsgisDrak4lTi1EjQYncukK4cxmrZHgFOSkv7Yl2KGKSJhDL4Jw8dRfwat4g6pQkkV8sWIRaaZG/3aZA07ybuJvWtAIrYyDz2ZFxhihx/d5srA+yWYP6Sbn8dufT8VstpiMtpQC6O/rDX3/tY1jGK6jw==</token>

<valid-until>20260123</valid-until>

</browser>

</ricoh-web-api>

In the <token> tag, there must be no spaces in the character string;
if there are spaces, remove them.

As in the following example:

5. save the config.xml file;

6. restart the Watchdoc service;

7. in the Watchdoc administration web site, check that the access token alert message no longer displays.

Unable to find the ‘Doxense.Web assembly, Version=5.4.0.0, culture=neutral, PublicKeyToken=94de63351b6ea861’.

Context

When the Ricoh WES is installed, the following error is displayed when the Configure button is clicked:
Unable to find the 'Doxense.Web Version=[n°_version], Culture=neutral, PublicKey Token=94de63351b6ea861'

Resolution

Install the Ricoh WES manually.

Do not use the WESRICOHDEPLOYER

Information to ask the technician

Have the login details for the print device's web portal.

Ask the technician on site to activate SP Modes and confirm as many times as possible using the hash key #.

5-113- 002 = 0
5-401-230 = 00000001
5-401-240 = 1000
5-420-041 = OFF
5-490-001 = Allowed

WES Ricoh - Native Scan feature - Unable to scan a document - Scanner full log error message

Context

When using the native scanning functionality, an error message appears on the device screen: Full scanner log contact the administrator.

Cause

This message relates to scan log management on the device.

Resolution

Using a browser, access the device configuration interface as an administrator.
In the configuration interface, click on the Scanner menu item, then General Settings.
For Print and delete scanner log, select: Do not print: delete oldest.