udoh.chigozie
08/03/2026, 6:59 PMRocky
08/04/2026, 7:58 AMmax_bdbje_clock_delta_ms).
2. Behavior during a regional outage:
* FE Quorum: StarRocks requires more than half of the Follower FEs to be alive to elect a leader. In a two-region setup (e.g., 2 Followers in Region A, 1 in Region B), if Region A goes down, the surviving region (Region B) will have only a minority and cannot automatically elect a leader.
* Recovery Path: Recovery is manual. You must set bdbje_reset_election_group = true in the surviving FE's fe.conf to force it to become the leader and reset the consensus group.
* CN Behavior: CNs cannot serve queries during an FE outage. CNs rely on the FE Leader for query planning and metadata. If there is no FE Leader, queries will fail.
* Recommended Distribution: Because a two-region split cannot provide automatic failover for a majority-based consensus, it is simply not advised for automatic DR. A 3-region deployment (1 Follower per region) is the standard for automatic regional HA.
──────────
Option 2: Two Independent Clusters
3. FE Metadata Backup and Restore:
Currently, the SQL-based BACKUP and RESTORE commands do not support shared-data clusters. For DR, you must perform a manual file-level backup of the FE meta_dir.
* Restore Path: You can restore by copying the meta_dir to a new FE in the second region and starting it with bdbje_reset_election_group = true.
4. Consistency Mechanism:
There is no built-in mechanism that captures FE metadata and object storage state as a single atomic snapshot. These are separate procedures.
5. Reconciliation (Handling Asynchronous Replication):
If the object store is replicated asynchronously, the restored FE metadata may reference data files that haven't arrived in the secondary region.
* Reconciliation Tool: StarRocks provides the ADMIN REPAIR TABLE statement specifically for shared-data tables. It allows the system to scan historical metadata versions and roll back the Tablet metadata to the most recent "healthy" version where all referenced files actually exist in the bucket. This is an ultra-fast, metadata-only operation.
6. Storage Volume Mutability:
The TYPE, LOCATIONS, and path-related properties of an existing Storage Volume cannot be altered (they are immutable). Only credential-related properties (like access keys) can be modified via ALTER STORAGE VOLUME.
* Recommendation: To point a cluster at a replica bucket at a different endpoint, you must either:
1. Use a stable DNS name (e.g., dr-bucket.internal) that you can repoint at the network level.
2. Create a new Storage Volume in the second cluster that points to the new bucket, though this usually requires re-creating the table schemas in the second cluster to use that volume.
Summary Recommendation
In practice, most users with strict DR requirements for shared-data mode use Option 2 with a "Cold Standby" or "Warm Standby" approach:
1. Replicate the Object Store at the storage layer (e.g., S3 Cross-Region Replication).
2. Periodically backup the FE meta_dir to the second region.Rocky
08/04/2026, 7:58 AMADMIN REPAIR TABLE to reconcile the metadata with the state of the replicated bucket.
If you require zero RTO, you would typically run two active clusters and use a tool like StarRocks Pipe or an external ingestion framework to dual-write data to both regions simultaneously.
References
• faq/Deploy_faq.md
• administration/management/FE_configuration.md
• deployment/deploy_manually.md
• deployment/plan_cluster.md