This page will explain the MailCleaner installation process. You will find here a “guide for the impatient” that will let you set up your MailCleaner in a few steps and minutes.

You can find a more complete description with additionnal options and possibilities here.

1. insert cd
2. choose Mailcleaner installation
3. let the Debian base System installation run
4. let system reboot
5. remove Mailcleaner cd
6. let system reboot
7. log in as root with password def
8. execute commande:

   > /root/mailcleaner_install.sh

use non-interactive

1. answer questions
2. let installer finish installation
3. optionally change default ip address (which is 192.168.1.101) with the command

   > /root/bin/ip_configurator

4. connect your favorite browser to the host with https at /admin (e.g. https://192.168.1.101/admin/) to configure your sytem (go there for docs)

1. insert MailCleaner intallation CD in your shutdowned system
2. power on your system
3. you will be prompted with the CD bootloader menu which present two choices (choose the first one):
   • MailCleaner installaton: this will cause the system to boot on the CD and begin MailCleaner installation. WARNING: any data currently on the hard drive(s) will be deleted !
   • Rescue system: this will cause the system to boot on the cd, detecting hardware as it will do for the installation, but will NOT delete hard drive(s), neither install anything. You may use this in order to get a shell to rescue your previous MailCleaner installation (or do anything else your imagination can tell you)
4. let the system boot. It will then do the following automatically:
   • boot Linux kernel
   • discover any useable hardware
   • format and partition your hard drive(s)
   • install Debian GNU/Linux base operating system
   • install MailCleaner packages
   • configure system
   • reboot
5. when finished (after reboot), remove the installation CD
6. reboot your system using the newly installed system on your hard drive(s)

At this point, the server contains a GNU Linux Debian 3.1 system with all the necessary packages for MailCleaner installation. The installation CD is no longer of use. The server is preconfigured with the IP address 192.168.1.101 and is accesssible via ssh (you can set up the network at this step, see Phase 3, “Network setup via the console”).

1. login the system, either on the console, or with a ssh session with these credentials:
   • username: root
   • password: def
2. type in this command (followed by a return):

    > /root/mailcleaner_install.sh

3. answer the questions:
   • Where to install mailcleaner binaries: Directory into which the Mailcleaner executable files are installed (/usr/mailcleaner is generally the best answer to this question).
   • Where to install mailcleaner spools: Directory into which the log files, spools, quarantines, and other temporary files are installed that are used by Mailcleaner. It is suggested to use a large partition. The /var partition that is created by the installation CD will suit the job quite nicely (/var/mailcleaner is generally the best answer to this question).
   • What is this host ID: The unique identifier of this server in the Mailcleaner installation. A Mailcleaner installation can contain a number of servers running in parallel. Each of these servers must have a unique ID. In the case of a Mailcleaner installation with only one server, use the value “1”.
   • What is this hostname: The DNS name of the server (without the domain). For the master server, this name will appear in the message release and information URLs in the virus and blocked message warnings, as well as in quarantine reports. It must therefore be resolvable by DNS. For slave servers, this name will appear in the headers added to filtered messages. It is important to NOT change the hostname of the system once Mailcleaner has been installed !
   • What is the default domain name: The server’s default DNS domain name. For the master server, this name will appear in the message release and information URLs in the virus and blocked message warnings, as well as in quarantine reports. It must therefore be resolvable by DNS. For slaves, this name will appear in the headers added to filtered messages
   • What is the web interface admin password: The administrative password. This password will be used for the administrative account “admin” in the web admin interface.
   • What is the technical and support mail address: The e-mail address for the customer’s technical support center (or perhaps the integrator’s technical support). This address appears as the sender’s address in warning messages for viruses and blocked messages, as well as for quarantine reports. This address must handle user replies for spam analysis (false negative/false positive).
   • Process with an interactive installation [y/N]: Should the installer prompt you when it compiles each component of the MailCleaner application? This can be useful when reinstalling MailCleaner or when certain components (mysql, exim, apache, etc.) have already been correctly compiled and installed. In the case of a new installation, or complete reinstallation, “n” is a good answer.
4. let the installer do its job. You can optionally monitor the process in another shell with this command:

   > tail -f /tmp/mailcleaner_install.log

5. now MailCleaner should be up and running. You can then set up the network now (see Phase 3) or start configuring your system to start fitering mails, see here.

1. setup network: If you would like to set up the network through the console

   > /root/bin/ip_configurator

2. setup keyboard layout: By default, the Mailcleaner automatic installation CD configures your server with a Swiss French (fr_CH-latin1) keyboard. The keyboard layout can be changed by using the following command:

   > loadkeys  /usr/share/keymaps/i386/TYPE/LOCALE.kmap.gz

   where TYPE is the keyboard type: [azerty|qwerty|qwertz|dvorak] and LOCALE is the language (locale) of the server: [fr|de|us|…]
   For example, the following command would be used for a French keyboard:

   > loadkeys  /usr/share/keymaps/i386/azerty/fr.kmap.gz 

   To make this change permanent:

   > cp /usr/share/keymaps/i386/TYPE/LOCALE.kmap.gz /etc/console/boottime.kmap.gz