Dwarf Mail Server 1.1.3

Sample Applications


Content


Overview

Sample applications can be used to test the mail server functionality after the fresh installation, or just to learn by playing with the sample configuration files.


Installation

The "conf/samples/mail/" directory contains several subdirectories with configuration files required by the particular sample application. An application can be run by executing one of the "run.bat" or "run.sh" scripts from the Dwarf installation home with URL of the application's main configuration file as the argument. Such file is typically named "main.xml".

Example of usage:

C:\Dwarf> run.bat conf/samples/mail/server/main.xml

  -- or --

localhost:/usr/dwarf# ./run.sh conf/samples/mail/server/main.xml


Applications

Each sample application has the corresponding "conf/samples/mail/xxxx/" subdirectory, which contains the application-specific configuration files.


Mail server

Subdirectory: conf/samples/mail/server/

This is a full-featured SMTP/POP3/IMAP4 server.

It in fact combines the SMTP, POP3 and IMAP4 sample servers to one complex server application, providing the full mail service.


SMTP server

Subdirectory: conf/samples/mail/smtp/

This is a standalone SMTP server.

Edit the "conf/samples/mail/smtp/smtp.xml" file and change the lines with the noticable "EDIT HERE!!!" comments to match your actual local host configuration.

The sample SMTP server is configured to receive mail for the local host name as well as the remote sites, but the remote delivery is deferred by default, so it will never be initiated by the server. You may run the mail queue manually for the remote recipients via the appropriate console command, or via ETRN extension to the SMTP protocol. To enable the automatic remote delivery, you must remove the "#remote" string from the "deferredNodes" SMTP parameter in the sample configuration file. Note also that for this mode of operation a valid DNS name server must be available to the SMTP server for MX record lookups.


POP3 server

Subdirectory: conf/samples/mail/pop/

This is a standalone POP3 server.

Edit the "conf/samples/mail/pop/pop.xml" file and change the lines with the noticable "EDIT HERE!!!" comments to match your actual local host configuration.


IMAP4 server

Subdirectory: conf/samples/mail/imap/

This is a standalone IMAP4 server.

Edit the "conf/samples/mail/imap/imap.xml" file and change the lines with the noticable "EDIT HERE!!!" comments to match your actual local host configuration.

Webmail

Subdirectory: conf/samples/mail/webmail/

This is a standalone SMTP server with a basic webmail interface. You must install the Dwarf HTTP Server first to be able to run this sample application, although it should run on any web server with Java Servlet 2.2 and JSP 1.1 support.

After starting the application open the http://127.0.0.1:8080 address and use the "joe" login name with "asdf" password to login and access the sample mailbox.


Return to the main page.


Copyright (c) 2004-2005, Gnome Ltd. All rights reserved.