WEDA Node Activator
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 |
| Installer Package | weda-installer-{arch}-v{version}.tgz | Download from Azure Artifacts or CI pipeline |
| WEDA Account | Username & password for WEDA Core | Self-registration |
| Credential File | Master key or device credential file (.bin) — only needed for Local File method | WEDA Core portal or 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:
- 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
- Color Support:
Enable 256-color mode for proper rendering:
export TERM=xterm-256color
- Font Requirements:
The terminal font must support Unicode characters to display icons and symbols correctly.
Running the Installer
The installer package deploys WEDA Node and WEDA Node Activator onto the device. Run this step once per device or during device image creation.
For Ubuntu/Debian (AMD64):
# 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 Ubuntu/Debian (ARM64):
# Extract the installer package
tar -xzf weda-installer-ubuntu-arm64-v{version}.tgz
# Navigate to installer directory
cd weda-installer-arm64-v{version}
# Run the installation script
sudo ./install.sh
What installer.sh does:
- Installs the WEDA Node Docker service stack configuration to
/opt/Advantech/dmagent/ - Places the WEDA Node Activator binary at
/opt/Advantech/dmagent/weda-node-activator/bin/weda-node-activator - Sets up required directories and file permissions
- Creates a desktop shortcut (
~/Desktop/weda-node.desktop) for easy access on GUI systems
After
installer.shcompletes, the WEDA Node service is not yet running. You must launch WEDA Node Activator to enable and configure it.
Starting WEDA Node Activator
# Must be run with sudo (required for Docker operations and /opt file access)
sudo /opt/Advantech/dmagent/weda-node-activator/bin/weda-node-activator
# Or use the desktop shortcut on systems with a GUI
Note: The application will refuse to start without
sudo/ root privileges.
Main Menu
After launch you will see the main menu:
Before WEDA Node is enabled:
┌──────────────────────────────────────────────────┐
│ WEDA Node Activator │
└──────────────────────────────────────────────────┘
Welcome to WEDA (WISE-Edge Developer Architecture)
Accelerating your Edge AI Development
╭──────────────────────────────────────────────────╮
│ WEDA Node Activator │
│ │
│ Install and manage your WEDA Node -- accelerate │
│ Edge AI development and edge-cloud orchestration │
╰──────────────────────────────────────────────────╯
Main Menu
What is WEDA?
Learn about WEDA platform and features
> Install WEDA Node
Begin installation wizard
Exit
Close WEDA Node Activator
↑/↓: Navigate Menu • Enter: Select Option • Ctrl+C: Exit
WEDA Node Activator v1.0.0 | Device: AA:BB:CC:DD:EE:FF | Model: EPC-U2217
After WEDA Node is enabled:
What is WEDA?
> Manage WEDA Node
Exit
Navigation:
- ↑/↓ or j/k — move between items
- Enter — select
- q or Ctrl+C — quit
- The footer always shows detected Device ID and Device Model