On occasion, system administrators may need to move a domain from one SmarterMail server to another. For example, there's a domain that is using an inordinate amount of disk space, so it needs to be moved to a SmarterMail server that has a lot of free disk space available.
IMPORTANT NOTE: SmarterMail data should be moved to a server that's running the same build number as the original server. Do not follow these steps to move a domain from a SmarterMail 16.x or prior installation, or a server running an older Build, to a new server running the current 100.0.xxxx build. If you wish to upgrade along with your domain migration, you must migrate to a server running the same version/Build then perform the upgrade, or perform the upgrade on the old server then migrate to one running the latest Build.
Follow these steps to move a SmarterMail domain to another server:
- Before beginning, make a backup copy of the domains.json file (default install path is C:\Program Files (x86)\SmarterTools\SmarterMail\Service\Settings\) and the folder for the domain you want to move. The default install path for domain folders is C:\SmarterMail\Domains\. So if you were moving example.com to a new SmarterMail server you'd want to make a backup of C:\SmarterMail\Domains\example.com.
- Stop the SmarterMail service on both servers.
- Copy the domain's folder from the old server to the new server. The default install path for the domain folder should match the old server: C:\SmarterMail\Domains\[domain_name]).
- Using Notepad or similar text editor, open the domains.json file on the old server. The default install path is C:\Program Files (x86)\SmarterTools\SmarterMail\Service\Settings\.
- Locate the entry for the domain being moved. (E.g., example.com) It will be displayed in the following format:
- Copy the domain entry from the file and keep it on hand. Then delete the domain entry and save the file. (NOTE: You may need to save it to the desktop, then manually replace the original due to Windows Security.)
- Make a backup of the domains.json file on the new server.
- Using Notepad or similar text editor, open domains.json on the new server.
- Paste the domain entry from the file on the old server, making sure to adhere to the proper naming/formatting of the name.
- Save the file. (NOTE: You may need to save it to the desktop, then manually replace the original due to Windows Security.)
- Start the SmarterMail service on both servers.
- Update the primary MX record for the domain to the new IP. This can take up to 24-48 hours for propagation.