51.7 Upgrading the Identity Manager Drivers

Starting with Identity Manager 4.0.2, NetIQ delivers new driver content through packages instead of through driver configuration files. You manage, maintain, and create packages in Designer. Although iManager is package-aware, Designer does not maintain any changes to driver content that you make in iManager. For more information about managing packages, see Managing Packages in the NetIQ Designer for Identity Manager Administration Guide.

NOTE:If you upgrade the 3.x version of the User Application driver to the User Application version 4.0.2 package, Designer installs both 3.x and 4.0 versions of the same driver policies. Having both 3.x and 4.0 policies within the package catalog might cause Designer to not function properly. Delete the version 3.x policies and retain the version 4.0 policies.

You can upgrade your drivers to packages in the following ways:

51.7.1 Creating a New Driver

The simplest and cleanest way to upgrade drivers to packages is to delete your existing driver and create a new driver with packages. Add all the functionality you want in the new driver. The steps are different for each driver. For instructions, see the individual driver guides on the Identity Manager Drivers documentation website. The driver now functions as before, but with content from packages instead of from a driver configuration file.

51.7.2 Replacing Existing Content with Content from Packages

If you need to keep the associations created by the driver, you do not need to delete and re-create the driver. You can keep the associations and replace the driver content with packages.

To replace the existing content with content from packages:

  1. Create a backup of the driver and all of the customized content in the driver.

    For instructions, see Section 50.3.2, Exporting the Configuration of the Drivers.

  2. In Designer, delete all objects stored inside of the driver. Delete the policies, filters, entitlements, and all other items stored inside of the driver.

    NOTE:Designer provides the auto-import facility for importing the latest packages. You do not need to manually import the driver packages into the package catalog.

    For more information, see Importing Packages into the Package Catalog in the NetIQ Designer for Identity Manager Administration Guide.

  3. Install the latest packages to the driver.

    These steps are specific for each driver. For instructions, see each driver guide at the Identity Manager Drivers documentation website.

  4. Restore any custom policies and rules to the driver. For instructions, see Section 51.9, Restoring Custom Policies and Rules to the Driver.

51.7.3 Keeping the Current Content and Adding New Content with Packages

You can keep the driver as it currently is and add new functionality to the driver through packages, as long as the functionality in packages does not overlap the current functionality of the driver.

Before you install a package, create a backup of the driver configuration file. When you install a package, it can overwrite existing policies, which might cause the driver to stop working. If a policy is overwritten, you can import the backup driver configuration file and recreate the policy.

Before you begin, make sure that any customized policies have different policy names than the default policies. When a driver configuration is overlaid with a new driver file, the existing policies are overwritten. If your custom policies do not have a unique name, you will lose them.

To add new content to the driver with packages:

  1. Create a backup of the driver and all of the customized content in the driver.

    For instructions, see Section 50.3.2, Exporting the Configuration of the Drivers.

    NOTE:Designer provides the auto-import facility for importing the latest packages. You do not need to manually import the driver packages into the package catalog.

    For more information, see Importing Packages into the Package Catalog in the NetIQ Designer for Identity Manager Administration Guide.

  2. Install the packages on the driver.

    For instructions, see each driver guide at the Identity Manager Drivers documentation website.

  3. Add the desired packages to the driver. These steps are specific for each driver.

    For more information, see the Identity Manager Drivers documentation website.

The driver contains the new functionality added by the packages.