Upgrading your Full Node (standalone version)

These instructions will show you how to upgrade Radix nodes installed as standalone instances. The instructions apply to:

  • Full nodes

  • Validator nodes

Please read the instructions all the way through first, before applying the changes.

1. Download the latest standalone distribution

The following instructions must be carried out as the radixdlt user.

  1. Switch to the radixdlt user:

    sudo su - radixdlt
  2. Go to https://github.com/radixdlt/radixdlt/releases and look for the entry with the Latest release marker.

  3. You should see a release asset zip file that starts with radixdlt-dist. Copy the URL of the file

  4. Append the full URL to a wget command to retrieve the file:

    wget https://github.com/radixdlt/radixdlt/releases/download/1.0-beta.35.1/radixdlt-dist-1.0-beta.35.1.zip

2. Stop the Node

Before upgrading the software, you’ll need to shut down the node.

sudo systemctl stop radixdlt-node.service

3. Save your existing setup

You’re going to replace the lib and bin directories of your existing installation to upgrade the software. Before doing that, you’re going to save the existing folders to another location.

directory structure for the standalone Radix installation
📂 /
  📂 etc/
    📂 radixdlt/
      📂 node/
        📂 bin/
        📂 lib/
  1. Move the lib directory to a new location.

    mv /etc/radixdlt/node/lib /etc/radixdlt/node/savelib
  2. Move the bin directory to a new location.

    mv /etc/radixdlt/node/bin /etc/radixdlt/node/savebin

4. Replace your existing setup

  1. Unzip the distribution file you downloaded in this step

    unzip radixdlt-dist-1.0-beta.35.1.zip  (1)
    1 The file name should correspond to the release version you have downloaded.
  2. Move the new lib directory from your unzipped distribution to your node directory.

    mv radixdlt-1.0-beta.35.1/lib /etc/radixdlt/node/lib
  3. Move the bin directory from your unzipped distribution to your node directory.

    mv radixdlt-1.0-beta.35.1/bin /etc/radixdlt/node/bin
  4. Now, exit the radixdlt user session

5. Save your existing Nginx configuration

If you still have an existing Nginx configuration from your previous installation then it’s a good idea to move it to another location:

sudo mv radixdlt-nginx-fullnode-conf.zip radixdlt-nginx-fullnode-conf.zip.spare

6. Download the latest Nginx configuration

  1. Go to https://github.com/radixdlt/radixdlt-nginx/releases/ and look for the entry with the Latest release marker.

  2. Copy the URL for radixdlt-nginx-fullnode-conf.zip.

  3. Paste the URL you copied into a wget command on your server to retrieve the zip file.

    wget -O radixdlt-nginx-fullnode-conf.zip https://github.com/radixdlt/radixdlt-nginx/releases//download/1.0-beta.35.1/radixdlt-nginx-fullnode-conf.zip

7. Install the Nginx configuration

  1. Unzip the nginx configuration. (You can overwrite all the files)

    unzip radixdlt-nginx-fullnode-conf.zip
  2. Copy the files to the Nginx installation directory.

    sudo cp -r conf.d/ /etc/nginx/
    sudo cp nginx-fullnode.conf /etc/nginx/nginx.conf

8. Restart Nginx and the Node

Execute the following commands to restart the web server and the node

sudo su - radixdlt
sudo systemctl restart radixdlt-node.service
sudo systemctl restart nginx

9. Ensure that the node has been upgraded

You can check the version of the node software by sending an information request using curl:

curl -k -u admin:<nginx_password_of_your_choice> https://localhost/system/info

The response is a json string that carries the version number as part of its payload.

// -- Truncated