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 the form of a patch file. This patch file can be used to update all your Access Manager Appliance components.
IMPORTANT:In a cluster setup, ensure that you install the patch on each node of the Access Manager setup.
Before upgrading, back up your current configuration. If the upgrade fails for any reason, you can use the backup file to recover your configuration.
To back up your Access Manager Appliance configuration, do the following on the primary Administration Console go to the /opt/novell/devman/bin directory. Run ambkup.sh script
To use the patch to upgrade to the latest Access Manager Appliance patches, verify that your current version of Access Manager Appliance is 3.2.1-57.
In the Administration Console, click > > > .
Examine the value of the field to see if it displays 3.2 SP1 version 3.2.1-57.
To download the patch:
Go to download.novell.com/patch/finder and specify AM_32_SP1_IR1a.zip in the field and click .
Download and save the 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.
Unzip the file using the unzip AM_32_SP1_IR1a.zip command.
After extraction, the following files and folders are created in the AM_32_SP1_IR1a 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 on a Linux server. |
|
installPtool.cmd |
Script to install the patch on a Windows server. |
|
AM_32_SP1_IR1a_201.patch |
The patch file. The name of the patch file changes for each IR release. |
Install the patch after extracting files from the AM_32_SP1_IR1a.zip file.
Log in as the root user.
Run the sh installPtool.sh command.
This command installs the patch and the bundled patch file.
HINT:To manage the Access Manager Appliance patch file, go to /opt/novell/nam/patching/bin folder.
If the patch is already installed, the existing patch files are replaced.
After the patch is installed, go to the /opt/novell/nam/patching/bin folder.
Use the following options to administer the Access Manager Appliance patch file.
|
Option |
Description |
Command on Linux server |
|---|---|---|
|
-qa |
Lists all the installed patches. |
./patch -qa |
|
-q |
Lists the details of a patch that is installed. |
./patch –q Example: If you have installed AM_32_SP1_IR1a_201.patch, use the following command:./patch –q IR1a-201 |
|
-i |
Installs a patch. During installation of the patch, all running services are stopped temporarily. After the patch is installed, all the services are restarted and details of the operation are written to log files. |
./patch –i <location and name of the patch> Example:./patch –i /tmp/ AM_32_SP1_IR1a_201.patch |
|
-e |
Removes a patch. Use this option to remove an installed patch. The patch maintains content relationship between 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 the running services are stopped temporarily. |
./patch –e <patch name> Example:./patch –e IR1a-201 |
|
-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 name of the patch> Example:./patch –qpl /tmp/AM_32_SP1_IR1a_201.patch |
|
-v |
Verifies a patch. Use this option to verify the integrity of a patch file. |
./patch –v <location and name of the patch> Example:./patch –v /tmp/AM_32_SP1_IR1a_201.patch |
|
-t |
Verifies if services can be restored by the installer. |
./patch –t <location and name of the patch> Example:./patch –t /tmp/AM_32_SP1_IR1a_201.patch |