REST Driver 1.1.2.0400 Readme

This Readme comprises the following sections:

• Overview
• System Requirements
• Upgrading the Driver
• Technical Support Information

Overview

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

Note: From 1.1.2.0400 release, the value for the keystore type must be PKCS12, However the truststore should be in JKS format.

System Requirements

Upgrading the Driver

The driver upgrade process involves the following tasks:

• Upgrading the Driver Packages
• Upgrading the Driver Files

Upgrading the Driver Packages

Note: No new packages have been shipped as part of this release.

Upgrading 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_REST_1.1.2_P4.zip file to a temporary location on your computer.


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


• For Identity Manager 4.8.x version:
  
  
  1. On the server where you want apply the driver patch, log in as root.
  
  
  2. Navigate to the extracted <IDM_REST_1.1.2_P4.zip> directory and perform one of the following actions for your platform:
  
  
  • Linux: Install the new netiq-DXMLRESTDrv.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/netiq-DXMLRESTDrv.rpm

  • Windows: Copy the RESTCommon.jar, RESTDriverShim.jar, RESTUtil.jar files to your driver installation folder. For example, \NetIQ\IdentityManager\NDS (local installation) or \Novell\RemoteLoader\64bit (remote installation).
  3. Restart eDirectory or Remote Loader (RL) Instance


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.

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:

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:

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

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.

• Defect 550089 - REST Shim does not consider 201 HTTP response code as a success code
• Defect 479065 - REST Driver updating refresh token
• Defect 547088 - REST driver returns NullPointerException.
• Defect 440103 - REST Driver Publisher Response