Installing EMWAC Internet Mail Services

Requirements

To use the Windows NT EMWAC Internet Mail Services, you need to have a computer with the following characteristics:

Installing

  1. Log into your Windows NT system as a user with administrative privileges.

  2. Download the appropriate ZIP files for your processor type by clicking below.

  3. All the online HTML documentation files for IMS are collected into a single ZIP file. If you prefer to have more local access to this online documentation, you should download that file.

  4. Unzip the files. You should have the following files:

    SMTPDS.EXE
    The SMTP Delivery Agent.

    SMTPRS.EXE
    The SMTP Receiver.

    POP3S.EXE
    The POP3 Server.

    IMS.CPL
    The Control Panel Applet.

    IMSCMN.DLL
    A DLL containing common code.

    COPYRITE.TXT
    The copyright statement for the software.

    READ.ME
    Summary of new features, etc.

    Note that all the EXE file are Windows NT Services.

  5. If you have installed a previous version of any of the services, you should remove them by typing (for each service):

    servicename -REMOVE

    See Deinstalling for further information. You should use the old version of the service to perform this remove operation.

    The remove operation does not remove the common registry information. That is, aliases, lists, directories for mail spool and inbox, etc, are still available. See more details in Registry.

  6. Decide which directory you are going to put the programs and the DLL in, and move them there. A good choice is the \WINNT\SYSTEM32 directory, which is where many other services live. Using the Security/Permissions menu option in the File Manager, verify that the SYSTEM user has read permission for the files.

    Move IMS.CPL to the \WINNT\SYSTEM32 directory. Start the Control Panel from the Program Manager to verify that the EMWAC IMS applet is represented as an icon in the Control Panel.

  7. Determine which version of the services you have. To do this, at the Windows NT Command Prompt, type:

    SMTPDS -VERSION
    SMTPRS -VERSION
    POP3S -VERSION

    and the version number will be displayed for each service. You should also check the IP address of your machine using the command:

    SMTPDS -IPADDRESS

    (The other services also recognise the -IPADDRESS parameter.) This will display the name of your machine (eg emwac.ed.ac.uk) and its IP address(es) as reported by the Windows Sockets API. If this information is incorrect, you need to reconfigure the TCP/IP software on your machine. The EMWAC Internet Mail Services will not work if this address (or list of addresses if your machine has more than one network interface) is wrong. See the IMS FAQ for the kind of problems this may cause.

  8. Install each service into the table of Windows NT Services (and simultaneously register it with the Event Logger) by running the program from the Windows NT command line, specifying the -INSTALL flag. (NOTE - it is vital that you execute this command using the copy of the service which you placed in the \WINNT\SYSTEM32 directory, and not using some other copy which you plan subsequently to delete.) Here are the commands to execute:

    SMTPRS -INSTALL
    SMTPDS -INSTALL
    POP3S -INSTALL

    Each program will register itself with the Service Manager and with the Event Logger, and will report success or failure. In the case of failure, see the section on Installation Problems below.

  9. To verify that the installation has succeeded, start the Windows NT Control Panel and double-click on the Services icon. The resulting dialog should contain
    EMWAC POP3 Server
    EMWAC SMTP Delivery Agent
    EMWAC SMTP Receiver
    in the list of installed services.

  10. Before you start the services running, you should configure them (see: Configuring EMWAC Internet Mail Services).

  11. Once you have configured the Internet Mail Services, you can start each service using the Start button in the control panel. If you have any difficulty starting the services, see the Troubleshooting page.

  12. Before you allow users to use the IMS, it is recommended that you create a local group called "IMSUsers" and add all IMS users into this group. The group should be assigned with "Log on as a batch job" right on NT Workstation or Server. It is different from the version 0.30 or earlier which requies "Log on locally" for the group on NT Servers. In order to get the "Log on as a batch job" right from the User Rights dialog in the User Manager, you should select the Show Advanced User Rights option in the User Rights dialog first.

    If IMS is running on an NT Server, you need assigned the right against the local NT Server not the local NT domain. For example, if your NT Server is called "PCNTSVR1" and your NT domain name is "NTDOMAIN1", you need bring up User Manager for Domain: Run "Select Domain" command in User menu, enter "\\PCNTSVR1" and press OK, then follow the above procedure to assign the right.

NOTE - UPGRADING FROM VERSION 0.1x and 0.2x. We have changed registry entry location for the EMWAC IMS Version 0.30 or later. Therefore you have to de-install the previous version before install the version 0.30 or later. This can be done by running the earlier version of POP3S, SMTPDS, and SMTPRS from the command line with the -remove flag.

Installation Problems

The system says that servicename is not a Windows NT program

This is probably because you are trying to run an executable for the wrong sort of processor. Check you have unpacked the correct ZIP file for your processor type.

The system says that the service won't install because of a "duplicate service name"

You must remove a previous version of the service in question using the servicename -REMOVE command before installing with servicename -INSTALL.

The service waits for a while, then terminates with a "usage" message

You must not run the service from the command line or from the File Manager, except with a command-line argument. Windows NT services must be started through the Services dialog in the Control Panel.