Skip to content

Latest commit

 

History

History
169 lines (138 loc) · 6.78 KB

2.2.snapshot.md

File metadata and controls

169 lines (138 loc) · 6.78 KB
Raw

Synchronize using a snapshot file

This guide will describe a fast way to synchronize a node on the bitcanna-1 blockchain. A snapshot is nothing more than someone sharing a copy of his or her blockchain's data folder in a compressed file.

Our current authorized providers are:

Make sure to include them in your delegations ;)!

The most easy and fastest way to sync a node is by using State Sync and is described here as an alternative.

For this step, its necesary that you have followed this manual previously, in order to install the bcnad binary.

1. Ensure your installed version of the bcnad binary is the lastest release:

bcnad version

The output must be: v2.0.3

If you are using Cosmovisor,

cosmovisor run version

The output must be:

cosmovisor run version
11:11AM INF running app args=["version"] module=cosmovisor path=/home/user/.bcna/cosmovisor/upgrades/wakeandbake/bin/bcnad
2.0.2

2. Initialize the folders

If you are a new user, you must initialize the folders:

Replace Moniker with your own validator name and use quotes for two or more separated words "Royal Queen Seeds".

bcnad init Moniker --chain-id bitcanna-1 --overwrite

This will create a .bcna folder in your $HOME directory.

3. Download the genesis.json file

cd $HOME
curl -s https://raw.githubusercontent.com/BitCannaGlobal/bcna/main/genesis.json > ~/.bcna/config/genesis.json

Ensure that you have the correct file. Run the SHA256SUM test:

sha256sum $HOME/.bcna/config/genesis.json
<output> cd7449a199e71c400778f894abb00874badda572ac5443b7ec48bb0aad052f29

4. Add server SEED's to the config.toml file:

sed -E -i 's/seeds = \".*\"/seeds = \"[email protected]:26656,[email protected]:26656\"/' $HOME/.bcna/config/config.toml

5. You can set the minimum gas prices for transactions to be accepted into your node’s mempool. This sets a lower bound on gas prices, preventing spam.

sed -E -i 's/minimum-gas-prices = \".*\"/minimum-gas-prices = \"0.001ubcna\"/' $HOME/.bcna/config/app.toml

6. Open the P2P port (26656 by default)

sudo ufw allow 26656

7. Download the file with block-data from one of our current authorized service providers:

Our current authorized providers are (in alphabetical order):

You should download a compressed file, unpack it and start the daemon. Follow the instructions at the webpages of the snapshot providers.

This is the folder's tree (without Cosmosvisor installation). You should decompress it at .bcna/data/

.bcna
├── config
└── data
    ├── application.db
    ├── blockstore.db
    ├── cs.wal
    ├── evidence.db
    ├── snapshots
    │   └── metadata.db
    ├── state.db
    └── tx_index.db

17 directories

8. If you have downloaded and decompressed the data-block you can run a first time to see if bcnad continues to sync:

bcnad start --log_level info

3:31PM INF Committed state appHash=77D16BED3F109A4A05A971C92602029569E049DFC1DC128CFF5CCAE3158F4B1B height=3886 module=state txs=0
3:31PM INF Indexed block height=3886 module=txindex
3:31PM INF minted coins from module account amount=1034628bcna from=mint module=x/bank
3:31PM INF Executed block height=3887 invalidTxs=0 module=state validTxs=0
3:31PM INF commit synced commit=436F6D6D697449447B5B38332031333820373720313731203135362032333220313431203435203137332037372031352031363020373120393720393520352031393020313836203733203131342034322031313620313230203536203338203230203337203437203231392032353220343920385D3A4632467D
3:31PM INF Committed state appHash=538A4DAB9CE88D2DAD4D0FA047615F05BEBA49722A7478382614252FDBFC3108 height=3887 module=state txs=0

9. Service creation

Ensure that you have stopped the previous test with CTRL+C. With all configurations ready, you can start your blockchain node with a single command (bcnad start). In this tutorial however, you will find a simple way to set up systemd to run the node daemon with auto-restart.

At this point you can create a simple BCNA service file, or you can configure Cosmovisor. Cosmovisor works like an upgrade "supervisor" that checks and applies the correct version of the software. As a result you can setup Cosmovisor as a replacement of the bcnad daemon/command line utility and let Cosmovisor handle future upgrades.

So the next step is (one of the following)

  • Skip Cosmovisor and continue with simple system service creation
  • Go to Cosmovisor guide and skip this step and the following steps of this guide.

Setup bcnad systemd service (copy and paste all to create the file service):

    cd $HOME
    echo "[Unit]
    Description=BitCanna Node
    After=network-online.target
    [Service]
    User=${USER}
    ExecStart=$(which bcnad) start
    Restart=always
    RestartSec=3
    LimitNOFILE=4096
    [Install]
    WantedBy=multi-user.target
    " >bcnad.service

Enable and activate the BCNAD service.

sudo mv bcnad.service /lib/systemd/system/
sudo systemctl enable bcnad.service && sudo systemctl start bcnad.service

Check the logs to see if it is working:

sudo journalctl -fu bcnad -o cat

10. Check the synchronisation: If catching_up = true the node is syncing. Also you can compare your current block with the last synced block of another node, or at our Explorer:

curl -s localhost:26657/status  | jq .result.sync_info.catching_up
#true output is syncing - false is synced

curl -s localhost:26657/status | jq .result.sync_info.latest_block_height
#this output is your last block synced

curl -s "http://seed1.bitcanna.io:26657/status?"  | jq .result.sync_info.latest_block_height
#this output the public node last block synced
tags: doc github