Project

General

Profile

« Previous | Next » 

Revision 862e3480

Added by Alexis Mousset about 6 years ago

Fixes #12049: Update doc for 4.3

View differences:

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