Sending EMG debug information to technical support Print
Thursday, 15 October 2015

This article describes what information is needed when contacting technical support in order to troubleshoot an EMG installation.

First of all we need version and license info for EMG.
You display it by running "emgd -v". Send us the entire output.

Second, your configuration files.
All users and routing files (/etc/emg/users, /etc/emg/routing or others in use).

Third, log files from /etc/emg/log.
Please create the necessary log files in the following way:
1) Stop emgd, "emgd -stop". Make sure there are no emgd processes still running using the "ps" command.
2) Move away or remove the current log files 
3) Add NOLOGSERVER and LOGLEVEL=DEBUG2 (or simply DEBUG if you are using EMG 7) at the top of your server.cfg.
4) Optionally, set ROTATELOGS=100M:10 in your server.cfg. This keeps 10 generations of each log file, letting them grow to 100MB each. You can keep more files if you want, but 100MB is a good size when debugging.
5) If you have many connectors (>10), instead add CONNECTOR_LOGLEVEL=INFO at the top of your server.cfg, and LOGLEVEL=DEBUG2 on the connectors that are involved in the current problem. For normal traffic, this means the connectors where the message arrives and where it is supposed to be sent out. For delivery reports, it also means the connector where the delivery report arrives, which may be different from the one where the message leaves, and the one where the delivery report is sent back, which is usually the same as where the original message arrived.
6) Start emgd
7) Run the failing procedure
8) Stop emgd, "emgd -stop"
9) Make a compressed archive with the relevant files
cd /etc/emg
tar cvf logs.tar log/
"gzip logs.tar", or "bzip2 logs.tar" if bzip2 is available on your system

Fourth, any other files you think is relevant.

Make sure that you do not do ANY changes to the files before sending them to us. Also make sure no character mapping is applied to the files (DOS<->UNIX line termination etc). The best way is usually to put everything into different files, create a tar-archive containing these files, compress it and then send us the compressed tar-archive as an attachment.

Send the log files and the configuration files as attachments to This e-mail address is being protected from spambots. You need JavaScript enabled to view it . If you have an open ticket for this particular problem, please keep the subject line containing the ticket id. If it's a new problem, make sure the subject line does not contain an old ticket id.

If the compressed log files are large (> 5MB), you can open up a ticket first by sending an e-mail to This e-mail address is being protected from spambots. You need JavaScript enabled to view it and then use our FileCentral inbox for uploading the file(s).

Please specify the ticket id in the message.