17.3 Configuring the Remote Loader for Driver Instances on UNIX or Linux

The Remote Loader can host the Identity Manager application shims contained in .dll, .so, or .jar files. For the Remote Loader to run on a UNIX or Linux computer, the application needs a configuration file such as LDAPShim.txt for each driver instance. You can also create or edit a configuration file by using command line options.

By default, the Remote Loader connects to the Identity Manager engine through TCP/IP using TLS/SSL protocols. The default TCP/IP port for this connection is 8090. You can run multiple driver instances with the Remote Loader on the same server. Each instance hosts a separate Identity Manager application shim instance. To use multiple instances of the Remote Loader on the same server, specify different connection ports and command ports for each instance.

NOTE:

  • The configuration file can contain any command line options except -config.

  • When adding parameters to the configuration file, you can use the long form or a short form of the parameter. For example, -description or -desc.

  • The following procedure lists the long form first, followed by the short form in parentheses. For example -description value (-desc value).

  • For more information about the parameters used in this section, see Understanding the Configuration Parameters for the Remote Loader.

To create a configuration file:

  1. In a text editor, create a new file.

    NetIQ provides a sample file config8000.txt to help you configure the Remote Loader and drivers for use with your application shim. The sample file is located by default in the /opt/novell/dirxml/doc directory.

  2. Add the following configuration parameters to the file:

    • -description (optional)

    • -commandport

    • connection parameters:

      • port

      • address

      • fromaddress

      • handshaketimeout

      • rootfile

      • keystore (conditional)

      • storepass (conditional)

      • localaddress

      • hostname

      • kmo

    • trace file parameters (optional):

      • -trace

      • -tracefile

      • -tracefilemax

    • -javaparam

    • -class or -module

    For more information about specifying values for these parameters, seeSection 17.2, Understanding the Configuration Parameters for the Remote Loader.

  3. Save the file.

    For the Remote Loader to start automatically when your computer starts, save the file to the /etc/opt/novell/dirxml/rdxml directory.