16.2. Finding the Right Patches to Apply
Abstract
This section explains how to find the patches for a specific version of AMQ on the Red Hat Customer Portal and how to figure out which patches to apply, and in what order.
Locate the patches on the customer portal
If you have a subscription for AMQ, you can download the latest patches directly from the Red Hat Customer Portal. Locate the patches as follows:
- Login to the Red Hat Customer Portal using your customer account. This account must be associated with an appropriate Red Hat software subscription, otherwise you will not be able to see the patch downloads for AMQ.
- Navigate to the customer portal Software Downloads page.
- In the Product dropdown menu, select the appropriate product (for example, A-MQ or Fuse), and then select the version, 6.3, from the Version dropdown menu. A table of downloads now appears, which has three tabs: Releases, Patches, and Security Advisories.
- Click the Releases tab to view the GA product releases.
- Click the Patches tab the rollup patches, and the regular incremental patches (with no security-related fixes).
- Click the Security Advisories tab to view the incremental patches with security-related fixes.
Note
To see the complete set of patches, you must look under the Releases tab, the Patches tab and the Security Advisories tab.
Types of patch
The following types of patch can be made available for download:
- Rollup patches
- Incremental patches
Rollup patches
A rollup patch is a cumulative patch that incorporates all of the fixes from the preceding patches. Moreover, each rollup patch is regression tested and establishes a new baseline for the application of future patches.
Since AMQ 6.2.1, a rollup patch file is dual-purpose, as follows:
- Each rollup patch file is a complete new build of the official target distribution. This means you can unzip the rollup patch file to obtain a completely new installation of AMQ, just as if it was a fresh download of the product (which, in fact, it is). See Section 16.3, “Installing a Rollup Patch as a New Installation”.
- You can also treat the rollup patch as a regular patch, using it to upgrade an existing installation. That is, you can provide the rollup patch file as an argument to the standalone patch console commands (for example,
patch:addandpatch:install) or the Fabric patch console command,patch:fabric-install.
Incremental patches
Incremental patches are patches released either directly after GA or after a rollup patch, and they are intended to be applied on top of the corresponding build of AMQ. The main purpose of an incremental patch is to update some of the bundles in an existing distribution.
Which patches are needed to update the GA product to the latest patch level?
To figure out which patches are needed to update the GA product to the latest patch level, you need to pay attention to the type of patches that have been released so far:
- If the only patches released so far are patches with GA baseline (Patch 1, Patch 2, and so on), apply the latest of these patches directly to the GA product.
- If a rollup patch has been released and no patches have been released after the latest rollup patch, simply apply the latest rollup patch to the GA product.
- If the latest patch is a patch with a rollup baseline, you must apply two patches to the GA product, as follows:
- Apply the latest rollup patch, and then
- Apply the latest patch with a rollup baseline.
Which patches to apply, if you only want to install regression-tested patches?
If you prefer to install only patches that have been regression tested, install the latest rollup patch.
