Identity Gateway Integration Module (IGIM) 1.0.1.0400 Readme

Overview

This update is applicable for Identity Gateway Integration Module (IGIM) drivers running Identity Manager 4.8 or later. The driver version will be changed to 1.0.1.0400 after the patch is applied.

This readme document consists the following sections:

• System Requirements
• Upgrading the Identity Gateway Integration Module
• Technical Support Information

System Requirements

• Identity Manager 4.8 or later.
• Updating the driver with latest base package is mandatory.

Note: While configure the IDM Identity with changes Collector under Service Parameters for Username provide the credentials of the REST API user in the driver configuration.

Upgrading the Identity Gateway Integration Module

The driver upgrade process involves updating the driver files.

• Upgrading the Driver Packages
• Upgrading the Driver Files

Upgrading the Driver Packages

1. Download the following packages:

   Name	Package Name	Version	Build Date	Build Number
   Identity Gateway Integration Module	NETQIGIMBASE	1.1.1	20240719	154333



2. Open the project in Designer to deploy the driver.


3. Navigate to Help menu and select Check for Package Updates. Install the above IGIM packages.


4. Drag the driver from Designer Palette > Services .


5. Configure the driver as mention in IGIM Implementation Guide.


6. To verify driver configuration and packages, right click the connector line and navigate to Properties > Packages.

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_IGIM_1.1.0_P1.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 to apply the driver patch, log in as root.


2. Navigate to the <extracted IDM_IGIM_1.1.0_P1.zip> directory and perform one of the following actions for your platform:


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

• If you are installing the hotfix for the first time, run the following command:

rpm -ivh (patch-path)/linux/novell-DXMLIGIM.rpm

• If you are upgrading to this hotfix, run the following command:

rpm -Uvh (patch-path)/linux/novell-DXMLIGIM.rpm

• Windows: Copy the IGDriverShim.jar file to your driver installation folder. For example, \NetIQ\IdentityManager\NDS, if the driver is locally installed with the Identity Manager engine or \Novell\RemoteLoader\lib if the driver is installed with the Remote Loader.


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 IGIM 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/novell-DXMLIGIM.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

• Defect 611276 - IGIM Driver Security Equals / Rights for REST API.
• Defect 593324 - IGIM Driver Documentation needs updates.

Issue Fixed in Previous (1.0.1.0300) Release

• Defect 232153 - IGIM driver does not work on non-root installation.
• Defect 414374 - IDM 4.8.4 - IGIM driver doesn't start with https.
• Defect 346022 - IGIM Driver does not accept connection when the password contains colon.
• Defect 327275 - Policy NETIQIGIMIG-sub-etp causes the IDM collector with changes to report duplicate values.
• Defect 316209 - Policy NETIQIGIMIG-sub-etp causes the IDM collector with changes to fail due to incorrect syntax.