--========================================================================-- EzMTS - Mail Transport System Implementation Copyright (C) 2000 Craig Morrison, All Rights Reserved --========================================================================-- -==================================- -= Win32 Binary ONLY Distribution =- -==================================- Preface: READ THIS ENTIRE TEXT, please.. :-) NOTES: For the purpose of this text, 'C:\EzMTS' is the assumed path. Substitute your installation path for this path in all the steps below. At the end of this text are examples of all the various configuration files. [enter] means to press the 'enter' key on your keyboard. Installation -============- 1. Run INSTALL from the directory you placed EzMTS into. This will create the entries in EzMTS.INI that you need to get EzMTS up and running. 2. To start each of the parts of EzMTS from a command prompt type: START MTSSmtp -console C:\EzMTS\EzMTS.INI [enter] START MTSAgent -console C:\EzMTS\EzMTS.INI [enter] START MTSPop3 -console C:\EzMTS\EzMTS.INI [enter] HINT: Create a batch file to do this for you. 3. Send yourself an email via EzMTS. Advanced Configuration -======================- -= Mailing Lists =- Preface: You have ListServer automated processing with EzMTS, your ListServer will be LISTSERV@yourdomain.com. IE; if your domain is 'you.com' your ListServer address is: LISTSERV@you.com 1. In EzMTS.INI : [Agent] MailingList=EzMTS.Lists 2. In EzMTS.Lists : [MailingList] mylist=MyList.INI 'mylist' is the name of the list, so mail would be sent to mylist@yourdomain.com. 'MyList.INI' is the configuration file for the mailing list. 3. In MyList.INI : [Options] Tag=C:\EzMTS\MyList.tag Restricted=0 [Users] Count=1 User0= [Options]Tag Filename for the text to be added to each outgoing list message. [Options]Restricted 0=Public Subscription, 1=Invitation Only [Users]Count Number of list members [Users]User =Count - 1, the value is the email address of the list member enclosed in <>. <> is REQUIRED. 4. Add yourself to the list in step 3. Then (making sure EzMTS is up and running) send an email to your ListServer with the following command in the body of the email: HELP The reply from ListServer will give you a list of valid commands and their syntax. -= Aliases =- 1. In EzMTS.INI : [Agent] Alias=EzMTS.Alias 2. In EzMTS.Alias : [Alias] listmaster=postmaster This couldn't be much more simple than it is. In the above; 'listmaster' is an alias for 'postmaster'. What this means is that all mail addressed to 'listmaster' will up end up in the mailbox for 'postmaster'. --========================================================================-- EzMTS Example Configuration Files --========================================================================-- -==============- -= EzMTS.User =- -==============- ; ; EzMTS user file. ; ; Count= The number of users. ; ; User= = Count-1 ; = user name ; ; For each user there has to be a directory off of your MailPath (EzMTS.INI). ; E.G; postmaster - c:\EzMTS\postmaster ; [User] Count=1 ; Postmaster !MUST! be defined in your configuration ; Either here, or as an alias in EzMTS.Alias User0=Postmaster -===============- -= EzMTS.Lists =- -===============- ; ; List name=List initialization file ; ; Filenames are rooted off of MailPath in EzMTS.INI ; [MailingList] mylist=MyList.INI -===============- -= EzMTS.Alias =- -===============- ; ; EzMTS user Alias file ; ; Simple: = one per line ; [Alias] listmaster=postmaster -==============- -= EzMTS.Pass =- -==============- ; ; This is the password definition list for EzMTS ; ; Simply put, one entry per user, = ; [Passwords] Postmaster=dummy -=============- -= EzMTS.INI =- -=============- ; ; ; EzMTS Configuration File ; ; Each section describes a certain functionality for EzMTS ; Just follow the comments. ; ; The [All] section describes items that are for general use ; among all three portions of the MTS. [All] ; Domain are the domain(s) that you are hosting mail for. ; Currently Domain0 is the only domain being used. Domain0=domain.com ; MailPath is the root path of your mail directory. All the ; other files/directories referred to here are off this path. MailPath=E:\EzMTS\dist ; InboxName is the directory off the MailPath that holds ; all incoming mail. No path information, just a single ; directory name. InboxName=INBOX ; Users is the name (no path!) of your user file for EzMTS. Users=EzMTS.User ; For every user listed in this file, there MUST be a ; directory for their mail to reside in. E.G; postmaster ; c:\EzMTS\postmaster ; ; ; The [Agent] section describes the items that are used by the ; SMTP Agent. [Agent] ; PrimaryDNS is the IP address of your primary domain name ; server. PrimaryDNS=192.168.1.3 ; SecondaryDNS is the IP address of your secondary domain name ; server. SecondaryDNS= ; Number of retries before MTSAgent sends a bounce message ; back to the original sender saying the mail is ; undeliverable. Retries=5 ; RetryInterval is the number of seconds to pause between ; services of the out-going message queue. A 0 value sets ; the Agent into single-shot mode, it does its thing then ; quits. RetryInterval=300 ; MailList is the name (no path!) of the file that lists ; the definitions of your mailing lists. MailingList=EzMTS.Lists ; Alias is the name (no path!) of your alias file for EzMTS. Alias=EzMTS.Alias ; Sends all output to specified file, instead of console. LogFile=Agent.Log ; ; ; The [SMTP] section lists those items of pertinence to the ; SMTP server. [SMTP] ; Port is what port the SMTP server will listen for incoming ; connections on. Port=25 ; Relay=1 to route foreign mail delivered to your system. ; Relay=0 to NOT route any foreign mail, only mail for your ; system or from users of your system is accepted. Relay=0 ; Archive is the file you would like *!ALL!* incoming mail ; stored in. EVERYTHING coming in via SMTP is stored here. ; This is useful for providers who must archive mail. Archive=SMTP.Archive ; Sends all output to specified file, instead of console. LogFile=SMTP.Log ; ; ; The [POP3] section lists those things that are associated ; with the POP3 server. [POP3] ; Passwords is the name (no path!) of the password file for ; the users you are hosting mail for. Passwords=EzMTS.Pass ; Port is the port that the POP3 server will listen for ; connections on. Port=110 ; Sends all output to specified file, instead of console. LogFile=POP.Log ; -==============- -= MyList.INI =- -==============- ; ; EzMTS Mailing List Initialization File ; ; [Options] ; ; Restricted=<0|1> When Restricted=1 you have to manually add ; users to the mailing list. ; When Restricted=0, you have opened the list ; up to public subscription. Anyone who sends ; the proper ListServ command will have access ; to the list. ; Restricted=0 ; ; Tag= is a text file containing the text ; you want added to each message for ; this mailing list. ; Tag=C:\yourpath\tagfile.txt [Users] ; ; Count= where is the number of users in the list ; Count=1 ; ; User= = 0 to Count-1 ; = Do I really have to tell you? ; <> are REQUIRED around the ; you@yourdomain.com. ; User0=