Migrator Pro for Exchange 20.11.1 - Installation and Configuration Guide

2.3 Migrator Pro for Exchange Default Installation

2.3 Migrator Pro for Exchange Default Installation

To run the Default Installation option in the Installation wizard:

1. Once the PowerShell commands are successfully executed, navigate to the folder where you saved the Migrator Pro for Exchange Installation files, then right-click on the Migrator Pro for Exchange Install file and select to Run as Administrator.

2. 
   Click Run on the security warning, and then click Next on the Welcome screen:

    

3. 
   The wizard then prompts you to review and accept the Migrator Pro for Exchange license and maintenance agreement. To accept the agreement, select the I accept… radio button and click Next.

    

4. If you accept the license terms the wizard then prompts you to choose between Default Installation and Advanced Installation. Click on the Default Installation option.

    

The wizard then scans your environment to gather the information it needs, and to determine whether you need to install any of several required accessory applications.  A progress meter shows the wizard’s progress:

These accessory components are required for the Migrator Pro for Exchange installation:

• Windows features IIS and .NET Framework 4.8 full

• SQL Server 2022 Express

  • [local]\SQLEXPRESS installs as a named instance using the format servername\SQLExpress

  • Installs in Mixed mode with install account as SA, and local SA password is Password1

• Microsoft Online Sign-on assistant

• Azure AD PowerShell module

  If you already have these accessory apps installed, you can just skip ahead to the next step below. Otherwise, the Migrator Pro for Exchange installer will prompt you to authorize the installation of the ones you need.  In that case, click the Install button to accept. If you have to install Microsoft .NET 4.8 Framework, you may also be prompted to accept Microsoft’s license agreement.  If so, mark the checkbox for I have read and accept…, and click Install.

  The installation of accessory applications may take several minutes.  Some of the newly installed components may then require a system reboot, in which case the wizard will also prompt you to authorize the reboot.  Click Yes to authorize the reboot.  If you do have to reboot, the wizard will automatically resume at the next screen in this process (next step below).

5. 
   The wizard then prompts you for the login credentials Migrator Pro for Exchange should use for its MCP Service and the Migrator Pro for Exchange AppPool.  Enter the credentials and click Next.

The installation resumes when you click Next, and a progress meter shows the progress, and notifies you when the installation is complete:

6. Click the Finish button to close this portion of the wizard. Another progress meter shows the process progress through this last phase of the installation, and the wizard then notifies you when the process is complete:

7. Click this Finish button to close the Migrator Pro for Exchange Installer.

Now that the physical installation is complete, see section 3 below to configure Migrator Pro for Exchange for your environment and purposes. The first time you run the Migrator Pro for Exchange Admin Portal after this installation, Migrator Pro for Exchange will prompt you to define your target forest.

2.4 Migrator Pro for Exchange Advanced Installation or Upgrade

2.4 Migrator Pro for Exchange Advanced Installation or Upgrade

To run the Advanced Installation option in the Installation wizard (for either a fresh installation or an upgrade):

1. Once the PowerShell commands are successfully executed, navigate to the folder where you saved the Migrator Pro for Exchange Installation files, then right-click on the Migrator Pro for Exchange Install file and select to Run as Administrator.

2. Click Run on the security warning, and then click Next on the Welcome screen:

   

3. 
   The wizard then prompts you to review and accept the Migrator Pro for Exchange license and maintenance agreement. To accept the agreement, select the I accept… radio button and click Next.

    

4. If you accept the license terms the next prompt asks you to choose between Default Installation and Advanced Installation. Click on the Advanced Installation option.

The wizard then scans your environment to gather the information it needs for installation, and to determine whether you also need to install any required accessory applications.  A progress meter shows the progress:

These accessory components are required for the Migrator Pro for Exchange installation:

• Windows features IIS and .NET Framework 4.8 full

• Microsoft Online Sign-on assistant

• Azure AD PowerShell module

  If you already have these accessory apps installed, you can just skip ahead to the next step below. Otherwise, the Migrator Pro for Exchange installer will prompt you to authorize the installation of the ones you need.  In that case, click the Install button to accept. If you have to install Microsoft .NET 4.8 Framework, you may also be prompted to accept Microsoft’s license agreement.  If so, mark the checkbox for I have read and accept…, and click Install.

  The installation of accessory applications may take several minutes.  Some of the newly installed components may then require a system reboot, in which case the wizard will also prompt you to authorize the reboot.  Click Yes to authorize the reboot.  If you do have to reboot, the wizard will automatically resume at the next screen in this process (next step below).

5. 
   On the installation wizard Welcome screen, click Next.

6. 
   On the Destination Location screen, select the destination folder for the installation and then click Next.

7. 
   On the Database Server Login screen, select or browse to the Migrator Pro for Exchange database server you are installing to, select the connection authentication method, and enter the Name of database (or Browse to it and select it). Then click Next.

8. 
   The Database Server Login screen appears again, this time for the Migrator Pro for Exchange Logging Database. Select or browse to the logging database server you are installing to, select the connection authentication method, and enter the Name of database (or Browse to it and select it). Then click Next.

9. On the Passphrase screen, enter a passphrase to secure secrets stored in the SQL database. Then click Next. Store this phrase in a secure place for future reference. This phrase will be needed for all installations that access the SQL database.

   

10. On the Login screen, enter the User Name and Password to use for the Binary Tree Migrator Pro for Exchange MCP Service and Migrator Pro for Exchange AppPool and then click Next.

11. 
    On the Migrator Pro for Exchange Administrative Group screen, enter an Active Directory Security Group to limit access to the Migrator Pro for Exchange Admin Portal, and then click Next. Note that E2E_Admins is the default group but a different group name can be entered.

12. 
    On the Ready to Install the Program screen, click Install.

    The installation process may take a few minutes, and the window shows a progress meter while you wait.

    Click Cancel if you want to cancel. The installer will first check to determine if the server has adequate disk space, and will alert you if there is not enough space available for installation.

13. 
    When installation is complete, the wizard Complete screen appears. Click Finish to close the installer program and return to the Migrator Pro for Exchange Installer.

14. And click Finish again to close the Installer.

When the installation completes, the wizard creates a shortcut icon on the Desktop to launch Migrator Pro for Exchange. This entry is also added to the Windows Start menu along with entries for the Migrator Pro for Exchange Worker.

Now that the physical installation is complete, see section 3 below to configure Migrator Pro for Exchange for your environment and purposes. The first time you run the Migrator Pro for Exchange Admin Portal after this installation, Migrator Pro for Exchange will prompt you to define your target forest.

2.5 Uninstalling Migrator Pro for Exchange

To uninstall Migrator Pro for Exchange, go to Programs and Features from the Windows Control Panel:

1. Click Start, and then click Control Panel.

2. Click Programs and Features, and then select Migrator Pro for Exchange from the list.

3. Click Uninstall. Uninstalling Migrator Pro for Exchange also uninstalls Migrator Pro for Exchange Worker that is installed on the Migrator Pro for Exchange console.

4. Click Yes.

5. Click Finish.

3. Configuring Migrator Pro for Exchange

The first time you run the Migrator Pro for Exchange Admin Portal after installing the software (in section 2 above), Migrator Pro for Exchange will prompt you to define your target forest.  Your target forest can reside in a local Exchange environment, or may be a tenant forest in Office 365.

Use the New Forest wizard to define your target forest.

Double-click the Migrator Pro for Exchange shortcut on the Desktop, or Migrator Pro for Exchange in the Windows Start menu.

The Admin Portal opens, and Migrator Pro for Exchange starts its New Forest wizard with the Migrator Pro for Exchange License screen: