2.2 Installing the REST Driver Files

You can install the REST driver files as a root user or as a non-root user in your system. The procedure to install the driver files is similar for any connected application.

You must ensure that you have the required REST driver files such as,.zip,.rpm, and.jar etc., from the required driver build available in Micro Focus Download site to install the REST driver in your system.

For example:

  • .zip file: <IDM_REST_1100.zip>

  • .rpm file: <netiq-DXMLRESTDrv.rpm>

  • .jar file: <RESTUtils.jar>

This section explains the common procedure to install the driver files:

  1. Download and unzip the contents of the <IDM_REST_1100.zip> file to a temporary location on your computer.

  2. Install the driver files (for IDM 4.7.4 and above) based on your user role.

    To install as a:

    Installing Driver Files as a Root User

    1. Login as a root user on the server where you want apply the driver jar file.

    2. Navigate to the extracted <IDM_REST_1100.zip> directory and perform one of the following actions based on your platform:

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

        <rpm -Ivh (binaries-path)/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).

    Installing Driver Files as a Non-Root User

    1. Verify that the /rpmdirectory exists and contains the _db.000 file.

    2. The_db.000 file is created during a non-root installation of the Identity Manager engine. The absence of this file indicates that the Identity Manager is not installed properly. In such case, reinstall the Identity Manager to correctly place the file in the mentioned directory.

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

      ROOTDIR=<non-root eDirectory location>

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

    4. For example, to install the REST driver rpm, use this command:

      rpm --dbpath $ROOTDIR/rpm -Ivh --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

      NOTE:In the above command /opt/novell/eDirectory is the location where non-root Identity Manager is installed, and /home/user/ is the home directory of the non-root user.

  3. (Conditional) If the driver is running locally, start the Identity Manager and the driver instance.

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

You can also install the REST driver files on the Identity Manager server or a remote server that supports Remote Loader configuration. For more information about installing Remote Loader, see Considerations for Installing Identity Manager Engine Components and Remote Loader in the NetIQ Identity Manager Setup Guide for Linux or Planning to Install the Remote Loader in the NetIQ Identity Manager Setup Guide for Windows.