summaryrefslogtreecommitdiffstats
path: root/contrib/README.md
blob: 2a5e640503f07dca517cb2e095cb9b22e36e7cb9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
<!--
title: "Netdata contrib"
custom_edit_url: https://github.com/netdata/netdata/edit/master/contrib/README.md
sidebar_label: "Netdata contrib"
learn_status: "Published"
learn_topic_type: "References"
learn_rel_path: "Developers"
-->

# 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:

```sh
ln -s contrib/debian
```

Edit the `debian/changelog` file to reflect the package version and
the build time:

```sh
netdata (1.21.0) unstable; urgency=medium

  * Initial Release

 -- Netdata Builder <bot@netdata.cloud>   Tue, 12 May 2020 10:36:52 +0200
```

Then build the debian package:

```sh
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.

```sh
ls -1 ../*.deb
../netdata_1.21.0_amd64.deb
../netdata-dbgsym_1.21.0_amd64.deb
../netdata-plugin-cups_1.21.0_amd64.deb
../netdata-plugin-cups-dbgsym_1.21.0_amd64.deb
../netdata-plugin-freeipmi_1.21.0_amd64.deb
../netdata-plugin-freeipmi-dbgsym_1.21.0_amd64.deb
sudo dpkg -i ../netdata_1.21.0_amd64.deb
```

### 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.