6.2 Installing Remote Loader

To install the Remote Loader:

1. Log in to the computer where you want to install Remote Loader.

   NOTE:You can install the Java Remote Loader as a non-administrator user.

2. Navigate to the \products\idm\windows\setup\ directory.

3. Run the idm_install.exe program.

4. Accept the license agreement and then click Next.

5. In the Select Components window, specify the Remote Loader components that you want to install.

   For more information about the options, see Understanding the Installation Program.

6. (Optional) To select specific drivers for the individual components, complete the following steps:

   1. Click Customize the selected components, and then click Next.

   2. Expand Drivers under the component that you want to install.

   3. Select the drivers that you want to install.

7. Click Next.

8. In the Activation Notice window, click OK.

9. For Authentication, specify a user account and its password with sufficient rights in eDirectory to extend the schema. Specify the user name in the LDAP format. For example, cn=admin,o=company.

10. For Pre-Installation Summary, verify the settings.

11. Click Install.

12. Activate Identity Manager. For more information, see Activating Identity Manager.

13. Configure the Remote Loader to connect with the drivers and Identity Manager. For more information, see Section 6.3, Configuring the Remote Loader and Drivers.

14. To create and configure your driver objects, consult the specific guide for that driver. For more information, see Identity Manager Drivers documentation website.

To perform a silent installation:

1. Log in to the computer where you want to install Remote Loader.

2. Navigate to the \products\idm\windows\setup\ directory

3. Create a properties file or edit the sample silent.properties file.

4. Specify the following parameters in the file:

   CONNECTED_SYSTEM_SELECTED

   Specifies whether you want to install the 32-bit Remote Loader service and drivers. You can install both 32-bit and 64-bit versions on the same server.

   X64_CONNECTED_SYSTEM_SELECTED

   Specifies whether you want to install the 64-bit Remote Loader service and drivers. You can install both 32-bit and 64-bit versions on the same server.

   UTLITIES_SELECTED

   Specifies whether you want to install the Utilities and system components for the Remote Loader.

   DOT_NET_REMOTELOADER_SELECTED

   Specifies whether you want to install the .NET Remote Loader service and drivers.

5. To perform a silent installation, run the following command from the command prompt:

   install.exe -i silent -f silent.properties

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\idm\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\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, 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 Configuring the Remote Loader and Drivers in the NetIQ Identity Manager Driver Administration Guide.

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

1. Log in as administrator on the computer where you want to install the .NET Remote Loader.

2. 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 .NET Remote Loader installation files, located by default in the \products\idm\windows\setup\ directory.

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

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

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

3. Run the idm_install.exe program from the installation directory.

4. Accept the license agreement, and then click Next.

5. In the Select Components window, specify the .NET Remote Loader.

   For more information about the options, see Understanding the Installation Program.

6. (Optional) To select specific drivers for the individual components, complete the following steps:

   1. Click Customize the selected components, and then click Next.

   2. Expand Drivers under the component that you want to install.

   3. Select the drivers that you want to install.

7. Click Next.

8. In the Activation Notice window, click OK.

9. Select the .NET Remote Loader installation directory on your computer.

10. Review the Summary page, then click Install to complete the installation.