FreeBSD

This page assumes that you have decided to install UnPoller on to an existing FreeBSD operating system.

First#

Make sure you have set up a user on your controller for UnPoller to poll. You must have a working (and supported) version of Grafana and at least one of InfluxDB or Prometheus. If you don't have them, follow these instructions for installing InfluxDB and Grafana.


Installation#

Install compiled binary from ports run:

pkg install net/unpoller

Compile#

To build and install from ports run:

cd /usr/ports/net-mgmt/unpoller
make install clean

Maintenance#

See Application Configuration and the example config file for additional post-install configuration information.

important

When configuring make sure that you do not include :8443 on the url of the controller if you are using unifios. Those are: UDM Pro, UDM, UXG, or CkoudKey with recent firmware.

Use these commands to maintain the service:

# View manual.
man unpoller
# Edit config file.
# A defualt configuration file is placed in /usr/local/etc/unpoller/up.conf which is not overwritten on upgrades
# A sample configuration is placed in /usr/local/etc/unpoller/up.conf.sample
vi /usr/local/etc/unpoller/up.conf
# enable the service. Or edit /etc/rc.conf
sysrc unifi_poller_enable="YES"
# Start, Restart, Stop service.
service unpoller start
service unpoller restart
service unpoller stop
# Check service status, useful for scripts.
service unpoller status
# Logs should wind up in this file, but your syslog may differ.
grep unpoller /var/log/messages

Next Steps#

  1. Don't forget the Grafana Plugins.
  2. Finish Setting-up Grafana.