Difference between revisions of "Moving Roles"

[unchecked revision][unchecked revision]
Line 21: Line 21:
 
= Moving the SPE running in Single-Server-Mode to another server =
 
= Moving the SPE running in Single-Server-Mode to another server =
  
−
* Close all MailStore SPE related programs, except for the ''MailStore Service Provider Edition Configuration''.
+
* Close all MailStore SPE related programs, except for the ''MailStore Service Provider Edition Configuration'' on the old server.
 
* Stop the MailStore SPE instance host, client access server and management roles.
 
* Stop the MailStore SPE instance host, client access server and management roles.
 
* Transfer your MailStore SPE license to the new machine through our [https://my.mailstore.com/TransferLicense license portal].
 
* Transfer your MailStore SPE license to the new machine through our [https://my.mailstore.com/TransferLicense license portal].
Line 28: Line 28:
 
* Remove all MailStore SPE related certificates from the computer's personal (MY) certificate store.
 
* Remove all MailStore SPE related certificates from the computer's personal (MY) certificate store.
 
* Export the SSL certificates and private keys from the old machines certificate store and import it to the same location on the new machine.  
 
* Export the SSL certificates and private keys from the old machines certificate store and import it to the same location on the new machine.  
−
* PowerShell command to export all certificats stored in the computers ''MY'' store as a single file:
+
* On Windows Server 2012 R2 you can use the following PowerShell command to export all certificats stored in the computers ''MY'' store as PFX containers to the current user's desktop:
−
Get-ChildItem Cert:\LocalMachine\My | Export-Certificate -FilePath $env:USERPROFILE\all_mailstore_spe_certs.sst -Type SST
+
(Get-ChildItem Cert:\LocalMachine\My).Thumbprint | ForEach-Object { Export-PfxCertificate -Cert ("Cert:\LocalMachine\My\{0}" -f $_) -FilePath ("$env:USERPROFILE\Desktop\{0}.pfx" -f $_) -Password  (ConvertTo-SecureString -AsPlainText -Force "not_secure_234") }
−
* Powershell command to import the previously exported certificates in the new server certificate store:
+
* Windows Server 2012 R2 Powershell command to import the previously exported certificates in the new server certificate store:
−
Import-Certificate -FilePath $env:USERPROFILE\all_mailstore_spe_certs.sst -CertStoreLocation Cert:\LocalMachine\My
+
Get-ChildItem -Path $env:USERPROFILE\Desktop\ -Filter *.pfx | Import-PfxCertificate -Exportable -Password  (ConvertTo-SecureString -AsPlainText -Force "not_secure_234") -CertStoreLocation Cert:\LocalMachine\My
−
 
+
* Remove the ''%program files%\MailStore Infrastructure\config'' directory on the new server, replace it with the ''config'' directory from the old one.
−
* Copy your "config" folder from the old machine to the new server and overwrite the fresh config.
+
* Transfer you instance data directories to the new server.
−
* Start the management role, then the other ones in arbitrary order.
+
* Open the management role configuration and adjust the ''Server Name''.
−
* Check the SPE's dashboard and verify that everything role is coming up properly.
+
* Start the management role.
−
* Change the instance host, in the configuration of each instance. http://en.help.mailstore.com/spe/Moving_Instances
+
* Try to log in into the management webinterface. The log in should be successful, but the connection to the instance host and client access server should be failed.
−
* Change the location of the instance host's base directory, if that has changed.
+
* Open the client access server configuration and adjust the ''Server Name'' and the ''Management Server''. The ''Server Name'' must be in lower case. Perform the pairing.
−
* Uninstall MailStore SPE on the old machine. Use ''Add/Remove Programs'' available in the control panel.
+
* Start the client access server role.
 +
* Verify that the connection to the client access server can be established in the dashboard.
 +
* [[Management_Console_-_Infrastructure#Client_Access_Servers|Remove]] the leftovers of the other client access server.
 +
* Open the instance host configuration and adjust the ''Server Name'' and the ''Management Server''. The ''Server Name'' must be in lower case. Perform the pairing.
 +
* Start the instance host role.
 +
* Verify that the connection to the instance host can be established in the dashboard.
 +
* [[Management_Console_-_Infrastructure#Instance_Hosts|Change] the location of the instance host's base directory, if it has changed.
 +
* [[Moving_Instances|Change]] the configuration of each instance to refelct the new ''Server Name'' and path.
 +
* [[Management_Console_-_Infrastructure#Instance_Hosts|Remove] the leftovers of the other instance host.

Revision as of 12:26, 5 March 2015

Renaming the server where the SPE runs on in Single-Server-Mode

When the server has been renamed, the management dashboard will show you the warning

The Name of this Server differs from the licensed Machine Name. Therefore your license has been disabled.

The Instance Host and Client Access Server roles are not connected to the Management Server role and the instances are not started. Perform the following steps to get your SPE running again:

  • Stop the MailStore SPE instance host, client access server and management roles.
  • Transfer your MailStore SPE license to the new machine through our license portal.
  • Open the configuration of the management role and adjust the Server Name to match the new name.
  • Start the management server role.
  • Log in into the dashboard and verify that he license warning is gone.
  • Open the configuration of the instance host role and adjust the Server Name to match the new name. Additionally enter the new server name in the Management Server field and pair this role with the management server role.
  • Start the instance host role.
  • Change the Instance Host setting in the instance configuration of each instance.
  • Remove the leftover of the old servername from the Dashboard -> INFRASTRUCTURE -> Instance Hosts.
  • Open the configuration of the client access server role and adjust the Server Name to match the new name. Additionally enter the new server name in the Management Server field and pair this role with the management server role.
  • Start the client access server role.
  • Remove the leftover of the old servername from the Dashboard -> INFRASTRUCTURE -> Instance Hosts.


Moving the SPE running in Single-Server-Mode to another server

  • Close all MailStore SPE related programs, except for the MailStore Service Provider Edition Configuration on the old server.
  • Stop the MailStore SPE instance host, client access server and management roles.
  • Transfer your MailStore SPE license to the new machine through our license portal.
  • Install MailStore SPE on the new machine.
  • Stop all roles on the new server.
  • Remove all MailStore SPE related certificates from the computer's personal (MY) certificate store.
  • Export the SSL certificates and private keys from the old machines certificate store and import it to the same location on the new machine.
  • On Windows Server 2012 R2 you can use the following PowerShell command to export all certificats stored in the computers MY store as PFX containers to the current user's desktop:

(Get-ChildItem Cert:\LocalMachine\My).Thumbprint | ForEach-Object { Export-PfxCertificate -Cert ("Cert:\LocalMachine\My\{0}" -f $_) -FilePath ("$env:USERPROFILE\Desktop\{0}.pfx" -f $_) -Password (ConvertTo-SecureString -AsPlainText -Force "not_secure_234") }

  • Windows Server 2012 R2 Powershell command to import the previously exported certificates in the new server certificate store:

Get-ChildItem -Path $env:USERPROFILE\Desktop\ -Filter *.pfx | Import-PfxCertificate -Exportable -Password (ConvertTo-SecureString -AsPlainText -Force "not_secure_234") -CertStoreLocation Cert:\LocalMachine\My

  • Remove the %program files%\MailStore Infrastructure\config directory on the new server, replace it with the config directory from the old one.
  • Transfer you instance data directories to the new server.
  • Open the management role configuration and adjust the Server Name.
  • Start the management role.
  • Try to log in into the management webinterface. The log in should be successful, but the connection to the instance host and client access server should be failed.
  • Open the client access server configuration and adjust the Server Name and the Management Server. The Server Name must be in lower case. Perform the pairing.
  • Start the client access server role.
  • Verify that the connection to the client access server can be established in the dashboard.
  • Remove the leftovers of the other client access server.
  • Open the instance host configuration and adjust the Server Name and the Management Server. The Server Name must be in lower case. Perform the pairing.
  • Start the instance host role.
  • Verify that the connection to the instance host can be established in the dashboard.
  • [[Management_Console_-_Infrastructure#Instance_Hosts|Change] the location of the instance host's base directory, if it has changed.
  • Change the configuration of each instance to refelct the new Server Name and path.
  • [[Management_Console_-_Infrastructure#Instance_Hosts|Remove] the leftovers of the other instance host.
Retrieved from "https://help.mailstore.com/en/spe/index.php?title=Moving_Roles&oldid=1240"