10.6 Upgrading the Identity Manager Drivers

NetIQ delivers new driver content through packages. 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 Understanding Packages in the NetIQ Designer for Identity Manager Administration Guide.

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

10.6.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.

10.6.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 Exporting the Driver Configuration.

  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 Restoring Custom Policies and Rules to the Driver.

10.6.3 Keeping the Current Content and Adding New Content with Packages

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 Exporting the Driver Configuration.

    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.