Skip to content

Commit a9f8340

Browse files
committed
Use polkadot-parachain binary instead of polkadot-omni-node
1 parent 7870c65 commit a9f8340

File tree

2 files changed

+43
-66
lines changed

2 files changed

+43
-66
lines changed

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

Lines changed: 17 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -96,28 +96,17 @@ This guide provides two deployment options. Select the option that best fits you
9696

9797
=== "Manual Setup"
9898

99-
1. Install Rust using the following commands:
100-
```bash
101-
# Install Rust
102-
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
103-
source $HOME/.cargo/env
104-
105-
# Install specific Rust version
106-
rustup install 1.91.1
107-
rustup default 1.91.1
108-
rustup target add wasm32-unknown-unknown --toolchain 1.91.1
109-
rustup component add rust-src --toolchain 1.91.1
110-
```
99+
Extract the binary from the official Docker image:
111100

112-
2. Install the Polkadot Omni Node using the following command:
113-
```bash
114-
cargo install --locked [email protected]
115-
```
101+
```bash
102+
# Create a temporary container and copy the binary
103+
docker create --name temp-parachain parity/polkadot-parachain:stable2509-2
104+
sudo docker cp temp-parachain:/usr/local/bin/polkadot-parachain /usr/local/bin/
105+
docker rm temp-parachain
116106

117-
3. Verify a successful installation using the `--version` flag:
118-
```bash
119-
polkadot-omni-node --version
120-
```
107+
# Verify installation
108+
polkadot-parachain --version
109+
```
121110

122111
## Generate Node Key
123112

@@ -245,7 +234,7 @@ Follow these steps to build a chainspec from the runtime:
245234
WorkingDirectory=/var/lib/polkadot-collator
246235

247236
# Block-Producing Collator Configuration
248-
ExecStart=/usr/local/bin/polkadot-omni-node \
237+
ExecStart=/usr/local/bin/polkadot-parachain \
249238
--collator \
250239
--chain=/var/lib/polkadot-collator/chain-spec.json \
251240
--base-path=/var/lib/polkadot-collator \
@@ -500,14 +489,17 @@ Updates or upgrades can happen on either the runtime or client. Runtime upgrades
500489
sudo cp -r /var/lib/polkadot-collator /var/lib/polkadot-collator.backup
501490
```
502491

503-
3. Update `polkadot-omni-node`:
492+
3. Pull the new image and extract the binary:
504493
```bash
505-
cargo install --locked --force polkadot-omni-node@<NEW_VERSION>
494+
docker pull parity/polkadot-parachain:<NEW_TAG>
495+
docker create --name temp-parachain parity/polkadot-parachain:<NEW_TAG>
496+
sudo docker cp temp-parachain:/usr/local/bin/polkadot-parachain /usr/local/bin/
497+
docker rm temp-parachain
506498
```
507499

508-
4. Verify `polkadot-omni-node` version to confirm successful update:
500+
4. Verify `polkadot-parachain` version to confirm successful update:
509501
```bash
510-
polkadot-omni-node --version
502+
polkadot-parachain --version
511503
```
512504

513505
5. Restart the service:

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

Lines changed: 26 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ Select the best option for your project, then use the steps in the following tab
129129

130130
rm files.txt
131131
```
132-
3. Launch Polkadot Hub Node using the official [Parity Docker image](https://hub.docker.com/r/parity/polkadot-omni-node){target=\_blank} with the following command:
132+
3. Launch Polkadot Hub Node using the official [Parity Docker image](https://hub.docker.com/r/parity/polkadot-parachain){target=\_blank} with the following command:
133133
```bash
134134
docker run -d --name polkadot-hub-rpc --restart unless-stopped \
135135
-p 9944:9944 \
@@ -139,7 +139,7 @@ Select the best option for your project, then use the steps in the following tab
139139
-p 30333:30333 \
140140
-v $(pwd)/asset-hub-polkadot.json:/asset-hub-polkadot.json \
141141
-v $(pwd)/my-node-data:/data \
142-
parity/polkadot-omni-node:v1.20.2 \
142+
parity/polkadot-parachain:stable2509-2 \
143143
--name=PolkadotHubRPC \
144144
--base-path=/data \
145145
--chain=/asset-hub-polkadot.json \
@@ -246,46 +246,28 @@ Select the best option for your project, then use the steps in the following tab
246246

247247
=== "Manual systemd Setup"
248248

249-
This option uses systemd to provide more control and is recommended for production environments requiring custom configurations.
249+
This option provides more control and is recommended for production environments requiring custom configurations.
250250

251-
1. Install Rust and required toolchain using the following command:
251+
1. Install the Polkadot Parachain binary by extracting it from the official Docker image:
252252
```bash
253-
# Install Rust
254-
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
255-
source $HOME/.cargo/env
256-
257-
# Install specific Rust version
258-
rustup install 1.91.1
259-
rustup default 1.91.1
260-
rustup target add wasm32-unknown-unknown --toolchain 1.91.1
261-
rustup component add rust-src --toolchain 1.91.1
253+
# Pull the image and extract binary
254+
docker pull parity/polkadot-parachain:stable2509-2
255+
docker create --name temp-parachain parity/polkadot-parachain:stable2509-2
256+
sudo docker cp temp-parachain:/usr/local/bin/polkadot-parachain /usr/local/bin/
257+
docker rm temp-parachain
258+
259+
# Verify installation
260+
polkadot-parachain --version
262261
```
263262

264-
2. Install required dependencies using the following commands:
265-
- System dependencies:
266-
```bash
267-
sudo apt update
268-
sudo apt install -y build-essential git clang curl libssl-dev llvm libudev-dev make protobuf-compiler
269-
```
270-
- Polkadot Omni node:
271-
```bash
272-
cargo install --locked [email protected]
273-
```
274-
You can verify successful installation of Polkadot Omni node using the version command:
275-
```bash
276-
polkadot-omni-node --version
277-
```
278-
279-
!!! tip
280-
281-
Compiling polkadot-omni-node from source requires significant RAM (minimum 24GB recommended). The compilation may take 10-15 minutes on systems with adequate resources.
263+
Check [Docker Hub](https://hub.docker.com/r/parity/polkadot-parachain/tags){target=\_blank} for the latest stable tags.
282264

283-
3. Download the Polkadot Hub chain specification:
265+
2. Download the Polkadot Hub chain specification:
284266
```bash
285267
curl -L https://raw.githubusercontent.com/paritytech/polkadot-sdk/master/cumulus/parachains/chain-specs/asset-hub-polkadot.json -o asset-hub-polkadot.json
286268
```
287269

288-
4. Create user and directory structures using the following commands:
270+
3. Create user and directory structures using the following commands:
289271
- Create a dedicated user:
290272
```bash
291273
sudo useradd -r -s /bin/bash polkadot
@@ -303,12 +285,12 @@ Select the best option for your project, then use the steps in the following tab
303285
sudo chown -R polkadot:polkadot /var/lib/polkadot-hub-rpc
304286
```
305287

306-
5. Create a systemd service file for the Polkadot SDK RPC node:
288+
4. Create a systemd service file for the Polkadot SDK RPC node:
307289
```bash
308290
sudo nano /etc/systemd/system/polkadot-hub-rpc.service
309291
```
310292

311-
6. Open the new service file and add the following configuration:
293+
5. Open the new service file and add the following configuration:
312294
```ini
313295
[Unit]
314296
Description=Polkadot Hub RPC Node
@@ -320,7 +302,7 @@ Select the best option for your project, then use the steps in the following tab
320302
Group=polkadot
321303
WorkingDirectory=/var/lib/polkadot-hub-rpc
322304

323-
ExecStart=/usr/local/bin/polkadot-omni-node \
305+
ExecStart=/usr/local/bin/polkadot-parachain \
324306
--name=PolkadotHubRPC \
325307
--chain=/var/lib/polkadot-hub-rpc/asset-hub-polkadot.json \
326308
--base-path=/var/lib/polkadot-hub-rpc \
@@ -349,7 +331,7 @@ Select the best option for your project, then use the steps in the following tab
349331
WantedBy=multi-user.target
350332
```
351333

352-
7. Start the service using the following commands:
334+
6. Start the service using the following commands:
353335
- Reload systemd:
354336
```bash
355337
sudo systemctl daemon-reload
@@ -368,7 +350,7 @@ Select the best option for your project, then use the steps in the following tab
368350
sudo journalctl -u polkadot-hub-rpc -f
369351
```
370352

371-
8. You can use a few different commands to verify your node is running properly:
353+
7. You can use a few different commands to verify your node is running properly:
372354
- Get chain information:
373355
```bash
374356
curl -H "Content-Type: application/json" \
@@ -472,7 +454,7 @@ Use the following commands for updating or upgrading your RPC node according to
472454
```
473455
2. Pull the latest image:
474456
```bash
475-
docker pull parity/polkadot-omni-node:<NEW_TAG>
457+
docker pull parity/polkadot-parachain:<NEW_TAG>
476458
```
477459
3. Start the new container using the same command from the setup section with the updated image tag.
478460

@@ -486,9 +468,12 @@ Use the following commands for updating or upgrading your RPC node according to
486468
```bash
487469
sudo cp -r /var/lib/polkadot-hub-rpc /var/lib/polkadot-hub-rpc.backup
488470
```
489-
3. Update the binary:
471+
3. Pull the new image and extract the binary:
490472
```bash
491-
cargo install --locked --force polkadot-omni-node@<NEW_VERSION>
473+
docker pull parity/polkadot-parachain:<NEW_TAG>
474+
docker create --name temp-parachain parity/polkadot-parachain:<NEW_TAG>
475+
sudo docker cp temp-parachain:/usr/local/bin/polkadot-parachain /usr/local/bin/
476+
docker rm temp-parachain
492477
```
493478
4. Restart the service:
494479
```bash

0 commit comments

Comments
 (0)