Project

General

Profile

« Previous | Next » 

Revision ce2b073c

Added by Alexis Mousset over 6 years ago

Fixes #11198: Update doc for 4.2

View differences:

10_installation/10_install_server/11_install_root_server_debian.txt
===== Add the Rudder packages repository
Rudder 4.1 requires Java RE (version 8 at least) which is not packaged by default on Debian 7 nor Ubuntu 14.04.
Rudder 4.2 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.1/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
echo "deb http://www.rudder-project.org/apt-4.2/ $(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.1/SLES_11/ Rudder
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.2/SLES_11/ Rudder
zypper refresh
----
10_installation/10_install_server/13_install_root_server_centos_rhel.txt
----
echo '[Rudder_4.1]
name=Rudder 4.1 EL repository
baseurl=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/
echo '[Rudder_4.2]
name=Rudder 4.2 EL repository
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
gpgcheck=1
gpgkey=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
gpgkey=http://www.rudder-project.org/rpm-4.2/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.1/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
echo "deb http://www.rudder-project.org/apt-4.2/ $(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.1]
echo '[Rudder_4.2]
name=Rudder 4.1 EL repository
baseurl=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
gpgcheck=1
gpgkey=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
gpgkey=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
----
......
----
yum install rudder-agent-4.1.0-1.EL.7.x86_64.rpm
yum install rudder-agent-4.2.0-1.EL.7.x86_64.rpm
----
10_installation/11_install_agent/30_install_agent_suse.txt
----
zypper ar -n 'Rudder SLES 12 repository' http://www.rudder-project.org/rpm-4.1/SLES_12/ Rudder
zypper ar -n 'Rudder SLES 12 repository' http://www.rudder-project.org/rpm-4.2/SLES_12/ Rudder
----
......
----
zypper ar -n 'Rudder SLES repository' http://www.rudder-project.org/rpm-4.1/SLES_11_SP1/ Rudder
zypper ar -n 'Rudder SLES repository' http://www.rudder-project.org/rpm-4.2/SLES_11_SP1/ Rudder
----
......
----
zypper sa 'http://www.rudder-project.org/rpm-4.1/SLES_10_SP3/' Rudder
zypper sa 'http://www.rudder-project.org/rpm-4.2/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.1.
from older versions to the latest version, 4.2.
The upgrade is quite similar to the installation.
12_upgrade/05_caution.txt
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.
==== Upgrade from Rudder 3.1, 3.2 or 4.0
==== Upgrade from Rudder 3.1, 3.2 4.0 or 4.1
Migration from 3.1, 3.2 or 4.0 are supported, so you can upgrade directly to 4.1.
Migration from 3.1, 3.2, 4.0 or 4.1 are supported, so you can upgrade directly to 4.2.
[WARNING]
......
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 or 4.1 server.
pre-4.0 agents with a 4.0, 4.1 or 4.2 server.
However, some networking issues may appear when using 4.0 or 4.1 agents with older servers with the
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*).
......
====
==== Compatibility between Rudder agent 4.1 and older server versions
==== Compatibility between Rudder agent 4.2 and older server versions
===== 4.0.x servers
===== 4.0.x and 4.1.x servers
Rudder agents 4.1.x are compatible with 4.0 Rudder servers.
Rudder agents 4.2.x are compatible with 4.0 Rudder servers.
===== 3.1.x and 3.2.x servers
Rudder agents 4.1.x are not compatible with Rudder servers older than 4.0.0.
You need to upgrade your server to 4.1 before the agents.
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.1 and older agent versions
==== Compatibility between Rudder server 4.2 and older agent versions
===== 4.0.x agents
===== 4.0.x and 4.1.x agents
Rudder agent 4.0.x are fully compatible with Rudder server 4.1.x. It is
therefore not strictly necessary to update your agents to 4.1.x.
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.1.x, but they
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.0.x, unless you want to be able to use
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.1, and you have to upgrade them.
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>>.
==== Protocol for reporting
Rudder 3.1 uses syslog messages over UDP by default for reporting, but if you upgraded
Rudder uses syslog messages over UDP by default for reporting (since 3.1), but if you upgraded
your server from a previous version, you will keep the previous setting which uses
syslog messages over TCP.
12_upgrade/10_upgrade_debian.txt
----
echo "deb http://www.rudder-project.org/apt-4.1/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
echo "deb http://www.rudder-project.org/apt-4.2/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
----
12_upgrade/20_upgrade_rhel.txt
----
echo '[Rudder_4.1]
name=Rudder 4.1 Repository
baseurl=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/
echo '[Rudder_4.2]
name=Rudder 4.2 Repository
baseurl=http://www.rudder-project.org/rpm-4.2/RHEL_$releasever/
gpgcheck=1
gpgkey=http://www.rudder-project.org/rpm-4.1/RHEL_$releasever/repodata/repomd.xml.key' > /etc/yum.repos.d/rudder.repo
gpgkey=http://www.rudder-project.org/rpm-4.2/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.1/SLES_11_SP1/ Rudder
zypper ar -n "Rudder SLES repository" http://www.rudder-project.org/rpm-4.2/SLES_11_SP1/ Rudder
----
......
----
zypper sa "http://www.rudder-project.org/rpm-4.1/SLES_10_SP3/" Rudder
zypper sa "http://www.rudder-project.org/rpm-4.2/SLES_10_SP3/" Rudder
----
Makefile
DOCBOOK_DIST = xsl/xsl-ns-stylesheets
RUDDER_VERSION = 4.1
RUDDER_VERSION = 4.2
NCF_VERSION = $(shell curl -s "$(RELEASE_INFO)/rudder/versions/$(RUDDER_VERSION)/components/ncf")
ASCIIDOC = asciidoc
xsl/webhelp-common.xsl
inputSelector: '#searchfield',
algoliaOptions: {
'hitsPerPage': 5,
'facetFilters': '(tags:v4.1)'
'facetFilters': '(tags:v4.2)'
}
});
</script>

Also available in: Unified diff