Install Rudder Root server on Debian or Ubuntu

Add the Rudder packages repository

Each package that is published by Rudder Project is signed with our GPG signature. To ensure the packages you will install are official builds and have not been altered, import our key into apt using the following command:

wget --quiet -O- "https://www.rudder-project.org/apt-repos/rudder_apt_key.pub" | sudo apt-key add -

Our key fingerprint is:

pub  4096R/474A19E8 2011-12-15 Rudder Project (release key) <security@rudder-project.org>
      Key fingerprint = 7C16 9817 7904 212D D58C  B4D1 9322 C330 474A 19E8

Then run the following commands as root:

echo "deb http://www.rudder-project.org/apt-4.0/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
apt-get update

This will add the package repository and finally update the local package cache.

Install your Rudder Root Server

To begin the installation, you should simply install the rudder-server-root metapackage, which will install the required components:

apt-get install rudder-server-root
[Warning]Warning

Any nodes running syslogd (not syslog-ng or rsyslog) will fail to send any reports about the configuration rules they have applied to a Rudder Server running on Ubuntu (and only on Ubuntu). Rudder will apply rules on nodes but will never get reports from them. Therefore Rudder will not be able to calculate compliance.

The only supported platform using syslogd by default is RHEL/CentOS 5, and several workarounds are available to fix this:

  1. Install another syslog server on your nodes, such as rsyslog or syslog-ng.
  2. Change the rsyslog configuration on the Rudder server (running Ubuntu 12.04 or later) to use port 514 and authorize this in the rsyslog configuration.
  3. Setup iptables on the node to send syslog traffic to the correct port on your Rudder server.
  4. Use a different OS for your Rudder server that Ubuntu Server 12.04 or later.