19.4 Installing Java Remote Loader on Windows

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 java remote loader - dirxml_jremote on any supported Windows platform that has a compatible JRE (1.8.0 minimum) and Java Sockets.

  1. On the server that hosts the Identity Manager engine, copy the application shim .iso or .jar files, in the default location. For example, C:\NetIQ\IdentityManager\NDS\lib 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 products\IDM\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 C:\NetIQ\IdentityManager.

  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, use 7-Zip or supported software to unzip .tar.gz files.

  8. Set the CLASSPATH environment variable to all jars that are present in lib folder. If you have dependent jars specific to any driver, copy those jar files to lib folder, then set the CLASSPATH environment variable to these jars also.

    For example, set:

    CLASSPATH=E:\RL\JAVARL\lib\activation.jar;E:\RL\JAVARL\lib\commondrivershim.jar;E:\RL\JAVARL\lib\delimitedtextshim.jar;E:\RL\JAVARL\lib\delimitedtextutil.jar;E:\RL\JAVARL\lib\dirxml.jar;E:\RL\JAVARL\lib\dirxml_misc.jar;E:\RL\JAVARL\lib\dirxml_remote.jar;E:\RL\JAVARL\lib\jco3environment.jar;E:\RL\JAVARL\lib\mail.jar;E:\RL\JAVARL\lib\mapdb.jar;E:\RL\JAVARL\lib\nxsl.jar;E:\RL\JAVARL\lib\shimwrapper.jar;E:\RL\JAVARL\lib\xds.jar;E:\RL\JAVARL\lib\xp.jar

  9. Set the PATH environment variable to bin folder of JDK or JRE for Java.exe.

  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 dirxml_jremote.tar.gz jar file contains this file. For more information, see Section 20.0, Configuring the Remote Loader and Drivers.

  12. Launch the Remote Loader using following commands:

    1. To specify a Remote Loader password:

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <config file name> -sp <Remote Loader Password> <Object Driver Password>

      For example,

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config e:\RL\JAVARL\config8000.txt -sp novell novell

    2. To start the Remote Loader:

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <config file name>

      For example,

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config e:\RL\JAVARL\config8000.txt

    3. To stop the Remote Loader:

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <config file name> -unload

      For example,

      java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config e:\RL\JAVARL\config8000.txt -unload