MailCleaner Support

!!!!!! Actually MailCleaner is NOT available anymore on AWS ( 2023/06/15 )¶

French version below / version française ci dessous: https://support.mailcleaner.net/boards/3/topics/41-mailcleaner-on-aws-french-version

ENGLISH VERSION¶

Welcome to this knowledge base which describes how to configure your MailCleaner server(s) on AWS. Please note this is a enterprise version and you require to first ask for a trial version at sales@mailcleaner.net.

Here are the AMIs IDs by region:

Please let us know if your region is not available, and we will add it.

The first thing to do is to create a MailCleaner instance from our Community AMI. Here are the steps to follow :

BE CAREFUL to use a FIXED PUBLIC IP: https://pragmaticintegrator.wordpress.com/2012/12/13/assign-a-fixed-ip-to-aws-ec2-instance/

1. Choose AMI : From your EC2 interface, create a new instance and search for"MailCleaner" in "Community AMIs" (see screenshot : step1.png). AMI-id has to be ami-51ad7d31
2. Choose Instance Type: Make sure that your instance type meets the minimum requirements (2 CPU, 4 GB RAM, 60 GB SATA III - 7200 rpm hard drive, 100 Mbps network, 2 Mbps network connectivity) by example m3.medium
3. Configure Instance Details: if you are building a cluster, you can set the Number of instances to your number of hosts including the master.
4. Add Storage: Make sure to respect the minimum requirements. Choose an EBS volume type with 80 GB (see screenshot : step4.png)
5. Tag Instance: this is all up to you
6. Configure Security Group: be sure to create all firewall rules you require (see screnshots : step6-inbound and step6-outbound)
7. Review: You can Launch your instance(s)

Once this is done, connect (with https) to only one of your MailCleaner's instances with those credentials :

• https://aws_public_ip/admin/
• User: admin
• Password: MCPassw0rd

WARNING If you are redirected to https://mailcleaner/admin/, re-enter https://aws_public_ip/admin/ and go to Configuration > Services > Web interfaces > and change the Base URL with your public AWS Ip.

Go to Configuration > Base system > Registration menu then enter your license (that you should have get from our sales department).

Cluster configuration :
For connecting to your MailCleaner through SSH, the best is to use the SSH key provided when creating the instance.
You can also use, for now, the username root and password MCPassw0rd.

Create a security group for connections between the MailClelaner nodes. You have to create a security group and attach it to each MailCleaner instances of your cluster (see the attachment: firewall rules for cluster.png)

All your servers must have a different HOSTID. By default HOSTID is set to 1. So you can let one server with this ID. Let s say this will be your master node.
Connect to all other servers with SSH to give to each of those a different HOSTID

1. Launch ifconfig and note the private IP.
2. Launch cat /etc/mailcleaner.conf and save the result to a text file.
3. Launch /usr/mailcleaner/scripts/configuration/slaves.pl and then choose 1) change host settings (required!) then insert the private IP
4. You then come back to the script menu. Choose 3) delete slave then insert 1 as slave id and hit enter.
5. You then come back to the script menu. Choose 4) add slave then insert the Slave Id of the current server. Insert hostname, private IP and the password corresponding to the field MYMAILCLEANERPWD from the second step.
6. Exit the script by pressing q and wait.
7. Then, edit the file /etc/mailcleaner.conf to modify the "HOSTID =" line with the HOSTID given to the current server. Also change the line "ISMASTER =" to "ISMASTER = N"

Once this is done for each slave servers, you ll need to register all of your servers. Connect to https://aws_public_ip/admin/ go to Configuration > Base system > Registration. All your different instances will use the same licence but will upgrade to the latest MailCleaner version only if they all have a different HOSTID

Once all instances are up to date, you can go on with the classical HOWTO to configure a cluster at chapter 5 Cluster configuration: http://www.mailcleaner.net/downloads/MailCleaner-installation.pdf

Once the cluster is correctly set up, change Configuration > Base system > DNS settings > Force HELO / EHLO identity with to your own domain name.