From 30b94862648cdbf4f537337d2e2f01c369a9dee9 Mon Sep 17 00:00:00 2001 From: Lennart Weller Date: Thu, 21 Apr 2016 14:27:29 +0200 Subject: Imported Upstream version 1.1.0 --- contrib/README.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 contrib/README.md (limited to 'contrib/README.md') diff --git a/contrib/README.md b/contrib/README.md new file mode 100644 index 000000000..4578989a4 --- /dev/null +++ b/contrib/README.md @@ -0,0 +1,49 @@ +# netdata contrib + +## Building .deb packages + +The `contrib/debian/` directory contains basic rules to build a +Debian package. It has been tested on Debian Jessie and Wheezy, +but should work, possibly with minor changes, if you have other +dpkg-based systems such as Ubuntu or Mint. + +To build netdata for a Debian Jessie system, the debian directory +has to be available in the root of the netdata source. The easiest +way to do this is with a symlink: + + ~/netdata$ ln -s contrib/debian + +Then build the debian package: + + ~/netdata$ dpkg-buildpackage -us -uc -rfakeroot + +This should give a package that can be installed in the parent +directory, which you can install manually with dpkg. + + ~/netdata$ ls ../*.deb + ../netdata_1.0.0_amd64.deb + ~/netdata$ sudo dpkg -i ../netdata_1.0.0_amd64.deb + + +### Building for a Debian system without systemd + +The included packaging is designed for modern Debian systems that +are based on systemd. To build non-systemd packages (for example, +for Debian wheezy), you will need to make a couple of minor +updates first. + +* edit `contrib/debian/rules` and adjust the `dh` rule near the + top to remove systemd (see comments in that file). + +* edit `contrib/debian/control`: remove `dh-systemd` from the + Build-Depends list, and add `pkg-config` to it. + +Then proceed as the main instructions above. + +### Reinstalling netdata + +The recommended way to upgrade netdata packages built from this +source is to remove the current package from your system, then +install the new package. Upgrading on wheezy is known to not +work cleanly; Jessie may behave as expected. + -- cgit v1.2.3