Update Lodestar client

One-page interactive complete guide to update Lodestar client.

Disclaimer

This guide is for informational purposes only. The author nor website owner does not guarantee accuracy of the information in this guide and is not responsible for any damages or losses incurred by following the guide.

Lodestar client can be used for staking on various supported chains. Client installation is always only one, used by services with an individual configuration (different service name, data path and ports in use).

Check current version of Lodestar running on the server:

cd /usr/local/bin/lodestar && ./lodestar -v

  1. Get Lodestar Client

    • Remove old client folder

      cd ~/downloads && sudo rm -r lodestarclient && sudo rm -r lodestar

    • Find the latest stable version of Lodestar client on Github

    • Download Lodestar version 1.25.0 to your node

      mkdir ~/downloads/lodestarclient && cd ~/downloads/lodestarclient && curl -LO https://github.com/ChainSafe/lodestar/releases/download/v1.25.0/lodestar-v1.25.0-linux-amd64.tar.gz

    • Extract downloaded file

      $ tar xvf lodestar-v1.25.0-linux-amd64.tar.gz

    • Create lodestar directory and move the client into it

      mkdir ~/downloads/lodestar && mv ~/downloads/lodestarclient/lodestar ~/downloads/lodestar/lodestar

    • Remove old repository clone

      cd ~/downloads && sudo rm -r lodestar

    • Build Lodestar

      • Download latest Lodestar client from GitHub 
        cd ~/downloads && git clone -b stable https://github.com/chainsafe/lodestar.git
      • Install yarn 
        cd lodestar && yarn install
      • Build Lodestart client 
        yarn run build

  2. Check version of new Lodestar client

    ~/downloads/lodestar/lodestar -v

  3. Stop Lodestar services

    Stop Lodestar Beacon service and all validators-based services

    sudo systemctl stop lodestarbeacon
sudo systemctl stop lodestar-vi...
sudo systemctl stop lodestar-vi...
...

    Stop cosnsensus services

    /usr/local/bin/staking.sh stop consensus

    Check cosnsensus services status

    /usr/local/bin/staking.sh check consensus

  4. Remove old production Lodestar client

    sudo rm -r /usr/local/bin/lodestar

  5. Copy new production client to /usr/local/bin directory

    sudo cp -a ~/downloads/lodestar /usr/local/bin

  6. Start the Lodestar services

    Start Lodestar Beacon service and all validators-based services

    sudo systemctl start lodestarbeacon
sudo systemctl start lodestar-vi...
sudo systemctl start lodestar-vi...
...
    /usr/local/bin/staking.sh start consensus

  7. Monitor

    • systemctl status lodestarbeacon lodestar-vi.. lodestar-vi..
    • journalctl -fu lodestarbeacon
    • journalctl -f -u lodestar-vi.. -u lodestar-vi..
    /usr/local/bin/staking.sh check consensus
    /usr/local/bin/staking.sh monitor consensus