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:

   Copy

   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.

   Copy

   ./znn-controller

   • Interactive Prompt:

     Copy

     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.

   Copy

   wget -O znn_controller-linux-x86_64.zip YOUR_LATEST_URL

   Example:

   Copy

   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:

  Copy

  unzip -o znn_controller-linux-x86_64.zip

  • -o Flag: Overwrites existing files without prompting.

• Remove the ZIP File:

  Copy

  rm znn_controller-linux-x86_64.zip

5) Deploy the Updated Controller

• Run the Updated znn-controller:

  Copy

  ./znn-controller

• Deployment Options:

  Upon execution, you will be presented with deployment options:

  Copy

  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:

    Copy

    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.

  Copy

  ./znn-controller

  • Interactive Prompt:

    Copy

    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.