Add Device

Step-by-Step guide on how to add a device to your workspace.

The beeta.one platform utilises an Agent software that runs on edge devices to facilitate the seamless integration of data flows and enable efficient processing at the edge. This Agent acts as a bridge between the edge devices and the beeta.one platform, ensuring smooth communication and data transfer.

The Agent is designed to be hardware-agnostic, compatible with any edge device running a Linux Distribution and with Docker installed. This flexibility allows for easy deployment and scalability across a wide range of edge computing environments.

Prerequisites

  • Ensure that your device is running a Linux OS (Ubuntu, Debian, Raspberry Pi OS, or similar recommended).

  • Install Docker Engine on your device by following the instructions on the official Docker page here or follow the guidance below.

  • Ensure you have access to the device via the command-line interface (CLI).

Minimum Hardware Requirements

  • Supported Platforms: x86, AMD64 (x86-64), ARM.

  • Processor: 32-bit, 64-bit recommended

  • CPU Speed: 1GHz

  • Memory (DDR3): 512MB RAM, 2GB+ RAM recommended

  • Internal Storage (Onboard Flash): 4GB.

  • External Storage (Disk): 2GB.

Registering the Device and Downloading Configuration

  1. Log in to the beeta.one platform and navigate to the devices page in the side navigation.

  2. Click on the "+ New Device" button to add a new device to the platform.

  3. Provide a name for your device and select the appropriate device type from the list. If your device type is not listed, select "other" as long as your device fulfils the listed requirements.

  4. Submit the form, and your newly created device will appear in the list with the status "registered."

  5. Click on the three dots next to your device and select "Download Agent config." This will download a JSON file containing the necessary configuration for the Agent.

Connect to a Device via SSH

Now you need to connect to the device you want to install the Agent on. To securely connect to your device using SSH, follow these steps:

  1. Open the Terminal: On your local machine, open the terminal. On Linux and macOS, you can do this by pressing Ctrl + Alt + T or searching for "Terminal" in your applications menu. On Windows, you can use PowerShell or Command Prompt.

  2. Run the SSH Command: Use the following command to initiate an SSH connection:

    ssh [username]@[host_ip_address]

    Replace [username] with your username on the remote device and [host_ip_address] with the IP address of the device you want to connect to. For example:

    ssh pi@192.168.1.100

  3. Confirm the Connection: If this is your first time connecting to the device, you will be prompted to confirm the connection by typing yes and pressing Enter.

  4. Enter Your Password: When prompted, enter the password for the remote device. Note that the terminal will not display characters as you type the password for security reasons.

  5. Access the Command Line Interface: Once authenticated, you will have access to the command line interface of the remote device, allowing you to run commands as if you were physically present at the machine.

  6. Close the SSH Session: To end the SSH session, type exit and press Enter, or use the shortcut Ctrl + D.

Example

Here is an example of connecting to a Raspberry Pi with the default username pi and an IP address of 192.168.1.100:

bashssh pi@192.168.1.100

After entering the password, you will be logged into the Raspberry Pi's command line interface.

Troubleshooting

If you encounter issues connecting via SSH, ensure that:

  • The IP address of the remote device is correct.

  • The SSH server is running on the remote device.

  • The port (default is 22) is not blocked by a firewall.

  • The username and password are correct.

Next, you will need to install the Docker Engine on your device if you don't already have it. Follow the instructions on this page.

Installing the Agent on Your Device

  1. Connect to your device via the command-line interface (CLI).

  2. Copy the previously downloaded configuration file to your device or create a new configuration file on the device by running the following command:

    sudo nano agent-conf.json

    Copy the content from the downloaded JSON file and paste it into the newly created agent-conf.json file. Save and close the file.

  3. Run the following command to install the Agent on your device, replacing <config-file> with the path to the configuration file:

    curl -sO https://file-service.theone.beeta.one/agent/installer.sh && sh installer.sh <config-file>

  4. The installation process will begin and connect your device to your workspace. Once the process is complete, your device will appear in the list with the status "Connected". If you run into trouble the first time, before diving into a deeper troubleshoot, try to run the installer again.

By following these steps, you can easily add a device to your workspace and install the Agent, enabling efficient data collection, preprocessing, and analysis at the edge. This empowers organisations to harness the full potential of edge computing, leading to improved operational efficiency, reduced latency, and enhanced decision-making capabilities.

PreviousGetting StartedNextInstall Docker Engine

Last updated