Rodeo Installation Guide¶

This guide covers installing Rodeo on Red Hat-based (RHEL, CentOS, Fedora) and Debian-based (Ubuntu, Debian) Linux systems.

Prerequisites¶

Before installing Rodeo, ensure your system meets the following requirements:

Linux operating system (RHEL 8+, CentOS 8+, Fedora 36+, Ubuntu 20.04+, or Debian 11+)
Root or sudo privileges
At least 2 GB of available disk space
Network connectivity (for graph database connections)

Installation on Red Hat-Based Systems¶

Installing from RPM¶

Download the Rodeo RPM package to your system.
Install the package using dnf (recommended) or rpm:

# Using dnf (recommended)
sudo dnf install ./rodeo-<version>.rpm

# Or using rpm directly
sudo rpm -ivh rodeo-<version>.rpm

Verify the installation:

rodeo --version

Resolving Dependencies¶

If you encounter dependency issues, ensure that the EPEL repository is enabled:

sudo dnf install epel-release
sudo dnf update
sudo dnf install ./rodeo-<version>.rpm

Installation on Debian-Based Systems¶

Installing from DEB¶

Download the Rodeo DEB package to your system.
Install the package using apt:

sudo apt update
sudo apt install ./rodeo-<version>.deb

Alternatively, use dpkg followed by dependency resolution:

sudo dpkg -i rodeo-<version>.deb
sudo apt-get install -f

Verify the installation:

rodeo --version

Post-Installation Setup¶

After installing the package, you must run the setup script to complete the configuration.

Running the Setup Script¶

Run the setup script, run this as your user:

/opt/rodeo/setup_user_service.sh

What the Setup Script Configures¶

The setup script performs the following actions:

Creates a new user systemd service and start the rodeo-service

Starting the Rodeo Service¶

After setup, you can manage the Rodeo service using systemd:

# Start the service
systemctl --user start rodeo.service

# Enable the service to start on boot
systemctl --user enable rodeo.service

# Check service status
systemctl --user status rodeo.service

Verifying Your Installation¶

Run the following command to ensure the Rodeo Service is properly installed and running:

rodeo version

Uninstalling Rodeo¶

Red Hat-Based Systems¶

sudo dnf remove rodeo

Debian-Based Systems¶

sudo apt remove rodeo

# To also remove configuration files:
sudo apt purge rodeo

Next Steps¶

Once installation is complete, proceed to the CLI Reference to learn about available commands, or see the Mapping Files Guide to start creating ETL pipelines.