Skip to content

How to setup KARBO masternode

Ihor Zenich edited this page Sep 19, 2019 · 6 revisions

Create linux service to start karbowanecd

On this page you will find description how to run karbowanecd with JSON PRC as linux service. I use Ubuntu server 18.04 x64, but this description you can be applied to any of the linux versions with small changes.

  1. To start service we will use user karbo, so lets create it, manage permissions and login:
useradd -m -s /bin/bash -G adm,systemd-journal,sudo karbo && passwd karbo
groupadd karbo
usermod -a -G karbo karbo
su karbo
  1. Create directory /KARBO/ in home directory of karbo user:
cd ~
mkdir KARBO
cd KARBO
  1. Download latest linux version of karbowanec and unpack it:

This one is for Linux 18.04, if you have other version, find a corresponding release at https://github.com/seredat/karbowanec/releases/

wget https://github.com/seredat/karbowanec/releases/download/v.1.6.5/karbowanec-bionic-1.6.5_linux_x86_64.zip
unzip -j karbowanec-bionic-1.6.5_linux_x86_64.zip -d KARBO
rm karbowanec-bionic-1.6.5_linux_x86_64.zip
  1. Create log file and add permision to write it:
sudo touch /var/log/karbowanecd
sudo chgrp -R karbo /var/log/karbowanecd
sudo chmod -R 770 /var/log/karbowanecd
  1. You should pre-download blockchain bootstrap to speed-up process:
cd KARBO
mkdir .karbowanec
cd .karbowanec
wget https://bootstrap.karbo.io/blockchain-$(date "+%Y-%m-%d").tar.gz
tar -xvzf blockchain-$(date "+%Y-%m-%d").tar.gz
rm -f blockchain-$(date "+%Y-%m-%d").tar.gz

Exit to root

exit
  1. Add Karbo to firewall:
apt-get install ufw -y
ufw default allow outgoing
ufw default deny incoming
ufw allow ssh/tcp
ufw limit ssh/tcp
ufw allow http/tcp
ufw allow https/tcp
ufw allow 32348/tcp comment "KARBO"
ufw logging on
ufw -f enable
systemctl enable ufw
ufw status

Retun to karbo

su karbo
cd ~
  1. Lets check if everything is ok. Try to run daemon with karbo user permission and wait for SYNCHRONIZED OK. Do not forget to change address to your wallet!
sudo -u karbo KARBO/karbowanecd --data-dir=KARBO/.karbowanec --log-file=/var/log/karbowanecd --restricted-rpc --enable-cors=* --enable-blockchain-indexes --rpc-bind-ip=0.0.0.0 --rpc-bind-port=32348 --fee-address=KixW1oDMYMyabY6CdwS13fQuUwmUeXTPThF9s9JfDggbXSQGnZXkrP9LvcJtV9x7qb2pLsSobkXWXCrPsGGeC1V6VPBhPva

After that, stop it via entering exit inside daemon session.

If you facing errors, you could run Karbo node with debug:

sudo -u karbo KARBO/karbowanecd --data-dir=KARBO/.karbowanec --log-file=/var/log/karbowanecd --restricted-rpc --enable-cors=*  --enable-blockchain-indexes --rpc-bind-ip=0.0.0.0 --rpc-bind-port=32348 --log-level=4 --fee-address=KixW1oDMYMyabY6CdwS13fQuUwmUeXTPThF9s9JfDggbXSQGnZXkrP9LvcJtV9x7qb2pLsSobkXWXCrPsGGeC1V6VPBhPva

Exit to root

exit
  1. To autostart karbowanecd daemon, we need to create service file in /etc/systemd/system:
nano /etc/systemd/system/karbowanecd.service
[Unit]
Description=karbowanecd
Documentation=http://karbo.io
After=syslog.target

[Service]
User=karbo
ExecStart=/home/karbo/KARBO/karbowanecd --data-dir=/home/karbo/KARBO/.karbowanec --log-file=/var/log/karbowanecd --restricted-rpc --enable-cors=*  --enable-blockchain-indexes --rpc-bind-ip=0.0.0.0 --rpc-bind-port=32348 --fee-address=KixW1oDMYMyabY6CdwS13fQuUwmUeXTPThF9s9JfDggbXSQGnZXkrP9LvcJtV9x7qb2pLsSobkXWXCrPsGGeC1V6VPBhPva
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target

Do not forget to change address to your wallet!

  1. Run service:
systemctl daemon-reload
systemctl enable karbowanecd.service
systemctl start karbowanecd.service
  1. Check service status:
root@mega:~# systemctl status karbowanecd.service
● karbowanecd.service - karbowanecd
   Loaded: loaded (/etc/systemd/system/karbowanecd.service; enabled; vendor preset: enabled)
   Active: active (running) since Wed 2019-07-03 15:20:34 CEST; 4s ago
     Docs: http://karbo.io
 Main PID: 23749 (karbowanecd)
    Tasks: 1 (limit: 4915)
   CGroup: /system.slice/karbowanecd.service
           └─23749 /home/karbo/KARBO/karbowanecd --data-dir=/home/karbo/KARBO/.karbowanec --log-file=/var/log/karbowanecd --restricted-rpc --enable-cors=* --enable-blockchain-indexes --rpc-bind-ip=0.0.0.0 --rpc-bind-port=32348 --

Jul 03 15:20:34 mega.karbonode.top systemd[1]: Started karbowanecd.
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]: 2019-Jul-03 15:20:34.906243 INFO    karbowanec v1.6.5.860 (41b1aab)
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:   _|    _|    _|_|    _|_|_|    _|_|_|      _|_|
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:   _|  _|    _|    _|  _|    _|  _|    _|  _|    _|
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:   _|_|      _|_|_|_|  _|_|_|    _|_|_|    _|    _|
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:   _|  _|    _|    _|  _|    _|  _|    _|  _|    _|
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:   _|    _|  _|    _|  _|    _|  _|_|_|      _|_|
Jul 03 15:20:34 mega.karbonode.top karbowanecd[23749]:
lines 1-18/18 (END)

And check your Karbo masternode from browser:
(don't forget to change server url to yours)

You should see something like

{"fee_address":"KixW1oDMYMyabY6CdwS13fQuUwmUeXTPThF9s9JfDggbXSQGnZXkrP9LvcJtV9x7qb2pLsSobkXWXCrPsGGeC1V6VPBhPva","status":"OK"}

and

{"already_generated_coins":"7610716.850198408475","alt_blocks_count":0,"block_major_version":4,"block_minor_version":0,"contact":"","difficulty":12379436832,"fee_address":"KixW1oDMYMyabY6CdwS13fQuUwmUeXTPThF9s9JfDggbXSQGnZXkrP9LvcJtV9x7qb2pLsSobkXWXCrPsGGeC1V6VPBhPva","grey_peerlist_size":4572,"height":375361,"incoming_connections_count":0,"last_block_difficulty":11254033484,"last_block_reward":9114426667130,"last_block_timestamp":1562158538,"last_known_block_index":375360,"min_tx_fee":100000000000,"outgoing_connections_count":4,"readable_tx_fee":"0.100000000000","rpc_connections_count":1,"start_time":1562160046,"status":"OK","top_block_hash":"f4a86fa082a91cdfc8dfb18b4d4649f79a83a0b607485be65c07be33b42c5924","tx_count":414367,"tx_pool_size":3,"version":"1.6.5.860 (41b1aab)","white_peerlist_size":277}

Update KARBO masternode

  1. Login to karbo user, go to karbo folder:
su karbo
cd KARBO
  1. Check current Karbo version: ./karbowanecd --version
  2. Download new Karbo binaries from https://github.com/seredat/karbowanec/releases/, unzip it.
  3. Stop Karbo daemon: sudo systemctl stop karbowanecd.service
  4. Replace Karbo binaries with a fresh one.
  5. Start Karbo daemon: sudo systemctl start karbowanecd.service and check Karbo daemon status sudo systemctl status karbowanecd.service and version: ./karbowanecd --version