LICENSE

The program can be used freely, although at your own risk. It may however not be re-distributed or altered, and the copyright notice must be intact.


BASIC SETTINGS

Edit the http.ini file in the application directory according to your server environment:

BindIP=127.0.0.1
Change this to the IP number of the server.

BindPort=81
The standard HTTP port is 80. If you have another HTTP service active on the server you will have to use a different port, though.

LogCut=128000
The maximum number of bytes to show in the log viewer. Default is 64000.

WebRoot=C:\mercury\HTTPServer\web
The directory where the html files are located. 

MercDir=C:\mercury\
The directory where the Mercury executable is located. Optional. The program will attempt to find Mercury automatically (from the Windows registry or by using the default location \mercury\), but if this for some reason fails it's possible to enter the information here.

Autostart=0
Enter 1 if you want the http server to become active immediately when the program is started. Otherwise enter 0 (default).


USER RIGHTS

The program should obviously run on the same computer as Mercury, and should preferably be started by the same user.


AUTHORIZATION

The program has built-in server authorization that will verify user name and password against the POP3 account information in Mercury. It's possible to disable it but at present no html files are provided for running the server without authorization active.

For access to the admin tools you need to log in using the Postmaster account.


CREATING USERS

As of version 1.1 there is a tool to create new users from the web page. Note that user creation requires maiser to be active and at least one admin password for maiser to be defined. If not a server restart is needed to allow Mercury to find the new user.


CHANGING PASSWORDS

If you don't want users to be able to change their POP3 password from the web page you can remove this part from the usermbox.html template file (see comment in the file).


STATUS DISPLAY

The status page shows the state of the most commonly used Mercury modules only.


VIEWING MESSAGES

The mailbox page provides a tool for admins to view messages in a user's inbox. Messages are shown as individual MIME parts, and each part can be downloaded separately. This tool is provided for troubleshooting purposes and is not intended as a webmail alternative. When deleting messages from the web interface you need to make sure there is no other simultaneous access to the mailbox.


LOGGING

The log display is intended for debugging purposes and needn't be active in normal use. The HTTP server keeps no log files.


HTML PAGES AND HTML TEMPLATE

If you want to personalize the web pages, just edit the files in the web directory (.html and .tab) according to your preferences. template.html will change the appearance of all server generated pages. Kindly leave the credits intact, though.


SECURITY

All communication with the HTTP server is in clear text and can be intercepted by a third party. I advise to use the tool in a LAN environment only and not make it available to users connecting over the Internet. If you have remote users that may want to change their autoreply settings using this tool a good pratice is to provide them with a VPN connection to the LAN.

Other than that there are no know security implications relating to this software.


OS REQUIREMENTS

The program has been tested under Windows XP, Windows 2000, and Windows 2000 Server. It's expected to work under Windows 98, Windows ME, Windows NT 4, Windows 2003 Server, and Windows Vista as well, but some functions may not be available. Please report problems to the mail address below.


Stockholm, March 2008

Rolf Lindby
rolf@serieguide.se



VERSIONS

1.0.1 (May 2006)
Added minimize to tray function.
Added favicon.

1.0.2 (September 2006)
Small bug fix in autoreply function. It's now possible to revert to autoreply with no time limit after having used time limits.
Updated networking to latest build of Synapse (http://www.ararat.cz/synapse/).

1.0.3 (July 2007)
Autoreply with date limits will now allow the use of Mercury/32 template substitutions in the reply message (see excerpt from the Mercury help below). Updated networking to Synapse 38b5 (http://www.ararat.cz/synapse/).

1.1.0 (March 2008)
Added tools for starting, stopping, and restarting Mercury, as well as putting server offline.
Added tools for creating new user and new alias.
Added tools for changing user passwords. The postmaster password is protected from change, though.
Added display of messages in queue on the status page. 
New global html templates (template.html for admin tools, usermbox.html for other users).
New html templates for admin tools that will be displayed according to menu selections (status.sub, control.sub,
logs.sub, user.sub, mbox.sub).
Fixed bug in identification of loaded Mercury modules and added more information to the status page.
New icon created.
Function to strip attachments from messages considered unreliable and removed for the time being.
Updated networking to Synapse 38 final (http://www.ararat.cz/synapse/).

1.2.0 (June 2008)
Updated program to support Mercury version 4.61, which has some changes in the internal window hierarchy.
Added detection of Mercury program version.
Added display of logfiles for standard daemons (SpamHalter, GrayWall, ClamWall) if installed in the default location (main Mercury directory). Template file logs.sub was changed accordingly.

1.2.2 (August 2008)
Added support for starting and restarting Mercury using loader.exe.
Added a summary of some statistics for GrayWall logs.
Added a simple log filter function for MercuryS and MercuryE logs.
Added code for updating the alias file without calling malias.exe and fixed 2 bugs that in certain circumstances would prevent an alias from being created.
Removed options for status display - all information (server, queue and disk usage) will now always be shown.


-  -  -

Excerpt from "Creating and enabling programmable autoreplies" in Mercury/32 help:

"If the automatic reply is a valid Mercury/32 template file, add the optional value "1" at the end of the line. All the standard rules for template files apply, and you can use two special substitutions as well as the basic set - ~P0, which is replaced with the full e-mail address of the owner of the mailbox to which the message is being delivered, and ~P1, which is replaced by the date in the "Date" field of the original message."

