Skip to content

Commit 5569d63

Browse files
committed
Update AI index pages for node infrastructure docs
1 parent ad7ac4d commit 5569d63

File tree

3 files changed

+32
-15
lines changed

3 files changed

+32
-15
lines changed

.ai/pages/node-infrastructure-run-a-collator-collator.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,6 @@ Block-producing collators require robust hardware for reliable operation includi
5151
- Open ports:
5252
- 30333 (parachain P2P)
5353
- 30334 (relay chain P2P)
54-
- 9944 (WebSocket RPC - for management)
5554

5655
Uptime is critical. Consider redundancy and monitoring to maintain block production reliability.
5756

@@ -106,6 +105,7 @@ This guide provides two deployment options. Select the option that best fits you
106105
# Make it executable and move to system path
107106
chmod +x polkadot-parachain
108107
sudo mv polkadot-parachain /usr/local/bin/
108+
sudo chown root:root /usr/local/bin/polkadot-parachain
109109

110110
# Verify installation
111111
polkadot-parachain --version
@@ -259,11 +259,18 @@ Follow these steps to build a chainspec from the runtime:
259259
--prometheus-port=9615 \
260260
--node-key-file=/var/lib/polkadot-collator/node.key \
261261
--name="YourCollatorName" \
262+
--blocks-pruning=256 \
263+
--state-pruning=256 \
264+
--database=paritydb \
262265
-- \
263-
--execution=wasm \
264266
--chain=polkadot \
265267
--port=30334 \
266-
--sync=warp
268+
--sync=fast \
269+
--blocks-pruning=256 \
270+
--state-pruning=256 \
271+
--database=paritydb \
272+
--pool-limit=0 \
273+
--rpc-port=0
267274

268275
Restart=always
269276
RestartSec=10
@@ -278,7 +285,11 @@ Follow these steps to build a chainspec from the runtime:
278285
- `--collator`: Enables block production mode
279286
- `--node-key-file`: Uses the generated node key for stable peer ID
280287
- `--name`: Your collator name (visible in telemetry)
281-
- Relay chain uses `--sync=warp` for faster initial sync
288+
- `--blocks-pruning=256` and `--state-pruning=256`: Keeps only recent blocks and state, reducing disk usage (collators don't need archive data)
289+
- `--database=paritydb`: Uses ParityDB for better performance
290+
- `--sync=fast`: Fast sync mode for the relay chain
291+
- `--pool-limit=0`: Disables transaction pool on relay chain (collators don't need it)
292+
- `--rpc-port=0` (relay chain): Disables RPC on the embedded relay chain node (not needed for collators)
282293

283294
## Run the Collator
284295

@@ -318,7 +329,7 @@ Sync time depends on:
318329
- Disk I/O speed
319330
- Current chain size
320331

321-
The relay chain uses warp sync for faster synchronization.
332+
The relay chain uses fast sync for faster synchronization.
322333

323334
!!! warning
324335

.ai/pages/node-infrastructure-run-a-node-parachain-rpc.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,6 @@ RPC nodes serving production traffic require robust hardware:
7373
- 30334 (relay chain P2P)
7474
- 9944 (Polkadot SDK WebSocket RPC)
7575
- 9933 (Polkadot SDK HTTP RPC)
76-
- 9615 (Prometheus metrics - optional)
7776
- Consider DDoS protection and rate limiting for production deployments
7877

7978
!!! note
@@ -236,7 +235,8 @@ Select the best option for your project, then use the steps in the following tab
236235
--base-path=/data \
237236
--chain=polkadot \
238237
--state-pruning=256 \
239-
--blocks-pruning=archive-canonical
238+
--blocks-pruning=256 \
239+
--rpc-port=0
240240
```
241241

242242
=== "Pruned Node"
@@ -269,7 +269,8 @@ Select the best option for your project, then use the steps in the following tab
269269
--base-path=/data \
270270
--chain=polkadot \
271271
--state-pruning=256 \
272-
--blocks-pruning=archive-canonical
272+
--blocks-pruning=256 \
273+
--rpc-port=0
273274
```
274275

275276
!!! note
@@ -441,7 +442,8 @@ Select the best option for your project, then use the steps in the following tab
441442
--base-path=/var/lib/people-chain-rpc \
442443
--port=30334 \
443444
--state-pruning=256 \
444-
--blocks-pruning=archive-canonical
445+
--blocks-pruning=256 \
446+
--rpc-port=0
445447

446448
Restart=always
447449
RestartSec=10
@@ -485,7 +487,8 @@ Select the best option for your project, then use the steps in the following tab
485487
--base-path=/var/lib/people-chain-rpc \
486488
--port=30334 \
487489
--state-pruning=256 \
488-
--blocks-pruning=archive-canonical
490+
--blocks-pruning=256 \
491+
--rpc-port=0
489492

490493
Restart=always
491494
RestartSec=10

.ai/pages/node-infrastructure-run-a-node-polkadot-hub-rpc.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,6 @@ RPC nodes serving production traffic require robust hardware. The following shou
4646
- 30334 (relay chain P2P)
4747
- 9944 (Polkadot SDK WebSocket RPC)
4848
- 9933 (Polkadot SDK HTTP RPC)
49-
- 9615 (Prometheus metrics - optional)
5049
- Consider DDoS protection and rate limiting for production deployments
5150

5251
**Note**: For development or low-traffic scenarios, you can reduce these requirements proportionally. Consider using a reverse proxy (nginx, Caddy) for production deployments.
@@ -208,7 +207,8 @@ Select the best option for your project, then use the steps in the following tab
208207
--base-path=/data \
209208
--chain=polkadot \
210209
--state-pruning=256 \
211-
--blocks-pruning=archive-canonical
210+
--blocks-pruning=256 \
211+
--rpc-port=0
212212
```
213213

214214
=== "Pruned Node"
@@ -241,7 +241,8 @@ Select the best option for your project, then use the steps in the following tab
241241
--base-path=/data \
242242
--chain=polkadot \
243243
--state-pruning=256 \
244-
--blocks-pruning=archive-canonical
244+
--blocks-pruning=256 \
245+
--rpc-port=0
245246
```
246247

247248
Critical configuration parameters include port mappings and node parameters:
@@ -399,7 +400,8 @@ Select the best option for your project, then use the steps in the following tab
399400
--base-path=/var/lib/polkadot-hub-rpc \
400401
--port=30334 \
401402
--state-pruning=256 \
402-
--blocks-pruning=archive-canonical
403+
--blocks-pruning=256 \
404+
--rpc-port=0
403405

404406
Restart=always
405407
RestartSec=10
@@ -443,7 +445,8 @@ Select the best option for your project, then use the steps in the following tab
443445
--base-path=/var/lib/polkadot-hub-rpc \
444446
--port=30334 \
445447
--state-pruning=256 \
446-
--blocks-pruning=archive-canonical
448+
--blocks-pruning=256 \
449+
--rpc-port=0
447450

448451
Restart=always
449452
RestartSec=10

0 commit comments

Comments
 (0)