add SYNCING.md about fixing syncing issues

Signed-off-by: Jakub Sokołowski <jakub@status.im>
This commit is contained in:
Jakub Sokołowski 2020-01-29 14:03:36 +01:00
parent 56d6ba18a6
commit e30cf6fe95
No known key found for this signature in database
GPG Key ID: 4EF064D0E6D63020
2 changed files with 65 additions and 0 deletions

View File

@ -22,6 +22,7 @@ Currently there are no miners. Mainly because we have plenty of ETH in Ropsten a
Read up on the roles:
* [syncing](/SYNCING.md) - How to fix syncing issues.
* [faucet](ansible/roles/faucet) - Faucet API for distributing funds
* [geth-peer-fix](ansible/roles/geth-peer-fix) - Cronjob fix for issues with syncing

64
SYNCING.md Normal file
View File

@ -0,0 +1,64 @@
# Description
Syncing of light Geth nodes for Faucet purposes can be a pain. This doc might help you with debugging of those issues.
# Tools
Each Geth instance has an `ageth-*` script named after the container available. Lets try it for `ropsten` network:
```
admin@master-01.gc-us-central1-a.faucet.prod:~ % which ageth-faucet-ropsten-geth
/usr/local/bin/ageth-faucet-ropsten-geth
admin@master-01.gc-us-central1-a.faucet.prod:~ % ageth-faucet-ropsten-geth
Welcome to the Geth JavaScript console!
instance: Geth/v1.9.10-stable-58cf5686/linux-amd64/go1.13.6
at block: 7220692 (Wed, 29 Jan 2020 13:00:00 UTC)
datadir: /data
modules: admin:1.0 eth:1.0 net:1.0 personal:1.0 rpc:1.0 web3:1.0
> admin.peers.map(function(o) { return o.enode })
[
"enode://67a391b012b86fa0da8573bab780c1d15e1555a0b9ab89bb7e44261fe9b0683d33cb67668a234e22b2bc4cd6a4b5b5b9d90ed653210ff5b2d04b2c73578ff4af@44.226.193.117:30303",
"enode://23fd0ff45034abb96933c07b4fa9e2aff5029f78ec27a425a2547990b59cffb1e8f87b6ae4a88d2fc4b6f3d57b67673fa3d4df1c893f2cc72ddf37ef75c21a00@178.128.242.69:30303",
"enode://053d2f57829e5785d10697fa6c5333e4d98cc564dbadd87805fd4fedeb09cbcb642306e3a73bd4191b27f821fb442fcf964317d6a520b29651e7dd09d1beb0ec@79.98.29.154:30303"
]
```
You can check syncing status using:
```
admin@master-01.gc-us-central1-a.faucet.prod:~ % ageth-faucet-ropsten-geth eth.syncing
{
currentBlock: 7208959,
highestBlock: 7220617,
knownStates: 0,
pulledStates: 0,
startingBlock: 7143423
}
admin@master-01.gc-us-central1-a.faucet.prod:~ % ageth-faucet-ropsten-geth eth.syncing
false
```
# Adding Peers
The Geth console allows for adding new peers by hand using the `admin.addPeer()` method:
```
admin@master-01.gc-us-central1-a.faucet.prod:~ % ageth-faucet-ropsten-geth
Welcome to the Geth JavaScript console!
instance: Geth/v1.9.10-stable-58cf5686/linux-amd64/go1.13.6
at block: 7220710 (Wed, 29 Jan 2020 13:02:35 UTC)
datadir: /data
modules: admin:1.0 eth:1.0 net:1.0 personal:1.0 rpc:1.0 web3:1.0
> admin.addPeer("enode://d9d79ebe7b5bf1131a68a9be33059711940c0d7f59ad09b88fde328a35b0951f1e613d3beea2b5e3bf959c36a92c951aba66036e29c2e678137f8c0b86029ead@115.159.50.247:30303");
true
```
# Health Check
Consul uses a script for checking syncing status of Geth nodes:
```
admin@master-01.gc-us-central1-a.faucet.prod:~ % /usr/local/bin/check_sync_faucet_ropsten_geth.sh
Geth synced: true
```
When node is not synced this script returns a non-0 status code.