• v7.0.8
    • v7.11.0 (latest)
    • v7.10.0
    • v7.9.0
    • v7.8.0
    • v7.7.0
    • v7.6.0
    • v7.5.0
    • v7.3.0
    • v7.2.0
    • v7.1.1
    • v7.1.0
    • v7.0.8
  • Services & Support
  • Devo.com
  • Contact
    • Contact Us
    • Request a Demo
    • Partner Inquiry
  • Log In
    • USA Devo
    • EU Devo
PREVIOUS
Install the Relay on an Ubuntu box (v1.4.2)
NEXT
Install with Docker

Sending data to Devo / The Devo In-House Relay / Installing the Devo Relay / Install the Relay on a Red Hat or CentOS box (v1.4.2)

Download as PDF

Install the Relay on a Red Hat or CentOS box (v1.4.2)

We recommend installing the Devo Relay on Ubuntu. 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. 

Machine hostname

The hostname of the machine on which you install the relay must not contain dots.

Relay migration

If you are using an old version of the Devo relay and want to migrate to the most recent version (v1.4.2), go to Relay migration to learn how to do it.

Before you begin

Make sure you can provide a machine with the following requirements:

Hardware

Minimum requirements:

  • 2 vCPU
  • Memory → 2 GB
  • Hard disk → The hard disk memory should be twice the required disk buffer.

    Hard disk memory

    Note that the hard disk memory should be calculated in relation to the data ingest. Higher volumes of data would allow you to handle potential long downtimes in the network better.

    Learn more about this in Relay buffers.

    Vendor recommendations

    Check the minimum RAM recommended by the vendor per logical CPU here.





Network

Ensure that the Devo Relay can access the following resources:

For USA users:

  • https://us.devo.com: 443
  • us.elb.relay.logtrust.net: 443

For EU users:

  • https://eu.devo.com: 443
  • eu.elb.relay.logtrust.net: 443 

These are the ports used by the Devo In-house Relay:

  • Reserved inbound ports → 12999 to 13002 configured with default rules
  • Optional inbound ports → 13003 to 13030 reserved for custom rules

These ports should not be used by any other services.

You should have the API Key for your Devo domain handy when you start this process. To copy the API key, log in to the domain using the Devo web application, then go to the Access Keys tab in Administration  → Credentials. Learn more in Security credentials.

Installing the Devo Scoja 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

Java and Python versions

Note that the .rpm package includes the required Java and Python versions. Consider uninstalling any other version you may have:

yum remove java
yum remove python

  1. Create the devo.repo file in /etc/yum.repos.d/ with the following contents:

    [devo]
    baseurl = http://packages.devo.com/rpms
    gpgcheck = 1
    gpgkey = http://packages.devo.com/PublicKey
    name = Devo Inc. packages
  2. Update the repository list.

    sudo yum repolist
  3. Run this command to install the relay.

    sudo yum install devo-scoja-relay

     The system will prompt you a few times. Choose Yes each time. 

  4. Finally, the system prompts you to enter the following command as root user:

    /opt/devo/relay/bin/devo-scoja-relay-configure

    This launches the configuration utility. 

  5. 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. https://company.devo.com)
    - 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.

  6. 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 Scoja 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-scoja-relay

Then, launch the configuration utility:

/opt/devo/relay/bin/devo-scoja-relay-configure

Related articles

  • Relay troubleshooting tips (v1.4.2)
  • Managing the relay on the command line
  • Configuring the In-House Relay

Labels

  • latest
Download as PDF

PREVIOUS
Install the Relay on an Ubuntu box (v1.4.2)
NEXT
Install with Docker

Export

See what Devo can do for you. Request a demo!
Discover what's new (Release notes)
  • v7.0.8
    • v7.11.0 (latest)
    • v7.10.0
    • v7.9.0
    • v7.8.0
    • v7.7.0
    • v7.6.0
    • v7.5.0
    • v7.3.0
    • v7.2.0
    • v7.1.1
    • v7.1.0
    • v7.0.8
  • Services & Support
  • Devo.com
  • Contact
    • Contact Us
    • Request a Demo
    • Partner Inquiry
  • Log In
    • USA Devo
    • EU Devo
  • +1 888 6830910 (USA)
  • +34 900 838 880 (Spain)
Copyright © 2019 Legal Terms Privacy Policy Cookies Policy

Powered by Confluence and Scroll Viewport