Difference between revisions of "Moving the Archive"

[unchecked revision][checked revision]
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
It is possible to move a single archive store or the complete MailStore Server archive to a new hard-disk, machine or network share at any time. What is required to successfully move an archive is described in the following sections.
+
It is possible to move a single archive store, its components or the complete MailStore Server archive to a new hard-disk, machine or network share at any time. What is required to successfully move an archive is described in the following sections.
  
== Moving a Single Archive Store ==
+
== Moving an Entire Single Archive Store ==
To move an an archive store to an other hard-disk or network share, follow the instructions below. The MailStore master database all other archive stores remain unchanged.
+
To move an entire archive store to a different hard-disk or network share, follow the instructions below. The MailStore master database and all other archive stores remain unchanged.
  
When moving an archive store to a network share the information from the article [[Using Network Attached Storage (NAS)]] are analogical.  
+
When moving an archive store to a network share, the information from the article [[Using Network Attached Storage (NAS)]] are also applicable.
  
* Start MailStore Client as a user with administrative privileges.
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges.
* Navigate to ''Administrative Tools'' > ''Storage'' > ''Storage Locations''.
+
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
* Remember the state and the path of the archive store you want to move.
+
[[File:Tech_storageloc_01.png|center|550px]]
* Change the state of the archive store you want to move to ''Disabled''.
+
* Follow these steps for the archive store you want to move:
* Move the containing folder to the new location.
+
:* Make note of the status and the path on disk. You can find this information in the summary next to the archive store list.
* Back in MailStore Client click ''Edit..'' and change the path to the new directory. If a network share is used, enter the UNC path of the share e.g. ''\\computer\myshare\..''.
+
:* Change the status to ''Disabled''.
* Change the state of the archive store back to it's initial state.
+
:* In the file system, move the folder you've jotted down in the first step to the new location.
 +
:* In the context menu or in the details pane, click on ''Edit...''
 +
:* The ''Edit Archive Store Properties'' dialog opens.
 +
:* Change the base directory to the new folder. If a network share is used, enter the UNC path of the share i.e. <code>\\computer\myshare\folder</code>.
 +
:* Click on ''Finish''.
 +
:* Change the status of the archive store back to the one you've noted in the first step.
  
== Moving the Archive to an other Hard-Disk ==
+
== Moving Components of an Archive Store ==
To move a MailStore Server installation, where all archive stores are located underneath the directory of the master database (default: C:\MailArchive) to an other hard-disk follow the steps below. The MailStore program directory remains unchanged.  
+
In MailStore, archive stores always consist of the following three components:
 +
{{Archive_Stores_Structure}}
 +
These individual components can be moved to different physical storages. For example, you can move the database with folder information and meta data as well as the search index on a fast storage to accelerate folder operations and the MailStore search while leaving the email content files on a slower storage.<br/>
 +
To move parts of an archive store to another hard-disk or network share, follow the instructions below. The MailStore master database and all other archive stores remain unchanged.
  
* Stop the MailStore Server service, either through the MailStore Server Service Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
+
When moving an archive store to a network share, the information from the article [[Using Network Attached Storage (NAS)]] are also applicable.
* Move the master database directory (default: C:\MailArchive) and all subdirectories to the new location. Directory structure must be preserved.
 
* Run the MailStore Server Service Configuration utility and change the directory of the "Master Database" to the new location.
 
* Start the MailStore Server service again, either through the MailStore Server Service Configuration or the service control panel or by executing the command 'net start "MailStore Server"' from the command-line.
 
  
'''Notice:''' Please be aware, that the throughput of the external hard-disk may have a negative impact on the performance of MailStore Server.
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges.
 +
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
 +
* Follow these steps for the archive store you want to move parts of:
 +
:* Make note of the status. You can find this information in the summary next to the archive store list.
 +
:* [[File:Tech_storageloc_03.png|right|350px]]Change the status to ''Disabled''.
 +
:* In the context menu or in the details pane, click on ''Edit...''
 +
:* The ''Edit Archive Store Properties'' dialog opens.
 +
:* Enable the option ''Use different directories for database, content and search index''. The folders of the individual archive store components are shown.
 +
:* In the file system, move the folders to their new locations.
 +
:* In the dialog, change the base directories to the new folders. If network shares are used, enter the UNC paths of the shares i.e. <code>\\computer\myshare\folder</code>.
 +
:* Click on ''Finish''.
 +
:* Change the status of the archive store back to the one you've noted in the first step.
  
'''Please note:''' Archive stores that are not stored in a relative path to the master database are to be re-attached or modified after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
+
 
 +
== Moving the Archive to a Different Hard-Disk ==
 +
To move a MailStore Server installation, where all archive stores are located underneath the directory of the master database (default: <code>C:\MailArchive</code>), to a different hard-disk, follow the steps below. The MailStore program directory remains unchanged.
 +
 
 +
* Stop the MailStore Server service through the [[MailStore Server Service Configuration]].
 +
* Move the master database directory (default: <code>C:\MailArchive</code>) and all subdirectories to the new location. The folder structure must remain unchanged.
 +
* Use the MailStore Server Service Configuration to change the directory of the "Master Database" to the new location.
 +
* Start the MailStore Server service again.
 +
 
 +
'''Notice:''' Please be aware that the throughput of an external hard-disk may have a negative impact on the performance of MailStore Server.
 +
 
 +
'''Please note:''' Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
  
 
== Moving the Archive to a New Machine ==
 
== Moving the Archive to a New Machine ==
To move a MailStore Server archive to a new machine including all users, settings and emails follow these steps:
+
{{Multiline Notices|Heading=Important Notices|To move your MailStore archive to a new machine, you need your license key (Product-Key) and the computer name (Machine-Name) of the computer on which MailStore Server was previously installed. You can find both in the MailStore Client in the Administrative Tools under Miscellaneous > License Management.}}
  
* Stop the MailStore Server service on the current machine, either through the MailStore Server Service Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
+
To move a MailStore Server archive, including all users, settings and emails, to a new machine, follow these steps:
* Move the master database directory (default: C:\MailArchive) and all its subdirectories and all archive stores that exist on the current machine to the new machine. Directory structure should be preserved.
+
{{#ev:youtube|https://youtu.be/3XZgBhFgya0|350|center|''Tech Tip: How to Move MailStore Server''}}
* Uninstall MailStore Server on the current machine. Use ''Add/Remove Programs'' available in the control panel.
+
* Create a [[Backup_and_Restore|backup]] of the archive.
 +
* Stop the MailStore Server service on the current machine through the [[MailStore Server Service Configuration]].
 +
* Move the master database directory (default: <code>C:\MailArchive</code>), all of its subdirectories and all archive stores that exist on the current machine to the new machine. The folder structure must remain unchanged.
 +
* Uninstall MailStore Server on the current machine.
 
* Transfer your MailStore Server license to the new machine through our [https://my.mailstore.com/TransferLicense license portal].
 
* Transfer your MailStore Server license to the new machine through our [https://my.mailstore.com/TransferLicense license portal].
* Install MailStore Server on the new machine.  
+
* [https://my.mailstore.com/downloads Install MailStore Server] on the new machine. You can install the latest version. Please note the [[Update_Notices_for_MailStore_Server|update notes]].
* If the location of the master database directory to use does not match the default path ''C:\MailArchive'', run the MailStore Server Service Configuration utility, stop the MailStore Server service and change the directory of the "Master Database" to the new location.
+
* If the location of the master database directory to use does not match the default path <code>C:\MailArchive</code>, run the MailStore Server Service Configuration, stop the MailStore Server service and change the directory of the "Master Database" to the new location.
* If you have any client-sided scheduled tasks, export the SSL certificate and private key (usually packaged in a PKCS#12 file) with the common name "MailStore Server" from the machines certificate store and import it to the same location on the new machine. Refer to the Windows help for further information about managing SSL certificates.
+
* If you have any client-sided scheduled tasks and are using your own SSL certificate, export the SSL certificate and private key (usually packaged in a PKCS#12 file) which is used by MailStore Server from the machines certificate store and import it to the same location on the new machine. Refer to the Windows help for further information about managing SSL certificates.
 +
* In case the new installation is using the same product key than the old installation and the product key is used as recovery key, nothing has to be done in regards to [[MailStore_Server_Service_Configuration#Security_and_Encryption|archive security]]. In case a different product key is used on the new machine or the archive was secured with a [[MailStore_Server_Service_Configuration#Set_Recovery_Key|generated random value]] the archive must be [[MailStore_Server_Service_Configuration#Reinitialize_Archive_Encryption|reinitialized]] before the first start.
 +
* Start the MailStore Server service on the new machine if it's not running.
  
* In case the new installation is using the same product key as the old installation and the product key is used as recovery key, nothing has to be done in regards to [[MailStore_Server_Service_Configuration#Security_and_Encryption|archive security]]. In case a different product key is uses on the new machine or the archive was secured with a [[MailStore_Server_Service_Configuration#Set_Recovery_Key|generated random value]] the archive must be [[MailStore_Server_Service_Configuration#Reinitialize_Archive_Encryption||reinitialized]] before the first start.
+
'''Please note:''' Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
* Start the MailStore Server service.
 
* Set up the scheduled tasks, if necessary.
 
 
 
'''Please note:''' Archive stores that are not stored in a relative path to the master database are to be re-attached or modified after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
 
  
 
== Moving the Archive to a Network Share ==
 
== Moving the Archive to a Network Share ==
To move a MailStore Server archive to a network share including all users, settings and emails follow the instructions below. The descriptions from the article [[Using Network Attached Storage (NAS)]] are analogical. The MailStore Server program directory remains at its original location.
+
To move a MailStore Server archive, including all users, settings and emails, to a network share, follow the instructions below. The information from the article [[Using Network Attached Storage (NAS)]] are also applicable. The MailStore program directory remains unchanged.
  
* Stop the MailStore Server service on the current machine, either trough the MailStore Server Service Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
+
* Stop the MailStore Server service through the [[MailStore Server Service Configuration]].
* Create a backup of your MailStore Server archive.
 
 
* Create a new share on the NAS-system.
 
* Create a new share on the NAS-system.
 
* Either grant the MailStore Server machine account or a user read-/write-permissions on that newly created share.
 
* Either grant the MailStore Server machine account or a user read-/write-permissions on that newly created share.
* If you granted the permissions to a user object, make sure you create an appropriate start-up script as described in [[Using Network Attached Storage (NAS)]].
+
* If you granted the permissions to a user object, configure MailStore Server as described in [[Using Network Attached Storage (NAS)]].
 
* Move all files from the original archive folder to the network share.
 
* Move all files from the original archive folder to the network share.
* Open the MailStore Server Service Configuration and set the path to the MailStore Server Master-Database to the UNC path of the share e.g. ''\\computer\myshare\..''.
+
* Use the MailStore Server Service Configuration to set the path to the MailStore Server Master-Database to the UNC path of the share, i.e. <code>\\computer\myshare</code>.
* Start the MailStore Server service again, either through the MailStore Server Service Configuration or the service control panel or by executing the command 'net start "MailStore Server"' from the command-line.
+
* Start the MailStore Server service again.
  
'''Please note:''' Archive stores that are not stored in a relative path to the master database are to be re-attached or modified after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
+
'''Please note:''' Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter [[Storage Locations]] of the MailStore Server manual.
  
 
== Moving an Archive Store to a Different Installation ==
 
== Moving an Archive Store to a Different Installation ==
To move an an archive store to a different installation, follow the instructions below. The product key or the recovery key of the installation where the archive store is coming from is required.
+
To move an archive store to a different installation, follow the instructions below. The product key or the recovery key of the installation where the archive store is coming from is required.
 +
 
 +
<p class=msnote>'''Please note:''' The archive store must be on version 7 or higher, so that it can move to a different archive. If that is not the case, the archive store and the associated Master Database have to be loaded once with  MailStore Server 7 or higher, because then some necessary database upgrades will be performed.</p>
  
* Start MailStore Client as a user with administrative privileges on the installation where the archive store is still attached to.
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges on the installation where the archive store is still attached to.
* Navigate to ''Administrative Tools'' > ''Storage'' > ''Storage Locations''.
+
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
 
* [[Storage_Locations#Detaching|Detach]] the archive store you want to move.
 
* [[Storage_Locations#Detaching|Detach]] the archive store you want to move.
 
* Move the folder or folders of the archive store to the new location.
 
* Move the folder or folders of the archive store to the new location.
* Start MailStore Client as a user with administrative privileges on the installation where the archive store will be attached to.
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges on the installation where the archive store will be attached to.
* Navigate to ''Administrative Tools'' > ''Storage'' > ''Storage Locations''.
+
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
 
* [[Storage_Locations#Attaching|Attach]] the moved archive store.
 
* [[Storage_Locations#Attaching|Attach]] the moved archive store.
  
 
[[de:Umziehen des Archivs]]
 
[[de:Umziehen des Archivs]]
 
[[en:Moving the Archive]]
 
[[en:Moving the Archive]]

Latest revision as of 10:23, 26 October 2023

It is possible to move a single archive store, its components or the complete MailStore Server archive to a new hard-disk, machine or network share at any time. What is required to successfully move an archive is described in the following sections.

Moving an Entire Single Archive Store

To move an entire archive store to a different hard-disk or network share, follow the instructions below. The MailStore master database and all other archive stores remain unchanged.

When moving an archive store to a network share, the information from the article Using Network Attached Storage (NAS) are also applicable.

  • Start the MailStore Client and log in as a MailStore user with administrative privileges.
  • Navigate to Administrative Tools > Storage > Storage Locations.
Tech storageloc 01.png
  • Follow these steps for the archive store you want to move:
  • Make note of the status and the path on disk. You can find this information in the summary next to the archive store list.
  • Change the status to Disabled.
  • In the file system, move the folder you've jotted down in the first step to the new location.
  • In the context menu or in the details pane, click on Edit...
  • The Edit Archive Store Properties dialog opens.
  • Change the base directory to the new folder. If a network share is used, enter the UNC path of the share i.e. \\computer\myshare\folder.
  • Click on Finish.
  • Change the status of the archive store back to the one you've noted in the first step.

Moving Components of an Archive Store

In MailStore, archive stores always consist of the following three components:

  • Folder Information and Meta Data
    Contains all data needed for the construction of the folder structure and the email list.
  • Email Headers and Contents
    Contains the actual payload of the archive.
  • Full Text Index
    Contains all data needed for searching through emails and attachments. The full text index can be reconstructed at any time. Additional information is available in chapter Search Indexes.

These individual components can be moved to different physical storages. For example, you can move the database with folder information and meta data as well as the search index on a fast storage to accelerate folder operations and the MailStore search while leaving the email content files on a slower storage.
To move parts of an archive store to another hard-disk or network share, follow the instructions below. The MailStore master database and all other archive stores remain unchanged.

When moving an archive store to a network share, the information from the article Using Network Attached Storage (NAS) are also applicable.

  • Start the MailStore Client and log in as a MailStore user with administrative privileges.
  • Navigate to Administrative Tools > Storage > Storage Locations.
  • Follow these steps for the archive store you want to move parts of:
  • Make note of the status. You can find this information in the summary next to the archive store list.
  • Tech storageloc 03.png
    Change the status to Disabled.
  • In the context menu or in the details pane, click on Edit...
  • The Edit Archive Store Properties dialog opens.
  • Enable the option Use different directories for database, content and search index. The folders of the individual archive store components are shown.
  • In the file system, move the folders to their new locations.
  • In the dialog, change the base directories to the new folders. If network shares are used, enter the UNC paths of the shares i.e. \\computer\myshare\folder.
  • Click on Finish.
  • Change the status of the archive store back to the one you've noted in the first step.


Moving the Archive to a Different Hard-Disk

To move a MailStore Server installation, where all archive stores are located underneath the directory of the master database (default: C:\MailArchive), to a different hard-disk, follow the steps below. The MailStore program directory remains unchanged.

  • Stop the MailStore Server service through the MailStore Server Service Configuration.
  • Move the master database directory (default: C:\MailArchive) and all subdirectories to the new location. The folder structure must remain unchanged.
  • Use the MailStore Server Service Configuration to change the directory of the "Master Database" to the new location.
  • Start the MailStore Server service again.

Notice: Please be aware that the throughput of an external hard-disk may have a negative impact on the performance of MailStore Server.

Please note: Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter Storage Locations of the MailStore Server manual.

Moving the Archive to a New Machine

Important Notices: To move your MailStore archive to a new machine, you need your license key (Product-Key) and the computer name (Machine-Name) of the computer on which MailStore Server was previously installed. You can find both in the MailStore Client in the Administrative Tools under Miscellaneous > License Management.

To move a MailStore Server archive, including all users, settings and emails, to a new machine, follow these steps:

Tech Tip: How to Move MailStore Server
  • Create a backup of the archive.
  • Stop the MailStore Server service on the current machine through the MailStore Server Service Configuration.
  • Move the master database directory (default: C:\MailArchive), all of its subdirectories and all archive stores that exist on the current machine to the new machine. The folder structure must remain unchanged.
  • Uninstall MailStore Server on the current machine.
  • Transfer your MailStore Server license to the new machine through our license portal.
  • Install MailStore Server on the new machine. You can install the latest version. Please note the update notes.
  • If the location of the master database directory to use does not match the default path C:\MailArchive, run the MailStore Server Service Configuration, stop the MailStore Server service and change the directory of the "Master Database" to the new location.
  • If you have any client-sided scheduled tasks and are using your own SSL certificate, export the SSL certificate and private key (usually packaged in a PKCS#12 file) which is used by MailStore Server from the machines certificate store and import it to the same location on the new machine. Refer to the Windows help for further information about managing SSL certificates.
  • In case the new installation is using the same product key than the old installation and the product key is used as recovery key, nothing has to be done in regards to archive security. In case a different product key is used on the new machine or the archive was secured with a generated random value the archive must be reinitialized before the first start.
  • Start the MailStore Server service on the new machine if it's not running.

Please note: Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter Storage Locations of the MailStore Server manual.

Moving the Archive to a Network Share

To move a MailStore Server archive, including all users, settings and emails, to a network share, follow the instructions below. The information from the article Using Network Attached Storage (NAS) are also applicable. The MailStore program directory remains unchanged.

  • Stop the MailStore Server service through the MailStore Server Service Configuration.
  • Create a new share on the NAS-system.
  • Either grant the MailStore Server machine account or a user read-/write-permissions on that newly created share.
  • If you granted the permissions to a user object, configure MailStore Server as described in Using Network Attached Storage (NAS).
  • Move all files from the original archive folder to the network share.
  • Use the MailStore Server Service Configuration to set the path to the MailStore Server Master-Database to the UNC path of the share, i.e. \\computer\myshare.
  • Start the MailStore Server service again.

Please note: Archive stores that are not stored in a relative path to the master database may have to be re-attached or their paths edited after moving the archive. Details about managing archive stores are available in chapter Storage Locations of the MailStore Server manual.

Moving an Archive Store to a Different Installation

To move an archive store to a different installation, follow the instructions below. The product key or the recovery key of the installation where the archive store is coming from is required.

Please note: The archive store must be on version 7 or higher, so that it can move to a different archive. If that is not the case, the archive store and the associated Master Database have to be loaded once with MailStore Server 7 or higher, because then some necessary database upgrades will be performed.

  • Start the MailStore Client and log in as a MailStore user with administrative privileges on the installation where the archive store is still attached to.
  • Navigate to Administrative Tools > Storage > Storage Locations.
  • Detach the archive store you want to move.
  • Move the folder or folders of the archive store to the new location.
  • Start the MailStore Client and log in as a MailStore user with administrative privileges on the installation where the archive store will be attached to.
  • Navigate to Administrative Tools > Storage > Storage Locations.
  • Attach the moved archive store.