4.12 Configuring Packages

4.12.1 Package General Settings

This property page lists the general settings for the package. These options can be changed only when a package is being developed. After a package is released or imported, these items cannot change.

Table 4-21 Package General Settings

Setting

Description

Name

Displays the package name.

Short Name

Displays the unique short name for the package. This name is unique for the package in the Identity Vault.

Version

Displays the package version.

Description

Displays a description for the package.

Type

Lists what type of package it is. It lists whether it is a base package, and if it can be installed on an Identity Vault, driver set, or driver.

Protected

If this option is selected, the Copy package option is disabled on imported packages. This allows a developer to protect the content of a package and not allow someone else to create a new package with this content.

Category

Lists the category the package is stored in.

Group

Lists the group the package is stored in.

Meta data

Lists specific information about a package. It lists:

  • When the package was created.

  • When the package was built.

  • If the package is released or not.

  • If the package has been imported.

  • Lists where the package is hosted.

  • Lists the name of the user who built the package.

4.12.2 Package Configuration Wizard

This property page is displayed only on driver base packages. The settings customize what is displayed when users use the Driver Configuration Wizard to install a driver base package.

The Configuration Wizard is an XML editor. Copy the contents of from an existing driver base package that contains the functionality you want to have in this driver base package to this page.

The following is taken from the Active Directory driver base package as an example:

<?xml version="1.0" encoding="UTF-8"?><features>
  <mandatory/>
  <optional>
    <group display-name="Default Configuration" expanded="false">
      <package id="5DRKWAWH_201009040020200702" name="Defautl Configuration" selected="true"/>
    </group>
    <group display-name="Entitlements and Exchange Mailbox Support" expanded="false">
      <package id="PJP89Z9R_201003031352370466" name="Active Directory Entitlements and Exchange Mailbox Support" selected="true"/>
      <package id="DETECXTK_201004161538110582" name="Audit Entitlements Common" selected="true"/>
      <package id="YMO9C1Y3_201006291302430386" name="Active Directory Audit Entitlements" selected="true"/>
    </group>
    <group display-name="Password Synchronization" expanded="false">
      <package id="XTEF1YO3_201006231733410161" name="Password Synchronization Common" selected="true"/>
      <package id="4EHOWL6T_201006291417220804" name="Active Directory Password Synchronization" selected="true"/>
    </group>
    <group display-name="Data Collection" expanded="false">
      <package id="IJLG31AY_201006141353520247" name="Managed System Information for AD" selected="true"/>
      <package id="S3NVESCX_201005251632080655" name="Generic Data Collection Query Support" selected="true"/>
    </group>
    <group display-name="Account Tracking" expanded="false">
      <package id="WUHJYFNL_201003011427170743" name="Account Tracking Common" selected="true"/>
      <package id="MMXLVRGT_201003011554580470" name="Active Directory Account Tracking" selected="true"/>
    </group>
  </optional>
</features>

4.12.3 Package Constraints

The package constraints list the restrictions associated with a package. These options can only be changed when a package is being developed. After a package is released or imported, these items cannot change.

Table 4-22 Package Constraints Settings

Constraint

Description

IDM Compatibility

Lists the minimum and maximum versions of Identity Manager that the package supports. These settings are always populated.

Application Compatibility

Lists the minimum and maximum versions of the application the package supports. These settings are not required for all packages.

Driver Type

Lists all of the supported driver types the package can be used with.

4.12.4 Package Dependencies

The Package Dependencies property page list the packages that the current package needs to run. Packages are divided up into much smaller pieces than a driver configuration file. Some packages have dependencies on other packages and some do not.

Table 4-23 Package Dependencies Settings

Setting

Description

Name

Lists the name of the package that is a dependency.

Minimum

Lists the minimum version of the package dependency.

Less than

Lists the highest version of the package dependency.

Exceptions

If there is a version of the package that is not a dependency, it is listed as an exception.

Add dependency

Allows you to add dependencies to the package you are currently developing. This option is not available for released packages.

Remove dependency

Allows you to remove dependencies to the package you are currently developing. This option is not available for released packages.

4.12.5 Package Initial Settings

The initial settings are used by package developers to create a template of items that are required for a driver to start. This information is specified in ds-object code that modifies the driver object at installation. The ds-object code installs driver shim parameters, driver start options, named passwords, GCVs, and filters. Unlike other package content, these settings cannot be uninstalled.

4.12.6 Package Languages

The Package Languages property page lists the languages that package is translated into.

4.12.7 Package License

The Package License property page lists the license for the package.

4.12.9 Package Readme

The package Readme lists the information the developer wants you to know about the package. For example, it can contain a list of new features in a package version, what the linkage directives should be for a package, and a change log for the package. For more information about package development, see Section 7.0, Developing Packages.

4.12.10 Package Targets

The package targets are all of the places where the package is installed in your project. This allows you to see where the package is being used if you need to uninstall a package.

4.12.11 Package Vendor

The package vendor information is listed on this property page. This allows you to contact the vendor of a package if you need more information about a package.

Table 4-24 Vendor Settings

Setting

Description

Vendor Name

Specify the vendor name. If this is for internal consumption, specify the name of your company.

Vendor Address

Specify the address for the vendor or your company.

Vendor URL

Specify the URL of the vendor or your company.

Vendor eMail

Specify an e-mail for the vendor or your company.

Contact Name

If there is a specific contact person for this package, specify his or her name.

Contact eMail

If there is a specific e-mail address for the contact person, specify it in this field.