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 Devo platform and the Devo web application:
For USA users:
For EU 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 hypervisor and Devo Cloud region. If you downloaded the appliance for Hyper-V, you'll have to unzip it so the VHDX file is ready to use.
- Open your hypervisor and use the OVA or VHDX file you downloaded to create the new virtual machine.
- Enter a name for the new machine. This name must not contain dots.
- Create the new machine.
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.
Log into your new virtual machine with the user
logtrustand 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.
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.
- 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.