Knowledgebase article 156

Enable Mail Debugging


This will enable Mail Debugging mode to capture mail related events in your tomcat log file.  If your problem is not mail related, please see http://support.grouplink.net/ehelpdesk/kb/kbView.glml?kbId=125 to enable Full Debugging.

Warning: Debug mode will cause the log files to be more verbose, thus increasing in size daily. It is not recommended to leave debug mode on for extended periods of time.  Please disable this after your issue is resolved.

Windows:
for eHD versions 9.X & 10.X, follow these instructions.  For eHD versions 11.X & 12.X, follow the Linux instructions.

1. Run (as administrator) the "Configure Tomcat" application.  (GLtomcat6w.exe located in the tomcat\bin).

2. Stop the tomcat service and click on the Java tab.

3. Under Java Options, add the following lines (to the bottom of possibly many already existing lines):

-Dmail.debug=true

Note: Be careful not to include any spaces anywhere (even after the statement) or tomcat will crash.

4. (optional) delete the current log files located in tomcat\logs

5. Start the tomcat service.

Linux:

In the <tomcat_dir/conf/ directory, edit the file wrapper.conf. Look for this section of the file:

# Java Additional Parameters
wrapper.java.additional.1=-Djava.awt.headless=true
wrapper.java.additional.2=-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
wrapper.java.additional.3=-Djava.util.logging.config.file=../conf/logging.properties
wrapper.java.additional.4=-Djava.endorsed.dirs=../endorsed
wrapper.java.additional.5=-Dcatalina.base=..
wrapper.java.additional.6=-Dcatalina.home=..
wrapper.java.additional.7=-Djava.io.tmpdir=../temp
wrapper.java.additional.8=-XX:PermSize=100m
wrapper.java.additional.9=-XX:MaxPermSize=256m
wrapper.java.additional.10=-server
wrapper.java.additional.11=-Dfile.encoding=UTF-8

We're going to add an additional parameter to this list. The additional parameters are numbered sequentially, so we'll mark this one number 12. So we would add this line after number 11:

wrapper.java.additional.12=-Dmail.debug=true

Save the file, then restart Tomcat. 

Group eHD Standard Support Last modified Nov 16, 2023 Type Public Viewed 3271