REST driver 1.3.3.0100 release notes

Overview

This update is applicable for REST drivers running OpenText Identity Manager version 4.9 or 24.4 (4.10). The driver version will be changed to 1.3.3.0100 after the patch is applied.

System requirements

OpenText Identity Manager version 4.9 or 24.4 (4.10)

Upgrading the driver

Upgrading the driver involves upgrading the:

• Driver packages

• Driver files

Upgrading the driver packages

Import the following packages into Designer from the Packages folder.

Upgrading the driver files

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

2. If the driver runs locally, stop the driver instance and the Identity Vault.

3. If the driver runs with a Remote Loader instance, stop the driver and the Remote Loader instance.

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

5. 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_REST_1.3.3_P1.zip> directory and perform any one of the following actions for your platform:

      1. Linux: Install the new netiq-DXMLRESTDrv.rpm in your driver installation directory by running the following command in a terminal window:

         rpm -Uvh (patch-path)/linux/netiq-DXMLRESTDrv.rpm

      2. Windows: Copy the RESTCommon.jar, RESTDriverShim.jar, RESTUtil.jar files to your driver installation folder. For example, \NetIQ\IdentityManager\NDS (local installation) or \NetIQ\IDM\RemoteLoader\64bit\lib  (remote installation).

      3. Restart OpenText eDirectory or Remote Loader instance. 

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

   1. Create the _db.* file during a non-root installation of the Identity Manager engine.
      Absence of this file may indicate that OpenText Identity Manager is not properly installed. Reinstall OpenText Identity Manager to correctly place the file in the directory.

      This will set the environmental variables to the directory where Identity Vault is installed as a non-root user.
      For example, to install the REST 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/netiq-DXMLRESTDrv.rpm

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

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

      3. To install the driver files, enter the following 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/novell-DXMLsaphrjco.rpm

         In this command, /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. If the driver runs locally, start the Identity Vault and the driver instance.

8. If the driver runs with a Remote Loader instance, start the Remote Loader instance and the driver instance.

Technical support information

• Issue ID OCTCR56A656243: SCIM driver does not log HTTPS request documents at trace level six or seven.

• Issue ID OCTCR56A656302: SCIM driver does not log HTTPS response documents at trace level six or seven when the body contains non US-ASCII characters.

• Issue ID OCTCR56A754086: REST Driver times out on re-auth using a refresh token.

• Issue ID OCTCR56A829101: Upgrading REST Base Package results in driver configuration size increase and corruption.