Install on an Ubuntu box
This article takes you step-by-step through the installation of the Devo Relay on a machine running Ubuntu. We install the Relay using a .deb package that resides in Devo public repository. You will need to use the package that is specific for your Devo region (EU, USA, or Spain).
You should have the API Key for your Devo domain handy when you start this process. To copy the API key, log into the domain using the Devo web application, then go to the Access Keys tab in Administration → Credentials.
Install the Devo relay
Import the Devo repository public key:
Create the logtrust.list file in /etc/apt/sources.list.d/ with the following contents:
Update the resources list.
Install the package specific to your Devo region:
EU USA Spain
This launches the configuration utility.
The utility takes you through the steps required to set up the secure connection with the Devo Cloud for your region.
The first step is to 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 cannot contain periods or special characters.
Next you enter the endpoint for the Devo Cloud. Enter the endpoint for your region:
Enter the port as 443. This is the fixed inbound port on the Devo Cloud.
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.
Now enter the API Secret for the Devo domain to which you will be forwarding events.
Go to Administration → Credentials in the Devo web application to copy the API Secret.
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. This concludes the setup process. Click OK.
Returning to the terminal, navigate to the /etc/logtrust/relay/ directory and open the logtrust.conf file in your favorite editor.
Edit the URLs for the first two parameters to reflect the region of the Devo Cloud you use. Use us.devo.com for the USA cloud, eu.devo.com for Europe, and es.devo.com for Spain. Below is a sample file edited for the Europe region.
logtrust.services.url = "https://eu.devo.com/domain/clientrelay.json" logtrust.services.downloadHomeRelayConfig.url = "https://eu.devo.com/domain/clientrelay/config" api.key = "7f63f5cea3exxxxxxc113769861800118669687934f9axxxxxx117cea7da344a" api.secret = "09165fdxxxxxx0d28ef341cb8eb392fdfe253cf4f2axxxxxxa435f56656867a3" hardware.id = "fedora-relay" relay.address = "10.0.2.15" proxy.host = "None" proxy.port = "0"
- 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.