Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

merge formal snapshot and snapshots docs #15898

Merged
merged 3 commits into from
Jan 24, 2024

Conversation

johnjmartin
Copy link
Contributor

Description

most of the info in the formal snapshot page is stale, this merges the two docs

Copy link

vercel bot commented Jan 24, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
mysten-ui ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jan 24, 2024 10:43pm
sui-core ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jan 24, 2024 10:43pm
sui-typescript-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jan 24, 2024 10:43pm
3 Ignored Deployments
Name Status Preview Comments Updated (UTC)
explorer ⬜️ Ignored (Inspect) Visit Preview Jan 24, 2024 10:43pm
multisig-toolkit ⬜️ Ignored (Inspect) Visit Preview Jan 24, 2024 10:43pm
sui-kiosk ⬜️ Ignored (Inspect) Visit Preview Jan 24, 2024 10:43pm

docs/content/guides/operator/snapshots.mdx Outdated Show resolved Hide resolved
1. **Verifiability:** Formal snapshots have first-class support in the core Sui protocol. As such, they must be trustless/verifiable by the node operator upon download. To support this, the protocol signs a commitment to the live object state at end of epoch, which formal snapshots are checked against at restore time. If this verification fails, the node state is moved back to the state before the snapshot restore attempt.

Because these snapshots do not contain indexes, they are most immediately useful for validators and state sync Full nodes (SSFNs). You can upload snapshots to remote object stores like S3, Google Cloud Storage, Azure Blob Storage, and similar services. These services typically run the export process in the background so there is no degradation in performance for your Full node. With snapshots stored in the cloud, you can recover from catastrophic failures in your system or hardware more efficiently.

## Enabling snapshots

Full nodes do not take snapshots by default. To enable this feature you must apply specific configs to your Full node.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure why it won't let me write a comment below, but on line 48 can we rename to ### Enabling DB snapshots for consntsency?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also what are your thoughts on changing line 2 above to be DB Snapshots or Database Snapshots or Full Snapshots? I think part of the confusion has been the fact that "snapshots" is now ambiguous, so we should disambiguate in all cases, not just some.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants