Chat now with support
Chat with Support

Migrator for GroupWise 4.7 - Administration Guide

About this guide AddProxy utility Directory Exporter AD Object Merge Tool Administrator-Driven Batch Migrator
Why and when to use the Admin-Driven Batch Migrator Before running the Admin-Driven Batch Migrator ... Online search feature Per-screen instructions and application notes Did it work? Remember to distribute any user .pst files
The Log Viewer Office 365 Admin Account Pool Utility Discovery utility

Migrating to Office 365 with Microsoft's DirSync

Migrating to Office 365 with Microsoft’s DirSync

The Exchange Administrative Operations screen offers the below options when migrating to Office 365 and using Microsoft’s DirSync tool to provision Office 365 from a local AD. You may select any number and combination of features you like, except: 

IMPORTANT: You must Prepare local AD accounts for MS Online Service DirSync separately, before you run the program for any other function. When you select Prepare local AD accounts, all other options are disabled (grayed out); when you select any other option, the Prepare Local AD accounts option is disabled.
Prepare local AD accounts for MS DirSync: Prepares the accounts in your local AD to be provisioned into the Office 365 AD by Microsoft's DirSync tool. This is a necessary administrative step that must precede your running the MS DirSync. After running the MS DirSync, you must then run this Batch Migrator program again and select Set Office 365 resource capacity (next item below) to complete mailbox-enabling in Office 365.
Set Office 365 resource capacity: Reads (from the local AD) the capacities of all resource objects in the user-list .csv, and then copies that information to the corresponding object records in Office 365. Do not select this operation until you have completed the Prepare local AD accounts operation (above) and successfully run MS DirSync.
Set forwarding from Exchange to GroupWise: Tells the program to display a screen (later in the program sequence) to set mail-forwarding rules from the target back to the source, for all users in the user-list .csv file. Typically set when target AD objects are mail-enabled but not yet migrated, so Exchange will correctly route mail to users who are still active in GroupWise.
Remove forwarding from Exchange to GroupWise: Tells the program to display a screen (later in the program sequence) to remove mail-forwarding rules from the target back to the source, for all users in the user-list .csv file. Typically selected when users are migrated to Exchange, to remove the forwarding rules that previously (before they were migrated) routed mail to them in GroupWise.
Remove user free/busy forwarding to GroupWise: Tells the program to remove forwarding of CMG free/busy queries to GroupWise for all users in the user-list .csv file. Typically selected when users are migrated to Exchange, to remove the forwarding rules that previously (before they were migrated) routed F/B queries for them to GroupWise.
Remove directory synchronization exclusion: Removes the attribute value (in AD) that disables dirsyncs in the Exchange-to-GroupWise direction by Quest CMG Directory Connector. Removing the attribute (by this feature) enables bidirectional dirsyncs, including in the E-to-G direction. For more information, see the CmgExcludeFromDirSync parameter notes in the Migrator for GroupWise Program Parameters Reference.

Select any number and combination of features you like, and then click Next.

Migrating to Office 365 without Microsoft's DirSync

Migrating to Office 365 without Microsoft’s DirSync

The Exchange Administrative Operations screen offers these options when migrating to Office 365 and provisioning directly ffrom Migrator for GroupWise to Office 365 (without Microsoft’s DirSync tool):

Set forwarding from Exchange to GroupWise: Tells the program to display a screen (later in the program sequence) to set mail-forwarding rules from the target back to the source, for all users in the user-list .csv file. Typically set when target AD objects are mail-enabled but not yet migrated, so Exchange will correctly route mail to users who are still active in GroupWise.
Remove forwarding from Exchange to GroupWise: Tells the program to display a screen (later in the program sequence) to remove mail-forwarding rules from the target back to the source, for all users in the user-list .csv file. Typically selected when users are migrated to Exchange, to remove the forwarding rules that previously (before they were migrated) routed mail to them in GroupWise.
Remove user free/busy forwarding to GroupWise: Tells the program to remove forwarding of CMG free/busy queries to GroupWise for all users in the user-list .csv file. Typically selected when users are migrated to Exchange, to remove the forwarding rules that previously (before they were migrated) routed F/B queries for them to GroupWise.
Remove directory synchronization exclusion: Removes the attribute value (in AD) that disables dirsyncs in the Exchange-to-GroupWise direction by Quest CMG Directory Connector. Removing the attribute (by this feature) enables bidirectional dirsyncs, including in the E-to-G direction. For more information, see the CmgExcludeFromDirSync parameter notes in the Migrator for GroupWise Program Parameters Reference.
Create Office 365 accounts: Creates a new O365 Exchange mailbox and sets user properties for each user in the designated users .csv file.
Manage password and license for Office 365 users: Select this checkbox to display (later in the program sequence) the Select Office 365 Administrative Operations screen. From that screen, you can reset user passwords and specify licensing options.

Select any number and combination of features you like, and then click Next.

10: Select Office 365 Administrative Operations

This screen appears if you selected the Manage password and license for Office 365 users checkbox on the Exchange Administrative Operations screen. It lets you select these options:

Reset user passwords: Resets the user passwords for mailboxes in the user-list .csv file. This function assigns random one-time-only passwords that let a user logon to Office 365 the first time, and then he/she must reset the password to something more durable and memorable.
Assign user licenses: When this checkbox is selected, Migrator for GroupWise performs a new O365 user licensing operation.
IMPORTANT: The Admin-Driven Batch Migrator reads a mandatory program parameter to get the two-character Usage Location code that Microsoft requires for its Office 365 licenses (per this Microsoft article). Be sure to set a value for:

... in Migrator for GroupWise’s gwmigapp.ini configuration file before you try to License users. The parameter value must be a two-letter keyword, which must conform to the standardized values listed for ISO 3166-1-alpha-2.

NOTE: If this O365 licensing feature returns a Multiple Account- Skus error (in the log), then the Batch Migrator has detected multiple accounts and requires that you specify just one for this feature. Use the Get-MsolAccountSku cmdlet to retrieve the AccountSkuIds for all valid licenses, then review the list and pick the one you want to use. Specify the license you want in Migrator for GroupWise’s gwmigap.ini configuration file:
License users: Select this option to assign licenses to users. The following checkboxes allow the administrator to specify which service plans are available to licensed users:
Note that SharePoint Online is a prerequisite service plan for Office Web Apps.
Unlicense users: Select this option to remove user licenses.

11: Specify Active Directory Information

This screen appears only if the Exchange administrative functions, Migrate users or Provision distribution groups option was marked on screen #2: Select Operations. Specify the Active Directory server, and provide the administrator credentials and other information the program will need to manipulate Active Directory accounts, and click Next.

Global Catalog: Type the name of the AD Global Catalog server—for example, servername.mydomain.com.
Domain Controller: Specify the PowerShell Domain Controller that the program will call to perform operations.
Client access server (appears only if migrating to Exchange 2013 or 2010): Name of the target Exchange client access server.
User name: The user name of the administrator by whose authority the program will perform its functions.
Password: The password for the admin User name cited above.

The last two fields may or may not appear grayed out (unavailable), depending on whether you are migrating users or PDLs in this program run:

How users were loaded into Active Directory (only if migrating users, not PDLs, in this program run): Use the drop-down list box to specify the method by which user data was loaded into AD. In a typical migration scenario (documented in chapter 1), user data is loaded into AD by Quest Migrator for NDS + Object Merge. If you are following that typical scenario, select that option from the drop-down list box. Otherwise, use the list box to specify the alternate method by which user data was loaded into AD.
Path to an existing organizational unit for distribution groups (only if you are migrating PDLs, not users, in this program run): Type the groups' OU path into the text box. Then, when you click Next, if you are migrating only PDLs you may skip ahead to screen #22: Specify GroupWise Domain Path (the intervening screens do not apply and will not appear).

When you click Next from this screen, the program scans the associated user-list .csv file and compares that information to your program entries to see if it can identify any conflicts or other issues.

If no such problems are apparent, the program simply advances to the next screen (skip ahead to the next screen below). But if it does find a problem, it notifies you in User-list error dialog box.

In the dialog box: Click the View button to see a .csv file listing of errors and warnings. The program will save the .csv file to your Quest admin directory by appending "-error" to the same filename as your current user list.

Review the list, and decide whether you want to continue or abort the run:

To continue the program run: In the User-list error dialog box, click OK to dismiss the dialog box and advance to the next screen.
To abort the program run: In the User-list error dialog box, click Cancel to dismiss the dialog box and return to the previous program screen. Then click the Cancel button to abort the program run.
Related Documents