17.2. Patching a Broker in a Fabric
Abstract
In a fabric patches are applied to profiles and the patched version of the profile is applied to the broker. The management console is the recommended tool for patching brokers in a fabric. The fabric shell also has the commands needed to apply a patch and roll it out to running brokers.
Overview
The bundles loaded by a broker in a fabric is controlled by the broker's Fabric Agent. The agent inspects the profiles applied to the broker to determine what bundles to load, and the version of each bundle, and then loads the specified version of each bundle for the broker.
A patch typically includes a new version of one or more bundles, so to apply the patch to broker in a fabric you need to update the profiles applied to it. This will cause the Fabric Agent to load the patched versions of the bundles.
The management console is the recommended tool for patching brokers in a fabric. However, the command console's fabric shell also provides the commands needed to patch brokers running in a fabric.
Procedure
Patching a broker in a fabric involves:
- Getting a patch file.
- Customer Support sends you a patch.
- Customer Support sends you a link to download a patch.
- Uploading one or more patch files to the fabric's Maven repository.
- Applying the patch(es) to a profile version.This creates a new profile version that points to the new versions of the patched bundles and repositories.
- Migrate one or two brokers to the patched profile version to ensure that the patch does not introduce any new issues.
- After you are certain that the patch works, migrate the remaining brokers in the fabric to the patched version.
Using the management console
The management console is the easiest and most verbose method of patching brokers in a fabric. The management console Patching tab uploads patches to a fabric's Maven repository and applies the patch to a specified profile version. You can then use the management console to roll the patch out to all of the containers in the fabric.
See Using the Management Console for more information.
Using the command console
The Red Hat JBoss A-MQ command console can also be used to patch brokers running in a fabric. To patch a fabric broker:
- Upload the patch file to the fabric's Maven repository.
- Create a new profile version to which the patch will be applied.
- Modify all of the profiles in the new version which require the patch.
- Use the fabric:container-upgrade command to roll the patch out to the brokers running in the fabric.
