Skip to main content

Setup & Installation Manual

Introduction

Welcome to the WEDA Core installation guide. This manual provides a workflow to deploy the WEDA Core Platform via the OpsManager Installer.

WEDA Core serves as the central orchestration hub, enabling you to:

  • Manage Edge Devices: Register and monitor connected hardware.
  • Data Aggregation: Collect and visualize real-time sensor data.
  • Container Deployment: Remotely push and manage AI models or applications to the edge.

By the end of this guide, you will have a fully functional environment ready for advanced configurations, such as GPU pass-through for AI-based monitoring.

1. Prerequisites

Before installing WEDA Core, ensure your environment meets the basic system and networking requirements.

  • Operating System: A supported Linux distribution (e.g., Ubuntu 24.04 LTS).
  • Permissions: sudo / root access for system-wide installations.
  • Networking: Internet access for downloading dependencies (if using the online installer).

2. Download OpsManager Installer

Download the OpsManager installer package (.run file).
Replace {version} with the actual version number, e.g., v0.1.0.

wget https://downloads.opsmanager.edgesync.ws/releases/opsmanager-installer-{version}.run

3. Set Executable Permissions

After downloading, make the installer executable:

chmod +x opsmanager-installer-{version}.run

4. Remove Previous Installation (Optional)

If you have an existing installation, clean up previous OpsManager installations if necessary:

opsmanager destroy --purge
rm -rf ~/.opsmanager

5. Run the Installer

Execute the installer with sudo privileges. The installer will perform automated checks and set up the environment.

sudo ./opsmanager-installer-{version}.run

6. Define the Initial Configuration

Once installation is complete, run the interactive setup wizard to creating the initial configuration file.

opsmanager new
  • Configuration Details:
    In the initial setup of OpsManager, you will be prompted for Host IP, Domain Name, and Distro User.
    Press Enter to accept the default values, or enter your deployment specifics.
    After confirming, the configuration is saved to the ~/.opsman/config.yml file.


    ParameterDescription
    Host IPThe IP address where WEDA Core will be deployed.
    Domain NameThe domain name used to access the WEDA Core services.
    Distro UserThe system user executing OpsManager.

7. Deploy WEDA Core Platform

Execute the deployment command. OpsManager will read the configuration and use Ansible to automatically deploy all necessary services.

opsmanager up

Tip: The deployment involves pulling container images and configuring services. This process may take several minutes.