3.3 Unable to Initialize a Zoomdb-based Driver Using the Java Remote Loader

Issue: When you start an Identity Manager driver that uses ZoomDB (such as LDAP driver) using Java Remote Loader, initialization of class com.microfocus.database.builder.ZoomDBBuilder fails and you receive the following error in publisher channel:

An unexpected error occurred in the publisher channel: Could not initialize class com.microfocus.database.builder.ZoomDBBuilder

(Bug 1162310)

Workaround: Perform the following actions:

  1. On the server that hosts the Identity Manager engine, navigate to the /opt/novell/eDirectory/lib64/nds-modules/ location and copy the libzoomdb.so file to a location that you can access from the computer running Java Remote Loader.

  2. Sign out from the Identity Manager engine server.

  3. Log in to the computer where the Java Remote Loader is installed.

  4. On Linux platforms, perform the following steps:

    1. (Conditional) This step applies only if you are upgrading Identity Manager directly from the 4.8 version to the 4.8.2 version. In other words, you can skip this step if you are upgrading from the Identity Manager 4.8.1 version.

      1. Download and mount the Identity_Manager_4.8.2_Linux.iso from the NetIQ Download website.

      2. Navigate to the <iso mounted location>/IDM/packages/java_remoteloader/ directory and copy the dirxml_jremote.tar.gz file to the desired location. For example, /home.

      3. Unzip and extract the dirxml_jremote.tar.gz file.

        For example, tar -zxvf dirxml_jremote.tar.gz

      For more information about upgrading Java Remote Loader, see Upgrading Java Remote Loader in NetIQ Identity Manager Setup Guide for Linux.

    2. Place the libzoomdb.so file that you copied in Step 1 to the <location where you have extracted the dirxml_jremote.tar.gz file>/lib64/ directory.

      For example, /home/lib64/

    3. Initialize an instance of the LDAP driver using an RL configuration file.

      For example, "./dirxml_jremote -config <RemoteLoader_Configuration_file> -sp <password> <password>"

    4. Start the Remote Loader instance using the command:

      "./dirxml_jremote -config <RemoteLoader_Configuration_file> &"

  5. On Windows platforms, perform the following steps:

    1. (Conditional) This step applies only if you are upgrading Identity Manager directly from the 4.8 version to the 4.8.2 version. In other words, you can skip this step if you are upgrading from the Identity Manager 4.8.1 version.

      1. Download and extract the Identity_Manager_4.8.2_Windows.iso from the NetIQ Downloads website.

      2. Navigate to the <iso mounted location>\IdentityManagerServer\IDM\java_remoteloader directory.

      3. Unzip and extract the dirxml_jremote.tar.gz file to the desired location.

        For example, use 7-Zip or supported software to unzip the file.

      For more information about upgrading Java Remote Loader, see Upgrading Java Remote Loader in NetIQ Identity Manager Setup Guide for Windows.

    2. Set the CLASSPATH environment variable to all jars that are present in the lib folder. If you have dependent jars specific to any driver, copy those jar files to the 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

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

    4. Based on the operations you want to perform on the Remote Loader, run the following commands:

      1. To specify a Remote Loader password:

        java.exe -Djava.library.path="<absoluteLocation>\lib64" -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <RemoteLoader_Configuration_file> -sp <password> <password>

        For example,

        java.exe -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config config8000.txt -sp novell novell

      2. To start the Remote Loader:

        java.exe -Djava.library.path="<absoluteLocation>\lib64" -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <RemoteLoader_Configuration_file>

        For example,

        java.exe -Djava.library.path="<absoluteLocation>\lib64"-classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config config8000.txt

      3. To stop the Remote Loader:

        java.exe -Djava.library.path="<absoluteLocation>\lib64" -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config <RemoteLoader_Configuration_file> -unload

        For example,

        java.exe -Djava.library.path="<absoluteLocation>\lib64" -classpath %CLASSPATH% com.novell.nds.dirxml.remote.loader.RemoteLoader -config config8000.txt -unload