Skip to content

Commit

Permalink
Fixed review comments
Browse files Browse the repository at this point in the history
  • Loading branch information
chetan-zilliqa committed Sep 13, 2024
1 parent de65a9f commit 383e2bb
Showing 1 changed file with 19 additions and 13 deletions.
32 changes: 19 additions & 13 deletions zq2/docs/nodes/nodefaq.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,39 @@ description: Frequently asked questions
---

# Frequently Asked Questions

## [Validator node FAQ](#validator-faq)

## How do I sync my validator node? Should I use genesis sync or checkpoint sync ?

Currently, only genesis mode is supported for syncing validator nodes. We are actively working
on a fix for this issue. Issue link: [issue link]. Once the fix is live, you can use both genesis
sync and checkpoint sync.
Currently, only genesis mode is supported for syncing validator nodes.
We are actively working on checkpoint sync support feature for validator node. It will be activated through a
network upgrade coming soon.

## [API node FAQ](#api-node-faq)
## How do i sync my API node? Should i use genesis sync or checkpoint sync ?
For API node, both genesis sync and checkpoint sync option are supported.
## [Non validator node FAQ](#non-validator-node-faq)
## How do I sync my node if I'm not a validator node?
For non-validator node, both genesis sync and checkpoint sync option are supported.

## My API node s stuck at a specific block and is not progressing. What should i do ?
## My node is stuck at a specific block and is not progressing. What should i do ?
Try restarting the docker container, and the node should resume syncing from the last block.
```bash
docker restart <container_id>
```
## My API node starts, but the docker container stops immediately or after sometime.
## My node starts, but the Docker container stops immediately or after sometime.
This happens when running the api node from checkpoint.We observed that when a node is started from a
checkpoint , because of network latency issues, some nodes may experience node crash problem,
Issue link: [issue link].
The work around at present is as follows.
checkpoint , because of network latency issues, some nodes may experience node crash problem.
This is a temporary issue that will be fixed soon. It can happen to a node started from a checkpoint.
If you see the following error message in the logs.
```bash
{"timestamp":"2024-09-10T09:35:07.897651Z","level":"ERROR","fields":{"thread_name":"tokio-runtime-worker","message":"called `Result::unwrap()` on an `Err` value: database error: trie error: missing node\n\nC aused by:\n trie error: missing node\n\nStack backtrace:\n 0: anyhow::error::<impl core::convert::From<E> for anyhow::Error>::from\n at ./usr/local/cargo/registry/src/index.crates.io-6f17d22 bba15001f/anyhow-1.0.87/src/backtrace.rs:27:14\n
```
The work-around at present is as follows.
In the `zq2-prototestnet.toml` file, append following settings in the `[nodes.consensus]` section and
[start the node](../nodes/prototestnetnodes.md#start-the-node).
```bash
... # some content
[nodes.consensus]
... # some content
consensus_timeout = { secs = 3600, nanos = 0 }
```
```
If you notice any other crash issues not listed above, please bring them to our attention.

0 comments on commit 383e2bb

Please sign in to comment.