Revision 862e3480
Added by Alexis Mousset about 6 years ago
10_installation/05_requirements/21_supported_architecture.txt | ||
---|---|---|
|
||
* RedHat Enterprise Linux (RHEL) / RHEL-like 3 and 5 to 7
|
||
|
||
* Fedora 18
|
||
|
||
* SuSE Linux Enterprise Server (SLES) 10 SP3, 11 SP1, 11 SP3, 11 SP4, 12, 12 SP1, 12 SP2
|
||
|
||
* Ubuntu 10.04 LTS (Lucid), 12.04 LTS (Precise), 12.10 (Quantal), 14.04 LTS (Trusty), 16.04 LTS (Xenial)
|
||
* Ubuntu 10.04 LTS (Lucid), 12.04 LTS (Precise), 14.04 LTS (Trusty), 16.04 LTS (Xenial)
|
||
|
||
Other Unix systems:
|
||
|
10_installation/10_install_server/11_install_root_server_debian.txt | ||
---|---|---|
|
||
===== Add the Rudder packages repository
|
||
|
||
Rudder 4.2 requires Java RE (version 8 at least) which is not packaged by default on Debian 7 nor Ubuntu 14.04.
|
||
Rudder requires Java RE (version 8 at least) which is not packaged by default on Debian 7 nor Ubuntu 14.04.
|
||
|
||
The Java RE 8 for Debian or Ubuntu can be found through Oracle's website: https://www.java.com
|
||
|
||
... | ... | |
|
||
----
|
||
|
||
echo "deb http://www.rudder-project.org/apt-4.2/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
echo "deb http://www.rudder-project.org/apt-4.3/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
apt-get update
|
||
|
||
----
|
10_installation/10_install_server/12_install_root_server_sles.txt | ||
---|---|---|
|
||
----
|
||
|
||
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.2/SLES_11/ Rudder
|
||
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.3/SLES_11/ Rudder
|
||
zypper refresh
|
||
|
||
----
|
10_installation/10_install_server/13_install_root_server_centos_rhel.txt | ||
---|---|---|
|
||
----
|
||
|
||
echo '[Rudder_4.2]
|
||
name=Rudder 4.2 EL repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
|
||
echo '[Rudder_4.3]
|
||
name=Rudder 4.3 EL repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/
|
||
gpgcheck=1
|
||
gpgkey=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
gpgkey=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
|
||
----
|
||
|
10_installation/11_install_agent/10_install_agent_debian.txt | ||
---|---|---|
|
||
----
|
||
|
||
echo "deb http://www.rudder-project.org/apt-4.2/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
echo "deb http://www.rudder-project.org/apt-4.3/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
|
||
----
|
||
|
10_installation/11_install_agent/20_install_agent_centos_rhel.txt | ||
---|---|---|
|
||
----
|
||
|
||
echo '[Rudder_4.2]
|
||
name=Rudder 4.1 EL repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
|
||
echo '[Rudder_4.3]
|
||
name=Rudder 4.3 EL repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/
|
||
gpgcheck=1
|
||
gpgkey=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
gpgkey=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
|
||
----
|
||
|
10_installation/11_install_agent/30_install_agent_suse.txt | ||
---|---|---|
|
||
----
|
||
|
||
zypper ar -n 'Rudder SLES 12 repository' http://www.rudder-project.org/rpm-4.2/SLES_12/ Rudder
|
||
zypper ar -n 'Rudder SLES 12 repository' http://www.rudder-project.org/rpm-4.3/SLES_12/ Rudder
|
||
|
||
----
|
||
|
||
... | ... | |
|
||
----
|
||
|
||
zypper ar -n 'Rudder SLES repository' http://www.rudder-project.org/rpm-4.2/SLES_11_SP1/ Rudder
|
||
zypper ar -n 'Rudder SLES repository' http://www.rudder-project.org/rpm-4.3/SLES_11_SP1/ Rudder
|
||
|
||
----
|
||
|
||
... | ... | |
|
||
----
|
||
|
||
zypper sa 'http://www.rudder-project.org/rpm-4.2/SLES_10_SP3/' Rudder
|
||
zypper sa 'http://www.rudder-project.org/rpm-4.3/SLES_10_SP3/' Rudder
|
||
|
||
----
|
||
|
12_upgrade/00_upgrade.txt | ||
---|---|---|
== Upgrade
|
||
|
||
This short chapter covers the upgrade of the Rudder Server Root and Rudder Agent
|
||
from older versions to the latest version, 4.2.
|
||
from older versions to the latest version.
|
||
|
||
The upgrade is quite similar to the installation.
|
||
|
12_upgrade/05_caution.txt | ||
---|---|---|
=== Upgrade notes
|
||
|
||
==== Upgrade from Rudder 3.0 or older
|
||
==== Upgrade from Rudder 4.0 or older
|
||
|
||
Direct upgrades from 3.0.x and older are no longer supported on 4.1.
|
||
Direct upgrades from 4.0.x and older are no longer supported on 4.3.
|
||
If you are still running one of those, either on servers or nodes,
|
||
please first upgrade to one of the supported versions above, and then upgrade to 4.1.
|
||
please first upgrade to one of the supported versions, and then upgrade to 4.3.
|
||
|
||
==== Upgrade from Rudder 3.1, 3.2 4.0 or 4.1
|
||
==== Upgrade from Rudder 4.1 or 4.2
|
||
|
||
Migration from 3.1, 3.2, 4.0 or 4.1 are supported, so you can upgrade directly to 4.2.
|
||
Migration from 4.1 or 4.2 are supported, so you can upgrade directly to 4.3.
|
||
|
||
[WARNING]
|
||
==== Compatibility between Rudder agent 4.3 and older server versions
|
||
|
||
====
|
||
===== 4.1.x and 4.2.x servers
|
||
|
||
In Rudder 4.0, we changed the default communication protocol between agent and server,
|
||
but still stay compatible with the old protocol. Hence, you can perfectly keep using
|
||
pre-4.0 agents with a 4.0, 4.1 or 4.2 server.
|
||
Rudder agents 4.3.x are compatible with 4.1 and 4.2 Rudder servers.
|
||
|
||
However, some networking issues may appear when using 4.0, 4.1 or 4.2 agents with older servers with the
|
||
reverse DNS lookup option disabled in the settings (*Security* ->
|
||
*Use reverse DNS lookups on nodes to reinforce authentication to policy server*).
|
||
===== Older servers
|
||
|
||
Therefore, you need to upgrade your server to 4.1 *before* upgrading the nodes so that the
|
||
configuration distributed to the nodes include the use of the new protocol.
|
||
Rudder agents 4.3.x are not compatible with Rudder servers older than 4.1.
|
||
You need to upgrade your server to a compatible version before the agents.
|
||
|
||
====
|
||
==== Compatibility between Rudder server 4.3 and older agent versions
|
||
|
||
[CAUTION]
|
||
===== 4.1.x and 4.2.x agents
|
||
|
||
====
|
||
Rudder agent 4.1.x and 4.2.x are fully compatible with Rudder server 4.3.x. It is
|
||
therefore not strictly necessary to update your agents to 4.3.x.
|
||
|
||
In Rudder 4.1, we changed the name of '/opt/rudder/etc/ssl/rudder-webapp.crt' to '/opt/rudder/etc/ssl/rudder.crt'
|
||
and the name of '/opt/rudder/etc/ssl/rudder-webapp.key' to '/opt/rudder/etc/ssl/rudder.key'.
|
||
===== Older agents
|
||
|
||
These certificates are used for Rudder internal implementation, but if you are using them for anything
|
||
else, please update the paths to the files.
|
||
|
||
For example, if you were using these certificates for configuring sasl in slapd with:
|
||
|
||
TLSCertificateFile /opt/rudder/etc/ssl/rudder-webapp.crt
|
||
TLSCertificateKeyFile /opt/rudder/etc/ssl/rudder-webapp.key
|
||
|
||
Then, you now need to use:
|
||
|
||
TLSCertificateFile /opt/rudder/etc/ssl/rudder.crt
|
||
TLSCertificateKeyFile /opt/rudder/etc/ssl/rudder.key
|
||
|
||
====
|
||
|
||
==== Compatibility between Rudder agent 4.2 and older server versions
|
||
|
||
===== 4.0.x and 4.1.x servers
|
||
|
||
Rudder agents 4.2.x are compatible with 4.0 Rudder servers.
|
||
|
||
|
||
===== 3.1.x and 3.2.x servers
|
||
|
||
Rudder agents 4.2.x are not compatible with Rudder servers older than 4.0.0.
|
||
You need to upgrade your server to 4.2 before the agents.
|
||
|
||
==== Compatibility between Rudder server 4.2 and older agent versions
|
||
|
||
===== 4.0.x and 4.1.x agents
|
||
|
||
Rudder agent 4.0.x and 4.1.x are fully compatible with Rudder server 4.2.x. It is
|
||
therefore not strictly necessary to update your agents to 4.2.x.
|
||
|
||
===== 3.1.x and 3.2.x agents
|
||
|
||
Rudder agent 3.1.x and 3.2.x are compatible with Rudder server 4.2.x, but they
|
||
do not support the new "Audit" policy mode. It is therefore not strictly
|
||
necessary to update your agents to 4.2.x, unless you want to be able to use
|
||
the "Audit" policy mode.
|
||
|
||
===== 3.0.x or older
|
||
|
||
These agents are not compatible with Rudder 4.2, and you have to upgrade them.
|
||
Be careful to follow the upgrade path explained <<_upgrade_from_rudder_3_0_or_older, above>>.
|
||
These agents are not compatible with Rudder 4.3, and you have to upgrade them.
|
||
Be careful to follow the upgrade path explained <<_upgrade_from_rudder_4_0_or_older, above>>.
|
||
|
||
==== Protocol for reporting
|
||
|
||
... | ... | |
reporting on the server.
|
||
Read <<_rsyslog, perfomance notes>> about rsyslog for detailed information.
|
||
|
||
==== Upgrade manually installed relays (installed before 3.0)
|
||
|
||
With Rudder 2.11, there were no relay package and the configuration had to be done by hand.
|
||
|
||
To migrate a manually installed relay to 3.1 using the package, run the following intructions:
|
||
|
||
* Delete the previous Apache configuration file:
|
||
|
||
** `/etc/httpd/conf.d/rudder-default.conf file` on RHEL-like
|
||
** `/etc/apache2/sites-enabled/rudder-default` file on Debian-like
|
||
** `/etc/apache2/vhosts.d/rudder-default.conf` file on SuSE
|
||
|
||
* Install the relay package named *rudder-server-relay*.
|
||
|
||
This is enough to replace the relay configuration, and no change is needed on the root server.
|
||
|
||
==== Known issues
|
||
|
||
* After upgrade, if the web interface has display problems, empty your navigator cache and/or logout/login.
|
||
|
12_upgrade/10_upgrade_debian.txt | ||
---|---|---|
|
||
----
|
||
|
||
echo "deb http://www.rudder-project.org/apt-4.2/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
echo "deb http://www.rudder-project.org/apt-4.3/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
|
||
|
||
----
|
||
|
12_upgrade/20_upgrade_rhel.txt | ||
---|---|---|
|
||
----
|
||
|
||
echo '[Rudder_4.2]
|
||
name=Rudder 4.2 Repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
|
||
echo '[Rudder_4.3]
|
||
name=Rudder 4.3 Repository
|
||
baseurl=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/
|
||
gpgcheck=1
|
||
gpgkey=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
gpgkey=http://www.rudder-project.org/rpm-4.3/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
|
||
|
||
----
|
||
|
12_upgrade/30_upgrade_suse.txt | ||
---|---|---|
|
||
----
|
||
|
||
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.2/SLES_11_SP1/ Rudder
|
||
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.3/SLES_11_SP1/ Rudder
|
||
|
||
----
|
||
|
||
... | ... | |
|
||
----
|
||
|
||
zypper sa "http://www.rudder-project.org/rpm-4.2/SLES_10_SP3/" Rudder
|
||
zypper sa "http://www.rudder-project.org/rpm-4.3/SLES_10_SP3/" Rudder
|
||
|
||
----
|
||
|
rudder-doc.txt | ||
---|---|---|
Rudder 4.2 - User Manual
|
||
Rudder 4.3 - User Manual
|
||
========================
|
||
Normation_SAS_and_Fabrice_Flore-Thebault <contact@normation.com>
|
||
:description: User Documentation for the Rudder Drift Assessment Software. +
|
||
... | ... | |
Configuration Management, FusionInventory, CFEngine Community, +
|
||
CFEngine Nova, CFEngine, Scala, Free Software, Open Source, GPL +
|
||
User documentation
|
||
:revdate: Sep 2016
|
||
:revision: 4.2
|
||
:revdate: Jan 2018
|
||
:revision: 4.3
|
||
|
||
// Generate the map of content from list of files and alphabetically ordered
|
||
// glossary
|
||
... | ... | |
[colophon]
|
||
== License
|
||
|
||
Copyright (C) 2011-2017 Normation SAS
|
||
Copyright (C) 2011-2018 Normation SAS
|
||
|
||
Rudder User Documentation by http://normation.com[Normation SAS] is licensed under
|
||
a http://creativecommons.org/licenses/by-sa/3.0/[Creative Commons
|
xsl/webhelp-common.xsl | ||
---|---|---|
inputSelector: '#searchfield',
|
||
algoliaOptions: {
|
||
'hitsPerPage': 5,
|
||
'facetFilters': '(tags:v4.2)'
|
||
'facetFilters': '(tags:v4.3)'
|
||
}
|
||
});
|
||
</script>
|
Also available in: Unified diff
Fixes #12049: Update doc for 4.3