Difference between revisions of "Moving the Archive"

[unchecked revision][checked revision]
(Created page with '== How can I move my MailStore Server installation to a new server? == '''Q:''' I want to move my whole MailStore installation to a new server. What is the best-practice for thi…')
 
 
(61 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== How can I move my MailStore Server installation to a new server? ==
+
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.
  
'''Q:''' I want to move my whole MailStore installation to a new server. What is the best-practice for this?
+
== 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.
  
'''A:''' To migrate MailStore Server 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 MailStore Server Service on the current machine, either trough the MailStore Basic Configuration or the service control panel
+
* 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 stucture 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
+
[[File:Tech_storageloc_01.png|center|550px]]
* Move the file MailStoreServer.lic (can be found in %programfiles%\deepinvent\MailStore Server\MailStoreServer.lic") to a save location (e.g. USB-Disk) before removing the directory %programfiles%\deepinvent\MailStore Server
+
* Follow these steps for the archive store you want to move:
* Install MailStore Server on the new machine. Choose "Existing Archive" and select the path to directory where you copied your archive to
+
:* Make note of the status and the path on disk. You can find this information in the summary next to the archive store list.
* Start Mailstore Server and install MailStoreServer.lic license file
+
:* 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.
  
== Move My Archive to external harddisk ==
+
== 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.
  
'''Q:''' It seem that My Archive has filled up my harddisk (C). How can I move it to an external harddisk?
+
When moving an archive store to a network share, the information from the article [[Using Network Attached Storage (NAS)]] are also applicable.
  
* '''MailStore Home'''
+
* Start the MailStore Client and log in as a MailStore user with administrative privileges.
:To migrate MailStore Home to a new location:
+
* Navigate to ''Administrative Tools > Storage > Storage Locations''.
:Stop MailStore Home
+
* Follow these steps for the archive store you want to move parts of:
:* Copy the archive directory (default in Windows 7: "C:\Users\\Documents\MailStore Home") and all subdirectories to the new location. Directory structure must be preserved. Current directory is shown in the MailStore Home Base Configuration utility
+
:* Make note of the status. You can find this information in the summary next to the archive store list.
:* Run the MailStore Home Base Configuration utility from the start menu and change the directory to the new location.
+
:* [[File:Tech_storageloc_03.png|right|350px]]Change the status to ''Disabled''.
:* Start MailStore Home again.
+
:* 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.
  
:There is also a MailStore Home Portable Version available as public beta, which lets you run MailStore Home directly from an external device without the need to install anything.
 
  
* '''MailStore Server'''
+
== Moving the Archive to a Different Hard-Disk ==
:To migrate MailStore Server to a new location:
+
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 MailStore Server Service, either trough the MailStore Basic Configuration or the service control panel
 
:* 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 MailStore Server Service again.
 
  
:'''Notice:''' Please be aware, that the throughput of the external harddisk may have a negative impact on the performance of MailStore.
+
* 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.
  
== How can I use an existing MailStore Home archive with MailStore Home Portable? ==
+
'''Notice:''' Please be aware that the throughput of an external hard-disk may have a negative impact on the performance of MailStore Server.
  
'''Q:''' I'd like to switch to MailStore Home Portable. How can I use an existing archive from my current MailStore Home installation with MailStore Home Portable?
+
'''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.
  
'''A:''' First, determine where the "old" email archive is located on your hard drive. The easiest way to do so is through Start -> Programs -> MailStore Home -> MailStore Home Configuration.
+
== 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.}}
  
Copy MailStore Home Portable to the USB hard drive by unzipping the .zip file downloaded earlier. A directory "Application" and a file "MailStoreHomePortable.exe" are created.
+
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.
  
Copy the directory of the old email archive to the same place and rename it "Data". You should be able to see the following directories and files should be on the USB hard drive:
+
'''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.
  
* Application
+
== Moving the Archive to a Network Share ==
* Data
+
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.
* MailStoreHomePortable.exe
 
  
Double-click on MailStoreHomePortable.exe to make sure that everything is in the right place.
+
* 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. <code>\\computer\myshare</code>.
 +
* 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]]
 +
[[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.