WEDA Node Master

What You'll Learn

By the end of this guide, you'll be able to:

• Install WEDA Node on an edge device
• Monitor service health and status
• Update authentication credentials
• Restart services when needed
• Safely remove WEDA Node installation

Time Required: 10-15 minutes for first-time setup

---

Before You Start

Prerequisites

The following components are required for WEDA Node installation:

Item	Description	Source
Edge Device	Linux-based system (Ubuntu, Debian, etc.)	Physical hardware or virtual machine
WEDA Node Activator Binary	Application executable for installation	Azure Artifacts or build from source
Authentication Info	Master key OR auth info file	System administrator
Terminal Access	SSH or direct terminal access	Infrastructure access credentials

System Requirements

The target edge device must meet the following minimum specifications:

• Operating System: Linux (AMD64, ARM64, or ARMv7)
• RAM: 2 GB available memory
• Storage: 500 MB free disk space
• Network: Internet connectivity for Docker image downloads
• Permissions: sudo/root access for installation

Terminal Configuration

For optimal installation experience, the terminal environment should be configured as follows:

1. Display Size:

Terminal dimensions should be at least 80 columns × 24 rows (recommended: 100 × 30).

# Verify current terminal size
stty size

# Adjust dimensions if needed
resize -s 30 100

2. Color Support:

Enable 256-color mode for proper rendering:

export TERM=xterm-256color

3. Font Requirements:

The terminal font must support Unicode characters to display icons and symbols correctly.

---

Installation Methods

Method 1: Unified Installer (Recommended)

The unified installer packages the application with an automated installation script for streamlined deployment.

For Ubuntu/Debian (AMD64)

# Download unified installer from Azure Artifacts or pipeline run
wget {DOWNLOAD_URL}/weda-installer-ubuntu-amd64-v{version}.tgz

# Extract the installer package
tar -xzf weda-installer-ubuntu-amd64-v{version}.tgz

# Navigate to installer directory
cd weda-installer-amd64-v{version}

# Run the installation script
sudo ./install.sh

For Jetson/ARM64

# Download unified installer for ARM64
wget {DOWNLOAD_URL}/weda-installer-jetson-arm64-v{version}.tgz

# Extract the installer package
tar -xzf weda-installer-jetson-arm64-v{version}.tgz

# Navigate to installer directory
cd weda-installer-arm64-v{version}

# Run the installation script
sudo ./install.sh

Installer Operations

The installation script performs the following operations:

• Extracts and installs the WEDA Node Wizard binary to /opt/Advantech/dmagent/weda-node-wizard/bin/
• Configures required directories and permissions
• Creates a desktop shortcut for application access
• Marks the desktop shortcut as trusted (on supported systems)

Post-Installation Execution

# Run directly from the installation location
/opt/Advantech/dmagent/weda-node-wizard/bin/weda-node-wizard

# Or launch via desktop shortcut
# Desktop icon labeled "WEDA Node" or "WEDA Node Wizard"

Desktop Shortcut Details

• Ubuntu/Debian: Located at ~/Desktop/weda-node.desktop
• Jetson: Utilizes gnome-terminal for maximized window display
• Execution: Runs with sudo privileges for required system permissions

Method 2: Manual Binary Installation

Step 1: Download and Extract

# Download the binary (example for AMD64 Linux)
wget {DOWNLOAD_URL}/weda-node-activator-linux-amd64.tar.gz

# Extract the archive
tar -xzf weda-node-activator-linux-amd64.tar.gz

# Navigate to extracted directory
cd weda-node-activator-linux-amd64

Step 2: Launch the Application

# Run with sudo (required for /opt installation)
sudo ./weda-node-activator

Step 3: Navigate Main Menu

Upon successful launch, the main menu interface is displayed:

┌─────────────────────────────────────┐
│  WEDA NODE ACTIVATOR                │
└─────────────────────────────────────┘

Select an option to continue

  ▶ What is WEDA?
    Install WEDA Node
    Exit

↑/↓: Navigate • Enter: Select • q: Quit

Navigation Controls:

• Arrow Keys: ↑/↓ or Vim-style j/k to move between options
• Selection: Enter to select the highlighted option
• Exit: q or Ctrl+C to quit the application

---

Last updated on Jan-16, 2026 | Version 1.0