Notes

MailCleaner 2018

Account for web interface access: admin
Account for shell access: root
All passwords: MCPassw0rd

If you are using Windows to administer VM, please use your Hypervisor shell
access or Putty when you'll need to use SSH.


*** INTRO ***

Dear MailCleaner users,
You'll find in this archive an OVA file. It should be enough to install but
we'll try to provide information about each thing to check.

If you are not completely sure about what you do here or never did it before,
you should read all this documentation before starting manipulating. You could
learn some useful things.


*** Your preferred hypervisor ! ***

VA = "Virtual Appliance"

1) Create a VM by importing the provided OVA file (this step depend of your
product (please read the corresponding manual)
1.1) If asked about the operating system, answer Linux Debian 8 (Jessie)
64-bits or other Linux 64-bits
1.2) The machine should be 64 bits as 32 bits is not supported anymore
2) We advise to set at least two cores and 4Go RAM
3) Set your network if needed as usual
4) If you are using VMWare, go to the next paragraph
5) Start the virtual machine

NOTE: If you do not start the VA in a DHCP environment, it will take about a
minute to boot, as the MailCleaner will look for network to update itself,
and will timeout after 45 seconds without network.


*** VMWare ***

Please ensure you have read the previous paragraph before the operations
cited below.

1) Once imported, you should upgrade the VM hardware version to match your
version of ESXi / Workstation / Fusion:
- Power off the VM
- Right click on the VM
- Search the "Upgrade Virtual Hardware" or "Upgrade VM Compatibility"
2) Power on the VM and install VMWare Tools by executing the following command:

apt-get update && apt-get install open-vm-tools


*** NETWORK PART ***

Once the installation of the Virtual Machine is finished, you can connect your
favorite browser to the MailCleaner wizard configurator:

https://yourhost:4242

Where yourhost refers to either the hostname or the IP address.

MailCleaner is configured by default for DHCP, so if you have DHCP enabled on
your network, it will get an address. You could check your equipment to see
what address it got (or set a specific MAC in your VM preference). If you do
not have DHCP on your network MailCleaner will be accessible on his
configurator interface 192.168.1.42 Note: Please disable this interface after
installation ! => "Configuration -> Base system -> Network settings"

So your VM / VA launched correctly and you want to access it, so let's try some
things:

https://YOUR-VM-IP/admin/

Don't forget the final '/' and retype two times the address if needed as our
Base Url redirection can be tricky until it has been set correctly.

Reminder: Default account is "admin" using password: MCPassw0rd
This is the default password for absolutely all so you'll change it by using
the "configurator" Here: "Configuration -> Base system -> Wizard"

Of course, once you get a web Access, you'll probably want to set manual IP
here: "Configuration -> Base system -> Network settings"


*** SHELL ***

You could get a shell on your VM using different methods:

If you have DHCP on your network, find your IP or scan range for port 25 open !
then:
ssh root@YOUR-VA-IP

OR

Open a terminal on the VM using your Hypervisor

Of course after you got a shell access, you'll be welcome by a small wizard
allowing at least to change root pass and set networking configuration to
static IP (as well as Keyboard layout). You can access this wizard again by
executing:

/usr/mailcleaner/scripts/installer/installer.pl

Don't hesitate to give your feedback on our forum at: http://forum.mailcleaner.org/

Thank you !
The MailCleaner Team