A Mailborder Master server must exist before installing the Child server.
Minimum Recommended Hardware (Child)
2+ CPU cores
512+ MB RAM
40+ GB HDD
Install a supported Linux server
Supported Operating Systems
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.
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
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
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.
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
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.