From c208ff78665026bb9b9fb3acca6b162adaab3dd4 Mon Sep 17 00:00:00 2001 From: ggivo Date: Thu, 23 Oct 2025 17:20:30 +0300 Subject: [PATCH 1/2] docs: add maintNotificationsConfig to ClientOptions documentation --- docs/advanced-usage.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index 28295f995..bac497604 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -370,6 +370,26 @@ queued commands.

refuse commands and cancel these with an exception.

+Maintenance Notifications +maintNotificationsConfig +enabled() + + +

Since: 7.0

+

Enables Seamless Connection Handover (SCH) by listening for +server-side maintenance event notifications. When enabled, the client +receives push notifications about maintenance operations and can +proactively reconnect to healthy nodes, reducing failed commands during +maintenance windows.

+

Configure endpoint type for reconnection using +MaintNotificationsConfig.enabled(EndpointType.EXTERNAL_IP) +or use MaintNotificationsConfig.enabled() for +auto-detection based on connection characteristics. Disable with +MaintNotificationsConfig.disabled().

+

This feature requires Redis Enterprise or a Redis server that +supports maintenance event notifications.

+ + Replay filter replayFilter (cmd) -> false @@ -494,7 +514,11 @@ store/trust store.

Options to configure command timeouts applied to timeout commands after dispatching these (active connections, queued while disconnected, batch buffer). By default, the synchronous API times out commands using -RedisURI.getTimeout().

+RedisURI.getTimeout().

+

Use relaxedTimeoutsDuringMaintenance(Duration) to set +extended timeout during server maintenance operations (default: 10 +seconds). This helps prevent command failures when Seamless Connection +Handover (SCH) is enabled.

Publish Reactive Signals on Scheduler From 2325f49a866ce936b8396fb867d649851ec720c1 Mon Sep 17 00:00:00 2001 From: ggivo Date: Thu, 23 Oct 2025 17:38:33 +0300 Subject: [PATCH 2/2] move relaxedTimeouts config doc under maintConfig section --- docs/advanced-usage.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index bac497604..9f9e6ad4a 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -386,6 +386,9 @@ maintenance windows.

or use MaintNotificationsConfig.enabled() for auto-detection based on connection characteristics. Disable with MaintNotificationsConfig.disabled().

+

Use TimeoutOptions.relaxedTimeoutsDuringMaintenance(Duration) +to set extended timeout during maintenance operations (default: 10 +seconds).

This feature requires Redis Enterprise or a Redis server that supports maintenance event notifications.

@@ -514,11 +517,7 @@ store/trust store.

Options to configure command timeouts applied to timeout commands after dispatching these (active connections, queued while disconnected, batch buffer). By default, the synchronous API times out commands using -RedisURI.getTimeout().

-

Use relaxedTimeoutsDuringMaintenance(Duration) to set -extended timeout during server maintenance operations (default: 10 -seconds). This helps prevent command failures when Seamless Connection -Handover (SCH) is enabled.

+RedisURI.getTimeout().

Publish Reactive Signals on Scheduler