Skip to content

Latest commit

 

History

History
243 lines (197 loc) · 6.4 KB

installation.md

File metadata and controls

243 lines (197 loc) · 6.4 KB
Raw

🠔 Back

Nemeton Node Installation Guide


The official installation guide can be found at the link



Installation

Preparing the server for installation (one command)

sudo apt update && sudo apt upgrade -y && \
sudo apt install curl build-essential git wget jq make gcc tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y

Installing GO v1.19.2 (one command)

cd $HOME && \
ver="1.19.2" && \
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
sudo rm -rf /usr/local/go && \
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
rm "go$ver.linux-amd64.tar.gz" && \
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile && \
source $HOME/.bash_profile && \
go version

Set variables

CHAIN="okp4-nemeton-1" && \
MONIKER="<YOUR__MONIKER>" && \
WALLET="<YOUR_WALLET_NAME>"

echo "export MONIKER=$MONIKER" >> $HOME/.bash_profile && \
echo "export WALLET=$WALLET" >> $HOME/.bash_profile && \
echo "export CHAIN=$CHAIN" >> $HOME/.bash_profile && \
source $HOME/.bash_profile

Build binary

git clone https://github.com/okp4/okp4d
cd okp4d
make install
okp4d version

Init your node

okp4d init $MONIKER --chain-id $CHAIN && \
okp4d config chain-id $CHAIN && \
okp4d config keyring-backend test && \

Add wallet

okp4d keys add $WALLET

Download Genesis

wget -O ~/.okp4d/config/genesis.json https://raw.githubusercontent.com/okp4/networks/main/chains/nemeton-1/genesis.json

Download addrbook

wget -O $HOME/.okp4d/config/addrbook.json "https://raw.githubusercontent.com/cryptobtcbuyer/Testnet_guides/main/OKP4/addrbook.json"

Configure Peers

PEERS=a009a02a23428538b57591f73ba5a6462c476a70@136.243.88.91:6040,126dc25a6a5aa0cfa83010550dfb3c5a1a861755@65.108.201.15:21337,5c2a752c9b1952dbed075c56c600c3a79b58c395@95.214.55.232:26996,,dcc5b70f1df82def300db6f9dd859c1828514286@65.108.152.201:26656,d5519e378247dfb61dfe90652d1fe3e2b3005a5b@65.109.68.190:36656,8af258bbe73f4c66127a7b3e8b1ec23fde2950a6@65.108.192.123:19656,d1c1b729eff9afe7dfd371f190df6282c82ccfad@37.187.144.187:31656,a49302f8999e5a953ebae431c4dde93479e17155@141.95.153.244:26656,a98484ac9cb8235bd6a65cdf7648107e3d14dab4@116.202.231.58:36656,
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.okp4d/config/config.toml

Create a service file

sudo tee /etc/systemd/system/okp4.service > /dev/null <<EOF
[Unit]
Description=okp4
After=network-online.target

[Service]
User=$USER
ExecStart=$(which okp4d) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Launch node and check logs

sudo systemctl daemon-reload && \
sudo systemctl enable okp4d && \
sudo systemctl restart okp4d && \
sudo journalctl -u okp4d -f -o cat

Wait until the node is fully synchronized.

okp4d status | jq
# The node is synchronized if the value in the "catching_up" line is false

Create a validator

okp4d tx staking create-validator \
--amount=1000000uknow \
--pubkey=$(okp4d tendermint show-validator) \
--moniker=$MONIKER \
--chain-id=$CHAIN \
--commission-rate="0.05" \
--commission-max-rate="0.20" \
--commission-max-change-rate="0.1" \
--min-self-delegation="1" \
--fees=100uknow \
--from=$WALLET \
--identity="" \
--website="" \
--details="" \
-y

State Sync

(optional)

State Sync allows you not to synchronize the entire blockchain database and quickly synchronize the node.


Stop the node and clear the database

sudo systemctl stop okp4d  && okp4d tendermint unsafe-reset-all --home $HOME/.okp4d

Setting variables

SNAP_RPC="http://142.132.202.50:11111"  
# always check that the statesink is available. The address in quotes should open in the browser.
  
# Enter with one command:
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 100)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

Check

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH
# there must be something similar (the numbers will be different):
# 376080 374080 F0C78FD4AE4DB5E76A298206AE3C602FF30668C521D753BB7C435771AEA47189

Adding a peer

peers="5c5bf00059349042504c1e7d0449c4ac6ee37fc2@142.132.202.50:11114" \
&& sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.okp4d/config/config.toml

Adding a addrbook

wget -O $HOME/.okp4d/config/addrbook.json "https://raw.githubusercontent.com/cryptobtcbuyer/Testnet_guides/main/OKP4/addrbook.json"

Adding the variables to config.toml

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.okp4d/config/config.toml

Restart the node and check the logs

sudo systemctl restart okp4d  &&  sudo journalctl -u okp4d  -f -o cat

SnapShot

26.01.23 (1.7 GB) block height 633900

Download the snapshot

cd $HOME
wget http://142.132.202.50:8000/okp4_snap_633900.tar.gz

Stop the node, make a backup of priv_validator_state and delete the database

sudo systemctl stop okp4d  && \
cp $HOME/.okp4d/data/priv_validator_state.json $HOME/priv_validator_state.json.backup  && \
rm -rf $HOME/.okp4d/data/

Unpack the snapshot

tar -C $HOME/.okp4d/ -zxvf okp4_snap_633900.tar.gz --strip-components 3

Move the backup back

mv $HOME/priv_validator_state.json.backup $HOME/.okp4d/data/priv_validator_state.json

Restart the node and check the logs

sudo systemctl restart okp4d && journalctl -fu okp4d -o cat

Remove downloaded snapshot to free up space

cd $HOME && rm -rf okp4_snap_633900.tar.gz