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

Backup and restore instructions for nonce files #543

Open
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

timothymcmackin
Copy link
Collaborator

Need to backup nonce files if you move the baker to another machine.

@timothymcmackin timothymcmackin self-assigned this Feb 7, 2025
Copy link

vercel bot commented Feb 7, 2025

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

Name Status Preview Updated (UTC)
docs-staging ✅ Ready (Inspect) Visit Preview Feb 11, 2025 3:33pm

Copy link
Contributor

@germanD germanD left a comment

Choose a reason for hiding this comment

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

LGTM modulo threads

As a follow up, we should check with the L1 bakewr crew if both files actually need backing up. My understanding is that with current versions of Octez keeping the stateful one should suffice, and the other one can be safely removed.

But I would rather be safe than sorry.

docs/tutorials/join-dal-baker/run-baker.md Outdated Show resolved Hide resolved
docs/tutorials/join-dal-baker/run-baker.md Outdated Show resolved Hide resolved
docs/tutorials/join-dal-baker/run-baker.md Outdated Show resolved Hide resolved
Co-authored-by: Germán Delbianco <[email protected]>
Co-authored-by: Germán Delbianco <[email protected]>
The Octez baking daemon stores persistent operational data in the Octez client's data directory, notably consensus high-water marks and [random seed nonces](https://tezos.gitlab.io/active/randomness_generation.html).
If you want to back up the baker or move it to another machine and restore it, you must copy the nonce file or files from the Octez client's data directory to the equivalent directory on the new machine.
These nonce files are named `net<NETWORK_ID>_stateful_nonces` and `net<NETWORK_ID>_nonces`, where `<NETWORK_ID>` is the ID of the network, such as `netXdQprcVkpaWU_stateful_nonces` for Mainnet or `netXnHfVqm9ie_stateful_nonces` for Ghostnet.
All systems have the `net<NETWORK_ID>_stateful_nonces` file but only legacy baking deployments have the `net<NETWORK_ID>_nonces` file.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
All systems have the `net<NETWORK_ID>_stateful_nonces` file but only legacy baking deployments have the `net<NETWORK_ID>_nonces` file.
All systems have the `net<NETWORK_ID>_stateful_nonces` file but only legacy baking deployments have the `net<NETWORK_ID>_nonces` file.

systems -> deployments.

We should expand legacy to mean, that were first deployed with Octez versions earlier/older than v20.0~rc1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants