Role Service drivers are not migrated. If you have an existing Role Service driver for version 3.6, you must create a new one for version 3.6.1.
Migrating the User Application driver ensures that the driver contains the necessary configuration for new features, maintains support for existing configurations (for example, custom entities and provisioning request definitions), adds new driver properties, and updates the following:
Directory abstraction layer definitions
Provisioning request definitions
Several non-visible runtime configuration objects
You can set preferences for migrating the User Application driver (see Setting Provisioning View Preferences
in the Identity Manager User Application: Design Guide.
The User Application driver migration utility migrates only the User Application configuration of the User Application driver. It does not migrate the entire driver. Specifically, it doesn't migrate policies. These are handled by the general Designer and the deploy code.
Make a backup copy of the provisioning project that contains the User Application driver to migrate:
Right-click the name of the project in Project view, then select .
In the Copy Project dialog box, type a new (or accept the default name), then click .
Use one of the following methods to run the Migrate command for the User Application that you want to migrate.
In the , right-click the name of the User Application driver and select .
In the view, right-click the name of the User Application driver and select .
In the view, right-click the name of the User Application driver, and select .
This migrates the local definition of the driver found in the Designer workspace. These changes are not made to the Identity Vault until after you deploy the changes.
If the dialog box displays, select .
If you have unsaved work in an open editor, the dialog box displays.
If the dialog box is displayed, select to save changes in open editors.
If you are prompted for a driver version to migrate to, select , then click .
Designer warns you that schema changes are required in the Identity Vault, select to continue the migration (if you have already updated the Identity Vault schema in a separate process), or select to cancel the migration (if you have not already updated the Identity Vault schema).
See “Prerequisites” in the Roles Based Provisioning Module 3.6.1 Installation Guide for information about how to make schema changes. This is especially important if you are using the 3.5.1 IDM metadirectory because you must perform manual installation of new schema and driver configuration files for the 3.6.1 Roles Based Provisioning Module to work properly.
When the migration completes, Designer displays a dialog box listing information, warnings, and errors encountered during migration. For example, for all objects added during migration, informational text displays for those objects. You can perform several operations by using this dialog box:
The migration does not automatically save a log file describing the content of the dialog box to the project-name/Provisioning/AppConfig folder for the associated User Application. You can manually save it here. The default name of the file is migrationLogdate.log. You can also save the migration log to a file anywhere on disk by clicking the floppy disk icon in the upper right corner of the dialog box.
To revert to the original User Application configuration (for example, if errors occurred during the migration) click the button.
You can undo the migration until you click in the dialog box.
To deploy the driver, you can select ; or, if you want to deploy the driver later after validating the project using the project checker, follow the steps in Deploying the Migrated Driver to complete the process.
NOTE:When you migrate a driver, ensure that all other drivers in the same driver set are also migrated to the same version.
The driver migration is not complete until you deploy the entire driver to the Identity Vault.
Open the project in Designer and run the Project Checker on the migrated objects.
See “Validating Provisioning Objects” in the User Application: Design Guide. If validation errors exist for the configuration, you are informed of the errors. These errors must be corrected before you can deploy the driver.
Navigate to the Outline view, right-click the driver, and select , or in the Modeler view, right-click the driver and choose .
After the migration, the project is in a state in which only the entire migrated configuration can be deployed. You cannot import any definitions into the migrated configuration. After the entire migration configuration has been deployed, this restriction is lifted, and you can deploy individual objects and import definitions.
Repeat this process for each User Application driver in the driver set.