Firetrust
MailWasher Enterprise Server

LINUX INSTALLATION INSTRUCTIONS

Contents

Quick Overview

MailWasher Enterprise Server (MWES) works as a proxy, meaning it sits in front of your mail server collecting and processing all incoming mail. You will notice a significant reduction spam along with reduced load on your mail server when MWES is installed and working.

The following diagram illustrates how MWES operates.

Download

Download MailWasher Enterprise Server (MWES) for Linux. MWES may be used with any mail server such as Sendmail, Postfix, QMail, Exim etc.


Installation

1. cd mwes-xxxx

2. Run script ./install as "root"

3. By default a 30 day trial period is setup on installation.

On completing the installation, a browser window will launch taking you to the Setup Wizard at http://[company.site]:4044

You will be taken through a 4 step setup wizard as shown.


First you are asked to change your administrator password. This account will allow you to control the administration privileges. Do not give this out to users


Next, enter all the domains you want to filter email through.




Finally, you are shown the thank you screen. Press Finish to begin the System Check.


Upon completing the wizard you will be taken to the System Check screen to ensure you have setup your system correctly to work with MWES.

Press the Start system check button and MWES will run through its connectivity tests.




If there is a problem, MWES will notify you and suggest a fix. See points (5) and (6) below regarding ports or contact us at support.




If your setup is correct, MWES will notify you it has 'Passed' all tests.


5. Access Ports

Please make sure you have not firewalled these ports

4044 - Web interface
25 - Smtp
4051 - First Alert

6. Final step

Proxy Setup

Change the following in the /etc/mwes.conf file to suit your environment.

Example if both mwes(proxy) and your MTA(relay) are on the same machine.

1. Change your MTA (relay) smtp port to 26 and restart.

2. Change mwes(proxy) /etc/mwes.conf use_mta_proxy=1

then restart mwes

Example:

# MTA Proxy information

use_mta_proxy=1 (1 to enable 0 to disable)
proxy_port=25 (Don't change this)
proxy_hostname=

# MTA Relay information

mta_hostname=localhost (localhost or enter local IP)
mta_port=26 (MTA e.g. Sendmail "Daemon Option Port=26" in /etc/mail/sendmail.cf)

Upgrading

Note: Users upgrading from an earlier build to version 2.74 or later will need to make sure their existing config file entries correspond to changes in version 2.74 below

  • OLD NAME (Pre Version 2.74) -> NEW NAME (Version 2.74 onwards)
  • hostname -> web_hostname
  • port -> web_port
  • mta_hostname -> proxy_hostname
  • mta_port -> proxy_port
  • mta_relay_hostname -> mta_hostname
  • mta_relay_port -> mta_port

Proxy:

1. Download and Untar current release
2. Stop mwes service
3. cd mwes.xxx
4. Run ./install script it will automatically upgrade related files.
5. Start mwes

Note: No need to restart MTA

Uninstall

Users running 2.4.3 or older version should follow the uninstall instructions

Later versions can be uninstalled using "Uninstall" script.

1. cd mwes-xxxx
2. Run script ./uninstall as "root"

Start and Stop

/etc/init.d/mwesd [start/stop]

Kill -3 "mwes pid" shall be used to kill the process NOT "kill -9" and start mwes

TROUBLESHOOTING

If you find a problem, please contact us at nick.bolton@firetrust.com

There's also the forum for any questions and Frequently Asked Questions.



Q. Inbound email is not being filtered.

A. Please see the FAQ at I've installed MWES but it does not filter inbound email.



MISCELLANEOUS

Linux users can add/change many options in the mwes.conf file

See Further Configuration Settings