Install Rudder agent on RHEL or derivatives
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 8.2 [policy server hostname or ip] That will automatically execute the following steps. |
Installation
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 rpm using the following command:
rpm --import https://repository.rudder.io/rpm/rudder_rpm_key.pub
Our key fingerprint is:
pub 1024R/6F07D355 2012-11-09 Rudder Project (RPM release key) <security@rudder-project.org> Key fingerprint = 1141 A947 CDA0 4E83 82C1 B9C4 ADAB 3BD3 6F07 D355
Add a yum repository for Rudder (replace VERSION with RHEL version):
echo '[Rudder_8.2] name=Rudder 8.2 baseurl=http://repository.rudder.io/rpm/8.2/RHEL_<VERSION>/ gpgcheck=1 gpgkey=https://repository.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo
If you have an active subscription, use the following to get access to long term support (you need to replace the VERSION, username and the password by your Rudder account): echo '[Rudder_8.2] name=Rudder 8.2 username=LOGIN password=PASSWORD baseurl=http://download.rudder.io/rpm/8.2/RHEL_<VERSION>/ gpgcheck=1 gpgkey=https://download.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo Or for RHEL/CentOS < 7 (replace VERSION with RHEL version): echo '[Rudder_8.2] name=Rudder 8.2 baseurl=https://LOGIN:PASSWORD@download.rudder.io/rpm/8.2/RHEL_<VERSION>/ gpgcheck=1 gpgkey=https://LOGIN:PASSWORD@download.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo |
-
on Amazon Linux 2023:
echo '[Rudder_8.2] name=Rudder 8.2 baseurl=http://repository.rudder.io/rpm/8.2/AL_2023/ gpgcheck=1 gpgkey=https://repository.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo
Downloading the Amazon Linux 1 & 2 agents requires an active subscription. |
-
on Amazon Linux 1:
echo '[Rudder_8.2] name=Rudder 8.2 username=LOGIN password=PASSWORD baseurl=http://download.rudder.io/rpm/8.2/RHEL_6/ gpgcheck=1 gpgkey=https://download.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo
-
on Amazon Linux 2:
echo '[Rudder_8.2] name=Rudder 8.2 baseurl=http://download.rudder.io/rpm/8.2RHEL_7/ gpgcheck=1 gpgkey=https://download.rudder.io/rpm/rudder_rpm_key.pub' > /etc/yum.repos.d/rudder.repo
Install the package:
yum install rudder-agent
Configuration
Configure the agent
Configure the IP address or hostname of the Rudder Root Server in the following file
rudder agent policy-server <rudder server ip or hostname>
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. |
Add the node to the server
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 -l
The -l
here prevents the agent from trying to update its policies, which is not possible yet, and only run
with local policies.
By default, a node listens on port 5309 to allow remote agent trigger. This feature is optional and can be disabled for security reason. |
← on Debian/Ubuntu on SLES →