Sending EMG debug information to technical support

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“. Please send us the entire output.

Second, your configuration files. Below, $EMGDIR refers to the EMG installation directory, usually /etc/emg or /home/emg.

  1. $EMGDIR/server.cfg
  2. $EMGDIR/client.cfg
  3. All files in $EMGDIR/dbconfig/lastok, if you are using DBCONFIG.
  4. All users and routing files ($EMGDIR/users, $EMGDIR/routing or others in use). 

Third, the log files from $EMGDIR/log.  If the problem can be recreated in a separate development installation, or emgd can be stopped anyway for a short period, please prepare the necessary log files following the steps below. For a production system, you should be able to run “emgd -reload” after modifying the log level(s). In case you have a larger number of connectors, you may also need to limit the number of connector and pdu log files when creating the tar file.

  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:
    1. cd $EMGDIR
    2. tar cvf logs.tar log/
    3. “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. Combining everything into a single text file typically makes troubleshooting more difficult.

Send the log files and the configuration files as attachments to support@braxo.se. If you have an open ticket for this particular problem, please send the message as a reply to an email in that thread. If it’s a new problem, please make sure you send a new mail, and do not use the Reply function.

If the compressed log files are large (> 5MB), you can open up a ticket first by sending an e-mail to support@braxo.se and then send the files via Sprend, with the same address as recipient. Please specify the ticket id in the message.