MTK Installation

Preparing the Migration Workstation

The Migration Toolkit needs to connect to the GroupWise system and the Exchange/O365 system. You can set up one or more workstations to run the migration on.

Before beginning any migration you must prepare the migration workstation.

Prerequisite Software

On a Windows 7 SP1 make sure you have installed ALL the following prerequisite software and must be installed to the C: drive:

• Microsoft .NET 4.6.1 or higher
• Windows Management Framework 3.0 or higher

On a Windows 10 Enterprise 64-bit workstation make sure you have installed ALL the following prerequisite software and must be installed to the C: drive:

• Microsoft .NET 4.6.2 or higher (install from Windows Features, required for WMF 5.1)
• Windows Management Framework 5.1 or higher (install from Windows Features)

User Migrator and Email Migrator

• GroupWise client (Client version must match server version)
• A program to edit .CSV files (such as OpenOffice or LibreOffice as Excel does not save to CSV easily)
• Java 8 (64-bit required for 64-bit migration, 32-bit for the 32-bit version of the tool)

If creating users in On-Premise Active Directory/Exchange, install:

• Remote Server Administration Tool
• The Windows Features required on the workstation are enabled through the Control Panel. Without the Windows features enabled, the Toolkit will fail to function.

Control Panel | Programs and Features | Turn Windows Features On or Off  

• • Active Directory Module for Windows PowerShell
  • Active Directory Administrative Center
  • AD DS Snap-Ins and Command-line Tools

If creating users in Office365, install:

• Microsoft Online Services Sign-In Assistant for IT Professionals
• Windows Azure AD Module for Windows PowerShell

GroupWise to PST Migrator

On a Windows 7 SP1 or Windows 10 64-bit workstation make sure you have installed ALL the following prerequisite software and must be installed to the C: drive:

• Microsoft .NET 4.6.1 or higher (installed by default in Win10 64-bit)
• Java Runtime Environment 1.8 or higher
• GroupWise Client 7, 8, 2012 or 2014
• Outlook 2010, 2013, or 2016 (32-bit)

Migration Toolkit Installation

Once the requirements have been installed and configured, the system is ready for installation. The installation of the Migration Toolkit is very simple; run the Migration Toolkit Setup and follow the prompts.

• The setup wizard provides clear instructions on what is going to be installed.
• Select ‘Next’ to continue.
• Read and accept the terms of the License Agreement then select ‘Next’ to continue.
• The System Requirements is simply a reminder for purposes of the installation.
• The destination folder is default and all other information gathered is displayed. If any of the data is incorrect, select ‘Back’ and correct the information.
  • The program needs to be installed to the C: drive.
• To begin the installation, select ‘Next’.
• Select the desired components to install. The installation can be performed for a full, custom, or minimal installation. Select the desired components to install and select ‘Next’.
• Choose whether to create a start menu folder, and what it should be named. When finished, select ‘Next’ to continue.
• Select whether to include Desktop and Start menu icons, then select ‘Next’ to continue.
• The summary of the installation configuration is displayed. Review and make sure that all information provided is as desired, then initiate the install by selecting the ‘Install’ button.
• Once initiated, the program will be installed.
• On completion, the installation utility reports on the installation. Select ‘Finish’ to exit the installation program.
• To start the Toolkit, select either the start menu or the shortcut icons on the desktop. Make sure to select the desired tool for the toolkit.

Register License

The migration tool kit will not function until a valid license is applied. You may contact sales to acquire a license key.

Once you receive the email with the license validation key go to licenses.gwava.com [1]] and choose: RETAIN GW to Exchange, Personal Archive to PST and eDirectory to Active Directory Migration Tools

Enter your credentials, the GroupWise Trusted Application Key and Tree Name created in GroupWise System Preparation step 3. Be sure the TAK is exactly the same before hitting next. This will be locked into the license, and will need to be changed by licensing if it is incorrect.

Download the license .PEM file and then import into the User Migrator tool.

Install License

The first thing to do is install the license into the User Migrator Tool.

• Launch the User Migrator Tool
• Click on Configuration | License and import the license into the toolkit.

---

Back to MTK_Setup