Changing debugging level in EEE logs

From EnablerWiki

Created: 15 July 2009. Last Reviewed: 14 January 2011

By default, EEE log level is set to INFO so that only informational messages are logged. At times it can be worthwhile to change the logging level so that all EEE messages are displayed. This can be useful with functions such as integrated inventory when performing tasks such as goods receipts and transfers that print a receipt to the tills receipt printer. If EEE sends a print job to the receipt printer, but nothing prints, changing the logging level can assist with determining why printing is not working as expected.

The logging level for EEE is changed in the web.config file which is located in \inetpub\wwwroot\eee.

In the log4net section near the end of the file, there is a section for the RollingLogFileAppender that starts with

<appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">There will be a section under it for the threshold such as:-

<threshold value="INFO" />

This needs to be changed to ALL or DEBUG to show extra debugging info.

There is also a section at the end of the log4net section

<root>

<level value="INFO" />

<appender-ref ref="RollingLogFileAppender" />

</root>

This will also need to be changed to ALL or DEBUG.

When you then send a print job to a shared receipt printer from functions such as goods receiving or stock transfers, if the nothing prints, you can look at the log files in \inetpub\wwwroot\eee\log and search for relevant errors.

As an example, assume the shared printer was on a machine called JR7003SVR. If you searched the log file for the machine name, you would find something like the log extract below. This indicates that EEE can't access the printer. This could mean that the EEEServices account doesn't have access to the shared printer, or the name JR7003SVR can't be resolved on the network.

2009-07-07 12:59:50,250 [(null)] ERROR MurphyDBTables.PrinterFunctions [(null)] - Error (1801) occurred in ReceiptPrinter.SendBytesToPrinter. The printer name '\\JR7003SVR\thermal' is invalid.

The EEE logs are configured to maintain the last 10MB of logs, so when the logs are in debug mode, the 10MB of logs may only last a day or so.

Modifying the web.confile file will cause the EEE application to be reset, ending any active sessions, so this change should only be made when no users are logged into EEE.