Updating a node using the CLI

20th January 2022Radix Node 1.1.1 released

Use the RadixNode CLI to update your node or install a new node from scratch – or refer to the update instructions for Docker or systemd install methods.

Introduction

When updating your node, care should be taken to ensure the update goes smoothly. These instructions use the radixnode CLI tool for an easy update process.

1. Prepare to update

First, if you haven’t already done so, ensure that you have backed up your node-keystore.ks key file. This key file contains the private key that determines your node’s unique address and (if you are running a validator node) validator ID. If anything goes wrong in the update process, if you have your key file, you can always reinstall the node from scratch and use it to recover access to your node.

Next, you may want to consider using a backup node to perform a switch to the updated node with minimal interruption (especially if running a validator node) – or to provide a quick recovery if something goes wrong during the update. See our recommendations for Maintaining Uptime for more.

2. Update your node

If you upgrading node from version earlier than 1.1.0 , unregistration needs to be done using cli version 1.0.10. Then download the latest version of node cli as described here

To update and start the updated node, run one of the following commands:

  • docker

  • systemd

radixnode docker setup  \
     -u \     (1)
     -n fullnode \      (2)
     -t radix://rn1qgf0tug4nmxfa7su8zsu8pejzq48eeglvxf8le09cuy0nsghzg44weacz2q@3.109.36.249    (3)
1 The -u option specifies that this launch of the node will be an update, causing radixnode to create a backup of the current configuration file and ensure that the node has stopped before applying the changes.
2 The -n option sets the node type and supported value is fullnode. archivenode is no more supported from versions 1.1.0 onwards for node software
3 t is the IP address of a Radix node that you can use to join the network. On executing the command, the script will download the configuration file from the specified node and attempt to make a connection. Select any node IP from the closest region to your node from the list below:
Asia Pacific (south-east)
radix://rn1q2jt0jswv3lpct8tavr5tvlg2kv25f26x7w8kf6dz2hp4pu9cwq4we9tm5f@13.238.198.54
radix://rn1qvmp586ylq9e26n98zwyu9s5hdkq8j63t8l028x8wj4vqzk32dwzw0vrg58@54.66.161.181
Asia Pacific (south)
radix://rn1qgf0tug4nmxfa7su8zsu8pejzq48eeglvxf8le09cuy0nsghzg44weacz2q@3.109.36.249
radix://rn1qg54vufz29c5hcwqxuv4pr60f4fsq6ds0qpa7qnrchdwnapkw6qcxymhy7l@3.109.57.223
EU (west)
radix://rn1qthu8yn06k75dnwpkysyl8smtwn0v4xy29auzjlcrw7vgduxvnwnst6derj@54.216.99.177
radix://rn1qtk3g0a2ra663wyua0l4720vfzdje9uqsdzgzjet5w9dhspkaywnjal6dv6@52.212.46.210
US (east)
radix://rn1qtq336a2nn2269fjes53pynwlytrv0katm6uzlfcyl6m7yscac5g7mh8prw@23.22.58.54
radix://rn1qvw5v4w8llexz99uc9gmeh47qp2h9ax2y3aewm5e6vj5sdx8uuph2vfuvg3@52.200.121.204
If upgrading to version 1.1.0, then install Java 17 either by running sudo apt install -y openjdk-17-jdk or run cli command radixnode configure systemd
radixnode systemd setup  \
     -u \     (1)
     -n fullnode \      (2)
     -r 1.1.1 \   (3)
     -i 52.56.227.5 \    (4)
     -t radix://rn1qgf0tug4nmxfa7su8zsu8pejzq48eeglvxf8le09cuy0nsghzg44weacz2q@3.109.36.249:30000    (5)
1 The -u option specifies that this launch of the node will be an update, causing radixnode to create a backup of the current configuration file and ensure that the node has stopped before applying the changes.
2 The -n option sets the node type and supported value is fullnode. archivenode is no more supported from versions 1.1.0 onwards for node software
3 The -r option is optional and specifies the release of the node software you wish to install. If not provided it will use the latest release from https://github.com/radixdlt/radixdlt/releases.
4 The -i option is the external IP address of your server.
5 t is the IP address of a Radix node that you can use to join the network. On executing the command, the script will download the configuration file from the specified node and attempt to make a connection. Select any node IP from the closest region to your node from the list below:
Asia Pacific (south-east)
radix://rn1q2jt0jswv3lpct8tavr5tvlg2kv25f26x7w8kf6dz2hp4pu9cwq4we9tm5f@13.238.198.54
radix://rn1qvmp586ylq9e26n98zwyu9s5hdkq8j63t8l028x8wj4vqzk32dwzw0vrg58@54.66.161.181
Asia Pacific (south)
radix://rn1qgf0tug4nmxfa7su8zsu8pejzq48eeglvxf8le09cuy0nsghzg44weacz2q@3.109.36.249
radix://rn1qg54vufz29c5hcwqxuv4pr60f4fsq6ds0qpa7qnrchdwnapkw6qcxymhy7l@3.109.57.223
EU (west)
radix://rn1qthu8yn06k75dnwpkysyl8smtwn0v4xy29auzjlcrw7vgduxvnwnst6derj@54.216.99.177
radix://rn1qtk3g0a2ra663wyua0l4720vfzdje9uqsdzgzjet5w9dhspkaywnjal6dv6@52.212.46.210
US (east)
radix://rn1qtq336a2nn2269fjes53pynwlytrv0katm6uzlfcyl6m7yscac5g7mh8prw@23.22.58.54
radix://rn1qvw5v4w8llexz99uc9gmeh47qp2h9ax2y3aewm5e6vj5sdx8uuph2vfuvg3@52.200.121.204