Mailborder Child Server Installation Guide

Mailborder v4.1.9


checked checkbox black  Requirement Check

Master Server

A Mailborder Master server must exist before installing the Child server.
circuit black  Hardware

Minimum Recommended Hardware (Child)

  • 2+ CPU cores
  • 512+ MB RAM
  • 40+ GB HDD 
monitor black  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.
redhat black  RHEL6 Requirement


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
folder internet black  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.
edit property black  Record Installation Data 
You will need to have the following information available before starting the install process.

  • 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
bulletlist black  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: 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.
nic black 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: Bcast: Mask:
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)

  In the above example, the MAC address is 00:0C:29:2D:9F:7D. It does not matter if the server has multiple NICs and MACs. Only one is required to be present on the server for the license to function.

key black  Obtain a License Key
  • Create a user account on the Mailborder website if you do not already have an account.

  • Log into the Mailborder website.

  • Navigate to the Store section of the site. (Link on the Main menu.)

  • Select your Child product and enter the MAC address recorded in the previous step.

  • A key will be generated and available under the website left menu as illustrated in the picture. Licenses are generated immediately.

  • Download and save the license file. 
dl black 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

Debian 7
# wget

# wget

Ubuntu 12.04 LTS
# wget

Ubuntu 14.04 LTS
# wget

console black 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
# 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.
window black 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.
checked checkbox black 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 

Mailborder Privacy and Terms

User information submitted on this site is strictly guarded and not shared with third parties. While transaction information from sales is recorded, credit card information is not stored on Mailborder servers. For a complete overview review Website Terms and Conditions of Use.