Skip to content

Latest commit

 

History

History
115 lines (95 loc) · 3.28 KB

1.install-compile.md

File metadata and controls

115 lines (95 loc) · 3.28 KB
Raw

Install / Compile last BitCanna binary

bcnad is a blockchain application built using Cosmos SDK v.0.47.11 and Comet-BFT v.0.37.5 and IBC-go v7.4.0.

In this guide you will find how to install the last binary or compile it by yourself.

  • Before you start, you might want to ensure your system is up to date. Besides, you can install a utility named jq to read and navigate in JSON files and outputs.

    sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y build-essential curl wget jq

  • Increasing the default open files limit. If we don't raise this value, nodes will crash once the network grows large enough.

    sudo su -c "echo 'fs.file-max = 65536' >> /etc/sysctl.conf"
sudo sysctl -p

Option 1. Download and install the last binary

By downloading the binary we avoid compiling the source code.

  1. Download the latest version (v.3.1.0) from Github:

    cd $HOME
wget -nc https://github.com/BitCannaGlobal/bcna/releases/download/v3.1.0/bcna_linux_amd64.tar.gz

  2. Check the sha256sum for the downloaded file.

    sha256sum bcna_linux_amd64.tar.gz

    It must return: 7a714e976ef5d2589ce08736f9f12b15e44b2e63a80bf2fb86e82c2319ebcadf

  3. Verify that the version is 3.1.0

    rm -f ./bcnad #delete old file if exist
tar zxvf  bcna_linux_amd64.tar.gz
rm bcna_linux_amd64.tar.gz
chmod +x bcnad
./bcnad version

  4. Move the new binary to your machine's PATH and overwrite the previous version

    sudo mv bcnad $(which bcnad)   #copy&paste don't replace anything

    If you know the exact destination you could also run:

    sudo mv bcnad /usr/local/bin/ #or wherever you have it

Option 2. Compile instructions:

Install GoLang v1.21.6

The official instructions can be found here: https://golang.org/doc/install

  1. Firstly, remove any existing old Go installation as root 
    sudo rm -rf /usr/local/go
  2. Download the software and unpack: 
    wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz  
sudo tar -C /usr/local -xzvf go1.21.6.linux-amd64.tar.gz
  3. Update environment variables to include Go (copy everything & paste) 
    cat <<'EOF' >>$HOME/.profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export GOBIN=$HOME/go/bin
export PATH=$PATH:/usr/local/go/bin:$GOBIN
EOF
source $HOME/.profile
  4. To verify that Go is installed: 
    go version
    Should return go version go1.21.6 linux/amd64

Download source code and compile

  1. Download the source code using git

    git clone https://github.com/BitCannaGlobal/bcna.git
cd bcna
git checkout v3.1.0
make build   #it build the binary in build/ folder

  2. Verify the version:

    build/bcnad version

    The output must be 3.1.0

  3. You now have two options:

    • Move the binary to the /usr/local/bin path with: 
      sudo mv build/bcnad /usr/local/bin/
    • Or compile and install the binary in the $GOPATH path: 
      make install

Next step: Syncing the chain.

tags: doc github