Document toolboxDocument toolbox

.Install Devo Relay on an Ubuntu box vv7.3.0

This article takes you step by step through the installation of Devo Relay on a machine running Ubuntu. We will install the most recent version of Devo Relay (v2.0.0) using a .deb package that resides in Devo public repository.

Relay migration

If you are using an old version of Devo Relay and want to migrate to the most recent version (v2.0.0), go here to learn how to do it.

Before you begin

Make sure you can provide a machine with the requirements specified in this article.

Installing Devo Relay 

Follow these instructions to install the .deb package that contains the relay.

Note that the .deb package is certified for Ubuntu 18 (Bionic) and Ubuntu 20 (Focal Fossa). 

Important: Java versions

Please note that the devo-ng-relay and CLI require Java 8 to work. Other Java versions are not supported. The devo-ng-relay package includes this required Java version (Java 8) so please consider uninstalling any other version you may have, or use the Linux command update-alternatives to make Java 8 the default Java.

  1. Import the Devo repository public key:

    wget -qO - http://packages.devo.com/PublicKey | sudo apt-key add - 
    echo "deb http://packages.devo.com/ bionic devo" | sudo tee /etc/apt/sources.list.d/devo.list
  2. Update the resources list.

    sudo apt-get update
  3. Install the relay package and the relay command-line interface (CLI) using this command:

    sudo apt-get install devo-ng-relay
  4. Optionally, you can install the devo-monitor package that installs scripts that monitor machine status (CPU, memory, IO traffic) so their values can be sent to the Devo endpoint. The events collected by this package will be available in the box.stat.unix.* tables of your Devo domain. You can install this package using the following command: 

    sudo apt install devo-monitor

    It is highly recommended that you install the devo-monitor package on your machine since it will help in case you need to troubleshoot your relay.

  5. Finally, you must configure your relay and then activate it on the Devo platform. See the Devo Relay setup process in Set up your relay.

    You can relaunch the set up process at any time after the installation if needed.

    .