Chapter 20. Applying Patches to Red Hat Data Grid

Important

In Server Mode, it is not possible to patch Data Grid 7.3.1 or later on top of 7.3.0.

Data Grid 7.3.1 server is provided as a complete distribution. Data Grid 7.3.2 server, as well as each subsequent 7.3.x version, is provided as a patch.

To apply a patch to Data Grid, do the following:

  1. Download the patch from the Red Hat Customer Portal at https://access.redhat.com/downloads/

  2. Stop the server instance that you want to patch if it is running.

    To avoid issues with classloading, you should not apply patches to Data Grid while the server is running.

    Either use the Administration Console to stop the server or enter Ctrl-C in the terminal where Data Grid is running.

  3. Open a terminal and change to the RHDG_HOME directory. 

    $ cd RHDG_HOME

  4. Apply the patch as follows: 

    $ bin/cli.sh "patch apply /path/to/jboss-datagrid-7.3.x-server-patch.zip"

  5. Start the server with either the standalone.sh or domain.sh script, for example: 

    $ bin/standalone.sh -c clustered.xml

Resolving Errors with the 7.3.8 and 7.3.9 Patch

Important

When patching Data Grid server installations to upgrade to 7.3.8 or 7.3.9, an issue with the patch results in an error at startup. You must complete the following procedure after you apply the patch otherwise you cannot start Data Grid.

  1. Open your server configuration file for editing.

  2. Remove http-remoting-connector from the remoting subsystem.

    Before

    <subsystem xmlns="urn:jboss:domain:remoting:4.0">
  <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

    After

    <subsystem xmlns="urn:jboss:domain:remoting:4.0"/>

  3. Save and close your server configuration.

Refer to the following for more information: RHDG server fail to start after patch 7.3.8 is applied (Red Hat Knowledgebase)