4.9 Installing Java Remote Loader

You install the Java Remote Loader, dirxml_jremote, on computers where the operating system is not compatible with the native Remote Loader. However, the Java Remote Loader can also run on the same servers where you might install the native Remote Loader. Identity Manager uses the Java Remote Loader to exchange data between the Identity Manager engine running on one server and the Identity Manager drivers running in another location, where rdxml does not run. You can install dirxml_jremote on any supported Linux computer with any publicly supported version of Java.

  1. On the server that hosts the Identity Manager engine, copy the application shim .iso or .jar files, located by default in the /opt/novell/eDirectory/lib/dirxml/classes directory.

  2. Log in to the computer where you want to install the Java Remote Loader (the target computer).

  3. Verify that the target computer has a supported version of JRE.

  4. To access the installation program, complete one of the following steps:

    1. (Conditional) If you have the .iso image file for the Identity Manager installation package, navigate to the directory containing the Java Remote Loader installation files, located by default in /IDM/packages/java_remoteloader.

    2. (Conditional) If you downloaded the Java Remote Loader installation files from the NetIQ Downloads website, complete the following steps:

      1. Navigate to the .tgz file for the downloaded image.

      2. Extract the contents of the file to a folder on the local computer.

  5. Copy the dirxml_jremote_dev.tar.gz file to the desired location on the target computer. For example, copy the file to /usr/idm.

  6. Copy one of the following files to the desired location on the target computer:

    • dirxml_jremote.tar.gz

    • dirxml_jremote_mvs.tar

      For information about mvs, untar the dirxml_jremote_mvs.tar file, then refer to the usage.html document.

  7. On the target computer, unzip and extract the .tar.gz files.

    For example, tar -zxvf dirxml_jremote.tar.gz

  8. Place the .iso or .jar files for the application shim that you copied in Step 1 in the dirxml/classes directory under the lib directory.

  9. To customize the dirxml_jremote script so the Java executable is reachable through the RDXML_PATH environment variable, complete one of the following steps:

    1. Enter one of the following commands to set the environment variable RDXML_PATH:

      • set RDXML_PATH=path

      • export RDXML_PATH

    2. Edit the dirxml_jremote script and prepend the path to the Java executable on the script line that executes Java.

  10. You must specify the location of the jar files in the dirxml_jremote script from the lib subdirectory of the untarred dirxml_jremote.tar.gz directory. For example, /lib/*.jar.

  11. Configure the sample configuration file config8000.txt for use with your application shim.

    The sample file is located by default in the /opt/novell/dirxml/doc directory. For more information, see Configuring the Remote Loader and Drivers.