Rudder 4.3 - User Manual i Rudder 4.3 - User Manual Rudder 4.3 - 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.3 - User Manual iii COLLABORATORS TITLE : Rudder 4.3 - User Manual ACTION NAME DATE SIGNATURE WRITTEN BY Jonathan Clarke, Jan 2018 Nicolas Charles, Fabrice Flore-Thebault, Matthieu Cerda, Nicolas Perron, Arthur Anglade, Vincent Membré, and François Armand REVISION HISTORY NUMBER DATE DESCRIPTION NAME 4.3 Jan 2018 N Rudder 4.3 - 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 DNS - Name resolution . 15 3.2.2 JVM Security Policy . 15 3.2.3 Fully supported Operating Systems . 15 3.2.3.1 For Rudder Nodes . 15 3.2.3.2 For Rudder Root Server . 16 3.2.4 Partially supported Operating Systems . 16 3.2.4.1 For Rudder Nodes . 17 Rudder 4.3 - User Manual v 3.2.4.2 For Rudder Root Server . 17 3.2.5 Cloud compatibility . 17 3.2.6 Hardware specifications for Rudder Agent . 17 3.2.7 Hardware specifications and sizing for Rudder Root Server . 17 3.2.7.1 Memory . 18 3.2.7.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 . 19 3.3.2 Initial configuration of your Rudder Root Server . 19 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 . 21 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 . 22 3.3.8 Initial configuration of your Rudder Root Server . 23 3.3.9 Validate the installation . 23 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.2.1 For RHEL/CentOS . 25 3.4.2.2 For Amazon Linux . 26 3.4.2.3 For Amazon Linux 2 . 26 3.4.3 Install Rudder Agent on SLES . 26 3.4.4 Configure and validate . 28 3.4.4.1 Configure Rudder Agent . 28 3.4.4.2 Validate new Node . 28 3.5 Install Rudder Relay (optional) . 28 3.5.1 On the relay . 29 3.5.2 On the root server . 29 3.5.3 Validation . 29 3.5.4 Adding nodes to a relay server . 30 Rudder 4.3 - User Manual vi 4 Upgrade 31 4.1 Upgrade notes . 31 4.1.1 Upgrade from Rudder 4.0 or older . 31 4.1.2 Upgrade from Rudder 4.1 or 4.2 . 31 4.1.3 Compatibility between Rudder agent 4.3 and older server versions . 31 4.1.3.1 4.1.x and 4.2.x servers . 31 4.1.3.2 Older servers . 31 4.1.4 Compatibility between Rudder server 4.3 and older agent versions . 31 4.1.4.1 4.1.x and 4.2.x agents . 31 4.1.4.2 Older agents . 32 4.1.5 Protocol for reporting . 32 4.2 On Debian or Ubuntu . 32 4.3 On RHEL or CentOS . ..