5.3 Upgrading the Driver

The driver upgrade process involves upgrading the installed driver packages and updating the driver files. The driver patch file contains the software to update the driver files.

5.3.1 Upgrading the Installed Packages

  1. Download the latest available packages.

    To configure Designer to automatically read the package updates when a new version of a package is available, click Windows > Preferences > NetIQ > Package Manager > Online Updates in Designer. For more information, see the NetIQ Designer for Identity Manager Administration Guide.

  2. Upgrade the installed packages.

    1. Open the project containing the driver.

    2. Right-click the driver for which you want to upgrade an installed package, 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 must fill in the required information to upgrade the package.

    9. Read the summary of the packages that will be installed, then click Finish.

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

      For detailed information, see the Upgrading Installed Packages in the NetIQ Designer for Identity Manager Administration Guide.

5.3.2 Applying the Driver Patch

The driver patch updates the driver files.

This section provides a general procedure for updating the driver files. For instructions about updating the driver to a specific version, search for the driver patch that you want to upgrade to in the Patch Finder Download Page and follow the instructions from the Readme file that accompanies the driver patch release.

Prerequisites

Before installing the patch, complete the following steps:

  1. Take a back-up of the current driver configuration.

  2. Stop the driver instance.

  3. Stop the .NET Remote Loader service.

  4. In a browser, navigate to the NetIQ Patch Finder Download Page.

  5. Under Patches, click Search Patches.

  6. Specify Identity Manager nn Multi-Domain Active Directory driver nn in the search box.

  7. Download and unzip the contents of the patch file to a temporary location on your server.

Applying the Patch

  1. Update the driver files:

    1. Navigate to the <Extracted Driver Patch File Temporary Location>\windows directory.

    2. Copy the following files to <IdentityManager installation>\RemoteLoader.NET\lib. folder.

      • DXMLMADDDriver.dll

      • MADWrapper.dll

      • ADDriver.dll (Active Directory driver version 4.1.2.0)

        NOTE:Copy this file only if you are using Windows Server 2019 (64-bit) as a connected system.

    3. Unblock the .dll files that you copied in Step 1b.

      Microsoft applies some security restrictions on the files copied to a Windows server which leaves the files in a blocked state. To unblock the files, right-click each file name and open the file with the Properties page and unblock the file.

  2. Start the .NET Remote Loader service.

  3. Start the driver instance.