From ee88b3ae0b1d91aab0a99d607d8de55ae2a45317 Mon Sep 17 00:00:00 2001 From: Sebastian Harl Date: Sat, 19 May 2012 17:37:11 +0200 Subject: [PATCH] NEWS.Debian: Documented the upgrade from version 4 to 5. --- debian/NEWS.Debian | 32 ++++++++++++++++++++++++++++++++ debian/changelog | 2 ++ 2 files changed, 34 insertions(+) diff --git a/debian/NEWS.Debian b/debian/NEWS.Debian index f0e20b4..7cc78aa 100644 --- a/debian/NEWS.Debian +++ b/debian/NEWS.Debian @@ -1,3 +1,35 @@ +collectd (5.1.0-1) unstable; urgency=low + + Version 5 of collectd introduced a couple of backward-incompatible changes. + The full list of changes is documented in the collectd wiki found at + . + + In a client / server setups it's generally advised to upgrade the server + first. By using the v5_upgrade target plugin, the v5 server will be able to + receive and process data sent by v4 clients. This allows to upgrade the + clients at an arbitrary later date. See the wiki for details. + + The layout of various RRD files has changed. In order to keep your old data + you have to migrate it. This can be done by using /usr/lib/collectd/utils/ + migrate-4-5.px. The script will output a series of shell commands that + should do all the work automatically. However, depending on your setup, a + couple of minor changes might be necessary to migrate all of your data. In + this case, please file a bug report so that the necessary changes can be + added to the script. The script will modify the RRD files in place. + + Thus, the migration can be done like this (you might want to backup your + data before): + + /usr/lib/collectd/utils/migrate-4-5.px -indir /var/lib/collectd/rrd/ \ + > migrate-4-5.sh + vim migrate-4-5.sh # verify / adapt the script + bash migrate-4-5.sh + + Also, the syntax of some plugin configuration blocks has changed. See the + wiki for details and instructions how to update your configuration. + + -- Sebastian Harl Sat, 19 May 2012 15:13:21 +0200 + collectd (4.2.0-1) experimental; urgency=low Prior to this version any plugin that has dependencies other than libc6 got diff --git a/debian/changelog b/debian/changelog index 5f63d28..9c4cd7b 100644 --- a/debian/changelog +++ b/debian/changelog @@ -31,6 +31,8 @@ collectd (5.1.0-1) unstable; urgency=low - Install collectdctl and collectdctl.1 to collectd-utils. * debian/libcollectdclient0.symbols: - Added lcc_sort_identifiers introduced in 5.1.0. + * debian/NEWS.Debian: + - Documented the upgrade from version 4 to 5. -- Sebastian Harl Sat, 19 May 2012 15:13:21 +0200 -- 2.30.2