4.3 Applying Access Manager Appliance 4.0 Hotfix* Patch

You can upgrade Access Manager 4.0 to 4.0 Hotfix by applying the Hotfix patch.

NOTE:Hotfix* is used to represent the hotfix number released for Access Manager Appliance 4.0.

Installing patches are not supported on the evaluation version. To install patches, upgrade to the licensed version using information at Upgrading from the Evaluation Version to the Licensed Version

The patch helps you upgrade to the latest Access Manager Appliance patches with ease. Instead of downloading tar files that contain the entire set of binaries, you can download a .zip file that contains incremental changes in form of a patch file. You can use this patch file to update all components of your Access Manager Appliance.

IMPORTANT:In a cluster setup, ensure that you install the patch on each node of the Access Manager Appliance setup.

4.3.1 Prerequisites

Ensure that you have installed the latest version of the product. Refer to the following readmes for verifying the version numbers of a specific Hotfix release:

4.3.2 Installing the Patch

Perform the following steps before applying the patch:

  1. Save the hotfix file to the server running Access Manager Appliance. If you have multiple servers in your set up, ensure that you copy this .zip file to all the servers.

  2. Extract the patch file by using the unzip <patch name>.zip command.

    After extraction, the following files and folders are created in the <patch name> folder:

    File/Folder Name

    Description

    rpm

    Contains rpm files for the patch to run on a Linux server.

    Patchtool

    Contains logging properties file and files necessary for the patch to run on a Windows server.

    installPtool.sh

    Script to install the patch and the patch tool on a Linux server.

    installPatch.sh

    Script to install the HF patch tool and the updated binaries on a Linux server.

    installPtool.cmd

    Script to install the patch on a Windows server.

    <patch name>-xxx.patch

    The patch file. The name of the patch file changes for each HF release.

    NOTE:xxx represents the build number which is available in the respective release readme.

  3. Log in as the root user.

  4. Go to the location where you have extracted the patch files.

  5. Run the sh installPatch.sh command.

    This command installs the patch and the bundled binaries.

    HINT:To manage the Access Manager Appliance patch file, go to /opt/novell/nam/patching/bin folder.

If the patch is already installed, the installer exits with a message.

4.3.3 Administering Patches

  1. After the patch is installed, go to the /opt/novell/nam/patching/bin folder.

  2. Use the following options to administer the Access Manager Appliance patch file.

NOTE:xxx represents the build number which is available in the respective release readme.

Option

Description

Command on Linux server

-qa

Lists all installed patches.

./patch -qa

-q

Lists the details of an installed patch.

./patch –q

Example: If you have installed <latest release patch name>, use the following command:./patch –q HF*-xxx

-i

Installs a patch. During installation of a patch, all running services are stopped temporarily. After a patch is installed, all services are restarted and details of the operation are written to log files.

./patch –i <location and patch name>

Example:./patch –i /tmp/AM_400_HF*-xxx.patch

-e

Removes an installed patch. The patch maintains content relationship among patches. So, if you have installed patch 1 and patch 2, patch 1 cannot be removed without removing patch 2. This is because patch 2 contains details of patch 1 as well.During the patch process, all running services are stopped temporarily.

./patch –e <patch name>

Example:./patch –e HF*-xxx

-qpl

Lists details of a patch that is not installed. If you want to view the changes that are included in the patch file without installing it on your server, use this option

./patch –qpl <location and patch name>

Example:./patch –qpl /tmp/AM_400_HF*-xxx.patch

-v

Verifies integrity of a patch.

./patch –v <location and patch name>

Example:./patch –v /tmp/AM_400_HF*-xxx.patch

-t

Verifies if services can be restored by the installer.

./patch –t <location and patch name>

Example:./patch –t /tmp/AM_400_HF*-xxx.patch