EMG 3.1.5 - User's Guide

Table of ContentsPreviousNextIndex

4. Configuration

4.1 General

Software configuration is done by editing the configuration files. For server configuration the file EMGDIR/server.cfg is used and for client configuration the file EMGDIR/client.cfg is used. EMGDIR defaults to /etc/emg as described in the Installation chapter.

The configuration files contain a number of keywords used to control the behavior of EMG.

In order to use EMG at least two connectors need to be defined in the server.cfg file. However, it is most common that at least three connectors are defined:

One incoming connector for MGP (used by the EMG client programs)
One incoming connector where messages will be received
One outgoing connector which connects to an SMSC or similar

For more information on connectors and how to configure them please consult the chapter Connectors.

4.2 Refreshing the server

After making changes to the server configuration file the changes will not be in effect until the server is either restarted, refreshed or reloaded. The routing table, user files and most options in the configuration file will be refreshed with the following exceptions:

Connectors cannot be deleted or added
The number of connector instances cannot be changed
The connector protocol cannot be changed

If any of these options need to be changed you would need to stop and start the server.

During a refresh all open connections will be closed gracefully while during a reload connections will not be close but only temporarily suspended.

4.3 Testing a configuration

After installing and configuring EMG consider the following:

When starting emgd does any messages that indicate a problem with the configuration file show up in the general log file (default EMGDIR/log/general)?
If EMG is to be used as a converter with both incoming and outgoing connectors, first verify that the outgoing connector(s) work(s). Use the emgsend command-line utility to "inject" messages into EMG and use the server.cfg keyword ROUTE or the routing table to make sure incoming messages from emgsend (MGP protocol) will be routed to the correct outgoing connector.
Check the connector logs (default EMGDIR/connector.*). For each message received and sent on a connector there will be a corresponding entry in the connector log file.
Use the "-debug" option with emgd to generate complete debug information. This information will be appreciated by NMT support engineers when helping out in troubleshooting an installation. The debug information will both be displayed on stdout and stored in the general log file. You may need to empty the log file from old information by simply removing the file before starting "emgd -debug". The file will be created if it does not exist when emgd is started.

Table of ContentsPreviousNextIndex