mirror of
https://github.com/rsyslog/rsyslog.git
synced 2025-12-22 01:20:42 +01:00
c72a43d280
This was former the case after 1,000 failures and could cause rsyslog to be spammed/ressou
61 lines
3.6 KiB
HTML
61 lines
3.6 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><title>Compatibility notes for rsyslog v7</title>
|
|
</head>
|
|
<body>
|
|
<h1>Compatibility Notes for rsyslog v7</h1>
|
|
This document describes things to keep in mind when moving from v6 to v7. It
|
|
does not list enhancements nor does it talk about compatibility concerns introduced
|
|
by earlier versions (for this, see their respective compatibility documents). Its focus
|
|
is primarily on what you need to know if you used v6 and want to use v7 without hassle.
|
|
<p>Version 7 builds on the new config language introduced in v6 and extends it.
|
|
Other than v6, it not just only extends the config language, but provides
|
|
considerable changes to core elements as well. The result is much more power and
|
|
ease of use as well (this time that is not contradictionary).
|
|
</p>
|
|
<h2>BSD-Style blocks</h2>
|
|
BSD style blocks are no longer supported (for good reason). See the
|
|
<a href="http://www.rsyslog.com/g/BSD">rsyslog BSD blocks info</a>
|
|
page for more information and how to upgrade your config.
|
|
<p>[<a href="manual.html">manual index</a>] [<a href="http://www.rsyslog.com/">rsyslog site</a>]</p>
|
|
|
|
<h2>CEE-Properties</h2>
|
|
In rsyslog v6, CEE properties could not be used across disk-based queues. If this was
|
|
done, there content was reset. This was a missing feature in v6. In v7, this feature
|
|
has been implemented. Consequently, situations where the previous behaviour were
|
|
desired need now to be solved differently. We do not think that this will cause any
|
|
problems to anyone, especially as in v6 this was announced as a missing feature.
|
|
|
|
<h2>omruleset and discard (~) action are deprecated</h2>
|
|
<p>Both continue to work, but have been replaced by better alternatives.
|
|
<p>The discard action (tilde character) has been replaced by the "stop"
|
|
RainerScript directive. It is considered more intuitive and offers slightly
|
|
better performance.
|
|
<p>The omruleset module has been replaced by the "call" RainerScript directive.
|
|
Call permits to execute a ruleset like a subroutine, and does so with much
|
|
higher performance than omruleset did. Note that omruleset could be run off
|
|
an async queue. This was more a side than a desired effect and is not supported
|
|
by the call statement. If that effect was needed, it can simply be simulated by
|
|
running the called rulesets actions asynchronously (what in any case is the right
|
|
way to handle this).
|
|
<p>Note that the deprecated modules emit warning messages when being used.
|
|
They tell that the construct is deprecated and which statement is to be used
|
|
as replacement. This does <b>not</b> affect operations: both modules are still
|
|
fully operational and will not be removed in the v7 timeframe.
|
|
|
|
<h2>Retries of output plugins that do not do proper replies</h2>
|
|
<p>Some output plugins may not be able to detect if their target is capable of
|
|
accepting data again after an error (technically, they always return OK when
|
|
TryResume is called). Previously, the rsyslog core engine suspended such an action
|
|
after 1000 succesive failures. This lead to potentially a large amount of
|
|
errors and error messages. Starting with 7.2.1, this has been reduced to 10
|
|
successive failures. This still gives the plugin a chance to recover. In extreme
|
|
cases, a plugin may now enter suspend mode where it previously did not do so.
|
|
In practice, we do NOT expect that.
|
|
|
|
<p><font size="2">This documentation is part of the
|
|
<a href="http://www.rsyslog.com/">rsyslog</a> project.<br>
|
|
Copyright © 2011-2012 by <a href="http://www.gerhards.net/rainer">Rainer Gerhards</a> and
|
|
<a href="http://www.adiscon.com/">Adiscon</a>. Released under the GNU GPL
|
|
version 2 or higher.</font></p>
|
|
</body></html>
|