Install Rudder agent on Debian or Ubuntu
If you are working on a test system, you can use the quick install script:
curl https://repository.rudder.io/tools/rudder-setup | bash -s setup-agent 5.0 [policy server hostname or ip]
That will automatically execute the following steps.
The Rudder agent requires that a syslog server is installed on the node. This syslog server can be either:
One of them is generally installed by default, but it may not be the case with minimal images. In this case you should install one (preferably syslog-ng or rsyslog).
Each official package 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://repository.rudder.io/apt/rudder_apt_key.pub" | sudo apt-key add -
Our key fingerprint is:
pub 4096R/474A19E8 2011-12-15 Rudder Project (release key) <firstname.lastname@example.org> Key fingerprint = 7C16 9817 7904 212D D58C B4D1 9322 C330 474A 19E8
Add Rudder’s package repository:
# If lsb_release is not installed on your machine, change $(lb_release -cs) by your distribution codename. # Ex: # stretch for Debian 9 # bionic for Ubuntu 18.04 LTS echo "deb http://repository.rudder.io/apt/5.0/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
Update your local package database to retrieve the list of packages available on our repository:
Install the package:
apt-get install rudder-agent
Configure the IP address or hostname of the Rudder Root Server in the following file
echo '<rudder server ip or hostname>' > /var/rudder/cfengine-community/policy_server.dat
We advise you to use the IP address of the Rudder root server. The DNS name of this server can also be used if you have a trusted DNS infrastructure with proper reverse resolutions.
You can now start the Rudder service with:
rudder agent start
Several minutes after the start of the agent, the new node should be pending in the Rudder web interface. You will be able to browse its inventory, and accept it to manage its configuration with Rudder.
You may force the agent to run and send an inventory by issuing the following command:
rudder agent inventory
You may force the agent run by issuing the following command:
rudder agent run
← on SLES on RHEL/CentOS →