Rudder 4.1 - User Manual i Rudder 4.1 - User Manual Rudder 4.1 - User Manual ii Copyright © 2011-2016 Normation SAS Rudder User Documentation by Normation is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License. Permissions beyond the scope of this license may be available at normation.com. Rudder 4.1 - User Manual iii COLLABORATORS TITLE : Rudder 4.1 - User Manual ACTION NAME DATE SIGNATURE WRITTEN BY Jonathan Clarke, Sep 2016 Nicolas Charles, Fabrice Flore-Thebault, Matthieu Cerda, Nicolas Perron, Arthur Anglade, Vincent Membré, and François Armand REVISION HISTORY NUMBER DATE DESCRIPTION NAME 4.1 Sep 2016 N Rudder 4.1 - User Manual iv Contents 1 Online version 1 2 Introduction 2 2.1 What is Rudder? . .2 2.1.1 Made for production environments . .3 2.1.2 Different roles for a better accessibility . .4 2.1.3 Universality . .5 2.2 Key Features . .6 2.2.1 OS independent target configuration state definition . .6 2.2.2 Centralize and aggregate real configuration states . .7 2.2.3 Automatic inventory . .8 2.2.4 REST API . .8 2.2.5 Audit trace and Change Requests . .8 2.2.6 Centralized authentication (LDAP, Active Directory, plugins) . .9 2.2.7 Extensibilty . 10 2.3 Technical architecture and software dependencies . 11 2.3.1 Functional architecture of Rudder . 11 2.3.2 Network architecture in client/server mode . 12 2.3.3 Agents . 13 3 Installation 14 3.1 Quick installation . 14 3.2 Requirements . 15 3.2.1 Networking . 15 3.2.1.1 Mandatory flows . 15 3.2.1.2 Optional flows . 15 3.2.1.3 DNS - Name resolution . 15 3.2.2 Fully supported Operating Systems . 15 3.2.2.1 For Rudder Nodes . 16 3.2.2.2 For Rudder Root Server . 16 3.2.3 Partially supported Operating Systems . 16 Rudder 4.1 - User Manual v 3.2.3.1 For Rudder Nodes . 17 3.2.3.2 For Rudder Root Server . 17 3.2.4 Cloud compatibility . 17 3.2.5 Hardware specifications for Rudder Agent . 17 3.2.6 Hardware specifications and sizing for Rudder Root Server . 17 3.2.6.1 Memory . 18 3.2.6.2 Disk . 18 3.3 Install Rudder Server . 18 3.3.1 Install Rudder Root server on Debian or Ubuntu . 19 3.3.1.1 Add the Rudder packages repository . 19 3.3.1.2 Install your Rudder Root Server . 20 3.3.2 Initial configuration of your Rudder Root Server . 20 3.3.3 Validate the installation . 20 3.3.4 Install Rudder Root server on SLES . 20 3.3.4.1 Configure the package manager . 20 3.3.4.2 Add the Rudder packages repository . 21 3.3.4.3 Install your Rudder Root Server . 21 3.3.5 Initial configuration of your Rudder Root Server . 22 3.3.6 Validate the installation . 22 3.3.7 Install Rudder Root server on RHEL-like systems . 22 3.3.7.1 Add the Rudder packages repository . 22 3.3.7.2 Install your Rudder Root Server . 23 3.3.8 Initial configuration of your Rudder Root Server . 23 3.3.9 Validate the installation . 24 3.4 Install Rudder Agent . 24 3.4.1 Install Rudder Agent on Debian or Ubuntu . 24 3.4.2 Install Rudder Agent on RHEL-like systems . 25 3.4.3 Install Rudder Agent on SLES . 26 3.4.4 Configure and validate . 27 3.4.4.1 Configure Rudder Agent . 27 3.4.4.2 Validate new Node . 27 3.5 Install Rudder Relay (optional) . 27 3.5.1 On the relay . 28 3.5.2 On the root server . 28 3.5.3 Validation . 28 3.5.4 Adding nodes to a relay server . 29 Rudder 4.1 - User Manual vi 4 Upgrade 30 4.1 Upgrade notes . 30 4.1.1 Upgrade from Rudder 3.0 or older . 30 4.1.2 Upgrade from Rudder 3.1, 3.2 or 4.0 . 30 4.1.3 Compatibility between Rudder agent 4.1 and older server versions . 31 4.1.3.1 4.0.x servers . 31 4.1.3.2 3.1.x and 3.2.x servers . 31 4.1.4 Compatibility between Rudder server 4.1 and older agent versions . 31 4.1.4.1 4.0.x agents . 31 4.1.4.2 3.1.x and 3.2.x agents . 31 4.1.4.3 3.0.x or older . 31 4.1.5 Protocol for reporting . 31 4.1.6 Upgrade manually installed relays (installed before 3.0) . 32 4.1.7 Known issues . 32 4.2 On Debian or Ubuntu . 32 4.3 On RHEL or CentOS . ..