Difference between revisions of "Move MailStore Gateway to new machine"

[unchecked revision][checked revision]
(Created page with "== Move MailStore Gateway to new machine == To move MailStore Gateway to a new machine, please follow the steps below: * Stop the MailStore Gateway service on the current ma...")
 
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
== Move MailStore Gateway to new machine ==
+
MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well. Please read the following instructions completely and carefully before you start implementing them.
 +
 
 +
== Scenarios ==
 +
The following scenarios are covered:
 +
* MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.
 +
* MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS.
 +
Most steps are the same for both scenarios, differences will be pointed out when necessary.
 +
 
 +
== Steps to Follow ==
 
To move MailStore Gateway to a new machine, please follow the steps below:  
 
To move MailStore Gateway to a new machine, please follow the steps below:  
  
−
* Stop the MailStore Gateway service on the current machine.
+
* If MailStore Gateway is exposed to the internet directly, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand.
−
* Install MailStore Gateway on the new machine.
+
* Create a [[Backup_and_Restore|backup]] of your OLD machine.
−
* Stop the MailStore Gateway service on the new machine.
+
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
−
* Adjust any DNS settings(internal DNS and external DNS if used).
+
* On the NEW machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
−
* Adjust firewall settings to point to the new machine where MailStore Gateway is installed.
+
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
−
* If using a third-party certificate, copy and install the certificate to the new Gateway server.
+
* On the NEW machine close the MailStore Gateway Config Tool.
−
* Copy the configuration file that holds your configuration settings over to the new server.
+
* Copy the files ''config.json'' and ''gateway.db'' in the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the same folder of the NEW machine, overwriting existing files.
−
** Copy the "config.json" file located in "C:\ProgramData\MailStore\Gateway" from the original Gateway Server to the same location on the new Gateway server.
+
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
−
* Adjust archiving profiles.
+
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
−
** Adjust the MailStore Gateway server name in your existing archive profiles.
+
* Start the MailStore Gateway Service on the NEW machine.
−
* Adjust client settings if used as "proxy"
+
* If MailStore Gateway is exposed to the internet through a firewall, adjust [[Firewall_Configuration|firewall settings]] to forward Gateway traffic to the NEW machine.
−
** Adjust Names in client settings (i.e Outlook, Thunderbird) if used
+
* Adjust DNS settings, if necessary.
−
* Start the MailStore Gateway Service on the new machine.
+
* If MailStore Gatway is exposed to the internet directly, adjust the MX record of the Gateway email domain to point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
−
* Uninstall the MailStore Gateway Service from the old machine
+
* Ensure the NEW machine is receiving mails.
 +
* Ensure the OLD machine is not receiving mails, anymore. If MailStore Gateway is directly exposed to the internet, depending on the TTL of the MX record, this might take 24 hours or even longer.
 +
* After the machine is not receiving mails anymore, archive the remaining mails from the OLD machine.
 +
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
 +
* Adjust email client settings to point to the new Gateway if used as email proxy.
 +
* Decommission the OLD machine.
 +
 
 +
 
 +
[[de:MailStore Gateway auf einen anderen Server verschieben]]
 +
[[en:Move_MailStore_Gateway_to_new_machine]]

Latest revision as of 13:33, 16 July 2024

MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well. Please read the following instructions completely and carefully before you start implementing them.

Scenarios

The following scenarios are covered:

  • MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.
  • MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS.

Most steps are the same for both scenarios, differences will be pointed out when necessary.

Steps to Follow

To move MailStore Gateway to a new machine, please follow the steps below:

  • If MailStore Gateway is exposed to the internet directly, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand.
  • Create a backup of your OLD machine.
  • Install MailStore Gateway on the NEW machine. The download can be found here [1].
  • On the NEW machine start the MailStore Gateway Config Tool by clicking on the desktop shortcut MailStore Gateway.
  • On the NEW machine stop the Gateway service by clicking Stop Service.
  • On the NEW machine close the MailStore Gateway Config Tool.
  • Copy the files config.json and gateway.db in the folder C:\ProgramData\MailStore\Gateway from the OLD machine to the same folder of the NEW machine, overwriting existing files.
  • If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
  • Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. Re-configure Let's Encrypt, if necessary.
  • Start the MailStore Gateway Service on the NEW machine.
  • If MailStore Gateway is exposed to the internet through a firewall, adjust firewall settings to forward Gateway traffic to the NEW machine.
  • Adjust DNS settings, if necessary.
  • If MailStore Gatway is exposed to the internet directly, adjust the MX record of the Gateway email domain to point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
  • Ensure the NEW machine is receiving mails.
  • Ensure the OLD machine is not receiving mails, anymore. If MailStore Gateway is directly exposed to the internet, depending on the TTL of the MX record, this might take 24 hours or even longer.
  • After the machine is not receiving mails anymore, archive the remaining mails from the OLD machine.
  • Adjust the archiving profiles in MailStore Server to point to the new Gateway.
  • Adjust email client settings to point to the new Gateway if used as email proxy.
  • Decommission the OLD machine.
Retrieved from "https://help.mailstore.com/en/gateway/index.php?title=Move_MailStore_Gateway_to_new_machine&oldid=305"