5.10 Migrating Associations

You can migrate user associations and workstation associations for bundles, user associations and workstation associations for policies, and workstation associations for images.

  1. Click stop listing the objects in the source zone icon (the Migration Tool Settings icon), then do the following:

    1. To overwrite existing associations in the ZENworks database, select the General option, then select the Overwrite objects that already exists option.

      WARNING:This overwrites any existing associations in the database, including those that were previously migrated.

      The Skip saving/loading history option allows you to dramatically improve performance on large migrations by not storing the local history.

    2. To access the options available for migrating associations, click Associations, then configure the desired settings.

      Setting

      Description

      If an associated object does not exist, stop the migration and prompt for redirection to the appropriate migration task to create the object

      Stops the migration when an object to be associated does not exist in the ZENworks database and prompts you to be redirected to the appropriate Migration Tasks step to migrate the object.

      After migrating the needed object, you can return to Step 6: Associations and click Migrate Now to resume migrating the associations.

      This option is useful for when you are migrating just a few items and want to deal with association failures on the spot.

      If you want to perform an unattended migration, do not select this option.

      Specify the context in the destination user source to search for the matching entities

      Lets you specify the context to search for the matching entities in the destination user source during the migration of the groups and container associations.

      For example, if the destination user source is migration.orgunit.org.com and you specify the context as OU1/OU2/users, then the utility looks for matching entities in migration.orgunit.org.com/OU1/OU2/users.

      If you do not specify the context, then the search is performed in the entire destination user source, that is migration.orgunit.org.com.

    3. Click Save Settings to exit the dialog box.

  2. Click Step 6: Associations in the Migration Tasks field.

  3. To model the migration, do the following:

    1. Select the desired options in the Display objects that are and the and also are drop-down lists.

      This option combination determines which associations are displayed for dragging to the Destination Zone panel and whether you want a warning displayed for ineligible associations. Warnings are displayed in a column on the Items to Migrate tab and the Migration History tab.

      Associations that can be migrated depend on whether their related eDirectory objects were migrated previously. You can display only those that are eligible for migration, as well as those that are both eligible or ineligible, with or without a warning about the ineligible associations.

      Display Objects That Are: These options allow you to choose which associations you want to search for at this time in the Source eDir Tree panel. You can continue to add associations to the Destination Zone panel as you change from one Display objects that are option to another, or you can migrate different groups of associations at a time. To stop listing of the objects in the Source eDir Tree, click stop listing the objects in the source zone icon

      The following options determine what associations are displayed:

      Option

      Purpose

      Bundles <--> users

      Displays only the associations existing in eDirectory for bundles and users or user groups.

      A user source must be configured in ZENworks Control Center before you migrate these associations.

      Bundles <--> workstations

      Displays only the associations existing in eDirectory for bundles, workstations, workstation groups, images, and workstations.

      Policies <--> users

      Displays only the associations existing in eDirectory for policies and users or user groups.

      A user source must be configured in ZENworks Control Center before you migrate these associations.

      Policies <--> workstations

      Displays only the associations existing in eDirectory for policies, workstations, and workstation groups.

      Policies, bundles, users, <--> workstations

      Displays all existing eDirectory associations for policies, bundles, users, user groups, workstations, workstation groups, and images.

      A user source must be configured in ZENworks Control Center before you migrate any user-related associations.

      And Also Are: These options do the following with respect to the combination that you select in the Display objects that are field:

      Option

      Purpose

      Either eligible or ineligible for migration (No Warning)

      For associations between the selected objects, this combination displays both the eligible and ineligible associations without any warning.

      This is the fastest method because no checking is required and it provides an unattended migration process.

      Eligible for migration

      Displays only the associations between the selected objects that are eligible for migration.

      If the migration source and user source are the same, then this is the slowest method because the utility must validate each item as it is queued. We recommend that you simply review the logs of the failed items to resolve why they did not migrate.

      Either eligible or ineligible for migration (Show Warning)

      For associations between the selected objects, this combination displays both the eligible and ineligible associations with a warning.

      If the migration source and user source are the same, then this is a slower method because checking is required for each item queued and you need to monitor the migration to respond to the warnings.

      Destination User Source: Lists the user sources available in ZENworks Configuration Management. By default, the user source that is listed as the migration source is selected.

    2. In the Source eDir Tree panel, navigate the eDirectory contexts to locate the objects to be associated and drag them into the Destination Zone panel.

      Specify the range of associations to be listed in the Listing Range option. The range is specified as 1-100 by default.

      This queues the items for migration.

      You can use the Ctrl and the arrow keys or Shift and the arrow keys to select multiple items.

      As you drag items from one panel to the other, the items listed in the Destination Zone panel are automatically sorted.

      If you drag an item multiple times, it is only queued once.

      If you migrate incrementally, you should queue only the objects that you want to migrate at this time because all items that are queued in the Destination Zone panel are migrated when you click the Migrate Now button.

      On the Items to Migrate tab, the number of items you are migrating (copied to the Destination Zone panel) is represented in parentheses on the tab’s label.

      The Migration Status field on the Items to Migrate tab displays information related to the items selected for migration. For example, the ZENworks Migration Utility might adjust the object name in Configuration Management because of characters in the eDirectory name that cannot be used in Configuration Management, such as a colon (:), which is replaced with an underscore (_) character.

  4. Repeat Step 3 as necessary to locate and queue all of the associations that you want to migrate at this time.

    IMPORTANT:Every association that you queue in the Destination Zone panel is migrated when you click the Migrate Now button.

  5. Review your selections in the Destination Zone panel.

    Specify the range of associations to be listed in the Listing Range option. The range is specified as 1-10 by default.

    In the Name column, the associations are represented with the association name that you queued, the <--> characters to represent an association, then the name of the object it’s associated with in eDirectory. This information is repeated in the Unique Identifier column with the fully distinguished object names.

    If the objects for the association (as determined by your selections in the Display objects that are and the and also are fields; see Step 3) do not each exist in the ZENworks database, the association cannot be migrated. If you selected in Step 1.b to be prompted to resolve this during migration, you can take care of those instances now; otherwise the migration continues and you can discover them on the Items to Migrate tab.

  6. To delete items from being associated, select the items and click the icon.

    You can use the Ctrl and the arrow keys or Shift and the arrow keys to select multiple items for deletion. This includes folders and their contents.

    Items queued for migration have their icons and texts dimmed. If you select dimmed items for deletion, they are only deleted from the queue.

    WARNING:If you select colored items (with teal or black text), they are deleted from the ZENworks database and are no longer available in ZENworks Control Center.

  7. To migrate all of the dimmed items displayed in the Destination Zone panel, including all dimmed items contained in subfolders, click the Migrate Now button.

    The following information applies to the Migration Utility during or after the migration process:

    • Focus is immediately moved to the Items to Migrate tab, where you can view the sequential progress of the migration.

    • The Step column displays a progress bar for each item being migrated. The overall progress bar is at the bottom of the screen.

    • The Migration History tab displays all of the items that were migrated. This list is updated dynamically as the items are migrated. You can safely click back and forth between the Items to Migrate and Migration History tabs during the migration process. You can also right-click anywhere in the tab’s panel and select Refresh to refresh the view with items that might not yet be displayed, but are migrated.

    • The Select tab displays all of the migrated associations, with their texts in teal color after being migrated, in both the Source eDir Tree and Destination Zone panels.

      The teal color persists, so the next time you open the Migration Utility and navigate the Source eDir Tree contexts and Destination Zone folders, you can see what you have previously migrated.

    • Associations that failed migration because their associated objects are not present in Configuration Management continue to be displayed with their icons dimmed.

      Instructions for handling failed migration items are covered in Step 8.

    • During migration, a temporary working folder is created on the workstation for each association being migrated. These folders are deleted as each association is successfully migrated.

    • During migration of groups and container associations, if there are more than one matching entity for the groups and containers in the destination user source, then you are prompted to select the entity to which you want to migrate the association.

  8. After the migration has completed, do the following as needed:

    1. Review the teal-colored items in both of the Select panels to determine whether you need to queue any other items for migration or delete any previously migrated items from the Destination Zone panel.

      You can also use the Migration History tab to discover this information.

      • If you discover other items to migrate, repeat Step 3 through Step 7.

      • To delete any items listed in the Destination Zone panel, select them and click .

        WARNING:The Destination Zone panel displays both previously migrated data with teal-colored text and items with black-colored text that were either created in ZENworks Control Center or migrated from a different workstation. The delete option () can be used on both. Therefore, it is possible to delete previously existing items from Configuration Management that were never migrated. This includes folders in ZENworks Control Center and all data contained under them.

    2. On the Items to Migrate tab, click the Failed - View Log button for each item that failed to migrate, and determine the best course of action. You can either fix the problem and migrate the item, or you can delete it from the Items to Migrate tab, which also deletes it from the queue in the Destination Zone panel.

      To view only those items that failed, right-click anywhere in the panel and select Delete successful to filter the listed items. This listing is maintained only for the current task.

    3. If you have failed items that you do not want to migrate, you can delete only those that are queued (still dimmed) from the queue in the Destination Zone panel. Right-click anywhere on the Items to Migrate tab and select Delete all items.

      This empties the Items to Migrate tab listing. It also deletes only the queued items not yet migrated from the Destination Zone panel listing.

      WARNING:If you select Delete all items in the Destination Zone panel instead, this deletes all listed items from both the Destination Zone panel and the Migration History tab, as well as from the ZENworks database, effectively removing them from ZENworks Control Center. To delete only the queued (not yet migrated) items by using Delete all items, it is safest to do so from the Items to Migrate tab.

  9. If you have completed all eDirectory object and association migrations, clean up your traditional ZENworks installation by continuing with Section 5.14, Managing Your Traditional ZENworks Installation.