Migrating Master Data from v4 to v5

A portion of the Mailborder v4 data can be migrated to a v5 server platform. This is done with the mb-migrate executable on the Mailborder v5 Master server. This process can migrate the following data:

  • Domains
  • White lists
  • Black lists
  • Email forwards
  • Portal Users, their Aliases, their personal white/black filters

No other data can be migrated due to the structure of Mailborder v5 being completely different from Mailborder v4. You will still need to create, modify, or assign new Process, File, MIME, and Geoblock policies. Although the program will migrate your white and black lists, those policies will still need to be assigned in the Mailborder v5 server. 


Database Access
On the Mailborder v4 server, you will need to create a new database user for the migration. You will need the database root user password. If you need to reset your database root password, see this article for instructions. From the command line:

mysql -u root -p


Once in the mysql client on the v4 server:

use mailborder;
CREATE USER 'newuser'@'%' IDENTIFIED BY 'your_password_here';
GRANT SELECT ON mailborder.* TO 'newuser'@'%';

*Make sure to change "newuser" and "your_password_here" to your own values. 


Firewall Access
Mailborder v4 servers have firewalls in place by default. You will need to stop the firewall or add a rule to allow the Mailborder v5 server to access the Mailborder v4 server on TCP port 3306. In the below example, the command is executed on the Mailborder v4 server and the Mailborder v5 server IP address is

sudo iptables -A INPUT -p tcp -s --dport 3306 -m conntrack --ctstate NEW,ESTABLISHED -j ACCEPT


Migrating Data
Once you have a completed the previous steps, you are ready to migrate your settings from v4 to v5. From the command line on the Mailborder v5 server:

sudo mb-migrate -m

Once the migration is complete, you can view, organize, and assign your migrated data in the Mailborder v5 interface. 


If you have a Mailborder v4 server and were issued a Mailborder v5 license code as a free upgrade, you may continue to run both servers as long as required. Once you are confident, you can retire the Mailborder v4 server at your leisure. 


Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk