Difference between revisions of "Moving the Archive"

[unchecked revision][checked revision]
 
(34 intermediate revisions by 5 users not shown)
Line 1: Line 1:
It is possible to move an existing 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 the Archive to an External Hard-Disk =
+
== 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.
  
To move the MailStore Server archive to a new location, proceed with these steps:
+
When moving an archive store to a network share, the information from the article [[Using Network Attached Storage (NAS)]] are also applicable.
* Stop the MailStore Server service, either through the MailStore Base Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
 
* Copy the archive directory (default: C:\MailArchive) and all subdirectories to the new location. Directory structure must be preserved.
 
* Run the MailStore Server Base Configuration utility and change the directory of the "Master Database" to the new location.
 
* Start the MailStore Server service again, either through the MailStore Base 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''.
 +
[[File:Tech_storageloc_01.png|center|550px]]
 +
* 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. <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 a New Machine =
+
== Moving Components of an Archive Store ==
 +
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.
  
To move the MailStore Server archive to a new machine including all users, settings and emails follow these steps:
+
When moving an archive store to a network share, the information from the article [[Using Network Attached Storage (NAS)]] are also applicable.
  
* Stop the MailStore Server service on the current machine, either trough the MailStore Base Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges.
* Copy the directory "MailArchive" and all file-groups that exist on the current machine to the new machine. Directory structure should be preserved.
+
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
* Uninstall MailStore Server on the current machine. Use ''Add/Remove Programs'' available in the control panel.
+
* Follow these steps for the archive store you want to move parts of:
* Install MailStore Server on the new machine. Choose "Existing Archive" and select the path to the directory where you copied your archive to.
+
:* Make note of the status. You can find this information in the summary next to the archive store list.
* 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.
+
:* [[File:Tech_storageloc_03.png|right|350px]]Change the status to ''Disabled''.
* Start Mailstore Server and activate the installation by entering the 25-digit activation key or install the license file you received after purchasing MailStore Server.
+
:* In the context menu or in the details pane, click on ''Edit...''
* Now set up the scheduled tasks again.
+
:* 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.
  
= Moving the Archive onto a NAS-share =
 
  
When moving an already running Installation, only the databases and container files are moved onto the NAS-share. The MailStore Server program itself remains at its original location.
+
== 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.  
  
The descriptions from the article [[Using Network Attached Storage (NAS)]] are analogical. The following steps are required to move the archive:
+
* 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.
  
* Stop the MailStore Server service on the current machine, either trough the MailStore Base Configuration or the service control panel or by executing the command 'net stop "MailStore Server"' from the command-line.
+
'''Notice:''' Please be aware that the throughput of an external hard-disk may have a negative impact on the performance of MailStore Server.
* Create a backup of your MailStore Server archive.
+
 
 +
'''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 ==
 +
{{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.}}
 +
 
 +
To move a MailStore Server archive, including all users, settings and emails, to a new machine, follow these steps:
 +
{{#ev:youtube|https://youtu.be/3XZgBhFgya0|350|center|''Tech Tip: How to Move MailStore Server''}}
 +
* 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].
 +
* [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 <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 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.
 +
 
 +
'''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.
 
* Create a new share on the NAS-system.
* Either grant the MailStore Server machine account or a user with administrative privileges on the MailStore Server machine 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 the MailStore Server Service is executed under the scope of that user object.
+
* 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 share.
+
* Move all files from the original archive folder to the network share.
* Open the MailStore Server Base 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 Base 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 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.
 +
 
 +
<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 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''.
 +
* [[Storage_Locations#Detaching|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''.
 +
* [[Storage_Locations#Attaching|Attach]] the moved archive store.
  
[[de:Umziehen_des_Archivs]]
+
[[de:Umziehen des Archivs]]
 +
[[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.