Testnet 9.3-b released: Upgrade Your Witnet Node/s Now!
Witnet Testnet 9.3-b (witnet-rust 0.9.3-b)
has been released: this covers the instructions on how to upgrade, ready for the network launch on Wednesday 22 September 2020.
What’s new?
The syncing issues faced in Testnet 9.3 have now been fixed (🤞) and tested, in preparation for the launch of the Witnet Mainnet, due on October 14th 2020.
Blocks mined in T9.3-b will count towards Phase 2 Mainnet WIT token allocation.
This release bootstraps a new network with the same genesis block from 0.9.3. However, balances and reputation scores will be reset.
Upgrade now! Different setups, different upgrade methods
The process will depend on your setup. Please identify which of the following setups you have:
- I’m running a node on Docker.
- I’m running a node on Docker Compose.
- I’m running a node with systemd.
- I’m running the binary directly from the release or the source code.
- I’m not running a node yet.
Check below for specific instructions corresponding to each setup.
Setup 1: I’m running a node on Docker
Upgrading is as easy as:
- Remove the old container. Don’t worry, your private keys won’t disappear:
docker stop witnet_node
docker rm witnet_node
2. Pull the latest version of the Docker image:
docker pull witnet/witnet-rust
3. Create a 0.9.3-b container with the following command (if you changed the persistent storage path in the past, change ~/.witnet-rust-testnet-6
for whatever path you were using):
docker run -d \
--name witnet_node \
--volume ~/.witnet:/.witnet \
--publish 21337:21337 \
--restart always \
witnet/witnet-rust
Voilà! Your 0.9.3-b Witnet Testnet node is now up and running. Your master key is safe and your addresses will be the same. This time your balance and reputation score will be lost though, as this is a full network reboot.
Remember that you can always double-check the Witnet version that you are running with this command:
docker exec witnet_node witnet --version
Take into account that Testnet 9.3-b has been scheduled for bootstrapping on Wednesday September 23 at 09:00 UTC. If you start your node before that date and time, it will start looking for peers and then it will remain idle until the bootstrapping. It will then continue operating normally.
If you want to make sure that everything is in order, please take a look at the new “What’s next?” guide in the Witnet protocol documentation.
Warning: if you customized your witnet.toml file, you may need to make those changes again after this upgrade.
Setup 2: I’m already running a node on Docker Compose
Upgrading your Docker Compose setup is even easier. First navigate to the directory where your docker-compose.yaml
file is. For example, if you are using @Bertux integration:
cd witnet-operator-tools/docker/compose/bertux-operator-stable
From there, doing the upgrade is as easy as:
docker-compose down
docker-compose pull
docker-compose up -d
If you want to make sure that everything is in order, please take a look at the new “What’s next?” guide in the Witnet protocol documentation.
Take into account that Testnet 9.3-b has been scheduled for bootstrapping on Wednesday September 23 at 09:00 UTC. If you start your node before that date and time, it will start looking for peers and then it will remain idle until the bootstrapping. Then it will continue operating normally.
Warning: if you customized your witnet.toml file, you may need to make those changes again after this upgrade.
Setup 3: I’m running a node with systemd
These are the steps for upgrading if you are using Harsh Jain’s systemd integration (the witnet.sh
installer and management tool):
- Make sure that you have the latest version of the
witnet.sh
file. - Simply run the
upgrade
command, changing the number after-e
with the number of nodes that you are operating:
./witnet.sh upgrade -s 1 -e 10
Remember that you can always double-check the Witnet version that you are running with this command:
./witnet.sh run -c "--version"
Voilà! Your nodes should be now up and running on the new Testnet 9.
If you want to make sure that everything is in order, please take a look at the new “What’s next?” guide in the Witnet protocol documentation.
Take into account that Testnet 9.3-b has been scheduled for bootstrapping on Wednesday September 23 at 09:00 UTC. If you start your node before that date and time, it will start looking for peers and then it will remain idle until the bootstrapping. Then it will continue operating normally.
Warning: if you customized your witnet.toml file, you may need to make those changes again after this upgrade.
Setup 4: I’m running the binaries directly or compiling from source
If not using Docker, you just need to download the latest release or build it from the source code. The new release will detect the genesis block, sync to the tip of the chain and start mining as usual. Your master key is safe and your addresses will be the same :)
The only case in which additional steps are needed is if you modified a custom witnet.toml
file. If that’s the case, please make sure you update all the consensus constants so they are the same as in this example. Also, you may need to make sure that your configuration file is located in the same directory as the witnet binary itself.
Regarding the genesis_block.json
, please ensure that it is located in .witnet/config/genesis_block.json
(relative to the witnet binary) . Remember that you can download this file from the release page.
You can always double-check the Witnet version that you are running with this command:
witnet --version
If you want to make sure that everything is in order, please take a look at the new “What’s next?” guide in the Witnet protocol documentation.
Take into account that Testnet 9.3-b has been scheduled for bootstrapping on Wednesday September 23 at 09:00 UTC. If you start your node before that date and time, it will start looking for peers and then it will remain idle until the bootstrapping. Then it will continue operating normally.
Warning: if you customized your witnet.toml file, you may need to make those changes again after this upgrade.
Setup 5: I’m not running a node yet
What are you waiting for? Get started in less than 5 minutes!