Mailborder Child Server Installation Guide
![]() |
Requirement Check |
Master Server
A Mailborder Master server must exist before installing the Child server.![]() |
Hardware |
Minimum Recommended Hardware (Child)
- 2+ CPU cores
- 512+ MB RAM
- 40+ GB HDD
![]() |
Install a supported Linux server |
Supported Operating Systems
- CentOS 6
- Debian 7
- Red Hat Enterprise Linux 6
- Ubuntu 12.04 LTS Server
- Ubuntu 14.04 LTS Server (64 bit only)
Build a server using a supported platform. The Gnome and KDE GUIs should not be installed. Additional packages should not be installed as the Mailborder installer will install all required packages.** The newly built server will require Internet connectivity to download the required packages. Mailborder supports both physical and virtual servers and has been tested extensively on VMware vShere (ESXi) v5 and v5.1.
** It is recommended that you do install the SSH server service.
If you are unsure which OS to use, Ubuntu 12.04 LTS is the most tested and stable platform for Mailborder.
![]() |
RHEL6 Requirement |
Important
If your server is running RHEL6 it must be subscribed on RHN (or satellite) to the following channels:Base Channel: Red Hat Enterprise Linux Server
- Red Hat Common
- RHEL Server Optional
![]() |
Register the Child Server |
Master Server Tasks
- Log into the Mailborder Master server for the cluster.
- Navigate to: Left Menu > Mailborder Servers
- Click Add Server
- Enter the FQDN and the IP address of the Child server.
- Select Child as the server type.
- Select the operating system.
- Click Add Server
- Ensure that the Add Firewall Rule and Configuration Rebuild tasks have completed on the Master server before continuing.
![]() |
Record Installation Data |
- The Master server's IPv4 or IPv6 address.
- The Child Server GUID assigned by the Master server.
- The Child Server DB User assigned by the Master server.
- The Child Server DB Password assigned by the Master server.
To obtain the GUID, DB User, and DB Password, navigate to the following location on the Master server:
- Left Menu > Mailborder Servers
- (Child Server Name) > DB User > View
![]() |
Important Notes |
- Ensure that your hostname is set correctly in /etc/hostname or /etc/sysconfig/network prior to installing Mailborder. FQDN's should be used as hostnames. Example: this.host.com. Some providers such as Rackspace use short hostnames. Be sure to change it and reboot before installing Mailborder.
- It is possible to change the IP address of the Mailborder server at a later date. Therefore, you can install the Mailborder server in a lab environment and move it when ready for production.
- If the server is using openvz with a VENET adaptor, it may not have a MAC address. In this case add a second adaptor using VETH. Make sure that the default route remains on the VENET adaptor. The secondary VETH adaptor does not need to be used. It just needs to exist.
![]() |
Record the MAC address |
- From the command line of the server, obtain the MAC address by executing ifconfig command.
# ifconfig
- Copy the MAC address (case sensitive).
eth0 Link encap:Ethernet HWaddr 00:0C:29:2D:9F:7D inet addr:192.168.1.80 Bcast:192.168.1.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:8917591 errors:0 dropped:0 overruns:0 frame:0 TX packets:23359 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:639287110 (609.6 MiB) TX bytes:3131708 (2.9 MiB)
![]() |
Obtain a License Key |
|
![]() |
![]() |
Download the Install Script |
- Install wget and unzip via yum or apt-get if it is not already installed.
# apt-get install wget unzip or yum install wget unzip
- Download the installer using the appropriate wget command below directly from the new Mailborder server:
CentOS 6
# wget https://s3.amazonaws.com/mailborder/releases/stable/4.1.0/noarch/installCOS6c.sh.zip
Debian 7
# wget https://s3.amazonaws.com/mailborder/releases/stable/4.1.0/noarch/installDeb7c.sh.zip
RHEL 6
# wget https://s3.amazonaws.com/mailborder/releases/stable/4.1.0/noarch/installRHEL6c.sh.zip
Ubuntu 12.04 LTS
# wget https://s3.amazonaws.com/mailborder/releases/stable/4.1.0/noarch/installU12c.sh.zip
Ubuntu 14.04 LTS
# wget https://s3.amazonaws.com/mailborder/releases/stable/4.1.0/noarch/installU14c.sh.zip
![]() |
Install the Mailborder Child |
- Copy the install script to a directory to start the installation from. (e.g. /root) The installer must be run as the root user. As root, unzip the installer and run it. Below is an example using the Ubuntu installer. Change the file names to fit your Linux distribution installer.
# unzip installU14c.sh.zip
# sh installU14c.sh
- If asked about saving firewall rules, simply accept the defaults by pressing enter.
- Once the install completes, download your license file and copy it to /mailborder/license.php on the Child server. You may either copy and paste the contents using the vim editor (or similar) or rename the file and upload it using an SFTP client.
![]() |
Reboot and Validate |
- Reboot the server after the installation process completes.
- Once the Child server checks in with the Master server, it will build configuration file by the task assigned by the Master server. Tasks can be monitored in the Master server's Task Log.
- The Child server will report in once per hour by default. You can view the Child server's status on the Mailborder Servers page in the Master server GUI.
![]() |
Post Reboot and GUI Install Notes |
- If the Child server is not able to contact the Master server, ensure that a valid path exists between the servers. Communication over port 3306 TCP is required.
- For troubleshooting you can view the error logs on each server here: /mailborder/logs