ESMS Administrator Instructions - Configuration



These pages contain instructions intended to guide an ESMS administrator through the configuration of ESMS.

To correctly configure ESMS you should go through all the instructions on this page in order.


System Settings

System Settings Screen Shot

This screen allows access to the Gateway Settings, SMPT Settings, POP Settings and Global blocking configurations screens. It also provides the setting of three very important features.

The first of these is the automatic mail check. If this box is checked, then ESMS will check for mail at the specified interval. If it is not check then ESMS will never check for mail.

Second, Enable User Access Control. If this box is not checked, then ESMS will not check that the mail received is from a valid user. It will allow anyone to send messages through the system.

Lastly, Enable Logging. When checked, ESMS will write a several log files to disk. Generally, this should only be used if there are problems with the operation of ESMS.

What you need to do

Firstly, you need to decide if you want ESMS to check mail by itself, and if so, how often. Generally, ESMS will be configured to check for mail every now and again. You must decide how often you want to do this. If you want to enable automatic mail checking, make sure the Enable Auto Mail Check box is checked and enter the time between check is the box below it.

Secondly, you will need to decide if you want the system to be completely open. If you do this, then anyone will be able to send messages through ESMS. It is more likely that you will want to restrict access. To do this, ensure that the Enable User Access Control box is checked.

Lastly, if you are having problems with ESMS you should enable the logging. Under normal use this option should be set to off.

Back to top


Gateway Settings

Gateway Settings Screen Shot

Configuring the identity of ESMS involves identifying the administrator, the gateways Email address and the name of the gateway.

To set your gateways' identity, select the System Setting button, then select Gateway Settings button. This will display the dialog box show here.

What you need to do

To fill in this dialogue box, you will need to know the Email address of the person who will administer ESMS. The name of the gateway (could be something like "My Email-SMS Gateway"). The address that people who want to use the system must send their mail.

Having got this information, enter it into the dialogue shown.

If you get any of this information wrong, it will not stop the gateway from working. The information is used as follows:

Setting Use
Administrator Email Used in the signature of all Email sent out by ESMS
Gateway Name Used when sending Email to provide a user friendly name in the 'To' field
Gateway Email Used when sending Email

Back to top


SMTP Settings

SMTP Settings Screen Shot

The SMTP settings are required to allow ESMS to send Email messages. To set these settings, select the System Settings button, and then the SMTP Settings button.

What you need to do

Firstly, you must find out the network name for your SMTP server. This is where ESMS will send its Email to. You must get this correct. If you do not, ESMS will not be able to send out any Email. The example shown has the SMTP local to the machine where ESMS is running, generally you will have something like host@provider.com.

Secondly, you need to provide the user name for the SMTP server. Most SMTP servers aren't too fussy, and you can often put anything you like here.

If you are unsure about any of these settings, you should contact your Internet provider or network administrator.

Back to top


POP Settings

POP Settings Screen Shot

The POP settings are required to allow ESMS to receive Email messages. To set these settings, select the System Settings button, and then the POP3 Settings button.

What you need to do

Firstly, you must find out the network name for your POP3 server. This is quite likely to be the same as your SMTP address. This is where ESMS will try and collect Email from. If you get this wrong ESMS will be unable to collect any Email.

Secondly, you need to enter the user name and password to allow ESMS to log onto the POP3 server. You should make sure that the account given to ESMS is not used by anyone else. Again, you must get these details correct.

If you are unsure about any of these settings, you should contact your Internet provider or network administrator.

Back to top


Configuring Services

Services Database Screen Shot

The services database maps the incoming requests to GSM/PCN service providers. Data is provided for the Vodafone and Orange networks.

What you need to do

If you wish to add a service, the procedure is as follows:

  • Click New Service and enter the name (e.g. CellNet)
  • In the Numbers area enter all the dial codes you wish to direct to this new service
  • In the Script File Name area, enter the name of the script file that will talk to the service provider.

Ok, what's this script thing then? ESMS uses a script to tell it how to transfer messages to the GSM/PCN network service provider. If you add a new script you must write a new script. For information on how to do this, see the script authoring page.

To modify an existing service, simply select if from the drop down list and make your changes. Scripts may be edited by selecting Edit Script, which will start Notepad.

To start with, it is advisable to using the two services provided if possible. Then once you have established that the gateway is working properly, additional services may be added.

NOTE:The two scripts provided may need altering as they have only been used on a US Robotics modem. If your modem is not attached to serial port 1, you will have to edit the scripts - don't worry it's a simple one character change at the start of the script. The second line of both scripts is "C1", change the "1" to be the number of your serial port.

Back to top


User Management

ESMS User Database Screen Shot

To add users to ESMS enter the user database and type in the new users details and click Add. If user access control has been enabled, these details will be used to determine if a message can be sent. If you want to allow everyone in a company to use the gateway you don't need to type in everyones details. You can specify a domain in the Email address. However, you must specify a full email address for an 'administrator' account. This account will be able to perform special commands, such as getting account information. The format for a domain account is admin@joe.co.uk;@joe.co.uk. This specifies 'admin@joe.co.uk' as the administrator account, and will allow anyone from the 'joe.co.uk' domain to use the system. You can specify more than one domain if you like. For example admin@joe.co.uk;@joe.co.uk;@joe.com will allow everyone from joe.co.uk and joe.com to access the system.

You can exclude specific users by entering their Email address or Mobile Phone numeber in either the Blocked Numbers or Blocked Email boxes.

If you have enabled logging, then each user will have a log file, clicking on View Log File will display this log.

Should you wish to modify a users details, simply select the required user from the list of users, edit the details and press the Update button.

Currently the Block User and Quota features are not available. These will alow the blocking of a user at a single key press without deleting their details, and the limiting of the number of messages that any one user can send.

Back to top


Customising ESMS Messages

There is no need to customise the Email messages sent out by ESMS, however, you may wish to do so. Before you can do this you will need to know what the files are and when they are used.

File Name Meaning/Use
help.txt Sent in reply to a help request
account.txt Used as a header when sending account information
autosig.txt Used as a signature for all Email sent
msg1.txt Error - Request contained an unrecognisable number
msg2.txt Error - Message too long
msg3.txt Error - Unregistered user
msg4.txt Error - Destination blocked
msg5.txt Error - Authorisation failure
msg6.txt Error - Recipient out of quota
msg7.txt Error - Sender out of quota
msg8.txt Error - Bad format
msg9.txt Error - Sender blocked by mobile user
msg10.txt Error - Authorisation failure
msg11.txt Error - Authorisation failure
msg12.txt Error - Authorisation failure (Special Services)
msg13.txt Ack - Blocking request accepted
msg14.txt Error - Blocking request failed
msg15.txt Ack - Unblock request accepted
msg16.txt Error - Unblock request failed
msg17.txt Error - Restricted feature
msg18.txt Error - Already blocked
msg19.txt Error - Message rejected by mobile network

If you have a look at any of these files, you will see that they all start something like this:

From: $GATENAME$ <$GATEEMAIL$>
Reply-To: <$ADMINEMAIL$>
Subject: $GATENAME$ account Information

The text flanked by two $ is replaced by information set in the System Setting dialogues. The available macros are:

Macro Replaced With
$GATENAME$ The gateways name, set in Gateway Settings
$GATEEMAIL$ The gateways Email address, set in Gateway Settings
$ADMINEMAIL$ The administrators Email address, set in Gateway Settings

Back to top


Note:All software on this site is supplied "as is", with no guarantee offered or implied. While every effort has been made to ensure the correct operation of the software, no responsibility is accepted for any loss, damage or charges incurred which may arise from the use of this software. A virus scan has not been performed on the download files, you are advised to do this before running any of the software. Re-distribution of the software is permitted providing that I) no charge is made for it, II) it is distributed in exactly the same form as found on this site, III) you do not take any credit for it's production. Any queries should be directed to the original author.

© 2003 James Battersby.
Main Page | Mail the WebMaster