Alinto Mail Server Pro Installation Guide Alinto Version 2.0.1
Index 1. Introduction....................................................................................... 1 2. Prerequisites...................................................................................... 1 2.1. Machine requirements......................................................................... 1 2.2. Hard disk...................................................................................... 1 2.3. Operating System............................................................................. 1 3. Installation procedure............................................................................. 1 3.1. Download or copy the installation archive..................................................... 1 3.2. Copy the licence file.......................................................................... 2 3.3. Run the installer............................................................................... 2 4. Additional information............................................................................. 4 4.1. Network....................................................................................... 4 4.2. Network flux matrix........................................................................... 4 5. DNS entries....................................................................................... 5 6. Support........................................................................................... 5
1. Introduction Alinto Mail Server Pro is an all-in-one messaging and collaboration server. This documentation will guide you to install this product on a server. At the end of this installation, you will get an e-mail and collaborative server with web administration, a webmail and a webmail mobile interface, synchronization tools (DAV, CalDAV, CardDAV, Active- Sync) and management APIs. 2. Prerequisites Alinto Mail Server Pro runs under Linux CentOS distribution and runs perfectly in any virtualization environement like VMWare, VirtualBox, KVM, Xen, Microsoft Azure 2.1. Machine requirements Users CPU RAM Up to 20 users 1 core 4GB (2GB minimum) Up to 50 users 2 cores 4GB Up to 200 users 4 cores 8GB Up to 1000 users 8 cores 8GB More than 1000 users Multi-server install. Contact us. Multi-server install. Contact us. 2.2. Hard disk The root partition must be at least 20GB to launch the installation. A data partition must be added according to your usage. Below 50 users, start with 50GB. The virtual hard disk capacity can still be increased afterwards using your virtualization software. 2.3. Operating System Install your server or virtual machine with 64 bits Linux CentOS 6.x. Please note that CentOS 7.x is not supported by this version You can download the "minimal" ISO here : http://isoredirect.centos.org/centos/6/isos/x86_64/ 3. Installation procedure The setup program is a CLI (Command Line Interface) program. Once your server is up and running, please connect with SSH. 3.1. Download or copy the installation archive Two methods are available : Installation Guide v2.0.1, 2015-11-25 Page 1 5
3.1.1. Using a single command line Copy and paste this command line into your SSH console: curl https://licence.alinto.net/download/amsp/alinto-amsp-install.tar.gz tar zx 3.1.2. Download and copy manually Download the installation software here: https://licence.alinto.net/download/amsp/alinto-amspinstall.tar.gz Copy it with "scp" or "winscp" onto your server Then, in your SSH console, uncompress the archive with this command: tar zxf alinto-amsp-install.tar.gz 3.2. Copy the licence file You have received a unique licence file attached to your registration e-mail. Copy this file onto the server using "scp" or "winscp" program. If you don t have your licence file, go to : http://licence.alinto.net/licence/ 3.2.1. Installation without copying the licence file If you have encountered problems copying the licence file, you can ignore the "--licence=" parameter. You will be prompted to copy/paste the licence during the installation. 3.3. Run the installer Before running the installer make sure your server hostname is reachable! You can test it with the host command: host <your_hostname> In your SSH console, run the installation program like this:./alinto-wizard.pyz --all-in-one --licence=<licence_file> You must specify "--all-in-one" to install all services on this server. Please note that the multi-server install is not available with your evaluation licence. You must specify "--licence=<licence_file>". If you ve copied the licence file into the same folder, you can specify "--licence=licence.txt" like this: Installation Guide v2.0.1, 2015-11-25 Page 2 5
./alinto-wizard.pyz --all-in-one --licence=licence.txt 3.3.1. Follow the installer instructions The installer need some information at the beginning of the installation. Just follow the instructions like this: ############################################## # Alinto AMSP Installation # ############################################## Service(s) to be installed : [X] Alinto Imap Backend (local) [X] Alinto Mongo (local) [X] Alinto Database (local) [X] Alinto Webapps (local) [X] Alinto Smtp (local) [X] Alinto Directory (local) Service(s) which will not be installed : [ ] Alinto Imap Proxy Enter your company name: MyCompany Enter Database root password: MySQLRootDbPassword Enter password for Alinto AMSP database user (should be different from root): MySQLUserDbPassword Enter your email domain name (ex: test.fr): mycompany.com Enter domain administrator password: MyAdminPassword Enter passphrase (used to encrypt and decrypt critical informations): MyPassphraseToEncryptCriticalInformations [===========>**************************************] 33% The installation program will now download and configure your server. It usually lasts between 15 minutes and one hour (mainly depending on your network speed). Once finished, it shows you access information like this: Installation completed! You can now start to discover Alinto Mail Server Pro: Administration: https://<server_ip_address>/factory Webmail: https://<server_ip_address>/wmm Credentials: Login: admin@mycompany.com Password: MyAdminPassword Installation Guide v2.0.1, 2015-11-25 Page 3 5
3.3.2. Test your installation Open your browser and go to https://<server_ip_address>/factory Enter your login and password and enjoy! 4. Additional information 4.1. Network All the messaging services are installed with Alinto Mail Server Pro on the Virtual Machine. All the services you will need are reachable through the IP of the VM, depending on which port you are using: SMTP (port 25 and 587) IMAP (port 143) IMAPs (port 993) POP (port 110) POPs (port 995) HTTP (port 80) HTTPs (port 443) You will have to open these ports on your firewall. It is your responsibility to configure your network so that the Virtual Machine is accessible from a public IP, live or NAT. Please ensure that these ports are not reachable outside your own network: mysql (port 3306) mongodb (port 27017) Default firewall rules CentOS has default firewall rules. You can remove them with : iptables --flush iptables-save 4.2. Network flux matrix Internet Firewall Alinto Mail Server Pro any incoming SMTP (25, 587) Public IP any incoming SMTPs (465) Public IP any incoming POP (110) Public IP any incoming POPs (995) Public IP Installation Guide v2.0.1, 2015-11-25 Page 4 5
Internet Firewall Alinto Mail Server Pro any incoming IMAP (143) Public IP any Incoming IMAPs (993) Public IP any incoming HTTP (80) Public IP any incoming HTTPs (443) Public IP any incoming LDAP (389) Public IP any output SMTP (25,587) Public IP any output SMTPs (465) Public IP any output HTTP (80) Public IP any output HTTPs (443) Public IP your network input SSH (22) Private IP (prefered) or Public IP your network output SSH (22) Private IP (prefered) or Public IP 5. DNS entries Here is an example of proper DNS entries for the e-mail platform: mail.amsp.alinto.net. IN A 31.172.161.12 amsp.alinto.net. IN MX 10 mail.amsp pop.amsp.alinto.net. IN CNAME mail.amsp.alinto.net. imap.amsp.alinto.net. IN CNAME mail.amsp.alinto.net. smtp.amsp.alinto.net. IN CNAME mail.amsp.alinto.net. 6. Support In case of trouble, you can contact our support service: E-MAIL supportpro@alinto.net PHONE +33 (0)478 38 73 60 Installation Guide v2.0.1, 2015-11-25 Page 5 5