REST API Implementation for Oracle EBS UM, HR and TCA Driver
This update is applicable for Oracle EBS UM, HR and TCA driver running Identity Manager 4.7.3 or 4.8. The driver version will be changed to 4.1.2 after the patch is applied.
System Requirements
Identity Manager 4.7.x or later
Identity Manager 4.8 or later
Upgrading the Driver
The driver upgrade process involves the following tasks:
- Updating the driver packages
- Updating the driver files
Updating the Driver Packages
- Download the following packages.
- NOVLORAUBASE_2.2.1.20191203042859.jar
- NOVLORAHENT_2.2.2.20191114220506.jar
- NOVLEBSENT_2.2.2.20191114062325.jar
- NOVLPWDSYNC_2.1.2.20190806140123.jar
- NOVLORAHBASE_2.3.1.20191203044842.jar
- NOVLORATBASE_2.3.1.20191203050514.jar
- Open the project containing the driver.
- Right-click the driver for which you want to install the new packages, then click Driver > Properties.
- Click Packages.
A check mark indicates a newer version of a package in the Upgrades column.
- Click Select Operation for the package that indicates there is an upgrade available.
- From the drop-down list, click Upgrade.
- Select the version that you want to upgrade to, then click OK.
NOTE: Designer lists all versions available for upgrade.
- Click Apply.
- (Conditional) Fill in the fields with appropriate information to upgrade the package, then click Next.
Depending on which package you selected for upgrade, you must fill in the required information appropriately to upgrade the package.
- Read the summary of the packages that will be installed, then click Finish.
- Review the upgraded package, then click OK to close the Package Management page.
Updating the Driver Files
- Take a back-up of the current driver configuration.
- (Conditional) If the driver is running locally, stop the Identity Vault.
- (Conditional) If the driver is running with a Remote Loader instance, stop the Remote Loader instance and the driver instance.
- Download and unzip the contents of the IDM_OracleEBS_4120.zip file to a temporary location on your computer.
- Perform the following steps based on your platform:
- Linux:
- Navigate to the <extracted IDM_OracleEBS_4120.zip>/Linux directory
- Install the novell-DXMLebsCommon.rpm, novell-DXMLebsUM.rpm, novell-DXMLebsHR.rpm and novell-DXMLebsTCA.rpm by running the following commands in a terminal window:
rpm -Uvh (patch-path)/linux/novell-DXMLebsCommon.rpm
rpm -Uvh (patch-path)/linux/novell-DXMLebsUM.rpm
rpm -Uvh (patch-path)/linux/novell-DXMLebsHR.rpm
rpm -Uvh (patch-path)/linux/novell-DXMLebsTCA.rpm
- (Conditonal)If the driver is running on Remote Loader, perform the above steps on the machine where Remote Loader is installed.
- Windows:
- If the driver is installed locally:
- Navigate to the <extracted IDM_OracleEBS_4120.zip>/Windows folder.
- Copy and replace the EBSShim.jar, EBSUserShim.jar, EBSHRShim.jar and EBSTCAShim.jar files in the C:\NetIQ\IDM\NDS\lib folder.
- If the driver is installed with Remote Loader:
- Navigate to the <extracted IDM_OracleEBS_4120.zip>/Windows folder.
- Copy and replace the EBSShim.jar, EBSUserShim.jar, EBSHRShim.jar and EBSTCAShim.jar files in the C:\NetIQ\IDM\RemoteLoader\64bit\lib.
- (Conditional) To update the driver files as a non-root user:
- 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.
- 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.
- To install the driver files, enter the following command:
For example, to install the UM 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-DXMLebsUM.rpm
Perform the above step for each driver 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.
- (Conditional) If the driver is running locally, start the Identity Vault and the driver instance.
- (Conditional) If the driver is running with a Remote Loader instance, start the Remote Loader instance and the driver instance.
Technical Support Information
What Is New/Issues Fixed in This Release
- Enhancement Bug 1151856 - Implemented REST mechanism to the Oracle EBS UM driver. Both SOAP and REST are now supported for the EBS events.
- Enhancement Bug 1155414 - Implemented REST mechanism to the Oracle EBS HR driver. Both SOAP and REST are now supported for the EBS events.
- Enhancement Bug 1157106 - Implemented REST mechanism to the Oracle EBS TCA driver. Both SOAP and REST are now supported for the EBS events.