Inet.Mail Perseus 2.0.9
21 September 2002
Hethmon Software
www.hethmon.com

*********************************************************************
*
* OS/2 ONLY
*
* Please Note: WarpIN is required to install Inet.Mail Perseus.
* The install program supports migrating Inet.Mail 1.3 Regular and 
* Inet.Mail 1.5 Pro versions to version 2.0. The converter program 
* will automatically be run as part of the WarpIN install.
*
*********************************************************************

0. Operating System Support

Inet.Mail Perseus supports both OS/2 Warp 4 and above and Windows
2000. For specific notes on Windows 2000 support, please see the
end of this Readme file.

1. General

This is the initial release of Inet.Mail 2.0, code name "Perseus".
This version differs from Inet.Mail Version 1.x (V1) in several significant
ways. The most notable is that Perseus does not contain a Presentation
Manager version of the server. The server is strictly a command line
executable. The second notable difference is that the configuration
utility is a Java* program. The configuration manager program can
control Perseus across any tcp/ip connection, it is not restricted
to the local machine any longer like V1.

With this version, migration from Inet.Mail Version 1 (V1) is
supported. Migration from version 1.3 Regular and 1.5 Pro is supported.
No versions prior to those are supported with the migration program.
You should make a complete backup of your inetmail directory before
installing this version. Backup of user directories is not required.

This readme file contains basic information on the usage of the
server. Please consult the Help files (available as an installation
option) for complete information.

2. Perseus

Inet.Mail Perseus is started by running the inetmail.exe program
at any command prompt. All necessary dlls are included and should 
be placed in the same directory. It is not necessary to start either
smtpd.exe or pop3d.exe separately, inetmail.exe starts and controls
both of these programs automatically, they cannot be started by
themselves.

Perseus supports the following options on the command line when
starting up:

  -loglevel n     Set the debug logging level (n) to a value between
                  1 and 100. The higher the number, the more verbose
                  the information written to the error logging file.
                  Must be specified before -l, -ll, or -lt.
  -l              Create err files (inetmail.err, smtpd.err, and pop3d.err)
                  containing debugging information. Overwrites any previous
                  file.
  -ll             Create err files, but append to any existing err files.
  -lt             Create err files, append to any existing. Additionally
                  restart the err files every two hours in order to keep
                  their size managable. Previous files are stored as
                  inetmail2.err, smtpd2.err, and pop3d2.err. The "2"
                  files contain the prior 2 hour period, so at any given
                  time, up to 4 hours of activity may be recorded.
  -portpop p      Use given port (p) to listen for POP3.
  -portsmtp p     Use given port (p) to listen for SMTP.
  -?              Show command line help and exit.
  -f filename     Use given <filename) for the configuration file. Default
                  name is perseus.cf.

All other options previously supported by V1 have been moved to the
configuration file.

2.1 Operation

After perseus is started, you will see a "inet.mail perseus>" command
prompt. At this prompt, you can issue 3 commands:

  set pass
  h
  q

The first command "set pass" allows you to set a new root password
for the server. This password is used when logging into the server via
the manager application. It is also settable in the configuration file.
Changing the manager password here does not change the value in the
configuration file. It will remain the new value only as long as the
server is running. The "h" command prints out a brief help summary. 
The "q" command quits the server.

2.2 Configuration File

The accompanying "perseus.cf" file lists all of the available
options. This file is a simple text file. The semi-colon character
";" is used to denote a comment line in the file. Comments are preserved
when editing the options via the manager program. Options fall into
several types. Each option includes a brief explanation and specifies
the data type.

2.2.1 character string

; registrationnumber -- type = character string
; Your registration number
registrationnumber abcde12345

This type is simply interpreted as a literal string value.

2.2.2 short integer value

; usmanagerport -- type = unsigned short integer value
; The tcp port used by the manager
usmanagerport 777

This type specifies a unsigned short (16bit) integer value.

2.2.3 boolean value

; logp_log -- type = boolean value (0 is false, 1 is true)
; General POP3 logging
logp_log 0

This type specifies a true/false condition. 0 is false and
1 is true.

2.2.4 unsigned long integer value

; maxpop3conn -- type = unsigned long integer value
; Maximum simultaneous POP3 connections
maxpop3conn 50

This type specifies a unsigned long (32bit) integer value.

2.2.5

; maxhops -- type = integer value
; Maximum number of received headers in a message before bouncing
maxhops 50

This type specifies a long (32bit) integer value.

3. Manager

The manager program is a pure Java application. Java version 1.1.8
is the recommended minimum level. To start the manager program, simply
run the "mgr.cmd" command file. It will add the necessary jar files
to the current classpath to start the program. Once started, you will
be presented with a login page. On this page, specify your server
hostname, the port to connect to, and the password to use. This will
connect you to the Perseus manager. All changes made through the 
manager program are dynamic with the exception of the port the Perseus
manager listens on.

4. New Features

4.1 Filters

Filters allow you to write an external program which is called by
Perseus during the mail processing cycle. Filters can be used to
implement virus scanning, uce rejection, message redirection and
many other things. A basic filter framework is supplied. Please
note filters must be compiled using Visual Age C++ Version 3.

Filter samples are available at:

  ftp://ftp.hethmon.com/pub/perseus/perseus-filter.zip
  http://www.hethmon.com/pub/perseus/perseus-filter.zip

Filters are currently only supported in C++. A REXX and Java
based filter will be supplied in the future.

4.2 SMTP after POP3

Also included is support for SMTP after POP3. This allows users
who normally would not be allowed to relay mail to do so for a specified
time period after they make a valid POP3 login.

4.3 Multiple Rejection Service Support

Any number of rejection services are now supported. You can now use
MAPS, ORDB, and any other number of services at the same time. Hostnames
for the various services must be specified in the "rbl.txt" file. Hostnames,
ip numbers, and ip ranges which should always be allowed must be placed
in the "rblok.txt" file.

4.4 Multi-level aliases

You may now have multi-level aliases with Inet.Mail Perseus. Perseus
will resolve all forward and cc addresses for local users. This resolving
will continue until the first loop is detected. Once a loop is detected,
processing is stopped and an error message is returned to the sender and
to the local postmaster account.

4.5 New IP Range Notation

When specifying blocks of ip addresses for relay lists, spam lists, or
anywhere else wildcards were used in V1, you may now use slash notation.
For example, to specify the complete block of 192.168.1.0, use
192.168.1.0/24. You may still use wildcard notation of 192.168.1.*, but
the slash notation allows blocks smaller than a full octet.

5. 16 bit TCP/IP Support

Executables supporting the 16 bit OS/2 tcp/ip stack are included.
Please select the 16bit option during installation.

6. System Requirements

OS/2:

OS/2 Warp 4 or later
Long filename support
16 or 32 bit tcp/ip stack
Java 1.1.8 or later
128 megabytes memory minimum recommended
Pentium II 233 mhz minimum recommended
256 color display required for Java manager
Approximately 5 megabytes disk space for program files

Windows:

Windows 2000 or later (Workstation or Server)
Long filename support
Java 1.1.8 or later
256 megabytes memory minimum recommended
Pentium 3 processor or better
256 color display required for Java manager
Approximately 5 megabytes disk space for program files

7. Feedback

Please direct all feedback on the program to the Inet.Mail mailing
list <inetmail@hethmon.com> or to Support <support@hethmon.com>.

8. Install Problems

One possible problem for upgrades is the install program not finding
the previous Inet.Mail installation directory. If this happens, please
run the hd.cmd file included. It simply queries the os2.ini file for the
location. This seems to clear up the problem with the WarpIN install.

This problem may also appear if you have never installed Inet.Mail. Please
try to run hd.cmd first if there are any REXX problems reported by WarpIN.

9. Windows 2000 Support

Inet.Mail Perseus is supported on Windows 2000 running as a service. The
install program will set up Inet.Mail as an automatic start service.
Running as a service, no interactive options are supported as in the
OS/2 version. Since Windows 2000 does not support REXX natively, you
must install a REXX interpreter separately to run the Steward mailing
list software. Regina REXX is recommended. It is available free of
charge from http://sourceforge.net/projects/regina-rexx/. Also needed 
is the RegUtil library package available from Patrick TJ McPhee at
http://www.interlog.com/~ptjm.

For your convenience, both packages are mirrored at Hethmon.com:

  ftp://ftp.hethmon.com/pub/tools/regina301.exe   (Regina REXX)
  ftp://ftp.hethmon.com/pub/tools/reginahtml.zip  (Regina HTML Help)
  ftp://ftp.hethmon.com/pub/tools/regutil1110.zip (RegUtil Library)

You must edit the perseus.cf file and give a valid hostname for your
machine. This name must resolve to the machine's IP address. Inet.Mail
will not start unless you have this entered. All other defaults in the
perseus.cf file are ok.

--------------------------------------------------------------------------

* Java is a trademark of Sun Microsystems
* OS/2 is a trademark of International Business Machines Corporation
* Windows is a trademark of Microsoft
* Windows 2000 is a trademark of Microsoft
Inet.Mail is a trademark of Hethmon Software
Inet.Mail Perseus is a trademark of Hethmon Software
