Bailey Kocin
04/01/2026, 9:32 PMBailey Kocin
04/01/2026, 9:43 PMRocky
04/01/2026, 9:44 PMfe/conf/cluster_snapshot.yaml or the ability to manually restart FE nodes with the --cluster_snapshot flag.
Instead, the restore process is integrated into the CelerData Cloud Console. Here is how you typically handle this:
1. Using the Cloud Console UI
For BYOC clusters, "Cluster Snapshot" is primarily an automated disaster recovery mechanism. If you need to restore a cluster or recover metadata:
* Navigate to the Backups/Snapshots Tab: In the CelerData Cloud Web UI, go to your cluster details and look for the Backups or Snapshots section.
* Restore to a New Cluster: The standard workflow for a full cluster restore from a snapshot in CelerData Cloud is to create a new cluster and select "Restore from Backup" as the creation method. You will be prompted to select the snapshot source (your S3 bucket) and the specific snapshot/timestamp.
* Metadata Recovery: If you are trying to recover from a total FE failure where the metadata is lost but the data remains in S3, CelerData's management plane usually handles the FE recovery automatically. If you need to trigger a manual restore from a specific URI that isn't appearing in the UI list, you may need to use the CelerData Cloud API or CelerData CLI.
2. Why you don't see the YAML spec
The YAML-based method described in the StarRocks documentation is designed for self-managed deployments (where you manage the VMs and process lifecycles). In CelerData Cloud:
* The Control Plane generates the necessary configuration and passes it to the nodes during the "Restore" or "Rebuild" task.
* The UI abstracts the cluster_snapshot.yaml and the --cluster_snapshot startup flag.
3. If you have a custom Snapshot URI in S3
If you have a snapshot stored at a custom URI (e.g., from a different cluster or region) and want to use it for a "Cross-Cluster Recovery" in BYOC:
1. Ensure the Storage Volume or Backup Repository is correctly registered in the new CelerData environment.
2. During the Create Cluster process in the Web UI, choose the restore option.
3. If the specific snapshot does not appear, check the permissions of the IAM role attached to the CelerData BYOC environment to ensure it has s3:Get_ and s3:List_ access to that specific bucket/path.
Recommendation
If you are performing a critical production recovery and the UI does not provide the granularity you need (like pointing to a specific URI for cluster_snapshot_path), it is recommended to contact CelerData Support. In BYOC environments, certain low-level metadata recovery operations are performed via the backend management plane to ensure the cluster remains in a "Managed" state.
Key difference to remember:
* Self-Managed: You edit cluster_snapshot.yaml and run start_fe.sh --cluster_snapshot.
* CelerData Cloud BYOC: You use the "Restore" action in the Cloud Console or the CelerData Cloud API, which executes those same steps on your behalf.
References
• administration/cluster_snapshot.md
• administration/management/Backup_and_restore.md