Release Date: May 2026
Release Type: Feature Release
Branch: 2.6.0
New Features
Multi-Master Cluster Replication Foundation
OneDB v2.6.0 introduces the first foundation of multi-master cluster replication for OneDB configuration data.
With this feature, changes made on one active OneDB node can be replicated to other registered active nodes in the background. This helps prepare OneDB for High Availability deployments where more than one OneDB node may remain active.
Key capabilities include:
- Background replication between active OneDB nodes
- Ordered replication events for more consistent replay
- Retry handling when a target node is temporarily unavailable
- Protection against replication loops when remote changes are applied
- Generic row-based replication logic for supported configuration tables
- Snapshot synchronization when a new cluster node is registered
Improved Node Registration and Synchronization
When a new node is added to the cluster, OneDB now performs an initial synchronization process before the node becomes active.
The node lifecycle now includes clearer states:
| State | Description |
|---|---|
| SYNCING | The node is being initialized and synchronized. |
| ACTIVE | The node is ready and participating in replication. |
| FAILED | The node could not complete the expected replication or synchronization flow. |
This gives administrators better visibility when managing cluster nodes from the OneDB Cluster UI.
Generic Snapshot Synchronization
OneDB v2.6.0 replaces the previous table-copy approach with a more flexible snapshot synchronization mechanism.
This allows OneDB to synchronize configured data using replication configuration, making the cluster replication design easier to maintain and extend in future versions.
Automatic Cache Reload After Replication
After replicated changes are applied to another node, OneDB can trigger an internal cache reload on the target node.
This helps ensure that important runtime configurations are refreshed without restarting the application, including:
- Key configuration
- Masking policy
- Token templates
- Field settings policy
- Query whitelist
- Site configuration
- API tokenization cache
Enhancements
OneDB v2.6.0 improves cluster readiness, node synchronization, and replication reliability across OneDB nodes.
This release also improves the High Availability foundation by making node registration, synchronization flow, replication handling, and cache refresh behavior more structured.
Bug fixes
No major public bug fixes are included in this release note.
Security Updates
No specific security update is included in this release note.
Known Notes
OneDB v2.6.0 is an early High Availability foundation release. The replication behavior is designed with eventual consistency in mind.
Administrators should still be careful with concurrent updates, delete conflicts, or update conflicts across multiple active nodes, especially during operational procedures.
For best results, all cluster nodes should use the same OneDB version and compatible database schema.
Cluster replication depends on the OneDB Key Manager database connection and should be configured by the system administrator during deployment.
Summary
OneDB v2.6.0 brings the first major step toward active-active cluster capability.
This release introduces background multi-master replication, improved node synchronization states, retry-safe replication handling, generic snapshot synchronization, and automatic cache reload between nodes.
It strengthens OneDB’s High Availability roadmap and prepares the platform for more advanced cluster behavior in future versions.