NetIQ Documentation: Identity Manager 4.0.1 Remote Loader Guide - Configuring a Identity Manager Application Shim for the Remote Loader

A.3 Configuring a Identity Manager Application Shim for the Remote Loader

There are a few additional steps involved in setting up an Identity Manager application shim for use with the Remote Loader in addition to the normal procedure for setting up an Identity Manager application shim.

Using iManager (with the Identity Manager plug-ins):

A.3.1 Install a driver configuration for the application shim

This is performed in the usual fashion using iManager (Click Identity Manager > Overview.)

Configure the driver for use with the Remote Loader

From the Overview, click the Identity Manager Driver object.
Select the Driver Configuration tab.
Change the radio button from "Java" or "Native" to "Connect to Remote Loader".
Enter a password in the Driver Object field.
This password will be used by the Remote Loader to authenticate itself to the remote interface shim.
Enter the password for the Remote Loader. This password is used by the remote interface shim to authenticate itself to the Remote Loader.
Enter the communications parameters for the Remote Loader. This is a series of "name=value" pairs. The following are supported:

Option	Parameter	Description
hostname	host name or ip address	Specifies the address or name of the machine on which the Remote Loader will run. Example: hostname=192.168.0.1
kmo	Key Name	Specifies the Key Name of the Key Material Object containing the keys and certificate used for SSL. Example: kmo='remote driver cert'
port	TCP port number	Specifies the port on which the Remote Loader will accept connections from the remote interface shim. Example: port=8090

Option

Parameter

Description

hostname

host name or ip address

Specifies the address or name of the machine on which the Remote Loader will run.

Example:

hostname=192.168.0.1

kmo

Key Name

Specifies the Key Name of the Key Material Object containing the keys and certificate used for SSL.

Example:

kmo='remote driver cert'

port

TCP port number

Specifies the port on which the Remote Loader will accept connections from the remote interface shim.

Example:

port=8090

An example of communication parameters is: hostname=192.168.0.1 port=8090 kmo=remotecert

Install the Remote Loader on the remote machine

Using the Identity Manager media, install the Remote Loader on the target machine.
Copy the .so file or the .jar file containing the Identity Manager application shim onto the target machine.
Place .jar files in the dirxml/classes directory under the lib directory (e.g.,$DXML_PATH/dirxml/classes).

Configure the Remote Loader

Create a configuration file specifying the shim module or class name, the command port, connection string, and any desired trace level. For example, create a file named config.txt with the following lines:
```
-commandport 8000
-connection "port=8090 rootfile=/dirxmlremote/root.pem"
-module $DXML_HOME/dirxmlremote/libcskeldrv.so.0.0.0
-trace 3
```
Set the loader and driver object passwords using the -setpasswords option. For example:
```
dirxml_remote -config config.txt -setpasswords rumple1 stiltskin2
```

Run the Remote Loader

Start the Remote Loader. For example:
```
dirxml_remote -config config.txt
```
Start the remote interface shim using iManager.
Confirm that the Remote Loader is operating properly.
Stop the Remote Loader. For example:
```
dirxml_remote -config config.txt -u
```
Install the Remote Loader as a Win32 service. For example:
```
dirxml_remote -config config.txt -service install
```