3.4 Installation Procedures

Use this topic to understand the installation methods for Identity Manager components.

3.4.1 Installation Procedures for Identity Manager Server, Identity Applications, and Identity Reporting

This section guides you through the process of installing the Identity Manager Server, Identity Applications, and Identity Reporting components through an interactive method or silent method. The Identity Manager Server option in the installation program allows you to install the 32-bit, 64-bit and .NET Remote loader.

NOTE:Before installing Identity Manager engine, ensure that your Windows server is updated with the latest Windows patch and the Windows server is restarted.

Interactive Installation

  1. Download the Identity_Manager_4.8_Windows.iso from the download site.

  2. Mount the downloaded iso.

  3. Based on the component that you wish to install, run the install.exe available at the following locations:

    • Identity Manager Server: <iso mounted location>\IdentityManagerServer

    • Identity Applications: <iso mounted location>\IdentityApplications

    • Identity Reporting: <iso mounted location>\IdentityReporting

  4. Select the language that you want to use for the installation and click OK.

    The Introduction screen displays the components available for installation.

  5. Click Next.

  6. Read and accept the license agreement.

  7. Select the components you wish to install and click Next.

  8. Specify the installation folder and then click Next.

    NOTE:The custom installation folder should not contain special characters such as . and _.

  9. Select the installation type:

    • Typical Installation

    • Custom Installation

  10. Based on the mode of installation that you have selected, the installation parameters will differ. Specify the required details. For information on the configuration parameters, see the following tables:

  11. Review the details on the pre-install summary page and click Install.

Silent Installation

To run a silent installation of the Identity Manager components, use the properties files available in the .iso for the respective components. The Identity Manager media includes a sample properties file at <iso_downloaded_location>\<Identity Manager Component>\response-files location.

To install the component using silent installation, perform the following actions:

  1. Download the Identity_Manager_4.8_Windows.iso from the NetIQ Downloads website.

  2. Mount the downloaded .iso.

  3. Based on the mode of installation that you want to use for installing the components, use the typical_install.properties or custom_install.properties files available at the following locations:

    • Identity Manager Server: <iso mounted location>\IdentityManagerServer\response-files

    • Identity Applications: <iso mounted location>\IdentityApplications\response-files

    • Identity Reporting: <iso mounted location>\IdentityReporting\response-files

  4. Modify the installation parameters according to your requirement. For information on the configuration parameters, see the following tables:

  5. To run the silent installation, run the following command from the directory of the component to be installed:

    .\install.exe -i silent -f <path to typical or custom install properties file>

    For example:

    .\install.exe -i silent -f C:\Users\Administrator\Desktop typical_install_idmengine.properties

  6. (Optional) For default installed locations, see the install log. For example, you can check the following files:

    C:\Program Files\NetIQ\IDM\Install\logs

3.4.2 Installing Remote Loader

Identity Manager provides you an option to install Remote Loader on a standalone server. Use this option when you want to install Identity Manager Engine and Remote Loader on separate computers.

NOTE:You can install the 64-bit Remote Loader and .NET Remote Loader using this option. To install a 32-bit remote loader, see Installation Procedures for Identity Manager Server, Identity Applications, and Identity Reporting.

Interactive Installation

  1. Download the Identity_Manager_4.8_RL_Windows.iso from the NetIQ Downloads website.

  2. Mount the downloaded.iso.

  3. From the mounted location, run the install.exe file.

  4. Select the language that you want to use for the installation and click OK.

  5. Click Next.

  6. Read and accept the license agreement.

  7. Click Next.

  8. Specify the installation folder and click Next.

  9. Click Install.

Silent Installation

  1. Download the Identity_Manager_4.8_RL_Windows.iso from the NetIQ Downloads website.

  2. Mount the downloaded.iso.

  3. Navigate to the <ISO mounted location>\response-files.

  4. To perform a silent installation, run the following command from the directory of the properties file:

    install.exe -i silent -f install.properties

3.4.3 Installing Java Remote Loader

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 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\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. Download the Identity_Manager_4.8_Windows.iso from the NetIQ Downloads website.

  5. Mount the downloaded .iso.

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

  7. 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.

  8. 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.

  9. On the target computer, unzip and extract the .tar.gz files.

    For example, use 7-Zip or supported software to unzip .tar.gz files.

  10. 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

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

  12. 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.

  13. 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.

  14. 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

3.4.4 Installing .NET Remote Loader

To install the .NET Remote Loader as an administrative user:

  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.

  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.

3.4.5 Installing SSPR

The installer provides you an option to install SSPR separately. Use this option when you want to install Identity Applications and SSPR on separate computers. This is the only option to install SSPR in a Standard Edition. SSPR is not automatically installed in a Standard Edition.

You can perform an interactive or a silent installation of SSPR.

Interactive Installation

  1. Download the Identity_Manager_4.8_Windows.iso from the NetIQ Downloads website.

  2. Mount the downloaded.iso.

  3. Navigate to the <ISO mounted location>\common\sspr directory.

  4. Run the install.exe file.

  5. Select the language that you want to use for the installation and click OK.

  6. Click Next.

  7. Read and accept the license agreement.

  8. Click Next.

  9. Specify the installation folder and click Next.

  10. Specify the configuration settings for SSPR. For more information, see Configuration Worksheet for Self-Service Password Reset.

  11. Click Next.

  12. Click Install.

Silent Installation

  1. Download the Identity_Manager_4.8_Windows.iso from the NetIQ Downloads website.

  2. Mount the downloaded.iso.

  3. Navigate to the <ISO mounted location>\common\sspr directory.

  4. To perform a silent installation, run the following command from the directory of the properties file:

    install.exe -i silent -f sspr_silentinstall.properties