Upstream Updates - Mon Sep 2 00:13:29 UTC 2024

[github-actions]

SIMD

Opened

• SIMD-0170: Reserve minimal CUs for builtins solana-foundation/solana-improvement-documents#170
• update existing SIMDs with their current status solana-foundation/solana-improvement-documents#169

Closed

Agave Wiki

d5d302be027ddb751c2dfdb3893fe85a3ae49d96^..0aad19e9984f24abcfa44cb39fa74be4f0de1112

diff --git a/2024-08-26-Testnet-Restart.md b/2024-08-26-Testnet-Restart.md
new file mode 100644
index 0000000..39337e5
--- /dev/null
+++ b/2024-08-26-Testnet-Restart.md
@@ -0,0 +1,111 @@
+## Edit
+As of 2024-08-27 08:00 UTC testnet is back online. The instructions below are no longer relevant, but you will need to update your shred version and start normally:
+
+    --expected-shred-version 4084 n+
+***
+
+This testnet restart is NOT urgent. Follow these instructions when you have time, but don’t skip sleep or disrupt other plans for this.
+
+## Summary
+Testnet has stalled. Agave v2.0.7 and Frankendancer v0.112.20007 contain bug fixes that we expect will prevent these stalls from recurring.
+
+|Attribute|Value|
+|---------|-----|
+|Validator version|Agave: v2.0.7. Frankendancer: v0.112.20007|
+|Snapshot slot|289_624_982|
+|Restart slot|289_624_982|
+|Shred version|4084|
+|Expected bank hash|EXknCC4rNBR5SyBVrUgUB3FaoGbujPMoraEjG7C49Bdk|
+
+
+## Step 1. Stop validator process if you haven’t already
+
+## Step 2. Create snapshot
+    agave-ledger-tool --ledger <ledger-path> create-snapshot n+    --snapshot-archive-path  <snapshot-path> n+    --hard-fork 289624982 n+    --  289624982 <snapshot-path>
+
+The output should include this at (or near) the end:
+
+    Successfully created snapshot for slot 289624982, hash EXknCC4rNBR5SyBVrUgUB3FaoGbujPMoraEjG7C49Bdk: /home/sol/ledger-restart-2024-0826/snapshot-289624982-9CGdqTDdZ3DJqQtyohr9qX6NQbsDxfFrkm8FoWjMTrUS.tar.zst
+Shred version: 4084
+
+Once you have created a snapshot move all the other snapshots to a backup directory, so your snapshot directory contains only
+    snapshot-289624982-9CGdqTDdZ3DJqQtyohr9qX6NQbsDxfFrkm8FoWjMTrUS.tar.zst
+
+If you fail to create a snapshot see the appendix for possible fixes.
+
+## Step 3: Install patched version of the validator software
+Make sure to upgrade your software to a patched version:
+
+Agave: `agave-install init v2.0.7`
+
+Frankendancer: Update to v0.112.20007
+
+## Step 4: Update startup config and start your validator
+### Agave
+Add these arguments to your validator startup script:
+
+    --wait-for-supermajority 289624982 n+    --expected-shred-version 4084 n+    --expected-bank-hash EXknCC4rNBR5SyBVrUgUB3FaoGbujPMoraEjG7C49Bdk n+
+
+### Frankendancer
+Include these lines in the `[consensus]` section of your toml file:
+
+    [consensus]
+        # ...
+        wait_for_supermajority_at_slot = 289624982
+        expected_bank_hash = "EXknCC4rNBR5SyBVrUgUB3FaoGbujPMoraEjG7C49Bdk"
+        expected_shred_version = 4084
+
+After making the appropriate changes start your validator as you normally would. As it starts, the validator will load the snapshot for slot `289624982` and wait for 80% of the stake to come online before producing/validating new blocks.
+
+To confirm your restarted validator is correctly waiting for 80% stake, look for this periodic log message to confirm it is waiting:
+
+    INFO  solana_core::validator] Waiting for 80% of activated stake at slot 289624982 to be in gossip...
+
+And if you have RPC enabled, ask it for the current slot:
+
+    solana --url http://127.0.0.1:8899 slot
+
+Any number other than `289624982` means you did not complete the steps correctly.
+
+Once started you should see log entries for “active stake” visible in gossip and “waiting for 80% of stake” to be visible. You can track these to see how the stake progresses.
+
+
+***
+
+## Appendix (use this only if step 2 failed)
+
+If you get an error like this:
+
+    Error: Slot 289624982 is not available
+
+Or this:
+
+    Unable to process blockstore from starting slot <slot> to 289624982; the ending slot is less than the starting slot. The starting slot will be the latest snapshot slot, or genesis if the --no-snapshot flag is specified or if no snapshots are found.
+
+Your snapshots directory contains a snapshot that is for a slot `>289624982`. If you also have a snapshot for slot `<=289624982` then move snapshots for slots `>289624982` to a backup directory and run the `agave-ledger-tool` command again. If you do not have a snapshot for slot `<=289624982` then you will need to download a snapshot
+
+If you successfully created a snapshot, resume the instructions above starting at Step 3. If you are unable to create a snapshot, follow the instructions below on downloading a snapshot.
+
+### Step 1: Download a snapshot from a known validator
+
+If you are unable to generate a snapshot locally for slot `289624982` you will need to download one from a known validator. Add these lines to your startup script.
+
+    --known-validator 5D1fNXzvv5NjV1ysLjirC4WY92RNsVH18vjmcszZd8on n+    --expected-shred-version 4084 n+
+Remove the flag `--no-snapshot-fetch` in your startup script if it is present.
+
+### Step 2: After download, restart
+
+Verify that you have a new snapshot in your snapshot directory.  If the snapshot is done downloading, stop your validator process.
+
+Add the flag `--no-snapshot-fetch` to your startup script
+
+Start your validator again using the instructions from step 4 above.
diff --git a/_Sidebar.md b/_Sidebar.md
index e93e311..f20904a 100644
--- a/_Sidebar.md
+++ b/_Sidebar.md
@@ -18,4 +18,6 @@
 * **Migration**
   * [Agave v2.0 Migration](Agave-v2.0-Transition-Guide)
 * **Testnet**
-  * [2024-01-02 Testnet Restart](2024‐01‐02-Testnet-Rollback-and-Restart)
 No newline at end of file
+  * [2024-01-02 Testnet Restart](2024‐01‐02-Testnet-Rollback-and-Restart)
+  * [2024-08-26 Testnet Restart](2024-08-26-Testnet-Restart)
+  
 No newline at end of file