4.1 Launching the Active Directory Migrator Console
To launch the Active Directory Migrator console:
1. Double-click the SMART AD Migrator Console desktop shortcut.
OR
Select SMART AD Migrator Console in the Start menu.
2. The SMART Active Directory Migrator screen appears briefly and the application opens.
The SMART AD Migrator Console will not launch until a license for AD Migration/Synchronization is applied in the SMART Directory Sync Console.
4.2 Refreshing Data
Use the Refresh button to refresh the data currently displayed in the table. The refreshed data will display all previous changes to the database and the currently available right click-options. All selected filter options will not be affected by refreshing.
To refresh the data displayed in the table:
1. Click the Refresh button .
4.3 Creating Mapping Files
Use the Create Mapping Files button to generate the User Mapping File (Map.usr) and Group Mapping File (Map.gg).
These files are automatically created during the ReACL process so the only time they need to be created manually is when re-permissioning SQL databases. This process is otherwise not required.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 38
To create the mapping files:
1. Click the Create Mapping Files button .
2. The Mapping Files window appears and displays the location of the created Map.usr and Map.gg files. Click OK.
Each time the Create Mapping Files process is run, the Map.usr and Map.gg files are overwritten.
If the Active Directory environment is non-English, the values in the sAMAccountName column of the
BT_SystemGroup table in the SQL database will need to be changed after SMART Directory Sync is installed to have the appropriate non-English values.
4.4 Migration Groups
Objects in the table can be grouped into Migration Groups for migration process management. Migration Groups allow you to filter and sync smaller groups of objects. An item can be part of a single Migration Group only.
To set Migration Group for objects:
1. Click on table rows to select one or more objects in the list. (Use Ctrl-Click to select more than one row.) 2. Right-Click to view the options menu and select Set Migration Group.
3. Select a migration group from the drop-down list or click New to create a new Migration Group for the selected objects. To remove a previously select migration group, select <None> from the drop-down list.
4. If creating a new Migration Group, enter a Migration Group Name.
5. Click Save. The Migration Group column is populated for the selected objects.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 39 Import Migration Groups
The import Migration Groups feature allows you to import a CSV file with objects and their matching migration groups
Duplicate objects in the CSV will not be stamped with a migration group.
Objects names can be the sAMAccountName (for Users, Rooms, Groups, and Devices) or the Distinguished Name (for Users, Rooms, Contacts, Groups, and Devices).
To import Migration Group values:
1. Click the Import Migration Groups button .
2. Select a CSV file containing the Migration Group names and click Open.
The CSV file should have two columns. The first column is Object Name and the second column is Migration Group Name. An example file is below:
jsmith,Windows 7 Group mjones,Windows 7 Group jtaylor,Windows 8 Group
An example file entry for Contacts is below:
CN=John Smith,DC=domain,DC=dom,Windows 7 Contacts
3. Click OK on the confirmation window. Click Export Results to export a file containing the matching results.
4.5 Using Blacklists
Objects can be added to the blacklist. Blacklisted objects will not be displayed unless the "Show Blacklisted" option is selected. Blacklisted objects cannot have actions performed on them, except Set Migration Group and Mark as Migrated.
To add objects to the blacklist:
1. Click on table rows to select one or more objects in the list. (Use Ctrl-Click to select more than one row.) 2. Right-Click to view the options menu and select Add to Blacklist. The selected objects are removed from the
displayed list.
3. Select the Show Blacklisted option to view the blacklisted objects.
To remove objects from the blacklist:
1. Select the Show Blacklisted option to view the blacklisted objects.
2. Click on table rows to select one or more objects in the list. (Use Ctrl-Click to select more than one row.)
3. Right-Click to view the options menu and select Remove from Blacklist. The selected objects are removed from the displayed list.
4. Deselect the Show Blacklisted option to view the non-blacklisted objects.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 40
4.6 Grouping, Sorting, and Filtering Tables
The data table can be grouped by column headers, sorted by column or filtered.
Grouping
To group the data table by column headers:
1. Click and drag a column header to the area above the column headers to group by that column header.
2. Click and drag additional column headers to create child groups.
3. To remove a grouping, rollover and click the "X" in the grouped by column heading.
Sorting
To sort the data table by column headers:
1. Click a column header to sort the table by the column in ascending order.
2. Click the column header again to sort the table by the column in descending order.
3. Click the column header a third time to remove the column sort and return to the default sort.
Filtering
To filter the data table with the column filters:
1. Click the filter icon in the column header. The filter options window appears.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 41
2. Select filter options and then click Filter. The table is updated as you select the options. The filter icon is darkened when applied.
3. To remove the column filter, click the filter icon and click Clear Filter.
4. To clear all column filters, click the Clear All Column Filters button or right-click on the header row and select Clear All Column Filters.
To filter the data table by DirSync Profile:
1. Select a profile from the DirSync Profiles drop-down list. The table is updated to display only objects associated with the selected DirSync profile. By default, objects from All Profiles are displayed.
To filter the data table by Migration Group:
1. Select a migration group from the Migration Group drop-down list. The table is updated to display only objects in the selected migration group. By default, objects from All batches are displayed.
4.7 Customizing Columns
The default data tables do not display every available column. However, the displayed columns can be customized. Also the column order can also be changed.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 42
To choose displayed columns:
1. Click the Choose Columns button in the table header or right click on the header row and select Choose Columns. The Choose Columns window appears.
2. Select the columns to display in the table.
3. Click OK. The table is updated with the selected columns.
To change the order of columns:
1. Click and drag the column header and drop it in a new location. The table is updated.
4.8 Selecting Multiple Table Rows
There are several ways to select multiple table rows.
To select all table rows:
1. Click the Select All button in the table header or use Ctrl+A. The first 1000 rows are selected by default.
By default, the first 1000 rows are selected. This setting can be changed in SQL in the ADM_Setting table field SelectAllLimit.
2. Perform a right-click action to the selected rows.
If attempting to select more than 1000 rows at time, perform the action on the first 1000, filter the list based on the action, and then select all again.
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 43
To select more than one table row:
o Use Ctrl+Click to select more than one row.
o Use Shift+Up/Down Arrow to select additional rows before or after the currently selected row.
o Use Shift+Pg Up/Pg Dn to select all rows before or after the currently selected row.
The following key shortcuts do not work: Shift+Ctrl+End, Shift+Ctrl+Home, Shift+Ctrl+Page Down, Shift+Ctrl+Page Up, Shift+Left Click, Click+Shift+Left Click.
4.9 Triggering a Sync
Use the Sync button to sync the data currently displayed in the table. Select a different DirSync Profile before starting a sync to synchronize just that configured Source to Target. If All Profiles is selected, all of the DirSync AD Migrator profiles will be synchronized. If the DirSync AD Migrator profile has been set to synchronize on a schedule, manually starting a sync is not necessary.
Only objects marked as "Ready to Sync" will be synced to the target.
To sync the data displayed in the table:
1. Click the Sync button .
2. After clicking the Sync button the following confirmation for the synchronization of the selected DirSync Profile will be displayed.
3. If All Profiles are selected the prompt will appear as follows:
4. If a sync is already running the following will be displayed:
SMART ACTIVE DIRECTORY MIGRATOR 9.2 USER GUIDE 44
4.10 Exporting the Grid
The view as it is currently sorted and filtered can be exported to a file.
To export the grid:
1. Click the Export Grid button .
2. Click OK on the Export All? confirmation window.
Select a location, enter a file name, select a type and then click