52.1 Applying Software Update to the Identity Manager Engine and Remote Loader

The Identity Manager engine and Remote Loader service pack updates the Identity Manager server and the Remote Loader. You can install the service pack in the guide (GUI) and silent modes only. The service pack does not support console mode.

To view the log files for the installation, navigate to the following locations:

  • Linux: /tmp/logs/idmPatchInstall.log

  • Windows: \%Temp%\logs

NOTE:For Windows servers, the service pack creates a backup folder in the \%UserProfile%\PatchInstallerBackUp<Date><Time> directory.

52.1.1 Prerequisites for Installing the Service Pack

Before installing the service pack, complete the following steps:

  1. Stop the eDirectory daemon.

    If you do not stop eDirectory, the service pack installer attempts to stop it. If the program fails to stop eDirectory, it displays a warning message. Then you will need to manually stop eDirectory.

  2. Stop the Remote Loader services.

    If the Remote Loader is in use, the service pack cannot update the Remote Loader.

  3. (Conditional) For a non-root installation, set the Java path by completing one of the following actions:

    • Edit the JAVA_NONROOT variable in the install.sh file for the service pack.

    • Export the Java 1.7 path.

  4. In a browser, navigate to the NetIQ downloads page.

  5. Under Patches, click Search Patches.

  6. Specify Identity Manager nn patch in the search box

  7. Download and unzip the contents of the file.

52.1.2 Installing the Service Pack as a Root User in GUI Mode

For a root installation, complete the following steps.

  1. Ensure that you have completed the prerequisites for installing the service pack. For more information, see Section 52.1.1, Prerequisites for Installing the Service Pack.

  2. On the server where you want to run the service pack, log in as root.

  3. Navigate to the cd-image directory where you unzipped the service pack files.

    For more information, see Section 52.1.1, Prerequisites for Installing the Service Pack.

  4. Depending on your platform, run one of the following commands:

    • Linux Execute the ./install.sh command in a terminal window.

    • Windows Launch the install.bat file.

  5. Select the components that you want to install, then click Install.

  6. (Conditional) To update the Remote Loader, complete the following actions:

    1. Click OK for the warning message about stopping the Remote Loader.

      Ensure that you have stopped the Remote Loader.

    2. If the installer cannot detect a 32-bit or 64-bit Remote Loader installed on your computer, Browse to the path for the installed Remote Loader.

      NOTE:By default, the service pack installer provides a Browse option for the Identity Manager server on Linux. It is not available on Windows by default.

  7. Review the installation status of the selected components, then click Done.

  8. (Conditional) Linux: To verify that the service pack has been successfully applied for the Identity Manager components that you selected in Step 5, complete the following steps:

    1. Check the Identity Manager server trace to verify that your Identity Manager version is updated. The trace window shows the following output:

      <product version="4.5.n.n">DirXML</product>

      where n represents the version of the Identity Manager service pack.

    2. To verify that Identity Manager RPMs are installed on your computer, run the command:

      rpm -qa | grep nov | grep 4.5 
  9. (Conditional) Windows: To verify that the service pack has been successfully applied for the Identity Manager components that you selected in Step 5, complete the following steps:

    1. Check the modification date for the files updated by the service pack installer.

    2. Launch the Remote Loader.

    3. Click Properties, then right-click rlconsole.exe.

    4. Click Properties > Details.

    5. Verify that the value in the file version is 4.5.n.n where n represents the version of the Identity Manager service pack.

52.1.3 Installing the Service Pack as a Non-Root User in GUI Mode

To run a non-root installation using the guided process, complete the following steps.

  1. Ensure that you have completed the prerequisites for installing the service pack. For more information, see Section 52.1.1, Prerequisites for Installing the Service Pack.

  2. On the server where you want to run the service pack, log in as a non-root user.

  3. Run the install.sh file.

  4. Browse for the base location of eDirectory. For example, /home/<user>/eDirectory.

  5. Click Install.

52.1.4 Silently Installing the Service Pack

To run a silent installation of the Identity Manager service pack installer, you must have a patchUpgradeSilent.Properties file. NetIQ provides a sample file located by default in the cd-image directory. This procedure can be used for a root or non-root installation.

  1. Ensure that you have completed the prerequisites for installing the service pack. For more information, see Section 52.1.1, Prerequisites for Installing the Service Pack.

  2. Modify the contents of the patchUpgradeSilent.Properties file.

    The sample file contains the following information:

    #Silent Properties File IDMPatchInstaller
    #eDirectory and RemoteLoader services should be stopped before installation
    #Set this property to true/false for Engine Upgrade for root and non root install
    install_Engine=true
    #Set this property to true/false for Remote Loader32 Upgrade
    install_RL32=true
    #Set this property to true/false for Remote Loader64 Upgrade
    install_RL64=true
    #Set this property for Engine Upgrade for NON ROOT user
    #eg: If the engine location is /home/eDirectoryNonRoot/eDirectory/opt/novell/eDirectory select till eDirectory(parent directory of /opt)
    engine_Location=/home/eDirectoryNonRoot/eDirectory/
    #Set this property for Remote Loader 32-Bit Install location 
    #Only for Windows
    RL32_Location=C:\\Novell\\IdentityManager\\RemoteLoader\\32bit
    #Set this property for Remote Loader 64-Bit Install location 
    #Only for Windows
    RL64_Location=C:\\Novell\\IdentityManager\\RemoteLoader\\64bit

    NOTE:On Windows servers, the service pack installation uses the same installation path for the Identity Manager engine server that was specified when Identity Manager 4.5 was installed.

  3. (Conditional) For a non-root installation, uncomment the engine_Location property to point to the exact location of the Identity Manager engine.

  4. To launch the installation process, enter one of the following commands:

    • Linux: <service pack location>/install.sh -i silent -f <filename>

    • Windows: <service pack location>\install.bat -i silent -f <filename>

    NOTE:If you run the non-root installation of Identity Manager as a root user, the installation program displays following warning:

    NetIQ recommends that you apply only patches pertaining to the installed IDM version. If you understand the risk and want to proceed, type yes else no:. 

    Ignore the warning message, and enter Yes to proceed.