Difference between revisions of "Moving Instances"

[unchecked revision][unchecked revision]
m (Dweuthen moved page Instance Management - Moving an Instance to Moving Instances without leaving a redirect)
Line 5: Line 5:
 
* Select the instance to move.
 
* Select the instance to move.
 
* Stop the instance.
 
* Stop the instance.
−
* Open the ''Instance Configuration''.
+
* Click on ''Configure...'' to open the ''Instance Configuration''.
 
[[File:Ms_spe_move_instance_01.png|center]]
 
[[File:Ms_spe_move_instance_01.png|center]]
−
* Move the ''Base Directory'' of the Instance with your preferred file explorer to the new location. It is not sufficient just to change the ''Base Directory'' in the ''Instance Configuration''. This will not move the instance automatically. You are able to move the ''Base Directory'' to a different ''Instance Host'' or to a storage, that is accessible from a different ''Instance Host'' if you want that instance being run on a different ''Instance Host''.
+
* Locate the ''Base Directory'' of the instance in your preferred file manager (i.e. Windows Explorer) and move the directory to the new location. This can be any location to which the current instance host has access, or, in case it is planed to migrate to another instance host, that is accessible by the new instance host.
−
*: '''Hint:''' If you need a minimal downtime of the instance, you could stop all archiving processes, create a backup of the instance with VSS, and store the backup in the new location. Then you just have to change the path instead of waiting for the transfer process.
+
*: '''Hint:''' It is not sufficient to just change the ''Base Directory'' in the ''Instance Configuration'', as this will not move the instance data automatically.
−
* Change the ''Base Directory'' in the ''Instance Configuration'' if you just have changed the location on the same ''Instance Host''.
+
* Change the ''Base Directory'' in the ''Instance Configuration'' to the new location.
−
[[File:Ms_spe_move_instance_02.png|center]]
+
*:[[File:Ms_spe_move_instance_02.png|center]]
−
* If you want the instance being run on a different ''Instance Host'', change the ''Instance Host'' and the ''Base Directory'', if it has changed.
+
* ''Optional:'' If the instance should also be move to a different instance host, change the value of the ''Instance Host'' field as well.
−
[[File:Ms_spe_move_instance_03.png|center]]
+
*:[[File:Ms_spe_move_instance_03.png|center]]
−
* Close the ''Instance Configuration''.
+
* Click ''OK'' to save the changes.
 
* Start the instance.
 
* Start the instance.
−
* Doubleclick on the instance and navigate to the ''Archive Stores'' tab.
+
* Open the instance details by double-clicking on an instance in the list.
−
* Verify that all stores are loaded correctly.
+
* Navigate to the ''Archive Stores'' tab to verify that all archives stores have been loaded successfully. If some archive stores failed to load, proceed with the following section to adjust archive store paths.
−
[[File:Ms_spe_move_instance_04.png|600px|center]]
+
 
−
* If an archive store is in an error state, because the path could not be found, follow these steps:
+
== Adjusting Archive Store Paths ==
−
** Remember the current ''Requested State'' of the archive store.
+
MailStore Service Provider Edition uses relative paths to point to archive store locations that are below the base directory of an instance. Thus moving an instance usually does imply an adjustment of archive store paths. In case archive stores have been created outside of the base directory, manual adjustments of archive store paths is needed after moving an instance. Follow the steps below to adjust the paths:
−
** Set the ''Requested State'' to ''disabled''.
+
 
−
** Select the ''Set Path'' command of the archive store.
+
* [[Management Console#Logging On|Log on]] to the Management Console.
−
** Change the path to the new path. You either can enter the full absolute path, or you can enter a relative path from the instance's ''Data'' directory, by appending a ''~'' in front of the archive store directory.
+
* Click on ''General'' > ''Instances''.
−
** Set the ''Requested State'' of the store back to the previous state.
+
* Open the instance details by double-clicking on an instance in the list.
−
[[File:Ms_spe_move_instance_05.png|600px|center]]
+
* Click on the ''Archive Stores'' tab.
−
* Restart your archiving profiles if you have paused them.
+
* Remember the current ''Requested State'' of the archive store.
 +
*: [[File:Ms_spe_move_instance_04.png|600px|center]]
 +
* Set the ''Requested State'' to ''disabled'' by clicking on ''Store Commands'' or right-click on the archive store to open a context menu.
 +
* Select ''Set Path'' command from the ''Store Commands'' menu.
 +
* Change the path to the new location. Either enter the absolute path, or use a relative path to the instance's ''Data'' directory, by prepending a ''~'' in front of the archive store's path.
 +
* Set the ''Requested State'' of the archive store back to the previous state.
 +
*: [[File:Ms_spe_move_instance_05.png|600px|center]]

Revision as of 09:38, 17 November 2014

To move an instance to a different location follow these steps:

  • Log on to the Management Console.
  • Click on General > Instances.
  • Select the instance to move.
  • Stop the instance.
  • Click on Configure... to open the Instance Configuration.
Ms spe move instance 01.png
  • Locate the Base Directory of the instance in your preferred file manager (i.e. Windows Explorer) and move the directory to the new location. This can be any location to which the current instance host has access, or, in case it is planed to migrate to another instance host, that is accessible by the new instance host.
    Hint: It is not sufficient to just change the Base Directory in the Instance Configuration, as this will not move the instance data automatically.
  • Change the Base Directory in the Instance Configuration to the new location.
    Ms spe move instance 02.png
  • Optional: If the instance should also be move to a different instance host, change the value of the Instance Host field as well.
    Ms spe move instance 03.png
  • Click OK to save the changes.
  • Start the instance.
  • Open the instance details by double-clicking on an instance in the list.
  • Navigate to the Archive Stores tab to verify that all archives stores have been loaded successfully. If some archive stores failed to load, proceed with the following section to adjust archive store paths.

Adjusting Archive Store Paths

MailStore Service Provider Edition uses relative paths to point to archive store locations that are below the base directory of an instance. Thus moving an instance usually does imply an adjustment of archive store paths. In case archive stores have been created outside of the base directory, manual adjustments of archive store paths is needed after moving an instance. Follow the steps below to adjust the paths:

  • Log on to the Management Console.
  • Click on General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Remember the current Requested State of the archive store.
    Ms spe move instance 04.png
  • Set the Requested State to disabled by clicking on Store Commands or right-click on the archive store to open a context menu.
  • Select Set Path command from the Store Commands menu.
  • Change the path to the new location. Either enter the absolute path, or use a relative path to the instance's Data directory, by prepending a ~ in front of the archive store's path.
  • Set the Requested State of the archive store back to the previous state.
    Ms spe move instance 05.png
Retrieved from "https://help.mailstore.com/en/spe/index.php?title=Moving_Instances&oldid=1190"