How to resolve "Found a version of YugabyteDB which does not send universe_uuid in its response of yb_servers function" in YugabyteDB

Environment

• YugabyteDB Smart JDBC Driver

Issue

When connecting to a multiple UugabyteDB cluster using Drivers, you may see the following info message repeatedly in your logs:

Found a version of YugabyteDB which does not send universe_uuid in its response of yb_servers() function. Connecting to more than one such clusters is not supported.

Root Cause

This message occurs because the JDBC smart driver expects each YugabyteDB cluster to return a universe_uuid in the response to the yb_servers() RPC. Older YugabyteDB versions (before v2024.1.6.0, v2024.2.3.0, or v2.25.2.0) do not return this field.
 

The driver needs universe_uuid to distinguish between clusters when connecting to multiple clusters simultaneously. If at most one connected cluster is on an older version, functionality is preserved, but multi-cluster support will be limited.

Impact

• Single-cluster environment: The info message is harmless; no action needed.
• Multiple clusters: Only one cluster can be on an older, unsupported version. If more than one is missing universe_uuid, load balancing and failover across those clusters will not work correctly.

Recommended Action

• If you are connecting to only one cluster, you can safely ignore this message.
• If you intend to connect to multiple clusters using the driver:
  • Upgrade all but one cluster to a YugabyteDB version that supports returning universe_uuid (v2024.1.6.0, v2024.2.3.0, v2.25.2.0 or later).
  • See YugabyteDB Docs: Smart Drivers – Connect to Multiple Clusters for upgrade instructions and details.