Revision ce2b073c
Added by Alexis Mousset over 6 years ago
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
Fixes #11198: Update doc for 4.2