Difference between revisions of "Moving Instances"

[unchecked revision]

[checked revision]

Latest revision as of 16:44, 23 March 2017

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 and stop it.
Click on Configure... to open the Instance Configuration.

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.
Please note: 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.
Optional: If the instance should also be move to a different instance host, change the value of the Instance Host field as well.
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

If relative paths, starting with swung dash (~) sign, have been used to point to archive store locations, moving an instance usually does not require adjustments of archive store paths. In case archive stores have been created using absolute paths, manual adjustment of the paths as described below is needed after moving an instance.

Important notice: Adjust the path of the archive store that is set to current state after all other archive store paths have been correctly adjusted. Otherwise duplicates may get created.

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.
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.

@@ Line 1: / Line 1: @@
-== Move an Instance to a different directory ==
+To move an instance to a different location follow these steps:
-To move an instance to a different directory on the same Instance Host follow these steps:
+* [[Management Console - Logging On|Log on]] to the Management Console.
-* [[Management Console#Logging On|Log on]] to the Management Console.
 * Click on ''General'' > ''Instances''.
-* Select the instance to stop.
+* Select the instance to move and stop it.
-* Stop the instance.
+* Click on ''Configure...'' to open the ''Instance Configuration''.
-* Open the ''Instance Configuration''.
 [[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.
+* 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.
-* Change the ''Base Directory'' in the ''Instance Configuration''.
+*: '''Please note:''' It is not sufficient to just change the ''Base Directory'' in the ''Instance Configuration'', as this will not move the instance data automatically.
-[[File:Ms_spe_move_instance_02.png|center]]
+* Change the ''Base Directory'' in the ''Instance Configuration'' to the new location.
-* Close the ''Instance Configuration''.
+*:[[File:Ms_spe_move_instance_02.png|center]]
+* ''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]]
+* Click ''OK'' to save the changes.
 * 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.
-* If an archive store is in an error state, because the path could not be found, follow these steps:
-[[File:Ms_spe_move_instance_04.png|center]]
-** Remember the current state of the archive store.
-** Set the state to ''disabled''.
-** Select the ''Set Path'' command of the archive store.
-** Change the path the new new path. You either can enter the full absolute path, or you can enter a relative path from the instance's ''Data'' directory.
-[[File:Ms_spe_move_instance_05.png|center]]
-== Move an instance to a different Instance Host ==
+== Adjusting Archive Store Paths ==
+If relative paths, starting with swung dash (~) sign, have been used to point to archive store locations, moving an instance usually does not require adjustments of archive store paths. In case archive stores have been created using absolute paths, manual adjustment of the paths as described below is needed after moving an instance.
-To move an instance to a different Instance Host follow these steps:
+<p class="mswarning">'''Important notice:''' Adjust the path of the archive store that is set to ''current'' state after all other archive store paths have been correctly adjusted. Otherwise duplicates may get created.</p>
-* [[Management Console#Logging On|Log on]] to the Management Console.
+* [[Management Console - Logging On|Log on]] to the Management Console.
 * Click on ''General'' > ''Instances''.
-* Select the instance to stop.
+* Open the instance details by double-clicking on an instance in the list.
-* Stop the instance.
+* Click on the ''Archive Stores'' tab.
-* Open the ''Instance Configuration''.
+* Remember the current ''Requested State'' of the archive store.
-[[File:Ms_spe_move_instance_01.png|center]]
+*: [[File:Ms_spe_move_instance_04.png|600px|center]]
-* Move the ''Base Directory'' of the Instance with your preferred file explorer to the new location on the other ''Instance Host''. It is not sufficient just to change the ''Base Directory'' and the ''Instance Host'' in the ''Instance Configuration''. This will not move the instance automatically.
+* Set the ''Requested State'' to ''disabled'' by clicking on ''Store Commands'' or right-click on the archive store to open a context menu.
-* Change the ''Base Directory'' and the ''Instance Host'' in the ''Instance Configuration''.
+* Select ''Set Path'' command from the ''Store Commands'' menu.
-[[File:Ms_spe_move_instance_03.png|center]]
+* 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.
-* Close the ''Instance Configuration''.
+* Set the ''Requested State'' of the archive store back to the previous state.
-* Start the instance.
+*: [[File:Ms_spe_move_instance_05.png|600px|center]]