1 collectd (5.1.0-1) unstable; urgency=low
3 Version 5 of collectd introduced a couple of backward-incompatible changes.
4 The full list of changes is documented in the collectd wiki found at
5 <http://collectd.org/wiki/index.php/V4_to_v5_migration_guide>.
7 In a client / server setups it's generally advised to upgrade the server
8 first. By using the v5_upgrade target plugin, the v5 server will be able to
9 receive and process data sent by v4 clients. This allows one to upgrade the
10 clients at an arbitrary later date. See the wiki for details.
12 The layout of various RRD files has changed. In order to keep your old data
13 you have to migrate it. This can be done by using /usr/lib/collectd/utils/
14 migrate-4-5.px. The script will output a series of shell commands that
15 should do all the work automatically. However, depending on your setup, a
16 couple of minor changes might be necessary to migrate all of your data. In
17 this case, please file a bug report so that the necessary changes can be
18 added to the script. The script will modify the RRD files in place.
20 Thus, the migration can be done like this (you might want to backup your
21 data before):
23 /usr/lib/collectd/utils/migrate-4-5.px -indir /var/lib/collectd/rrd/ \
24 > migrate-4-5.sh
25 vim migrate-4-5.sh # verify / adapt the script
26 bash migrate-4-5.sh
28 Also, the syntax of some plugin configuration blocks has changed. See the
29 wiki for details and instructions how to update your configuration.
31 -- Sebastian Harl <tokkee@debian.org> Sat, 19 May 2012 15:13:21 +0200
33 collectd (4.2.0-1) experimental; urgency=low
35 Prior to this version any plugin that has dependencies other than libc6 got
36 its own binary package. As the number of such packages was getting quite big
37 they have been merged into the "collectd" binary package and all plugin
38 dependencies were added as recommendations. See
39 /usr/share/doc/collectd-core/README.Debian.plugins for details.
41 -- Sebastian Harl <sh@tokkee.org> Sun, 28 Oct 2007 13:38:21 +0100
43 collectd (4.0.2-1) experimental; urgency=low
45 This version introduces significant changes to the layout of the RRD files
46 created by collectd. In order to keep your old data you have to migrate it.
47 This can be done by using /usr/lib/collectd/utils/migrate-3-4.px. This
48 script will output a series of shell commands that should do all the work
49 automatically. However, depending on your setup, a couple of minor changes
50 might be necessary to migrate all of your data. In this case, please file a
51 bug report so that the necessary changes can be added to the script. The
52 script creates the new RRD files in /tmp/collectd-4/ which can be moved to
53 /var/lib/collectd/rrd/ if everything went right.
55 Thus, the migration can be done like this (you might want to backup your
56 data before):
58 /usr/lib/collectd/utils/migrate-3-4.px | bash
59 rm -rf /var/lib/collectd
60 mkdir /var/lib/collectd
61 mv /tmp/collectd-4 /var/lib/collectd/rrd
63 Thanks to the new plugin infrastructure, the functionality to write RRD and
64 CSV files and the logging and networking facilities could be removed from
65 collectd's core and put into separate plugins, allowing more flexible
66 configurations. To get the behavior of collectd 3.x you have to enable the
67 "rrdtool" and "syslog" plugins (enabled by default) and enable and configure
68 the network plugin. See collectd.conf(5) for details.
70 This also means that a single configuration file is sufficient and there are
71 no longer any different modes that need to be configured. The init script
72 does no longer start one collectd process for each config file found in
73 /etc/collectd/ but only for collectd.conf.
75 Additionally, the syntax of the configuration file has changed slightly. All
76 strings need to be surrounded by double quotes. See collectd.conf(5) for
77 details.
79 Please note that there is no longer the need to load any plugins on the
80 server side just to be able to save values submitted by clients. All
81 required information are automatically loaded by collectd. You only need to
82 load plugins which are supposed to collect data locally.
84 See also: http://collectd.org/migrate-v3-v4.shtml
86 -- Sebastian Harl <sh@tokkee.org> Thu, 7 Jun 2007 17:36:58 +0200