JDG server uses the `patch feature` to install patches for Micro releases (known as CP)

Solution Verified - Updated

Environment

  • Red Hat JBoss Data Grid (JDG RHDG)
    • 6.6.1 and further
    • 7

Issue

  • I can see different distributions for a JDG but did not see a complete server zip file?
  • How can I install a JDG server with version x.y.1, there is no zip file which contain it?
  • Why there is no JDG server for shown within the downloads for JDG in the CustomerSupportPortal (CSP)?
  • I only found a Red Hat JBoss Data Grid 6.6.1 Server Update entry for download, but not a complete server ZIP, where I can download it?
  • There is only a jboss-datagrid-x.y.z-server-patch.zip which does not contain a complete server, how I can install the server with this zip file?
  • Why the JDG server is provided as a patch file?

Resolution

To be able to apply a CP without installing a complete new JDG server the Micro releases from JDG 6.6 onwards are provided as a 'patch.zip' file which cen applied easily with the managment CLI.
It is possible to rollback the patch with or without the configuration if there is any issue.

Install a CP patch to an existing server

Each CP is able to upgrade the server from any other former micro version. If there is any problem the CLI command will reject to install and show a message.

$JDG_HOME/bin/cli.sh [--connect=127.0.0.1:9999]
patch apply /path/to/jboss-datagrid-6.6.1.server-patch.zip

The server must be restarted after the patch has been applied!

Install a new JDG instance with all CP patches

To create a new server instance with the latest CP applied you need to download and unzip the related major version x.y.0 first.
Download the latest CP, the file is named Red Hat JBoss Data Grid x.y.z Server patch and apply the patch by follow Install a CP patch

Root Cause

From JDG 6.6.1 onwards all Micro updates, so called cumulative patches, for the JDG server are provided as a patch which include only the delta and meta information for the CLI.
This is for convenience as it is not longer necessary to replace the complete installation but simple apply the patch via a CLI command.

SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.