Toshiba WES - Troubleshoot the WES

General troubleshooting rules

In order to enable the Doxense Support team to establish a fast and reliable default diagnosis, please communicate as much information as possible during the declaration of the inciden

  • 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:

  1. Iin the configuration interface of the queue, in the WES section, click on the button Application status (displayed when the WES is properly installed);

  2. Click the Download button to download the log files and WES configuration;

  3. 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;

  4. If the configuration of the address and / or ports is not correct, click on the Configure button on the queue configuration interface.

  5. Verify that the procedure has resolved the problem.


Activating WES traces

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

To activate the traces

  1. in the Watchdoc web administration interface, from the Main Menu, Production section, click Printing queues, queues groups & pools;

  2. In the list of queues, click on the name of the queue with the WES for which you want to activate the trace files;

  3. in the queue management interface, click on Properties ;

  4. in the OSA section, click on the Edit the settings button:


  1. in the WES>Diagnostics section, tick the Enable traces box ;

  2. in the Trace level list, select :

    • Auto: retains standard traces ;

    • Include binary content: retains detailed traces.

  3. 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.

Error while starting a newformat breakdown

Context

While quotas were configured on the Toshiba WES, when a print job was validated, the user saw the ‘Internal Server error’ message displayed on the WES.

During analysis, the message ‘Error while starting a newformat breakdown: Invalid object name “dbo.formatbreakdown”’ appears in the log files.

Message "Internal Server Error" on the WES.

 

Cause

This problem may be due to the quota configuration.


Resolution

To solve this problem, it is necessary to complete the installation of WES after the installation steps:

  1. connect to SQL server as administrator;

  2. Open the mssql_formatbreakdown46.sql file so that you can copy its contents later;

  3. open SQL Server Management Studio ;

  4. in the Connect to Server interface, enter the following information:

    1. server name :

    2. the authentication type, plus Login / Password if necessary.

  5. in the left-hand tree, expand the Databases level

  6. locate watchdocstats and right-click;

  7. select New Query;

  8. on the right-hand page, paste the contents of the script mssql_formatbreakdown46.sql;


  1. then click on the Execute button;

  2. A message will inform you that the script has been executed successfully:

     

  3. Access the Watchdoc server as administrator;

  4. Open the config.xml file (by default: C:\Program Files\Doxense\Watchdoc\config.xml) with a text editor;

  5. in the /config/checkout section, add the line <use-formatbreakdowntable>true</useformatbreakdowntable>;

  6. quit SQL Server Management Studio and restart the Watchdoc service;

     

èCheck that printing is running correctly on the WES, and that quotas are taken into account.


InternalServerError. An Internal error occurred. JsonDbException

Context

This error message appears after the WES has been installed, even though everything seems to be configured correctly: Doxense.data.JsonDv.JsonDbException: Database must be initialized before any operation.

 

Cause

The interserver database is not configured when the Watchdoc server is started.

 

Resolution

In the Watchdoc administration interface, check the configuration of the interserver database (see Enable the interserver printing function).


Delay before printing

Context

When a user sends a document to a network printer targeting a print server, there is a delay of around twenty seconds before the document begins to be spooled and then sent to the server.

 

Cause

This anomaly is caused by the driver sending SNMP requests to the print server thinking it is a device. Each request causes a timeout.

 

Resolution

To solve this problem, disable the bidirectionality in the print queue properties from its configuration interface:

  1. in the list of devices installed on the server, select the Toshiba device:

  2. right-click, then, in the list, select "Properties";

  3. On the Ports tab, check that the box Activate the bidirectional mode management is disabled:

  1. On the Device's settings tab, check that the box Self update is unchecked.

  1. On the Advanced tab, click on By default printing button;

  2. On the Others tab, check that the box SMNT Communication is unchecked.


WES Licences counting error - No valid licence.

Context

When Toshiba WES is associated with a print queue, a failure of the MS Windows server or spooler may result in the number of WES licenses not appearing in the queue's properties (Main Menu> File Print + queue selection> Properties).

In this case, a error message is displayed in the WES profile interface:
"a malfunction has been detected, please consult the application log for more information. The on-board interface is not working properly. This device does not have a valid licence and will be rejected by this server".

Additionally, this problem is traced in the Watchdoc logs (which are stored by default in C: \ Program Files \ Doxense \ Watchdoc \ logs \ Watchdoc.txt), where a JSON error message appears during the service start-up phase.

Resolution

To resolve this issue, use the following procedure:

  1. Verify that the server is up-to-date with the latest Watchdoc version;

  2. Verify the JSON TOSHIBA error message is present when the service starts;

  3. Inventory files that do not properly display licenses;

  4. Go to the c: \ Program Files \ Doxense \ Watchdoc \ Data \ queues.jsdb folder;

  5. In this folder, locate the problem girls' files and rename them "NOMSERVER.QUEUES_OLD";

  6. Restart the Watchdoc service;

  7. Check in the queue properties that the WES licenses are displayed correctly.


WES manual uninstall on Toshiba e-Bridge-N

Context

It can occur, especially after a test period onto the Toshiba e-Bridge-N device, that this one is not yet connected and can no longer interface with the Watchdoc print server.

In this case, it is no more possible to uninstall the WES from the device from the Watchdoc administration interface. To be able to reuse the device, it is then necessary to uninstall the WES from the Toshiba e-Bridge-N device administration interface.

Instructions

To uninstall manually the WES from the device:

  1. thanks to a browser, access the device administration interface (TopAccess);

  2. in the Administration tab, log on with an administrator account;

  3. in the Configuration tab, click on General;

  4. in the parameters list, disable the Mode MDS:

     

  5. click on Save to validate the configuration modifications.

  6. click then on the Security tab;

  7. click on the Authentication entry;

  8. in the User authentification parameter, disable the user authentication:

     

  9. click on Save to validate the configuration modifications.

èWatchdoc is therefore uninstalled and the device is able to operate normally.


Configure the Confidentiality settings

To obtain precise information about users in the Watchdoc print history, you need to configure the confidentiality settings on the printing device.
Otherwise, user information will be hidden and replaced by stars:

 

  1. Access the device configuration interface as an administrator.

  2. Click on Administration > General in the menu.

  3. In the Confidentiality settings section, select ‘Store’ for the Log data privacy settingg:



  1. Click on Save to validate this setting.