Install on a virtual machine
This article provides step-by-step instructions for installing the Devo Relay on a virtual machine and assumes that the installer is comfortable using their chosen hypervisor.
Before getting started, you might want to watch this helpful video tutorial that describes this process using the VirtualBox hypervisor.
Before you begin
Make sure you can provide a machine with the following requirements:
One of the following hypervisors:
Ensure that the Devo Relay can access the following servers:
For USA users:
For EU users:
For South American users:
These are the ports used by the Devo In-house Relay:
These ports should not be used by any other services.
Install the virtual hard disk
The virtual disk deploys the Ubuntu OS and the Devo Relay.
Click to download the Devo Relay virtual appliance for your chosen hypervisor.
- Open your hypervisor and use the OVA file you downloaded to create the new virtual machine.
- Enter a name for the new machine. This name must not contain dots.
- Be sure that the machine has 2 GB of RAM allocated.
- Create the new machine.
The Devo Relay OVA is provided as a snapshot virtual machine that still requires full management of the OS. At the time of building the version you have downloaded, the included components and packages were up to date with no known vulnerabilities. This may have changed and it is best practice to keep your kernel, packages, and dependencies up to date.
This is especially true for security-related modules and packages. Some updates (for example, kernel updates) require the VM to be rebooted. Plan for a time that will cause the least amount of disruption during the (normally very short) downtime while your server is rebooting.
When accessing the Devo Relay via SSH you may also see notifications that packages can be updated, for example:
1 package can be updated.
0 updates are security updates.
To check for and install updates on the provided OVA based on Ubuntu, run the following command:
sudo apt-get update && sudo apt-get upgrade
To check for and install updates on CentOS, Red Hat, and Fedora systems, run the following command:
sudo yum update
The above will assure that the Devo Relay software as well as the underlying operating system components are kept up to date and potential security risks are remediated.
Set up the Devo Relay
This procedure guides you through the relay setup utility. You can use the console or a terminal editor during this procedure.
A note about the keyboard layout
The default installation loads the US keyboard layout. To change the layout for another region, issue the
loadkeys command before starting this procedure. Use the region code for your region. In this example, we are loading the Spanish keyboard layout (es).
sudo loadkeys es
Log into your new virtual machine with the user
devoand the password
changeme. Once you are logged in, you are prompted to change the password.
Run this command to launch the Devo Relay configuration utility.
First, select the cloud region your Devo domain resides in, then press Enter.
If you select Manual to configure a private cloud location, additional steps request the following information before proceeding.
- Your Devo web application URL (i.e.)
- IP address of your Devo endpoint
- Port to send to on your Devo endpoint
Now enter a name for the new relay. This is not the hostname; it's the relay name that will appear in the Devo web application in Administration → Relays.
The relay name can contain a maximum of 50 characters and must not contain periods. You can use underscores and hyphens but other special characters are not allowed.
Now enter the API Key for the Devo domain to which you will be forwarding events.
Go to Administration → Credentials in the Devo web application to copy the API Key.
Click Yes if the relay requires a proxy to reach the internet. If you do, you can enter the proxy address in the next screen. Otherwise, click No.
- Now you can activate the relay. Go to Administration → Relays and click the Activate button that appears in the new relay's row in the Relay list.
To confirm that the relay is operating correctly, follow our procedure to send test events and make sure they are saved in your Devo domain.
You can now start sending information from your data sources to the new Devo Relay and create the relay rules for event processing.
Reconfiguring the relay
To relaunch the configuration utility at any time after the installation, use the command: