7.2.3 Release Notes

Red Hat JBoss Data Grid 7.2

Release Information for JBoss Data Grid

Red Hat Customer Content Services

Abstract

JBoss Data Grid 7.2.3 Release Notes describe new features and enhancements. These Release Notes also provide details about issues that exist in this release of JBoss Data Grid as well as issues that this release resolves, along with information on supported configurations and component versions.

Chapter 1. JBoss Data Grid 7.2.3

1.1. Introduction to Red Hat JBoss Data Grid

JBoss Data Grid is an open source, distributed, in-memory key/value data store built from the Infinispan open source software project. JBoss Data Grid is designed to provide elastic, high performance, highly available capabilities that scale linearly.

You can deploy JBoss Data Grid as a server in Remote Client-Server mode or embedded in a Java Virtual Machine (JVM) in Library mode to distribute and replicate data across a cluster of nodes.

JBoss Data Grid allows you to optionally write data to disk and provides access to data from a variety of clients as well as through a RESTful API, the Memcached and Hot Rod protocols, or directly in process through a Java Map API.

1.2. About the Release Notes

Release Notes provide information about new features as well as known and resolved issues. You should read this document before installing JBoss Data Grid 7.2.

You can find the complete set of documentation for JBoss Data Grid at the JBoss Data Grid Product Documentation page in the Red Hat Customer Service Portal.

Chapter 2. Patching Red Hat JBoss Data Grid Server Instances

2.1. Applying Patches to Red Hat JBoss Data Grid Server Instances

Red Hat JBoss Data Grid server uses the patching functionality in JBoss Enterprise Application Platform (EAP) so that you can apply changes from errata releases without the need to completely replace an existing installation.

Patches are distributed for cumulative updates within a release version. The base version for this release is 7.2.0. You can apply 7.2.x patches to the base version or on top of other patches.

You cannot apply 7.2.x patches to any other JBoss Data Grid release version. Likewise you cannot apply patches from other release versions to the 7.2 release.

JBoss Data Grid provides patches for server instances only (Remote Client-Server mode). All other distributions, such as EAP modules, clients, and JBoss Data Grid Library mode, are provided as full releases.

Important

If you have applied the patch for JBoss Data Grid 7.2.2, you must first revert that patch before you apply the patch for JBoss Data Grid 7.2.3 or later. A known issue exists that prevents you from applying any patch on top of JBoss Data Grid 7.2.2.

To revert the patch for JBoss Data Grid 7.2.2, you do not need to reset the configuration. Revert the patch as follows:

$ bin/cli.sh "patch rollback --patch-id=jboss-jdg-7.2.2.CP --reset-configuration=false"

See Reverting Patches for information on rolling back patches.

To apply a patch to JBoss 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 JBoss Data Grid while the server is running.

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

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

    $ cd JDG_HOME
  4. Apply the patch as follows:

    $ bin/cli.sh "patch apply /path/to/jboss-datagrid-7.2.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

2.2. Reverting Patches

You can roll back patches to revert the Red Hat JBoss Data Grid server to the previously installed version.

Important

You should roll back patches only after applying a patch that results in unexpected behavior or undesirable effects. Rolling back patches is not intended for general uninstall functionality.

To revert a JBoss Data Grid patch, do the following:

  1. Stop the server instance that you want to roll back if it is running.

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

  2. Open a terminal and change to the JDG_HOME directory.

    $ cd JDG_HOME
  3. Find the ID of the patch that you want to roll back.

    $ bin/cli.sh "patch history"
  4. Roll back the server version as follows:

    $ bin/cli.sh "patch rollback --patch-id=PATCH_ID --reset-configuration=false"
    Warning

    Use caution when specifying the reset-configuration option.

    --reset-configuration=false does not revert the server configuration. Because applying patches can change the server configuration, it is possible that the server does not restart if you roll back the patch but do not roll back the configuration. In this case, you should verify the server configuration and manually adjust it as needed before starting the server.

    --reset-configuration=true reverts the server configuration to the pre-patch state. Any changes to the server configuration after the patch was applied are removed.

    If conflicts exist when you attempt to roll back the patch, the operation fails and warnings occur. Enter patch --help to list available arguments that you can use to resolve the conflicts.

  5. Start the server with either the standalone.sh or domain.sh script.

Chapter 3. New Features and Enhancements

3.1. Default Analyzers

JBoss Data Grid now provides a set of default analyzer definitions. For more information, see Default Analyzer Definitions in the Developer Guide.

3.2. Hot Rod Client Properties Include Near Cache Configuration

The Java Hot Rod client is updated to include near cache configuration as well as improved documentation for other properties. For more information, see the Configuration class in the Java Hot Rod Client API documentation.

Chapter 4. Supported Configurations

4.1. Supported configurations

Supported hardware and software configurations for JDG 7.2 are available on the Customer Portal at https://access.redhat.com/articles/2435931.

Chapter 5. Component Versions

5.1. Component Versions

The full list of component versions used in Red Hat JBoss Data Grid 7.2 are available on the Customer Portal at https://access.redhat.com/site/articles/488833.

Chapter 6. Known Issues

6.1. Known Issues

Find out about known issues and available workarounds in this release of Red Hat JBoss Data Grid.

Cannot Apply Patches to JBoss Data Grid Server If the 7.2.2 Patch Is Applied

Issue: JDG-2178

Description: If you have applied the patch for JBoss Data Grid 7.2.2, you must first revert that patch back before you apply the patch for JBoss Data Grid 7.2.3 or later. You cannot apply patches for subsequent releases on top of JBoss Data Grid 7.2.2.

Workaround: Revert the patch for JBoss Data Grid 7.2.2 as follows:

$ bin/cli.sh "patch rollback --patch-id=jboss-jdg-7.2.2.CP --reset-configuration=false"
JBoss Data Grid Does Not Start and NullPointerException Occurs if Persistent Location is Not Unique

Issue: JDG-1504

Description: It is not possible to start more than one instance of JBoss Data Grid from the same directory if the value of persistent-location is not unique in each configuration.

Workaround: Do one of the following to ensure the value of persistent-location is unique in the JBoss Data Grid configuration:

  • Set a unique path attribute for each instance.

    <persistent-location path="mydir${uniquesuffix}" />
  • Set a unique relative-to attribute for each instance if using a common path:

    <paths>
      <path name="mypath" path="/home/user/jboss-datagrid-7.2.0-server/standalone/mypath" />
    </paths>
    
    <persistent-location relative-to="mypath" path="mydir" />
  • Specify the -Djboss.server.data.dir system property to set a unique relative location for each instance if using a common path:

    ./standalone.sh -Djboss.server.data.dir=/home/user/jboss-datagrid-7.2.0-server/standalone/mypath
SKIP_CACHE_LOAD Flag Has No Effect if Authentication is Enabled

Issue: JDG-1424

Description: In Remote Client-Server mode, if you set the SKIP_CACHE_LOAD flag in the cache store configuration and enable authentication on Hot Rod clients, all entries are retrieved from the cache, including evicted entries.

Workaround: There is no workaround for this issue.

Intermittent Data Loss Occurs During Rolling Upgrades Between Clusters

Issue: JDG-991

Description: When performing a rolling upgrade of JBoss Data Grid, all migrated data can be deleted from the target cluster after the nodes in the source cluster are taken offline.

Workaround: There is no workaround for this issue.

Cluster Actions Disabled on JBoss Data Grid Administration Console in Reload-Required State

Issue: JDG-1843

Description: Actions available for the JBoss Data Grid cluster are not available in the Administration Console if you choose to restart the cluster after changing the configuration. In this case, the cluster is in the Reload-Required state.

Reload and Stop actions are available for each node in the cluster.

Workaround: Reload at least one node in the cluster to restore actions at the cluster level.

Errors Occur When Changing the Eviction Strategy from the JBoss Data Grid Administration Console

Issue: JDG-1804

Description: If JBoss Data Grid is running in domain mode and you change the eviction strategy in the configuration through the Administration Console but do not restart to apply the changes, an error occurs.

Workaround: Restart the server after changing to the eviction strategy.

NullPointerException Occurs When Reading Data from Persistent Storage in JBoss Data Grid 7.0 and Earlier

Issue: JDG-968

Description: If you store data in a cache store with JBoss Data Grid 7.0 and earlier and then attempt to read that data with JBoss Data Grid 7.1 or later, an error occurs and it is not possible to read the data.

Note

This issue does not apply when upgrading from JBoss Data Grid 7.1 to 7.2.

Workaround: There is no workaround for this issue.

Chapter 7. Resolved Issues

7.1. Resolved Issues

This release of JBoss Data Grid resolves the following issues:

JDG-2100 and JDG-2097 - JBoss Data Grid Quickstarts Missing Dependencies
The secure-embedded-cache and cdi-jdg quickstarts fail with errors when you attempt to run them.
JDG-2110 - JBoss Data Grid Eviction Strategy Did Not Take Effect
Setting the Exception eviction strategy in the JBoss Data Grid configuration did not take effect.
JDG-2105 - Documentation for the Hot Rod Node.js Client
The Readme documentation for Hot Rod Node.js client was not updated to include details on memory profiling capabilities and enhancements to avoid excessive memory consumption.
JDG-2103 - Operations with the Hot Rod Client Took Longer Than Expected after Network Split
If JBoss Data Grid detected a network split that partitioned nodes, the Hot Rod client took longer than expected to perform operations to the cluster.
JDG-2071 - Enabling Server Hinting Caused the Management Console to Display Nothing
If Server Hinting was enabled in the JBoss Data Grid configuration, the Management Console displayed nothing after login.
JDG-2070 - Failover to Remote Sites Not Successful with Cross-Site Replication
In an environment where JBoss Data Grid was configured to failover from one site to another, failover did not occur successfully and a warning was thrown.
JDG-1870 - Hot Rod Node.js Client Had Expired Certificates
The Hot Rod Node.js client included expired certificates.
JDG-1053 - The Nodes Tab in the Management Console Returns an HTTP 404 Error
When opening the Nodes tab for the default cluster, the Management Console returned an HTTP 404 error.

Legal Notice

Copyright © 2018 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.