Install Rudder root server on SLES
|
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-server 5.0 That will automatically execute the installation, and you can go directly to the Initial configuration section below. |
Before installation
Before all, you need to setup a server according to the server specifications. You should also configure the network.
As Rudder data can grow really fast depending on your number of managed nodes and number of rules, it is advised to separate partitions to prevent /var getting full and break your system.
Configure the package manager
|
You may encounter a segmentation fault in Zypper in the following cases:
This is due to a bug (bnc#929483 on SUSE bugtracker) in Zypper’s RPM headers parsing. You can either:
|
|
Zypper seems to be quite tolerant to missing dependencies and will let you install rudder-server-root even if you are missing something like git-core for example, if nothing provides it or you did not install it beforehand. Special care should be taken during initial installation not to say "Continue anyway" if Zypper does complain a dependency can not be resolved and asks what to do. |
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 the Rudder packages repository:
-
on SLES 15:
zypper ar -n 'Rudder 5.0' http://repository.rudder.io/rpm/5.0/SLES_15/ Rudder
-
on SLES 12:
zypper ar -n 'Rudder 5.0' http://repository.rudder.io/rpm/5.0/SLES_12/ Rudder
-
on SLES 11:
zypper ar -n 'Rudder 5.0' http://repository.rudder.io/rpm/5.0/SLES_11/ Rudder
Update your local package database to retrieve the list of packages available on our repository:
zypper refresh
Install Rudder root server
To begin the installation, you should simply install the rudder-server-root metapackage, which will install the required components:
zypper install rudder-server-root
Initial configuration
After the installation, you have to configure some system elements, by launching the following initialisation script:
/opt/rudder/bin/rudder-init
This script will ask you to fill in the following details:
- Allowed networks
-
A list of IP networks authorized to connect to the server. It uses the network/CIDR mask notation, for instance 192.168.0.0/24 or 10.0.0.0/8. To add several networks, first type the first network, then press the return key - the script will ask if you wish to add some more networks. Also, the allowed networks can be adjusted later in the web interface in the Administration - Settings tab without having to run the script again.
|
In case of typing error, or if you wish to reconfigure Rudder, you can execute this script again as many times as you want. |
Validate the installation
Once all these steps have been completed, use your web browser to go to the URL
given in the output of rudder-init.
You should see a loading screen, then a login prompt. The default login is:
-
User: admin
-
Password: admin
You are strongly advised to change this password as soon as possible.
The setup of the Rudder server is now over. If you plan to manage hundreds or thousands of nodes, please note that some performance tuning can be necessary on the system.
← on RHEL/CentOS on Debian/Ubuntu →