MacOS

This page assumes that you have decided to install UnPoller on to an existing macOS 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

1. Install Homebrew
   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2. Install Poller
   brew install golift/mugs/unpoller
3. Edit the config file after installing the brew.

   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.

   See Application Configuration for more information
   nano /usr/local/etc/unpoller/up.conf

   # or

   vi /usr/local/etc/unpoller/up.conf
4. Start the service:
   # do not use sudo

   brew services start unpoller
   • The log file should show up at /usr/local/var/log/unpoller.log
   • If it does not show up, make sure your user has permissions to create the file.
5. To restart ( required after upgrade)
   brew services restart unpoller

Maintenance

All maintenance is done with homebrew. Example commands:

# list all services brew controls.

brew services list

# restart poller.

brew services restart unpoller

# running stop will make it not run on boot.

brew services stop unpoller

# start makes it start now and on boot.

brew services start unpoller

# run starts it but will not re-start on boot.

brew services run unpoller

Next Steps

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