diff options
author | Thiago Rodrigues <thiagothogs@gmail.com> | 2020-06-22 15:27:12 -0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-06-22 14:27:12 -0400 |
commit | 3e4d81145fb1c1701ad1896b1643a7eccedaa976 (patch) | |
tree | ebd6b56ab7d4d29b51661e5238f9e32d14604a99 /packaging | |
parent | bedb2eea3ee19142f62818fdcca71cba04e2adc5 (diff) |
Update freebsd.md (#9116)
* Update freebsd.md
Update freebsd.md installation guide
* Update freebsd.md documentation
* Update Install from ports/packages in freebsd.md
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* Update freebsd.md documentation
* logo teste
* Update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* Update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md documentation
* update freebsd.md
* Update freebsd.md
* update freebsd.md
* add netdata-claim.sh to /usr/sbin in installation
* update freebsd.md
* update freebsd.md
* Update freebsd.md
* Update freebsd.md
* Update freebsd.md
* Update freebsd.md
* Update freebsd.md
Diffstat (limited to 'packaging')
-rw-r--r-- | packaging/installer/methods/freebsd.md | 87 |
1 files changed, 73 insertions, 14 deletions
diff --git a/packaging/installer/methods/freebsd.md b/packaging/installer/methods/freebsd.md index decec89af9..f40a108810 100644 --- a/packaging/installer/methods/freebsd.md +++ b/packaging/installer/methods/freebsd.md @@ -7,27 +7,86 @@ custom_edit_url: https://github.com/netdata/netdata/edit/master/packaging/instal # Install Netdata on FreeBSD -## Install from ports/packages -You can install Netdata from either the `ports` or `packages` collections. To install from packages: +## Install latest version +This is how to install the latest Netdata version on FreeBSD: + +Install required packages (**need root permission**): + ```sh -# pkg install netdata +pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof Judy liblz4 libuv json-c cmake ``` -You also need to enable the netdata service in `/etc/rc.conf` (add `netdata_enable="YES"`) and start the service: + +Download Netdata: + ```sh -# service netdata start +fetch https://github.com/netdata/netdata/releases/download/v1.22.1/netdata-v1.22.1.tar.gz ``` -## Install latest version -This is how to install the latest Netdata version from source on FreeBSD: +Unzip the downloaded file: ```sh -# install required packages -pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof Judy liblz4 libuv json-c cmake +gunzip netdata*.tar.gz && tar xf netdata*.tar && rm -rf netdata*.tar +``` -# download Netdata -git clone https://github.com/netdata/netdata.git --depth=100 +Install Netdata in `/opt/netdata`. If you want to enable automatic updates, add `--auto-update` or `-u` to install `netdata-updater` in `cron` (**need root permission**): -# install Netdata in /opt/netdata -cd netdata -./netdata-installer.sh --install /opt +```sh +cd netdata-v* && ./netdata-installer.sh --install /opt && cp /opt/netdata/usr/sbin/netdata-claim.sh /usr/sbin/ ``` + +You also need to enable the `netdata` service in `/etc/rc.conf`: + +```sh +sysrc netdata_enable="YES" +``` + +Finally, and very importantly, update Netdata using the script provided by the Netdata team (**need root permission**): + +```sh +cd /opt/netdata/usr/libexec/netdata/ && ./netdata-updater.sh +``` + +You can now access the Netdata dashboard by navigating to `http://NODE:19999`, replacing `NODE` with the IP address or hostname of your system. + +![image](https://user-images.githubusercontent.com/2662304/48304090-fd384080-e51b-11e8-80ae-eecb03118dda.png) + +From Netdata v1.12 and above, anonymous usage information is collected by default and sent to Google Analytics. To read +more about the information collected and how to opt-out, check the [anonymous statistics +page](/docs/anonymous-statistics.md). + +## Updating the Agent on FreeBSD +If you have not passed the `--auto-update` or `-u` parameter for the installer to enable automatic updating, repeat the last step to update Netdata whenever a new version becomes available. +The `netdata-updater.sh` script will update your Agent. + +## Optional parameters to alter your installation +| parameters | Description | +|:-----:|-----------| +|`--install <path>`| Install netdata in `<path>.` Ex: `--install /opt` will put netdata in `/opt/netdata`| +| `--dont-start-it` | Do not (re)start netdata after installation| +| `--dont-wait` | Run installation in non-interactive mode| +| `--auto-update` or `-u` | Install netdata-updater in cron to update netdata automatically once per day| +| `--stable-channel` | Use packages from GitHub release pages instead of GCS (nightly updates). This results in less frequent updates| +| `--nightly-channel` | Use most recent nightly udpates instead of GitHub releases. This results in more frequent updates| +| `--disable-go` | Disable installation of go.d.plugin| +| `--disable-ebpf` | Disable eBPF Kernel plugin (Default: enabled)| +| `--disable-cloud` | Disable all Netdata Cloud functionality| +| `--require-cloud` | Fail the install if it can't build Netdata Cloud support| +| `--enable-plugin-freeipmi` | Enable the FreeIPMI plugin. Default: enable it when libipmimonitoring is available| +| `--disable-plugin-freeipmi` | Enable the FreeIPMI plugin| +| `--disable-https` | Explicitly disable TLS support| +| `--disable-dbengine` | Explicitly disable DB engine support| +| `--enable-plugin-nfacct` | Enable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available| +| `--disable-plugin-nfacct` | Disable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available| +| `--enable-plugin-xenstat` | Enable the xenstat plugin. Default: enable it when libxenstat and libyajl are available| +| `--disable-plugin-xenstat` | Disable the xenstat plugin| +| `--enable-backend-kinesis` | Enable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)| +| `--disable-backend-kinesis` | Disable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)| +| `--enable-backend-prometheus-remote-write` | Enable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available| +| `--disable-backend-prometheus-remote-write` | Disable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available| +| `--enable-backend-mongodb` | Enable MongoDB backend. Default: enable it when libmongoc is available| +| `--disable-backend-mongodb` | Disable MongoDB backend| +| `--enable-lto` | Enable Link-Time-Optimization. Default: enabled| +| `--disable-lto` | Disable Link-Time-Optimization. Default: enabled| +| `--disable-x86-sse` | Disable SSE instructions. By default SSE optimizations are enabled| +| `--zlib-is-really-here` or `--libs-are-really-here` | If you get errors about missing zlib or libuuid but you know it is available, you might have a broken pkg-config. Use this option to proceed without checking pkg-config| +|`--disable-telemetry` | Use this flag to opt-out from our anonymous telemetry progam. (DO_NOT_TRACK=1)| |