Invalidation support

HCL Cache relies on Redis PUBSUB technology (Elastic-based search solution uses Redis PUBSUB for Near Real-Time (NRT) updates) to replicate invalidation messages. For more information on Redis PUBSUB for NRT updates, see The Elastic index lifecycle. Each cache defines a topic, with format {cache-namespace-cacheName}-invalidation where invalidation messages are issued and received.

The Redis database provides commands, that allow you to list listeners (PUBSUB CHANNELS), publish (PUBLISH) and subscribe to messages (SUBSCRIBE). See Invalidation in Redis for details.

Timing considerations

Sending and receiving invalidation messages using Redis is fast, but not instantaneous. Consider an Commerce+ request that executes in the Transaction serverts-app and makes a change to data in the database. Immediately after the database transaction commits, the local cache is invalidated and invalidation messages are sent to peer application servers. Meanwhile, the application may execute a subsequent request that expects to use the updated data. When the messages are received by the peer servers, they are immediately processed and the local cache is invalidated according to the messages received. But between the time that the messages are sent and the time that the local caches are invalidated, the data in the local caches is "stale". If the subsequent request is received in a peer server before the cache invalidation has completed, it will see the stale data, perhaps causing incorrect processing to occur.

To help avoid accessing stale data due to this situation, the Commerce+ data cache provides optional configurations to introduce a short delay in the original Transaction server request, just after the invalidation messages are sent, and before the request returns. If the delay is long enough to allow the invalidation messages to be completely processed in peer application servers, the timing problem can be avoided.

The delayAfterInvalidationMilliseconds data cache configuration can be used to specify how long a delay should be introduced. But it may be difficult to estimate how much delay should be introduced. The additional delayAfterInvalidationPercentBuffer configuration can be used to add an additional delay that is based on how long it typically takes to send and receive an invalidation message. This setting only has an effect when the delayAfterInvalidationMilliseconds is greater than zero. These settings can be specified on a global level, or can be specified for only certain logical caches. For more information about these settings, see ../../admin/concepts/cdcaddcomdatcacheconfig.html.

For example, if occasionally accessing stale data is unacceptable, specifying delayAfterInvalidationMilliseconds=1 and delayAfterInvalidationPercentBuffer=100 inserts a delay of 1 millisecond plus twice the length of time it typically takes to send and receive a message. That should be more than enough time to avoid the possibility of accessing stale data.