Install on a Red Hat or CentOS box
We recommend installing the Devo Relay on Ubuntu; either as a virtual appliance or on an actual machine. However, it is possible to install the relay on other Unix-family systems. These instructions are based on a CentOS system using the yum package manager.
The hostname of the machine on which you install the relay must not contain dots.
Installing the relay
This procedure guides you through creating the repository, updating it, installing the relay and launching the configuration utility.
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
Create the devo.repo file in /etc/yum.repos.d/ with the following contents:
Update the respository list.
Now, run this command to install the relay.
The system will prompt you a few times. Choose Yes each time.
Finally, the system prompts you to enter the following command as root user:
This launches the configuration utility.
The configuration utility takes you through the steps required to set up the secure connection with your Devo endpoint.
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 modify the relay configuration using the utility at any time after the initial installation, first reset the configuration to the default settings:
gconftool-2 --recursive-unset /apps/devo
Then, launch the configuration utility: