From 3ec30ab19867625cbbdbe1e017ffadbbfafcc3b1 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Fri, 7 Feb 2025 13:06:12 -0500 Subject: [PATCH 1/7] Backup and restore instructions for nonce files --- docs/tutorials/join-dal-baker/run-baker.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index 06ca5bc53..82032887b 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -124,6 +124,13 @@ However, make sure not to run the baker twice **for the same protocol version an You can upgrade accusers with a similar process. +## Backing up and restoring the baker + +The Octez baking daemon stores no persistent data of its own, but it depends on files in the Octez client's data directory. +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_stateful_nonces` and `net_nonces`, where `` is the ID of the network. +All systems have the `net_stateful_nonces` file but only legacy bakers have the `net_nonces` file. + ## Calculating the delay for attestation rights If you are setting up a new baker, you must wait until it receives attestation rights before it can bake blocks or attest to DAL data. From 30209d3a8f549bbad989337e2c5f1c5c7711e2f4 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 08:45:36 -0500 Subject: [PATCH 2/7] Baker stores data in client folder MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Germán Delbianco --- docs/tutorials/join-dal-baker/run-baker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index 82032887b..9bf5a6ebf 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -126,7 +126,7 @@ You can upgrade accusers with a similar process. ## Backing up and restoring the baker -The Octez baking daemon stores no persistent data of its own, but it depends on files in the Octez client's data directory. +The Octez baking daemon stores relies in the Octez client's data directory to store persistent operational data, 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_stateful_nonces` and `net_nonces`, where `` is the ID of the network. All systems have the `net_stateful_nonces` file but only legacy bakers have the `net_nonces` file. From b32907e9e957b31734e9a456d6ecf5a03f273ff8 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 08:48:40 -0500 Subject: [PATCH 3/7] grammar --- docs/tutorials/join-dal-baker/run-baker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index 9bf5a6ebf..b7f1f78b9 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -126,7 +126,7 @@ You can upgrade accusers with a similar process. ## Backing up and restoring the baker -The Octez baking daemon stores relies in the Octez client's data directory to store persistent operational data, notably consensus high-water marks and [random seed nonces](https://tezos.gitlab.io/active/randomness_generation.html). +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_stateful_nonces` and `net_nonces`, where `` is the ID of the network. All systems have the `net_stateful_nonces` file but only legacy bakers have the `net_nonces` file. From b865d1c83b622cb3311139d20c176dd1db992470 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 08:51:37 -0500 Subject: [PATCH 4/7] legacy baking deployments MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Germán Delbianco --- docs/tutorials/join-dal-baker/run-baker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index b7f1f78b9..800004d40 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -129,7 +129,7 @@ You can upgrade accusers with a similar process. 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_stateful_nonces` and `net_nonces`, where `` is the ID of the network. -All systems have the `net_stateful_nonces` file but only legacy bakers have the `net_nonces` file. +All systems have the `net_stateful_nonces` file but only legacy baking deployments have the `net_nonces` file. ## Calculating the delay for attestation rights From 329bbdb7acab68177cbdfcb8fc348a23090e6448 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 09:18:16 -0500 Subject: [PATCH 5/7] Examples of file names --- docs/tutorials/join-dal-baker/run-baker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index 800004d40..d8286e832 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -128,7 +128,7 @@ You can upgrade accusers with a similar process. 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_stateful_nonces` and `net_nonces`, where `` is the ID of the network. +These nonce files are named `net_stateful_nonces` and `net_nonces`, where `` is the ID of the network, such as `netXdQprcVkpaWU_stateful_nonces` for Mainnet or `netXnHfVqm9ie_stateful_nonces` for Ghostnet. All systems have the `net_stateful_nonces` file but only legacy baking deployments have the `net_nonces` file. ## Calculating the delay for attestation rights From 3f3372ab109a40bc58d52caf1f688796371a6d23 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 10:30:28 -0500 Subject: [PATCH 6/7] One cycle --- docs/tutorials/join-dal-baker/run-baker.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index d8286e832..16a8f49e3 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -129,7 +129,9 @@ You can upgrade accusers with a similar process. 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_stateful_nonces` and `net_nonces`, where `` is the ID of the network, such as `netXdQprcVkpaWU_stateful_nonces` for Mainnet or `netXnHfVqm9ie_stateful_nonces` for Ghostnet. -All systems have the `net_stateful_nonces` file but only legacy baking deployments have the `net_nonces` file. +All systems have the `net_stateful_nonces` file but only legacy baking deployments running versions of Octez prior to 20.0rc1 have the `net_nonces` file. + +After you have moved the nonce files and verified that the baker runs normally for one cycle, you can remove the legacy `net_nonces` file. ## Calculating the delay for attestation rights From f263d8a827fe3d8c9b2908bf2dbd62e2cf6119b7 Mon Sep 17 00:00:00 2001 From: Tim McMackin Date: Tue, 11 Feb 2025 10:32:50 -0500 Subject: [PATCH 7/7] Deployments --- docs/tutorials/join-dal-baker/run-baker.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tutorials/join-dal-baker/run-baker.md b/docs/tutorials/join-dal-baker/run-baker.md index 16a8f49e3..2e4298192 100644 --- a/docs/tutorials/join-dal-baker/run-baker.md +++ b/docs/tutorials/join-dal-baker/run-baker.md @@ -129,9 +129,9 @@ You can upgrade accusers with a similar process. 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_stateful_nonces` and `net_nonces`, where `` is the ID of the network, such as `netXdQprcVkpaWU_stateful_nonces` for Mainnet or `netXnHfVqm9ie_stateful_nonces` for Ghostnet. -All systems have the `net_stateful_nonces` file but only legacy baking deployments running versions of Octez prior to 20.0rc1 have the `net_nonces` file. +All deployments have the `net_stateful_nonces` file but only legacy baking deployments running versions of Octez prior to 20.0rc1 have the `net_nonces` file. -After you have moved the nonce files and verified that the baker runs normally for one cycle, you can remove the legacy `net_nonces` file. +After you have moved the nonce files to the new machine and verified that the baker runs normally for one cycle, you can remove the legacy `net_nonces` file. ## Calculating the delay for attestation rights