Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(website): add remove orphan containers guidance #14551

Merged
merged 1 commit into from
Aug 22, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.