fauSMTP
An OSA/OCE Compliant POP3 / SMTP server system that acts as a translator accepting SMTP from any standard email client and translates it to OSA/USDS and sends it to the OCE. This allows any email client to immediately become an OCE client capable of sending messages into the OSA network.
./fauSMTP.pl -h will give you help
Table of contents
Control Commands
- stop
- Stop the serve
- start
- Start the server
- restart
- Stop server (if it was running) and then start it
Configuration Switches and Arguments
Switch | Param | Default | Description |
-r | username | None | Register this application with Fautore OSA/OCE |
-smtpport | Port Num | 20001 | Set a new port number to use for SMTP |
-pop3port | Port Num | 20002 | Set a new port number to use for POP3 |
-jsonport | Port Num | 1895 | Set a new port number to use for OCE communications |
-usefromsmtp | 0|1 | 0 | Switch outgoing SMTP mail to use the from address SMTP server (its realm) rather than using that of the to address. Value may be any of 0 1 on off. |
-dedicatedsmtp | Connect String | None | Switch outgoing SMTP mail to use a dedicated SMTP server as defined within the values. The values are a comma delimited string of hostname,port,username,password. Example: ./fauSMTP.pl -dedicatedsmtp myhost.com,26,mruser,somepass\n". |
-settings | None | None | Display control/configuration settings. |
-client | None | None | Display pop3 and smtp setting information to aid in configuring an email client. Example would be to aid setting up say 'Thunderbird' email client. |
-pullinfo | None | None | Retrieve and Display OSA data synchronisation status.\n". |
-clearqueue | None | None | Clear the outgoing unsent mail queue (all mail will be lost). |
Rules for SMTP
Either the from address or at least one of the too address(s) must be of one formats described below.
Mail routing rules for OSA/OCE SMTP
In ALL cases the FROM address or TO address must be known as a client of this server, ELSE mail shall be rejected.
External (using domain name based address's)
- smith@somedomain.com to clark at somedomain.com:Normal internet based SMTP shall be used
- smith@somedomain.com to bob@oce
- Mail to is local and shall be placed into inbox bob, additionally shall be inserted using qMsg - 'DestKey'=local tribe key | 'DestMember'='bob' | 'DestCoterie'=
- smith@somedomain.com to oce@oce
- Mail to is local and shall be inserted using qMsg - 'DestKey'=local tribe key | 'DestMember'= | 'DestCoterie'=''
- bob@oce to smith at somedomain.com:Normal internet based SMTP shall be used
Local
- fred@oce to bob@oce
- Mail to is local and shall be placed into inbox bob, additionally shall be inserted using qMsg - 'DestKey'=local tribe key | 'DestMember'='bob' | 'DestCoterie'=
- fred@oce to oce@oce
- Mail to is local and shall be inserted using qMsg - 'DestKey'=local tribe key | 'DestMember'= | 'DestCoterie'=''
Remote (example remote tribe known as 'remtribe')
- fred@oce to alice at remtribe.oce:Mail to is remote and shall be inserted using qMsg - 'DestKey'=remote tribe key | 'DestMember'='alice' | 'DestCoterie'=
- fred@oce to oce at remtribe.oceMail to is remote and shall be inserted using qMsg - 'DestKey'=remote tribe key | 'DestMember'= | 'DestCoterie'=''
Installation
Install is handled via a simple command in a system terminal. The fauSMTP.pl command is generally going to be located at: {Fautore Home}/apps/fauSMTP.
fauSMTP.pl -r {OCE Member} {OCE Member Pass}
Where:
- {Fautore Home}
- The full path to the top level directory of the directory structure into which Fautore is installed.
- {OCE Member}
- A member of the OCE with "Chief" privilege on which the application is being registered.
- {OCE Member Pass}
- The OCE password for the {OCE Member} account used on the command line.
Example: fauSMTP.pl -r TribeDude SquattingBear_is_my_password