Update Guide

Table of Contents

  1. Prerequisites

  2. Stop the znnd Service

  3. Download the Latest znn-controller

  4. Replace the Existing znn-controller File

  5. Deploy the Updated Controller

  6. Verify the Update

1) Prerequisites

Before proceeding with the update, ensure you have the following:

  • Access Credentials: SSH access to your server with sudo privileges.

  • Basic Knowledge: Familiarity with command-line interfaces and server management.

  • Backup: It's recommended to back up your current configuration and controller files before performing the update.

2) Stop the znnd Service

  1. Access Your Server via SSH:

    Open your terminal and connect to your server using SSH: 

    ssh username@your_server_ip

    Replace username with your server's username (commonly root) and your_server_ip with your server's IP address.

  2. Stop the znnd Service:

    Run the znn-controller executable and select the option to Stop Service the znnd service. 

    ./znn-controller

    • Interactive Prompt: 

      1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above

    • Action:

      • Enter 4 and press Enter to stop the running the znnd service.

    Note: Ensure the service has completely stopped before proceeding to the next step. You can enter 2 and press Enter to verify the Status of the znnd service.

3) Download the Latest znn-controller

  1. Identify the Latest Release URL:

    Visit the Zenon Network GitHub Repository to find the latest version of the znn-controller. Copy the download URL for the x86/64 Linux release.

  2. Download the Latest Controller:

    Replace YOUR_LATEST_URL with the actual URL of the latest znn-controller release. 

    wget -O znn_controller-linux-x86_64.zip YOUR_LATEST_URL

    Example: 

    wget -O znn_controller-linux-x86_64.zip https://github.com/zenon-network/znn_controller_dart/releases/download/v0.0.5-beta/znn_controller-linux-x86_64.zip

4) Replace the Existing znn-controller File

  • Extract the Downloaded ZIP File: 

    unzip -o znn_controller-linux-x86_64.zip

    • -o Flag: Overwrites existing files without prompting.

  • Remove the ZIP File:

    rm znn_controller-linux-x86_64.zip

5) Deploy the Updated Controller

  • Run the Updated znn-controller: 

    ./znn-controller

  • Deployment Options:

    Upon execution, you will be presented with deployment options: 

    1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above

  • Select Deploy Option:

    • Action: Enter 1 and press Enter to deploy the updated controller.

  • Continue Using Existing Configuration:

    • Prompt: 

      Continue using the existing configuration? (Y/N):

    • Action: Enter Y and press Enter to confirm.

6) Verify the Update

  • Check the Status of the Controller:

    Run the znn-controller and select the status option to verify that the update was successful. 

    ./znn-controller

    • Interactive Prompt: 

      1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above

    • Action: Enter 2 and press Enter to view the current status.

Last updated