The Kusama CC2->CC3 Upgrade Guide

Following the early September release of Kusama CC1, which ran using the Polkadot v0.5.0 release, the Polkadot team have initiated Kusama CC2 with the release of v0.6.0.

This guide will go through the steps required to upgrade an existing validator setup running on Kusama CC1 to Kusama CC2. (Steps taken and tested from Logan Seather’s steps detailed here)

Upgrade Steps

Ensure that your Kusama CC1 validator node is no longer operational, by killing it’s service, assuming you’re running the Kusama node as a service named kusama.service.

$ systemctl stop kusama.service

Enter the directory in which you cloned the Polkadot github repository, for example:

$ cd $HOME/polkadot

Kusama CC1 ran on release v0.5.0 or v0.5.1. Therefore you must now fetch the new Git branches/tags, pull and checkout the Kusama CC2 release, which is v0.6.0.

$ git fetch
$ git pull
$ git pull --tags -f
$ git checkout v0.7.0

Ensure that when checking out, the release is at the following commit:

$ HEAD is now at 5020fa48 update kusama.json

Initialise the environment and build the Polkadot binaries as follows:

$ ./scripts/init.sh
$ cargo build --release --locked

Once the compilation has completed, start the node by running the polkadot binary, then stop it after 30 seconds. The aim of this is to allow for the default directories to be installed at $HOME/.local/share/polkadot/chains/ksmcc3.

$ ./target/release/polkadot

Kusama CC3 imported the final state as CC2, therefore to continue validation with the same private and session keys, these must be copied from CC2’s keystore directory to the directory mentioned above for CC3.

$ cp -r $HOME/.local/share/polkadot/chains/ksmcc2/keystore $HOME/.local/share/polkadot/chains/ksmcc3/keystore

Congratulations, your validator node can now be restarted to start operating and validating on Kusama CC3!

Check your node’s visibility on the Polkadot telemetry: https://telemetry.polkadot.io/#list/Kusama%20CC2

Stay tuned to Simply Staking for more Polkadot related guides and documentation:

• Website: https://simply-vc.com.mt
• Twitter: https://twitter.com/SimplyStaking
• Telegram: https://t.me/SimplyVC