Skip to content

Commit

Permalink
fix(website): add remove orphan containers guidance (#14551)
Browse files Browse the repository at this point in the history
  • Loading branch information
dionysuzx authored Aug 22, 2023
1 parent c22f2eb commit 97bd899
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -154,13 +154,13 @@ Make sure Docker is running and then run the following command to start the node
For a Grimsvotn L2 node:

```sh
sudo docker compose up -d --remove-orphans
sudo docker compose up -d
```

For an Eldfell L3 node:

```sh
sudo docker compose -f ./docker-compose.l3.yml --env-file .env.l3 up -d --remove-orphans
sudo docker compose -f ./docker-compose.l3.yml --env-file .env.l3 up -d
```

### Verify node is running
Expand All @@ -179,7 +179,7 @@ curl http://localhost:8547 \
which should return the chainId as `0x28c5d` (167005):

```json
{"jsonrpc":"2.0","id":0,"result":"0x28c5d"}
{ "jsonrpc": "2.0", "id": 0, "result": "0x28c5d" }
```

For Taiko L3, use port 8549 for the `eth_chainId` curl request and you should get chainId `0x28c5e` (167006).
Expand All @@ -194,18 +194,23 @@ curl http://localhost:8547 \
```

3. If the blockNumber response value is `0` or not growing, check the Taiko L2 logs here:

```bash
sudo docker compose logs -f
```

or the Taiko L3 logs here

```bash
sudo docker compose -f ./docker-compose.l3.yml --env-file .env.l3 logs -f
```

If you find an error, check the [Node troubleshooting](/docs/reference/node-troubleshooting) page.

#### Check with the node dashboard

A node dashboard will be running on `localhost` on the `GRAFANA_PORT` you set in your `.env` or `.env.l3` file.

- For a Grimsvotn L2 node that would default to: [http://localhost:3001/d/L2ExecutionEngine/l2-execution-engine-overview](http://localhost:3001/d/L2ExecutionEngine/l2-execution-engine-overview).
- For a Eldfell L3 node that would default to: [http://localhost:3002/d/L2ExecutionEngine/l2-execution-engine-overview](http://localhost:3002/d/L2ExecutionEngine/l2-execution-engine-overview).

Expand Down
16 changes: 16 additions & 0 deletions packages/website/pages/docs/manuals/node-runner-manual.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,22 @@ docker compose down -v
docker compose -f ./docker-compose.l3.yml --env-file .env.l3 down -v
```

## Start and remove orphan containers

This command will start and remove containers that are not part of the current docker compose file.

**Grimsvotn L2:**

```sh
docker compose up -d --remove-orphans
```

**Eldfell L3:**

```sh
docker compose -f ./docker-compose.l3.yml --env-file .env.l3 up -d --remove-orphans
```

## View grafana dashboard

**Grimsvotn L2:**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -160,3 +160,7 @@ docker compose -f ./docker-compose.l3.yml --env-file .env.l3 up -d
#### `dial tcp: connect: connection refused`

This means that you are not able to connect to the RPC endpoint. Check if you have a firewall up and that you are allowing those ports. For Ubuntu, this would be checked with "sudo ufw status".

#### `WARNING: Found orphan containers`

You should not have orphan containers as the L2 and L3 image container names are different in each docker compose file. Check the [node runner manual](/docs/manual/node-runner-manual) for a command to remove orphan containers.

0 comments on commit 97bd899

Please sign in to comment.