Comment on page
Updating a Witness Node
There will be many occasions when a node has to be updated with new or modified features. These software updates can be categorized as "soft forks" or "hard forks".
A soft fork is a software update that is compatible with earlier versions, in other words it’s backward compatible. A soft fork contains no new operation or updates to existing operations on the blockchain.
Generally a soft fork provides an update to an existing feature that isn't relevant to core blockchain operations.
A “hard fork” is a software update that isn’t backwards compatible, so any blocks coming after the activation of the software update will have to follow the new rules in order to be considered valid.
A hard fork is required whenever there is need for introducing new operation(s) or updating existing operation(s) on the blockchain. Each hard fork is time bound to update nodes and all Witnesses will be expected to finish the update before this date/time.
For example, if an update was released that required a hard fork and the hard fork date/time was set to be Jan 01, 2020 12:00EST, then every witness node must be updated before that date/time.
To update a Witness node use the following steps:
The current blockchain
witness_node
binary (.exe) should be backed up in such a way that if there is a serious problem with the update then the node can be rolled-back easily.Each new release will be published, and tagged, in the Peerplays public repository ready for download.
For example, the following is the code for test release 1.4.4:
Note: The above release is just an example, each release will have it's own tag / link.
Download the code from the provided tag / link.
After the Witness node has been built / compiled it needs to be started and the data replayed.
Run the following command:
./programs/witness_node/witness_node --replay-blockchain
If there are any issues during this step then a data resync should be run instead to download blocks from the seed nodes.
./programs/witness_node/witness_node --resync-blockchain
Finally the active node needs to be swapped for the newly built node.