<<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>
* * * Release notes for Xymon 4.3.22 * * *
<<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>
This documents the important changes between Xymon releases, i.e.
changes you should be aware of when upgrading.
For a full list of changes and enhancements, please see the
Changes file.
Changes for 4.3.22
==================
The default rules for HTTP response codes have been simplified and made more
generic:
1xx = Warning (when the final code received)
2xx = OK
3xx = Warning (except 302/303/307 = OK)
4xx = Critical
5xx = Critical
The specific changes from previous versions are:
- 401 and 403 response codes are now considered Critical (were OK)
- 301 Permanent Redirect response code is now considered a Warning (was OK)
- "Extended" or new HTTP status codes in the 4xx and 5xx range
are now considered Critical (unknown codes were previously a Warning)
In the case of 301, 401, and 403 HTTP codes, if you're expecting to receive
this HTTP status from a URL query, you should add the code explicitly to
the check by using the "httpstatus" syntax (see hosts.cfg(5)).
Basic HTTP Authentication is supported for testing logins to a site.
*** Special note: Many vendor-supplied default "Welcome" pages on unconfigured
apache servers are actually generated by a 403 error handler. Generically
testing for these pages will now show a red status instead of a green one. To
fix, simply place an index.html page at the root of the site so that 403's are
not generated.
The 'sslcert' test will now indicate the signature algorithm and cipher
that was actually used in the connection, instead of a list of all ciphers.
Use --showallciphers to restore the previous behavior.
On new installs, the default apache configuration no longer requires a trailing
slash when accessing the xymon pages. http://www.example.com/xymon will work.
NTPDATEOPTS, FPINGOPTS, and TRACEROUTEOPTS variables are now present in
xymonserver.cfg and will override the default options for the associated
xymonnet calls.
Note: The suggested options to 'traceroute' were never actually used as
the default on a standard installation. In a future release,
'-n -q 2 -w 2 -m 15' may be used unless overridden or otherwise specified.
Darwin clients (Mac OS X) now exclude AFS and read-only volumes (which are
usually just mounted disk images) from processing, properly handle volumes with
spaces in their names, and correctly process inode details.
A chpasswd.sh file is now provided which allows a logged-in user to
change their own .htpasswd password (after verification). Because it
verifies their existing password first, it requires the '-v' option to
htpasswd, which is only available in Apache 2.4.5 or higher.
By default, it is installed in the /xymon-seccgi/ directory, but can be
moved to the /xymon-cgi/ directory to allow all users to change their
password. Basic input validation is provided, but this CGI should be
used with caution and only with relatively-trusted user bases.
xymongen used to skip over host groups on pages when it calcuated that
there were no test results to be displayed in that table. These groups are
now displayed, but you can restore the previous behavior by passing it
the --no-showemptygroups option.
Changes for 4.3.21
==================
RSS feeds should now display the short description of the event again.
Changes for 4.3.20
==================
Remote summaries display had been broken for a while but should now be working
again. Summaries are now also displayed on the nongreen.html page
The "Actual Used" memory figure on recent Linux kernels is now taken from
the "Available" memory reported back from free (or /proc/meminfo), which should
give a more accurate response. Physical Memory Used is still reported as the
combination of Kernel Physical Use + buffers/cache, however this may change in
a future release.
Documentation for various directives in hosts.cfg(5) has been added
pulldata=IP:PORT directives are honored, if the defaults for the host are
incorrect
cgiwrap is now installed via hardlinking (or as packaged); FollowSymLinks
is no longer needed for the xymon cgi-bin directories and can be removed.
Planned downtime settings are now applied to 'purple' statuses as well
http checks can now be performed using a HEAD request if desired.
Which RRD graphs are displayed on a status page can now be customized on
a per-test basis through the use of environment variables. For example,
GRAPHS_cpu="la,vmstat1" will cause an additional graph to be shown on
cpu tests. (Submitted by Werner Maier)
A new column will be displayed on all xymon pages allowing direct access
to a server's raw clientlog (similar to the special info and trends columns).
This can be disabled with a "noclient" tag in hosts.cfg
Additional sample protocols.cfg services are present, for svn, amqp(s) and
ircd. (Note that different ircd servers respond differently and the included
protocol conversation may require modification to work on your server.)
Changes for 4.3.19
==================
This is mostly a bugfix release (see the Changes file for a full list),
but there are some enhancements:
Apache 2.4 syntax is now supported by the sample xymon.conf file.
EXTIME= syntax in analysis.cfg and alerts.cfg files is now supported.
Note that this exclusion is applied *after* any normal TIME=
specifiers. (If a TIME= modifier is present, then times outside of
that range are already excluded.)
An Acknowledgements report CGI is now available, similar to
the Notifications report. (Thanks, Andy Smith)
Client logs with multiple trigger lines found are guaranteed to have all
the sections returned, even if this exceeds the "maxbytes" specified (up to
the compiled-in limit). Additionally, the "current" location of new log
data written since the last time xymonclient was run is now marked for
reference. (Thanks, Franco Gasperino)
A new "deltacount" option is available in client-local.cfg. It functions
similarly to "linecount" for a given log: entry, but only counts matching
lines written in the log file since the last run.
Additional filtration options are available for the xymondboard command,
including the full body of the message, and acknoweldgement and disable
comments. Also, inequalities can be used to filter an epoch timestamp
against any of: lastchange, logtime, validtime, acktime, or disabletime.
See the xymon(1) man page for details.
The process list visible in the 'procs' test of Linux and FreeBSD clients
is now generated in ASCII "forest" mode for increased legibility.
