Overview

This update is applicable for SOAP drivers running Identity Manager 4.7.x or Identity Manager 4.8.x, or later. The driver version will be changed to 4.1.0.1 after the patch is applied.

System Requirements

Identity Manager 4.7.x, or later

Identity Manager 4.8.x, or later


Upgrading the Driver

The driver upgrade process involves the following tasks:

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

  2. (Conditional) If the driver is running locally, stop the driver instance and the Identity Vault.

  3. (Conditional) If the driver is running with a Remote Loader instance, stop the driver and the Remote Loader instance.

  4. Download and unzip the contents of the IDM_SOAP_4101.zip file to a temporary location on your computer.

  5. (Conditional) To update the driver files as a root user:

    1. On the server where you want apply the driver patch, log in as root.

    2. Navigate to the extracted IDM_SOAP_4101.zip directory and perform one of the following actions for your platform:

      3. For Identity Manager versions 4.8.1 upto 4.8.3:

      • Linux: Install the new novell-DXMLsoap.rpm in your driver installation directory by running one of the following command in a terminal window:

        • If you are upgrading the patch, run the following command:

          • rpm -Uvh (patch-path)/linux/novell-DXMLsoap.rpm

          Important: Ensure to replace the jetty-all-9.4.6.v20170531-uber.jar in /opt/novell/eDirectory/lib/dirxml/classes with jetty-all-9.4.34.v20201102-uber.jar extracted from the Common folder.

      • Windows: Copy the SOAPShim.jar, SOAPUtil.jar files to your driver installation folder. For example, \NetIQ\IdentityManager\NDS (local installation) or \Novell\RemoteLoader\64bit (remote installation).

          Important: Ensure to replace the jetty-all-9.4.6.v20170531-uber.jar in \NetIQ\IdentityManager\NDS (local installation) or \Novell\RemoteLoader\64bit (remote installation) with jetty-all-9.4.34.v20201102-uber.jar extracted from the Common folder.

    Important: You must ensure that all the released jar files have the required read, write, and execute permissions for the user.

  6. (Conditional) To update the driver files as a non-root user:

    1. Verify that <non-root edirectory="" location="">/rpm directory exists and contains _db.* file.

      2. The _db.* file is created during a non-root installation of the Identity Manager engine. Absence of this file might indicate that Identity Manager is not properly installed. Reinstall Identity Manager to correctly place the file in the directory.

    2. To set the root directory to the location of non-root Identity Vault, enter the following command in the command prompt:

      3. ROOTDIR=<non-root eDirectory location>

      This will set the environmental variables to the directory where Identity Vault is installed as a non-root user.

    3. To install the driver files, enter the following command:

      4. For example, to install the SOAP driver RPM, use this command:

      rpm --dbpath $ROOTDIR/rpm -Uvh --relocate=/usr=$ROOTDIR/opt/novell/eDirectory --relocate=/etc=$ROOTDIR/etc --relocate=/opt/novell/eDirectory=$ROOTDIR/opt/novell/eDirectory --relocate=/opt/novell/dirxml=$ROOTDIR/opt/novell/dirxml --relocate=/var=$ROOTDIR/var --badreloc --nodeps --replacefiles /home/user/nnovell-DXMLsoap.rpm

      where /opt/novell/eDirectory is the location where non-root eDirectory is installed and /home/user/ is the home directory of the non-root user.

  7. (Conditional) If the driver is running locally, start the Identity Vault and the driver instance.

  8. (Conditional) If the driver is running with a Remote Loader instance, start the Remote Loader instance and the driver instance.
Technical Support Information

Implementation in This Release

Issues Fixed in this release