Archive Migrator Publication Date: December, 2015 All Rights Reserved. This software is protected by copyright law and international treaties. Unauthorized reproduction or distribution of this software, or any portion of it, may result in severe civil and/or criminal penalties and will be prosecuted to the maximum extent possible under the law.
Copyright All rights reserved. No part or section of the contents of this material may be reproduced or transmitted in any form or by any means without the written permission of Metalogix International GmbH. Archive Migrator is a trademark of Metalogix International GmbH. Windows SharePoint Services is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. Technical Support For information about Metalogix Technical support visit http://metalogix.com/support. Technical support specialists can be reached by phone at 1.202.609.9100. The level of technical support provided depends upon the support package that you have purchased. Contact us to discuss your support requirements.
Contents Introduction 4 Archive Migrator Checklist 5 Prerequisites 8 Installation 9... 9 Installation Steps... 13 Entering the License Key... 14 Online Activation... 15 Offline Activation... 16 Checking the Current Archive Migrator License... 17 Configuring the Proxy Setting... 18 Uninstalling Archive Migrator Page 3
Introduction Migrate and Archive Metalogix Archive Migrator migrates legacy email archives and live email using the multi-award winning Metalogix migration engine. Migrator is unobtrusive with nothing installed on the target, Exchange or source servers and can run as a background process, making it effectively invisible to the end-user of the legacy archive or live email system. Migrator is the combination of Metalogix Content Matrix and Archive Manager two of the most used and trusted SharePoint migration and Exchange archiving technologies available today. Compliance Metalogix Archive Migrator mitigates the risk and complexity of standard archive migration methods and provides a permanent chain of custody for legal compliance. Corporate email users require a dedicated archiving solution to meet ever growing compliance needs and manage large amounts of sensitive company information. A direct source to target migration provides organizations with a tamper-proof, high-speed flow of content whilst maintaining the necessary chain-of-custody for every item migrated. Results are summarized and presented in a postmigration audit log. Speed matters Metalogix Archive Migrator can be effortlessly backed-up, managed and monitored through the whole archive migration process. Multi-threaded migration tasks can be carried out in parallel on different servers, which improves migration speed whilst maintaining data integrity. The asynchronous migration architecture reduces the classic transfer bottlenecks and advanced scanning calculates the migration process for each archived item between the source and target. Legacy Archive Migration There are number of key factors that need to be considered when migration from existing email archiving solutions. Metalogix Archive Migrator carries out the email archive migration process while allowing end users continued access to important legacy email. The award winning migration tool guarantees high-performance and processes a wide range of granular criteria. Email is copied straight from the archived source and written directly into Archive Manager and shortcuts are converted on the fly. Administrators can instantly take advantage of the latest Archive Manager feature set including advanced storage management and mixed environment control. Before performing the migration we recommend you fill in the Archive Migrator NOTE: Checklist - handy simple table for relevant details of your environment crucial for successful migration. (See the next section.) Page 4
Archive Migrator Checklist Archive Migrator Version Server Name IP Address User Operating System (on machine where Archive Migrator will be installed): Windows 7, 2012R2 Windows 8, Windows 10, Windows 2008R2, 32bit Windows 2012, MS Outlook version (on machine where Archive Migrator will be installed): Outlook 2003 Outlook 2007 Outlook 2010 Outlook 2013 NOTE: 64bit Windows 32bit 64bit Outlook 2016 Outlook bitness should be the same as Operating System bitness, both should be either 32 bit or 64 bit. Archive Environment If you are planning a migration from an archiving system, please complete the Source archiving system information. If an archiving system is the desired target of the migration, please provide the information about the target system. Source archiving system Target archiving system Metalogix Archive Manager Version Web Server (name, IP address) Domain User Connection type http https http https SQL Connection If you are planning migration from and/or to an archiving system, please fill in the SQL connection details for archive system database. Page 5
Fill in where applicable Source system Target system MS SQL Server (name, IP address) MS SQL Server version Database Database schema MS SQL Server Authentication Windows SQL Windows SQL Login Exchange Environment Fill in where applicable Source system Target system MS Exchange Server (name, IP address) MS Exchange Version User Domain controller Domain Domain administrator Connection Type Exchange Web Services EWS Connection Type 1 2 http 1 2 MAPI (Redemption) https Exchange Web Services 1 2 MAPI (Redemption) http https Exchange 2007 and above Outlook is required on a machine where migration runs Archive Migrator server (Outlook bitness should be the same as Operating System bitness, both should be either 32 bit or 64 bit) Page 6
Public folders archived in source system: Yes No Testing mailbox for first migration: Archived Mailboxes Number of mailboxes: Total size in the source system: Page 7
Prerequisites Archive Migrator can be installed anywhere in the domain where the migration will take place. Supported OS: Windows 7 and Windows 8 (x86 and x64) Windows Server 2008 R2 and later Windows 8.1 (x86 and x64) Requirements:.NET Framework 3.5 SP1.NET Framework 4.5 Full Microsoft SQL Server Compact 4.0 (included in the setup) PowerShell 3.0 (it is already integrated with Windows 8 and Windows Server 2012; it needs to be installed in Windows 7 SP1 and Windows Server 2008 R2 SP1) Outlook: - ATTENTION: required only with Exchange 2003 SP2 optional with later Exchange Servers when installed, bitness must be the same as the OS bitness If you are using MAPI connection and the OS bitness is different than the Microsoft Office bitness, always run the x86 version of Archive Migrator..NET Framework 3.5 SP1 and PowerShell 2.0 (in case of Exchange 2003 environment) are deployed when you run the installation using the Metalogix Archive Migrator Installer_X.X.X_package.exe file. The significantly smaller Metalogix Archive Migrator Installer_X.X.X.exe setup does not contain these prerequisites. Be sure to have EmailXtender UnPackContainer utility installed on EmailXtender ATTENTION: machine (usually in "C:\Program Files (x86)\otg\emailxtender\bin\utils" folder). Minimal UnPackContainer.exe version necessary for migration is UnPackContainer.exe version 2.8. Page 8
Installation Archive Migrator can be installed using either the small installation file (Metalogix Archive Migrator Installer_X.X.X.exe) or significantly bigger one (Metalogix Archive Migrator Installer_X.X.X_package.exe). The bigger package file contains also necessary prerequisites so it is suitable for first installation. The additional prerequisites included in the package are as follows: -.NET Framework 4.5 Installation Steps 1. Copy the Metalogix Archive Migrator Installer_X.X.X.exe (or Metalogix Archive Migrator_X.X.X_package.exe) file to the machine where the Archive Migrator should be installed. 2. Close all other open applications, including Internet Explorer. 3. Open Windows Explorer to the folder containing the Metalogix Archive Migrator installer file. Double-click the Metalogix Archive Migrator Installer_X.X.X_package.exe to start the installation process. Because this installer requires an elevated set of permissions to run, if you do not have the required permissions a message will open informing you that elevated permissions are required. To run the installer with these elevated permissions, select the installer file, right-click and select the Run as administrator option. 4. The Metalogix Archive Migrator InstallShield Wizard opens. In the initial dialog click Next to continue. 5. The License Agreement opens. Read through the License Agreement. If you agree to the terms of the license agreement, click the I accept of the license agreement radio button. Then click Next to continue. Page 9
There is also a Print button on this screen if users would like to have a hard copy of the license agreement. If you do not agree to the terms of the license agreement, click the I do not accept the terms of the license agreement option, and the installation will be canceled. 6. If desired, in the new dialog change the installation directory or just click Next. Page 10
7. Now click the Install button to run the installation process. Page 11
8. The installation process will run, and the Archive Migrator will be installed. Once the installation process has been completed, click Finish to exit the InstallShield Wizard. If the Run Archive Migrator check-box is selected, the product console is launched for you. 9. When launching the Archive Migrator for the first time, a prompt is displayed to specify database where migration metadata will be stored. By default SQL database details are required, but SQL Server Compact database (installed by Archive Migrator) can be used as well. Remember that for migrations comprising more than 100,000 items, full SQL Server is the preferred option. To specify the database select: a) Use SQL Server database - to use installed SQL database; click the database icon on the right side to enter details and credential for the desired SQL server and database b) Use SQL Server Compact database - to use Archive Migrator installed database suitable for smaller migrations; its location can be changed by clicking the icon next to the path text box Page 12
Entering the License Key When launching the Archive Migrator for the first time (or launching it after your license has expired), you will be prompted to input an Activation License Key. If you are trying to install a new license key over an existing key you can do so by going to the ribbon and selecting Help > Update License. 1. In the license activation dialog, select I have a license key, and enter the license key, provided with your evaluation or commercial license activation email (the key can be copy and pasted into the provided space). Page 13
2. Next select the activation method. Most systems can use the Online activation method, as long as the system has internet access. In some cases users are unable to use the online activation due to security setting or no internet access. In these particular cases the Offline activation option can be selected. Online Activation 1. After the license key is entered, select the Online activation option. In some cases users may be trying to authenticate the key through a proxy. To do this click the Set proxy option. This option is not required in most standard cases. 2. Click Next. 3. The Archive Migrator will contact the licensing server and attempt to authenticate the license key. Once it is successful a Congratulations! message will be returned, and the license key will be active and in use. 4. Click Finish to complete the process. Page 14
Offline Activation This option is generally used in cases where users are unable to use the online activation, due to security setting or no internet access. This option will still require some internet access, but allows the authentication to be done from another machine, i.e. a machine that has internet access. 1. Select the Offline activation option. 2. Click Next. 3. A Generate Activation Request dialog will be displayed. In the Activation Request window of this dialog will be a different key. The key in this window cannot be edited. This key is used to help activate the license from another location. This key can either be copied from the window, or the Save to file option can be used to save the key into a text file (in case it needs to be copied to another machine). There is also an Activation URL listed under the Activation Request. Copy this URL to a web browser that has internet access. Alternately if the system the Archive Migrator is on does have internet access through a web browser, click Go to automatically open a web browser to this URL. Navigate to the Activation URL on a machine that has internet access. 4. On the Offline Activation page, in the web browser, enter the activation text into the Activation data text box. Or if the key was saved to a file, select Browse and navigate to the file with the activation text. 5. Once the text is entered, click Activate. 6. The screen will refresh, and an Activation Successful message should be listed next to the text box. The text box itself will have a new key entered in it. You can copy this text by either: o Clicking the Download file button. This will save the new authenticated license as a DAT file called "LicenseActivationResponse" to a location on that local system. o Clicking the Copy text button. This will attempt to copy the text onto the local systems clipboard, so it can be later pasted into the Archive Migrator, or pasted into another file. If the copy to the clipboard is successful, a message will be displayed stating "Activation Text successfully copied to the clipboard". Click OK to continue. o Manually copy the text, by right-clicking in the text box and using the Select all option, then right-click again and choose Copy. Once the authenticated license has been copied, return to Archive Migrator. 7. If still on the Generate Activation Request window, click Next. This should move to the Enter your Activation Response window. 8. Paste the new license key into this window (right-click inside the text box, and choose Page 15
Paste. Alternately if the license was saved to a file from the web page, the Load from file option can be used to navigate to, and select, the DAT file. This would then load the license. Once the license has been entered, click Next. 9. The authenticated license has now been entered into the Archive Migrator. A Congratulations! message will be returned, and the license key will be active and in use. 10. Click Finish to complete the process. Checking the Current Archive Migrator License In the event that a licensing change was made after the license key for Archive Migrator has been installed, or if users just want to check the current status of the license key, they can go to the About dialog. This dialog gives details about the current license key, such as the type of license, expiry date (if any), the number of servers used, the number of seats, any size limitations for the migration, and how many mailboxes has already been migrated. If any changes are made to the license key, this dialog can be updated. The steps to do this are below. 1. Page 16 In the Archive Migrator ribbon menu, go to Help and click the About button.
2. In the dialog that opens, click the Refresh button. This will force a refresh of this data from the licensing servers, and update the information. Note: If an Offline license is used, the offline key process will need to be used to do this update instead, unless the system the Archive Migrator is installed on has internet access. Configuring the Proxy Setting In most cases Archive Migrator can automatically authenticate license keys, through an environment's proxy setting, however, in some cases the proxy may need to be configured within the Archive Migrator. In these cases users can specify the proxy settings though the connecting dialog. This page will review how to set the proxy settings for these special cases. 1. Click the Set proxy link available next to the Activate Online option. Then in the pop-up check the Enable proxy option. 2. Enter the Server name and Port for the proxy. This text box allows users to specify the specific server name or IP for the proxy, and the specific port the proxy can be set in. 3. Next, specify the credentials to use when connecting. The credentials of the current user will be selected by default (the Window authentication credentials), and the Domain/ username is displayed beside the first radio button option. Alternatively, users can specify alternate credentials by clicking the Different user radio button, and entering an alternate username and password. 4. Once the proxy options are set (if there are any) select Set to return to the connection dialog. The proxy configuration should be complete, and users should be able to authenticate their Page 17
license key through this proxy. Uninstalling Archive Migrator It is recommended that uninstalling Archive Migrator should be initiated from the Metalogix Archive Migrator Installer_X.X.X.exe file. Using this method will automatically uninstall all components of the application. 1. Navigate to the location that contains the Metalogix Archive Migrator Installer_X.X.X.exe file. Run the EXE file. 2. The Metalogix Archive Migrator InstallShield Wizard opens. 3. Select the Remove radio button and click Next to continue the uninstallation. 4. Click Yes to confirm uninstallation. The Archive Migrator will be uninstalled. 5. After Finish is clicked the Metalogix Archive Migrator InstallShield Wizard will close. If the uninstallation of Archive Migrator is complete and no additional components need to be uninstalled. Page 18