3.3 Upgrading the Driver Configuration

A DirXML 1.1a driver configuration can be run with an Identity Manager driver shim and the Metadirectory engine, with no changes to the driver configuration (unless you are using Password Synchronization 1.0; see Section 3.4, Upgrading from Password Synchronization 1.0 to Identity Manager Password Synchronization).

However, to edit a DirXML 1.1a driver configuration, you must either use the DirXML 1.1a iManager plug-ins or ConsoleOne®, or run the wizard that converts DirXML 1.1a configurations to Identity Manager format so you can edit the configuration using the Identity Manager iManager plug-ins. See Managing DirXML 1.1a Drivers in an Identity Manager Environment and Upgrading a Driver Configuration from DirXML 1.1a to Identity Manager 3.5.1 Formatin the Novell Identity Manager 3.5.1 Administration Guide.

NOTE:Running an Identity Manager driver configuration with a DirXML 1.1a driver shim is not supported.

Identity Manager 3.5.0 contains a new architecture for how policies reference one another. To take advantage of this new architecture, the driver configuration file provided for NT must be upgraded. For more information on the new architecture, see Upgrading Identity Manager Policies in the Understanding Policies for Identity Manager 3.5.1. You can upgrade the driver in Designer or iManager. If you are upgrading from Identity Manager 3.5.0 to Identity Manager 3.5.1, the following information does not apply.

3.3.1 Upgrading the Driver in Designer

  1. Make sure you have updated your driver with all the patches for the version you are currently running.

    We recommend this step for all drivers, to help minimize upgrade issues.

  2. Back up the driver. See Section 7.0, Backing Up the Driver for instruction on how to back up the driver.

  3. Install Designer version 2.0 or above, then launch Designer.

    If you had a project open in Designer when you upgraded Designer, proceed to Step 4. If you didn’t have a project open in Designer when you upgraded Designer, skip to Step 5.

  4. If you had a project open when upgrading Designer, the following warning message is displayed. Read the warning message, then click OK.

    Warning the editors will be closed and project needs to be opened.

    Designer closes the project to preform the upgrade.

  5. In the Project view, double-click System Model to open and convert the project.

    System Model

  6. Read the Project Converter message explaining that the project is backed up, converted to the new format, changes logged to a file, and the new project is opened, then click Next.

    Project Converter backing up the project

  7. Specify the name of the backup project name, then click Next.

    Naming the backup project

  8. Read the project conversion summary, then click Convert.

    Project Converter summary

  9. Read the project conversion result summary, then click Open Project.

    Project Converter results

    If you want to view the log file that is generated, click View Log.

3.3.2 Upgrading the Driver in iManager

  1. Make sure you have updated your driver with all the patches for the version you are currently running.

    We recommend this step for all drivers, to help minimize upgrade issues.

  2. Back up the driver. See Section 7.0, Backing Up the Driver for instruction on how to back up the driver.

  3. Verify that Identity Manager 3.5.1 has be installed and you have the current plug-ins installed, then launch iManager.

  4. Click Identity Manager > Identity Manager Overview.

  5. Click Search to find the Driver Set object, then click the driver you want to upgrade.

  6. Read the message that is displayed, then click OK.

    Do you want to convert the driver to the new architecture?

  7. If there is more than one driver to upgrade, repeat Step 2 through Step 6.