Skip to content

Commit 21fbb1c

Browse files
committed
PoS: mumbai deprecation update
- Community snapshots - Notes for context
1 parent eb2f262 commit 21fbb1c

File tree

1 file changed

+28
-20
lines changed

1 file changed

+28
-20
lines changed

docs/pos/how-to/snapshots.md

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,22 +4,30 @@ comments: true
44

55
When setting up a new sentry, validator, or full node server, it is recommended that you use snapshots for faster syncing without having to sync over the network. Using snapshots will save you several days for both Heimdall and Bor.
66

7+
## Community snapshots
8+
9+
With the [deprecation of Mumbai testnet](https://forum.polygon.technology/t/pos-tooling-after-mumbai-deprecation-no-action-required/13740), we're shifting to a community-driven model for snapshots where active members like Vault Staking, Stakepool, StakeCraft, and Girnaar Nodes will now provide snapshots. See [All4nodes.io](https://all4nodes.io/Polygon), an aggregator for Polygon community snapshots, for future community snapshots on the Sepolia-anchored Amoy testnet.
10+
11+
!!! tip "Older snapshots"
12+
13+
If you're looking for older snapshots, please visit [Polygon Chains Snapshots](https://snapshot.polygon.technology/).
14+
715
!!! note
816

917
We no longer support Bor archive snapshots due to unsustainable data growth.
1018

11-
!!!tip
12-
13-
For the latest snapshot, please visit [<ins>Polygon Chains Snapshots</ins>](https://snapshot.polygon.technology/).
19+
## Downloading and using client snapshots
1420

21+
!!! warning "Mumbai testnet now deprecated"
1522

16-
## Client snapshots
23+
Mumbai testnet is no longer supported. [Existing snapshots](https://snapshot.polygon.technology/), however, will still be available for the users who rely on them.
1724

1825
To begin, ensure that your node environment meets the **prerequisites** outlined [here](../how-to/full-node/full-node-binaries.md). Before starting any services, execute the shell script provided below. This script will download and extract the snapshot data, which allows for faster bootstrapping. In our example, we will be using an Ubuntu Linux m5d.4xlarge machine with an 8TB block device attached.
1926
To transfer the correct chain data to your disk, follow these steps:
2027

2128
- All one has to do is specify the network ("mainnet" or "amoy") and client type ("heimdall" or "bor" or "erigon") of your desired snapshot and run the following command:
2229

30+
2331
```bash
2432
curl -L https://snapshot-download.polygon.technology/snapdown.sh | bash -s -- --network {{ network }} --client {{ client }} --extract-dir {{ extract_dir }} --validate-checksum {{ true / false }}
2533
```
@@ -30,7 +38,9 @@ For example:
3038
curl -L https://snapshot-download.polygon.technology/snapdown.sh | bash -s -- --network mainnet --client heimdall --extract-dir data --validate-checksum true
3139
```
3240

33-
> This bash script automatically handles all download and extraction phases, as well as optimizing disk space by deleting already extracted files along the way.
41+
!!! tip
42+
43+
This bash script automatically handles all download and extraction phases, as well as optimizing disk space by deleting already extracted files along the way.
3444

3545
- `--extract-dir` and `--validate-checksum` flags are optional.
3646
- Consider using a Screen session to prevent accidental interruptions during the chaindata download and extraction process.
@@ -191,12 +201,10 @@ curl -L https://snapshot-download.polygon.technology/snapdown.sh | bash -s -- --
191201
Once the extraction is complete, ensure that you update the datadir configuration of your client to point to the path where the extracted data is located. This ensures that the systemd services can correctly register the snapshot data when the client starts.
192202
If you wish to preserve the default client configuration settings, you can use symbolic links (symlinks).
193203

194-
For example, let's say you have mounted your block device at `~/snapshots` and have downloaded and extracted the chaindata
195-
for Heimdall into the directory `heimdall_extract`, and for Bor into the directory `bor_extract`. To ensure proper registration
196-
of the extracted data when starting the Heimdall or Bor systemd services, you can use the following sample commands:
204+
For example, let's say you have mounted your block device at `~/snapshots` and have downloaded and extracted the chaindata for Heimdall into the directory `heimdall_extract`, and for Bor into the directory `bor_extract`. To ensure proper registration of the extracted data when starting the Heimdall or Bor systemd services, you can use the following sample commands:
197205

198206
```bash
199-
# remove any existing datadirs for heimdall and bor
207+
# remove any existing datadirs for Heimdall and Bor
200208
rm -rf /var/lib/heimdall/data
201209
rm -rf /var/lib/bor/chaindata
202210

@@ -208,7 +216,7 @@ sudo ln -s ~/snapshots/chaindata /var/lib/bor
208216

209217
# bring up clients with all snapshot data properly registered
210218
sudo service heimdalld start
211-
# wait for heimdall to fully sync then start bor
219+
# wait for Heimdall to fully sync then start Bor
212220
sudo service bor start
213221
```
214222

@@ -218,27 +226,27 @@ sudo service bor start
218226

219227
| Metric | Calculation Breakdown | Value |
220228
| ------ | --------------------- | ----------- |
221-
| approx. compressed total | 250 GB (bor) + 35 GB (heimdall) | 285 GB |
222-
| approx. data growth daily | 10 GB (bor) + .5 GB (heimdall) | 10.5 GB |
223-
| approx. total extracted size | 350 GB (bor) + 50 GB (heimdall) | 400 GB |
229+
| approx. compressed total | 250 GB (Bor) + 35 GB (Heimdall) | 285 GB |
230+
| approx. data growth daily | 10 GB (Bor) + .5 GB (Heimdall) | 10.5 GB |
231+
| approx. total extracted size | 350 GB (Bor) + 50 GB (Heimdall) | 400 GB |
224232
| suggested disk size (2.5x buffer) | 400 GB * 2.5 (natural chain growth) | 1 TB |
225233

226234
**Polygon mainnet**
227235

228236
| Metric | Calculation Breakdown | Value |
229237
| ------ | --------------------- | ----------- |
230-
| approx. compressed total | 1500 GB (bor) + 225 GB (heimdall) | 1725 GB |
231-
| approx. data growth daily | 100 GB (bor) + 5 GB (heimdall) | 105 GB |
232-
| approx. total extracted size | 2.1 TB (bor) + 300 GB (heimdall) | 2.4 TB |
238+
| approx. compressed total | 1500 GB (Bor) + 225 GB (Heimdall) | 1725 GB |
239+
| approx. data growth daily | 100 GB (Bor) + 5 GB (Heimdall) | 105 GB |
240+
| approx. total extracted size | 2.1 TB (Bor) + 300 GB (Heimdall) | 2.4 TB |
233241
| suggested disk size (2.5x buffer) | 2.4 TB * 2.5 (natural chain growth) | 6 TB |
234242

235243
**Polygon Amoy Erigon Archive**
236244

237245
| Metric | Calculation Breakdown | Value |
238246
| ------ | --------------------- | ----------- |
239-
| approx. compressed total | 210 GB (erigon) + 35 GB (heimdall) | 245 GB |
240-
| approx. data growth daily | 4.5 GB (erigon) + .5 GB (heimdall) | 5 GB |
241-
| approx. total extracted size | 875 GB (erigon) + 50 GB (heimdall) | 925 GB |
247+
| approx. compressed total | 210 GB (Erigon) + 35 GB (Heimdall) | 245 GB |
248+
| approx. data growth daily | 4.5 GB (Erigon) + .5 GB (Heimdall) | 5 GB |
249+
| approx. total extracted size | 875 GB (Erigon) + 50 GB (Heimdall) | 925 GB |
242250
| suggested disk size (2.5x buffer) | 925 GB * 2.5 (natural chain growth) | 2.5 TB |
243251

244252
!!! note
@@ -247,7 +255,7 @@ sudo service bor start
247255

248256
**Polygon Mainnet Erigon Archive**
249257

250-
Currently under maintenance. ETA Aug 2023 for Erigon bor-mainnet incremental snapshots.
258+
Currently under maintenance. ETA Aug 2023 for Erigon Bor-mainnet incremental snapshots.
251259

252260
## Recommended disk type and IOPS guidance
253261

0 commit comments

Comments
 (0)