27.5 Migrating the User Application Driver

When upgrading to a new version of Identity Manager or migrating to a different server, you might need to import a new base package for the User Application driver, or upgrade the existing package. For example, User Application Base Version 2.2.0.20120516011608.

When you begin working with an Identity Manager project, Designer automatically prompts you to import new packages into the project. You can also manually import the package at that time.

27.5.1 Importing a New Base Package

  1. Open your project in Designer.

  2. Right-click Package Catalog > Import Package, then select the appropriate package.

  3. (Conditional) If the Import Package dialog does not list the User Application Base package, complete the following steps:

    1. Click the Browse button.

    2. Navigate to designer_root/packages/eclipse/plugins/NOVLUABASE_version_of_latest_package.jar.

    3. Click OK.

  4. Click OK.

27.5.2 Upgrading an Existing Base Package

  1. Open your project in Designer.

  2. Right-click the User Application Driver.

  3. Click Driver > Properties > Packages.

    If the base package can be upgraded, the application displays a check mark in the Upgrades column.

  4. Click Select Operation for the package that indicates there is an upgrade available.

  5. From the drop-down list, click Upgrade.

  6. Select the version to which you want to upgrade. Then click OK.

  7. Click Apply.

  8. Fill in the fields with appropriate information to upgrade the package. Then click Next.

  9. Read the summary of the installation. Then click Finish.

  10. Close the Package Management page.

  11. Deselect Show only applicable package versions.

27.5.3 Deploying the Migrated Driver

The driver migration is not complete until you deploy the User Application driver to the Identity Vault. 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.

  1. Open the project in Designer and run the Project Checker on the migrated objects.

    For more information, see Validating Provisioning Objects in the NetIQ Identity Manager - Administrator’s Guide to Designing the Identity Applications. If validation errors exist for the configuration, you are informed of the errors. These errors must be corrected before you can deploy the driver.

  2. In the Outline view, right-click the User Application driver.

  3. Select Deploy.

  4. Repeat this process for each User Application driver in the driver set.