contrib/README.md

   1 # netdata contrib
   2
   3 ## Building .deb packages
   4
   5 The `contrib/debian/` directory contains basic rules to build a
   6 Debian package.  It has been tested on Debian Jessie and Wheezy,
   7 but should work, possibly with minor changes, if you have other
   8 dpkg-based systems such as Ubuntu or Mint.
   9
  10 To build netdata for a Debian Jessie system, the debian directory
  11 has to be available in the root of the netdata source. The easiest
  12 way to do this is with a symlink:
  13
  14     ~/netdata$ ln -s contrib/debian
  15
  16 Then build the debian package:
  17
  18     ~/netdata$ dpkg-buildpackage -us -uc -rfakeroot
  19
  20 This should give a package that can be installed in the parent
  21 directory, which you can install manually with dpkg.
  22
  23     ~/netdata$ ls ../*.deb
  24     ../netdata_1.0.0_amd64.deb
  25     ~/netdata$ sudo dpkg -i ../netdata_1.0.0_amd64.deb
  26
  27
  28 ### Building for a Debian system without systemd
  29
  30 The included packaging is designed for modern Debian systems that
  31 are based on systemd. To build non-systemd packages (for example,
  32 for Debian wheezy), you will need to make a couple of minor
  33 updates first.
  34
  35 * edit `contrib/debian/rules` and adjust the `dh` rule near the
  36   top to remove systemd (see comments in that file).
  37
  38 * rename `contrib/debian/control.wheezy` to `contrib/debian/control`.
  39
  40 * change `control.wheezy from contrib/Makefile* to control`.
  41
  42 * uncomment `EXTRA_OPTS="-P /var/run/netdata.pid"` in
  43  `contrib/debian/netdata.default`
  44
  45 * edit `contrib/debian/netdata.init` and change `PIDFILE` to
  46   `/var/run/netdata.pid`
  47
  48 * remove `dpkg-statoverride --update --add --force root netdata 0775 /var/lib/netdata/registry` from
  49   `contrib/debian/netdata.postinst.in`. If you are going to handle the unique id file differently.
  50
  51 Then proceed as the main instructions above.
  52
  53 ### Reinstalling netdata
  54
  55 The recommended way to upgrade netdata packages built from this
  56 source is to remove the current package from your system, then
  57 install the new package. Upgrading on wheezy is known to not
  58 work cleanly; Jessie may behave as expected.