We have found a moderate severity bug in Heimdall for CS2008. We currently have a hotfix ready for it and below the steps will explain how you can apply the hotfix to your nodes. However, the hotfix needs to be applied Before Heimdall block number 310800. If you are unable to apply the hotfix before, your node will not function and you will have to set up again (with a different address).
Please note that the changes required are on for Heimdall, please do not make any changes to your Bor node.
Applying the Hotfix for CS2008
Linux Packages:
First, you will need to stop Heimdall, Bridge, and Rest Server services.
To stop Heimdall and other services you can run the following commands:
Stop Heimdall: sudo service heimdalld stop
Stop rest-server: sudo service heimdalld-rest-server stop
Stop bridge: sudo service heimdalld-bridge stop
Now download the latest version of Heimdall
Install Heimdall: https://matic-public.s3.amazonaws.com/v0.1.9/matic-heimdall_0.1.9_amd64.deb
Now install the latest version of Heimdall on your both your nodes, Sentry, and Validator. However, please do this on your Sentry node first and start Heimdall and then follow the same steps on your Validator node.
Install Heimdall: sudo dpkg -i matic-heimdall_0.1.9_amd64.deb
The Matic Docs have been updated with the hotfix links.
Start Heimdall and other services:
Start Heimdall: sudo service heimdalld start
Start rest-server: sudo service heimdalld-rest-server start
Start bridge: sudo service heimdalld-bridge start
You can check your logs and see if Heimdall is working correctly. This setup won’t start the sync from scratch, it will only sync from where you had left off.
For Binaries
First, you will need to stop Heimdall, Bridge, and Rest Server services.
Stop Heimdall: pkill heimdalld
Stop Bridge: pkill heimdalld-bridge
Stop rest-server: pkill rest-server
Now you will need to pull the latest updates from the Heimdall Git repository. You will need to perform these steps on both the Sentry and Validator nodes. However, please do this on your Sentry node and start Heimdall and then follow the same steps on your Validator node.
Navigate to Heimdall folder in $GOPATH
cd $GOPATH/src/github.com/maticnetwor/heimdall
git checkout v0.1.9
make install
The Matic Docs have been updated with the hotfix links.
Once you are done with your setup, you can start Heimdall, bridge, and rest-server
Start Heimdall and other services
heimdalld start
In order to create a log for Heimdall you can run this command instead
$ mkdir ~/.heimdalld/logs/
$ heimdalld start > ~/.heimdalld/logs/heimdalld.log 2>&1 &
heimdalld rest-server
In order to create a log for Heimdall you can run this command instead
heimdalld rest-server > ~/.heimdalld/logs/heimdalld-rest-server.log 2>&1 &
bridge start --all
For Heimdall bridge, you can run this command to write logs for it
bridge start --all > ~/.heimdalld/logs/heimdalld-bridge.log 2>&1 &
If you don’t upgrade for both (assuming that you’re running both) then you will face issues with your nodes.
This should help you upgrade your node with the latest hotfix and you should be ready.