Gateway Setup Guide

Overview

Lumeo Gateway can be setup on a wide variety of hardware running on your premises, in public clouds or in the Lumeo cloud. This guide describes how to set it up on your hardware.

Helpful References :
Gateway documentation
Recommended Gateway Hardware

If installing on x86 server with Nvidia GPU, before you start, ensure that your device is setup with Ubuntu 18 or later, and the latest Nvidia drivers. Verify by running nvidia-smi on a terminal prompt.

Lumeo Gateway Installer

Interactive Install

Set up a new Gateway by running the following command on it and following the installer prompts:

bash <(wget -qO- https://link.lumeo.com/setup)

This command can also be found in Console under Gateways → Add Gateway. The installer offers you a bunch of options to optimize your installation in the interactive model. Installing the Gateway using this installer will also set it up to auto update whenever a new Gateway version is released.

Unattended Install

Gateway installer supports the following environment variables to allow for bulk, unattended installations:

Env Variable

Description

Notes

LUMEO_APP_ID

Specify the Application ID to connect this gateway to. See API section to find your Application ID.

Currently only supported for host (non-containerized) installations or Advanced Installation (see section below)

LUMEO_API_KEY

Provide the API Key for the specific Application you want to connect this gateway to. See API section to find your API Key.

Currently only supported for host (non-containerized) installations or Advanced Installation (see section below)

NO_PROMPT

Specify this env variable to provision a Gateway using the default settings.

Examples:
Install and provision gateway to a specific Application Id.

LUMEO_APP_ID='app_id' LUMEO_API_KEY='api_key' bash <(wget -qO- https://link.lumeo.com/setup)

Manual Container Install

You can also install Lumeo containers directly using the following commands, but then you will be responsible for updating the container yourself when new Gateway versions are released.

The interactive or unattended install methods described above also let you use containers, but in addition, will set your containers up for automated upgrades when new versions are released. Use the Manual container install method when you would like control over upgrades.

Nvidia Jetson

docker run -d --restart unless-stopped \
                   -v lumeo-container-name:/var/lib/lumeo  \
                   --env LUMEO_APP_ID='<app_id>' --env LUMEO_API_KEY='<api_key>' \
                   --network host --gpus all lumeo/gateway-nvidia-jetson:latest

x86 + DGPU

docker run -d --restart unless-stopped \
                   -v lumeo-container-name:/var/lib/lumeo  \
                   --env LUMEO_APP_ID='<app_id>' --env LUMEO_API_KEY='<api_key>' \
                   --network host --gpus all lumeo/gateway-nvidia-dgpu:latest

AWS - Lumeo Gateway Installer

Before using the Lumeo Gateway Installer on your Nvidia GPU enabled AWS EC2 machines, follow these steps :

In the EC2 console, configure and launch machine instance with the following configuration:

833833

After launching the virtual, log in, execute the following commands to configure the machine instance and install Lumeo Gateway software:

sudo apt update

Install nvidia drivers

sudo apt install nvidia-compute-utils-495 nvidia-dkms-495 nvidia-driver-495 nvidia-kernel-common-495 nvidia-kernel-source-495 nvidia-modprobe nvidia-prime nvidia-settings nvidia-utils-495

Verify the nvidia drivers are properly installed, execute the command:

nvidia-smi

To see output like this

[email protected]:~$ nvidia-smi
Sat Jun  4 01:10:01 2022       
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 510.73.05    Driver Version: 510.73.05    CUDA Version: 11.6     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|                               |                      |               MIG M. |
|===============================+======================+======================|
|   0  Tesla T4            Off  | 00000000:00:1E.0 Off |                    0 |
| N/A   37C    P8    15W /  70W |      0MiB / 15360MiB |      0%      Default |
|                               |                      |                  N/A |
+-------------------------------+----------------------+----------------------+
                                                                               
+-----------------------------------------------------------------------------+
| Processes:                                                                  |
|  GPU   GI   CI        PID   Type   Process name                  GPU Memory |
|        ID   ID                                                   Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+

If you receive an error, reboot the instance as it maybe required for different instance types and the drivers to load properly.

Finally execute the installer interactively and selecting the default option which is container.

bash <(wget -qO- https://link.lumeo.com/setup)

AWS - AMI Images

Using a Lumeo published AMI image makes it easy to setup a Lumeo Gateway hosted in your AWS account and provision it to your Lumeo account.

Instructions : Coming soon.

Post Install

Once setup, return to the Console to see it show up in the Gateways list.

13881388

You need to ensure the Gateway is able to talk to Lumeo’s cloud services. More info in Security & Network section.


Did this page help you?