7.12 Installing the Identity Manager 4.0.1 Patch

The Identity Manager 4.0.1 patch file contains updates for the Metadirectory server and the Remote Loader. The Identity Manager 4.0.1 patch can be installed in GUI and silent modes only. Console mode is not supported.

7.12.1 Prerequisites

  • Stop eDirectory.

    If eDirectory is not stopped, the patch installer tries to stop it.

  • Stop Remote Loader services.

    If the Remote Loader is in use, the patch installer cannot replace it.

  • (Conditional) Set the Java path for a non-root installation.

    Edit the JAVA_NONROOT variable in the install.sh file or export the Java 1.6 path.

7.12.2 GUI Installation

Run the following steps for both root and non-root installation.

  1. Download the Identity Manager 4.0.1 patch file from Novell and unzip the file.

  2. Change to the cd-image directory where you unzipped the files. Depending on your platform, run one of the following commands:

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

    • Windows: Launch the install.bat file.

  3. (Conditional) If eDirectory is running, the patch installer stops it. Click OK to continue the installation.

    or

    If the patch installer fails to stop eDirectory, a warning message is displayed. You can manually stop eDirectory and click OK to continue or click Cancel to stop the installation.

  4. From the patch installer page that displays on the screen, select the desired components for installation or upgrade, then click Install.

  5. (Conditional) If you are doing a non-root installation, click Browse and specify the path of eDirectory installation, then click Install.

    For a non-root installation, only Metadirectory server patch is available.

  6. (Conditional) A warning message is displayed if you selected Remote Loader in Step 4. Stop the Remote Loader service, then click OK.

    or

    If the Remote Loader service is already stopped, click OK.

    For Remote Loader, the Browse button is enabled if the patch installer is not able to detect a 32-bit or 64-bit Remote Loader installed on your system. Use the Browse button to specify the path of eDirectory installation.

    By default, the Browse button is available for the Metadirectory server on Linux. It is not available on Windows.

  7. Review the installation status of the selected components in an output screen, then click Done.

  8. (Conditional) Verify that the patch has been successfully applied for the Identity Manager components that you selected in Step 4.

    • Linux/Solaris: Do the following:

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

        <product version="4.0.1.x">DirXML</product>

        where x is the version of the Identity Manager patch.

      • On Linux, run the rpm -qa | grep nov | grep 4.0.1 command to verify Identity Manager RPMs installed on your system. On Solaris, running this command shows Identity Manager packages installed on your system.

      NOTE:In a non-root patch installation/upgrade, the RPM versions are not upgraded.

    • Windows: Do the following:

      • Check the modification date for the files updated by the patch installer.

      • Verify that the patch has been successfully applied for the Remote Loader:

        1. Launch the Remote Loader.

        2. Go to Properties, right-click rlconsole.exe, then select Properties.

        3. Click the Details tab and verify that the value in the file version is 4.0.1.x.

          where x is the version of the Identity Manager patch.

7.12.3 Silent Installation

In order to run a silent installation of the Identity Manager 4.0.1 patch, you must modify the patchUpgradeSilent.Properties sample file from the cd-image directory. Start the silent installation by using the correct command for your platform:

  • Linux/Solaris: ./install.sh -i silent -f patchUpgradeSilent.Properties

  • Windows: install.bat -i silent -f patchUpgradeSilent.Properties

The sample patchUpgradeSilent.Properties property file has the following attributes:

#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

On Windows, there is no option to specify the Metadirectory server installation path in the silent property file. The patch installer uses the same installation path that has been specified when Identity Manager 4.0.1 was installed.

The log files are available at the following locations:

  • Linux: /tmp/logs/idmPatchInstall.log

  • Solaris: /var/tmp/logs/idmPatchInstall.log

  • Windows: \%Temp%\logs

    The patch installer backup folder is created in the \%USERPROFILE%\PatchInstallBackup location. The backup folder is created only for Windows.