6.2 Installing or Upgrading Packages

Use the following list of tasks to install, add, upgrade, or import packages. For information about creating or copying packages, see Developing Packages.

6.2.1 Installing Packages

You can install packages on Identity Vaults, on driver sets, or on drivers. You can verify the packages have been imported by following the instructions in Importing Packages into the Package Catalog.

There are three different types of packages based on the package are installation target: Identity vault packages, driver set packages, and driver packages.

Driver packages are further grouped as:

  • Driver Base Configuration Packages: Contains the base functionality for a driver. You must install a driver base configuration package first.

  • Mandatory Features Packages: If there is a feature that is required for a driver to function, but is not included in the driver base configuration package, it is added to a mandatory features package.

  • Optional Features Packages: Contains features for a driver that aren’t mandatory for the driver to function.

To install packages on an existing Identity Vault, driver set, or driver, see Adding Packages.

To install a new driver, including the packages that make up the driver, use the following procedure:

  1. Drag and drop an application from the Palette into the Modeler.

    or

    Right-click the driver set in either the Outline view or in the Modeler, then click New > Driver.

  2. Click the check box next to the base package you want install, then click Next.

    NOTE:You can only install one base package per driver.

    Selecting a base package
  3. (Conditional) If you want to install any of the available optional features for the base package you selected, ensure the check box next to those packages is selected. Most options are selected by default because they are recommend for the driver.

    NOTE:In most installations, we recommend installing all optional features.

    Selecting optional packages

    Optional packages are grouped by feature. You can expand features to see the specific packages installed for each. You must select a feature to install the packages for that feature.

  4. (Conditional) If you do not want to install a particular optional feature, clear the check box for that package.

  5. Click Next.

  6. (Conditional) If the base package requires a dependent package, Designer prompts you to install the dependent package. Select the dependent package, then click OK.

  7. Respond to any prompts, if necessary, then click Next.

    The prompts are specific for each driver. Each driver guide contains the specific instructions for that driver. See the Identity Manager Driver guides Web site for the specific driver information.

  8. Review the installation summary, then click Finish.

After the packages are installed, the driver contains the functionality included in the packages.

6.2.2 Adding Packages

You can add new functionality to an existing driver by adding new packages to an existing Identity Vault, driver set, or driver.

  1. Right-click the Identity Vault, driver set, or driver, then click Driver > Properties.

  2. Click Packages, then click the Add Packages icon Selecting optional packages.

  3. Select the packages to install. If the list is empty, there are no available packages to install.

  4. (Optional) Deselect the Show only applicable package versions option, if you want to see all available packages.

    This option is only displayed on drivers. By default, only the packages that can be installed on the selected driver are displayed.

  5. Click OK.

  6. Click Apply to install all of the packages listed with the Install operation.

  7. (Conditional) Fill in the prompts with appropriate information to install the package, then click Next.

    Depending on which package you selected to install, you might have fields that you must fill in. For detailed information about the fields, see the specific driver guide at the NetIQ Driver Guides documentation Web site.

  8. Read the summary of the installation, then click Finish.

  9. Click OK to close the Package Management page after you have reviewed the installed packages.

  10. Repeat Step 1 through Step 9 for each Identity Vault, driver set, and driver where you want to add the new packages.

6.2.3 Upgrading Installed Packages

Designer provides the ability to upgrade the installed packages in two ways:

Using the Package Upgrade Method from the Properties Page

You can upgrade any package that is installed in your Identity Manager environment if there is a newer version of the package available.

Complete the following steps to upgrade an installed package:

  1. Ensure you add any GCVs included in the package to a new GCV Resource object. For more information, see the Global Configuration Value Definition Editor in NetIQ Identity Manager - Using Designer to Create Policies.

  2. Right-click the Identity Vault, driver set, or driver where the package is installed that you want to upgrade, then click Driver > Properties.

  3. Click Packages.

    If there is a newer version of a package, there is check mark displayed 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 that you want to upgrade to, then click OK.

    NOTE:Designer lists all versions available for upgrade.

  7. Click Apply.

  8. (Conditional) Fill in the fields with appropriate information to upgrade the package, then click Next.

    Depending on which package you selected to upgrade, you might have fields that you must fill in to upgrade the package. For detailed information about the fields, see the specific driver documentation located on the Identity Manager Drivers documentation Web site.

  9. Read the summary of the installation, then click Finish.

  10. Review the upgraded package, then click OK to close the Package Management page.

Using the Package Upgrade Consolidated View

The Package Upgrade Consolidated View helps you to view and upgrade the active packages of your entire Identity Manager project in a single view to the latest available versions. The provision of a single view removes the need for you to separately go to each driver, driver set, or Identity Vault in your project to view or perform an upgrade on the packages they contain.

Complete the following steps to upgrade an installed package:

  1. In the Outline view, right-click Package Catalog, then select Package Upgrade.

    The Package Upgrade Consolidated View dialog box appears.

  2. Select one or more packages from the list, then click OK.

    If your Identity Manager environment is already up-to-date, the list is empty. Otherwise, select the packages that you want to upgrade.

In addition, the Project Checker displays the list of available packages upgrades in your Identity Management environment.

6.2.4 Importing Packages into the Package Catalog

Designer adds packages to the Package Catalog dynamically. However, if you need to add a custom package to the Package Catalog, you can import the package .jar file.

Use the following procedure to import one or more packages into the package catalog.

  1. In the Outline view, right-click Package Catalog, then select Import Package.

  2. Select one or more packages from the list. If all of the available packages are already imported, the list is empty.

    or

    Click Browse, then browse to and select a package on the file system and click OK.

    Packages to Import
  3. Click OK to import the selected packages.

  4. Review the import message, then click OK.

After you import a package, you must install the package on a driver before you can use that package. Continue with Installing Packages for instructions.