Update Lisk Core (Binary)

How to update the Lisk Core binary distribution to a new version.

1. Download the new Lisk Core version

Download the new Lisk Core version inside of your user home directory.

  • Mainnet

  • Testnet

Linux:

wget https://downloads.lisk.io/lisk/main/3.0.2/lisk-core-v3.0.2-linux-x64.tar.gz
wget https://downloads.lisk.io/lisk/main/3.0.2/lisk-core-v3.0.2-linux-x64.tar.gz.SHA256

MacOS:

wget https://downloads.lisk.io/lisk/main/3.0.2/lisk-core-v3.0.2-darwin-x64.tar.gz
wget https://downloads.lisk.io/lisk/main/3.0.2/lisk-core-v3.0.2-darwin-x64.tar.gz.SHA256

Linux:

wget https://downloads.lisk.io/lisk/test/3.0.2/lisk-core-v3.0.2-linux-x64.tar.gz
wget https://downloads.lisk.io/lisk/test/3.0.2/lisk-core-v3.0.2-linux-x64.tar.gz.SHA256

MacOS:

wget https://downloads.lisk.io/lisk/test/3.0.2/lisk-core-v3.0.2-darwin-x64.tar.gz
wget https://downloads.lisk.io/lisk/test/3.0.2/lisk-core-v3.0.2-darwin-x64.tar.gz.SHA256

2. Verify Checksum

  • Linux

  • MacOS

sha256sum -c lisk-core-v3.0.2-linux-x64.tar.gz.SHA256
# lisk-core-v3.0.2-linux-x64.tar.gz: OK
sha256sum -c lisk-core-v3.0.2-darwin-x64.tar.gz.SHA256

3. Stop Lisk Core

pm2 stop lisk-core

4. Backup Lisk Core

4.1. Backup your custom configs

In case you created custom configurations inside the lisk-core/ folder, make sure to copy or move them out of the lisk-core/ folder before removing them in the next step.

  • custom-config.json: backup the custom configuration for Lisk Core

  • pm2.conf.json: backup the pm2 config file

4.2. Backup the application data

tar czf ~/backup_lisk.tar.gz ~/.lisk/

5. Remove the old version

rm -rf ~/lisk-core/

6. Extract the new version

  • Linux

  • MacOS

tar xzf ~/lisk-core-v3.0.2-linux-x64.tar.gz -C ~/
tar xzf ~/lisk-core-v3.0.2-darwin-x64.tar.gz -C ~/

7. Update the custom config

Update the custom configuration according to the provided default configurations for Lisk Core, located in lisk-core/config/default/, if necessary.

For updating to v3.0.2, it is highly important to ensure the new property unlockFixHeight is included in the configuration.

8. Start Lisk Core

pm2 start lisk-core

9. Sanity Check

Verify the correct version

lisk-core --version
#lisk-core/3.0.2 linux-x64 node-v12.22.7

Check if the new unlockFixHeight is correctly set:

  • unlockFixHeight value for the Mainnet is 16785878

  • unlockFixHeight value for the Testnet is 14867989.

Example: Checking unlockFixHeight for Testnet
lisk-core node:info --pretty | grep unlockFixHeight
"unlockFixHeight": 14867989
For delegates
For delegates: Don’t forget to Enabling forging again after the update.