This article describes how to change the distribution BlueMind works on. It can be used to update the distribution (Ubuntu 12.04 to Ubuntu 14.04 for instance).
This procedure is based on installing a target system to which the data is migrated. This new system will then replace the original one at the network level.
- install BlueMind on the target system in an identical version to the original system and configured with the same external-url. The Setup Wizard must have been run on the target server. E.g.:
- if the original system uses BlueMind 3.5.12-2, the target system must have BlueMind 3.5.12-2 installed
- if the original external-url is bluemind.domain.tld, the target system's BlueMind must be configured with the external-url bluemind.domain.tld
- install a valid subscription for this OS
- the target system's root user must be able to authenticate as root on the original server, ideally using key authentication.
- the rsync utility must be installed on both systems.
Data migration is done in three steps to minimize service downtime:
- hot synchronization of server data to the target server - this is a time-consuming operation but does not cause service interruption
- cold synchronization - quick operation but causes service interruption
- switching servers
Allows you to make an initial copy of data without interrupting the service:
- connect to the target server as root
stop services on the target servers:
synchronize BlueMind data using the rsync utility:
These operations can be interrupted and/or performed several times.
Note: The shorter the time between hot synchronization and cold synchronization, the faster cold synchronization will be.
Stop services on the servers (original and target):
In the target server, synchronize the data again:
In the target server, do a database dump for the original server data:
In the target server, copy the original server's files to the target server:
Import the database into the target server:
- Stop the original server
- Reconfigure the target server with the original server's IP address
- Restart the target server and connect to the network instead of the original server so that it can be reached instead of the original server
Connect to the BlueMind Administration console as email@example.com and:
- Go to the section Security > Firewall and immediately click "Save" to force the BlueMind firewall's rules regeneration
- Go to System Management > Mail Maintenance, click "Run" to regenerate the mail postfix routing tables
- Go to System Management > System Configuration and replace the old IP address in the "My Networks" field by the new address or the address range for which you want the relay open and click "Save"