debian/NEWS.Debian

   1 collectd (5.1.0-1) unstable; urgency=low
   2
   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   <https://collectd.org/wiki/index.php/V4_to_v5_migration_guide>.
   6
   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.
  11
  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.
  19
  20   Thus, the migration can be done like this (you might want to backup your
  21   data before):
  22
  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
  27
  28   Also, the syntax of some plugin configuration blocks has changed. See the
  29   wiki for details and instructions how to update your configuration.
  30
  31  -- Sebastian Harl <tokkee@debian.org>  Sat, 19 May 2012 15:13:21 +0200
  32
  33 collectd (4.2.0-1) experimental; urgency=low
  34
  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.
  40
  41  -- Sebastian Harl <sh@tokkee.org>  Sun, 28 Oct 2007 13:38:21 +0100
  42
  43 collectd (4.0.2-1) experimental; urgency=low
  44
  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.
  54
  55   Thus, the migration can be done like this (you might want to backup your
  56   data before):
  57
  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
  62
  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.
  69
  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.
  74
  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.
  78
  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.
  83
  84   See also: https://collectd.org/migrate-v3-v4.shtml
  85
  86  -- Sebastian Harl <sh@tokkee.org>  Thu,  7 Jun 2007 17:36:58 +0200
  87