Merge pull request #36 from unpoller/dn2_influxdb

update influx directions

Author: davidnewhall

documentation/docs/dependencies/influxdb.md

@@ -19,18 +19,20 @@ There are no pre-built graphs to display the data it collects.
 ### Windows
 
 Using Power Shell (Run as Administrator)
+
 ```shell
 wget https://dl.influxdata.com/influxdb/releases/influxdb-1.8.10_windows_amd64.zip -UseBasicParsing -OutFile influxdb-1.8.10_windows_amd64.zip
 Expand-Archive .\influxdb-1.8.10_windows_amd64.zip -DestinationPath 'C:\Program Files\InfluxData\influxdb\'
 ```
+
 Windows InfluxDB 1.x directions came [from here](https://portal.influxdata.com/downloads/)
 
 **Start & configure:**
+
 - Run `influxd.exe`
 - [Post setup](influxdb.md#post-setup) configuration
 
-*Default install path: 'C:\Program Files\InfluxData\influxdb\'*
-
+_Default install path: 'C:\Program Files\InfluxData\influxdb\'_
 
 ### CentOS 7
 
@@ -62,6 +64,7 @@ You need [Homebrew](https://brew.sh):
 ```shell
 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 ```
+
 ```shell
 brew install influxdb
 brew services restart influxdb
@@ -72,11 +75,10 @@ brew services restart influxdb
 Pull the container and run InfluxDB like this:
 
 ```shell
-docker pull influxdb:1
+docker pull influxdb:1.8
 docker run -p 8086:8086 \
--e INFLUXDB_DB=unifi \
--e INFLUXDB_ADMIN_USER=unifi \
--e INFLUXDB_ADMIN_PASSWORD=changeme \
+-e INFLUXDB_DB=unpoller \
+-e INFLUXDB_HTTP_AUTH_ENABLED=false \
 -v /YOURLOCALPATH/influxdb:/var/lib/influxdb \
 influxdb:1.8
 ```
@@ -94,17 +96,23 @@ Get shell access to wherever it is and run the command `influx`
 Create the database:
 
 ```none
-CREATE DATABASE unifi
-USE unifi
+CREATE DATABASE unpoller
+```
+
+We recommend running InfluxDB without authentication enabled,
+but if you wish to enable, add a user and give it access to the database.
+
+```none
+USE unpoller
 CREATE USER unifipoller WITH PASSWORD 'unifipoller' WITH ALL PRIVILEGES
-GRANT ALL ON unifi TO unifipoller
+GRANT ALL ON unpoller TO unifipoller
 ```
 
 Optionally - and this is a very sensible idea - set limits on how much data you wish to retain
 by implementing a retention policy. For example, to hold data for 32 days add the command:
 
 ```none
-CREATE RETENTION POLICY retention_policy ON unifi DURATION 32d REPLICATION 1
+CREATE RETENTION POLICY retention_policy ON unpoller DURATION 32d REPLICATION 1
 ```
 
 If you're using InfluxDB 2.x (not recommended at this time), you can set the retention policy by exec-ing into the container:

documentation/docs/help/common.md

@@ -16,16 +16,7 @@ It must be enabled in both the poller config and in your UniFi controller. Two s
 ### Check the port used to connect to the controller
 
 It should be `8443` if you are using a non-unifios interface (eg the original Cloudkey with
-  old firmware) and `443` (or just omitted) if you are using a unifios device (UDM-Pro, UDM, UXG, etc)
-
-### Run Updated Components
-
-Running out of date components may result in missing data, or errors from Grafana.
-
-Make sure you're running up-to-date software. InfluxDB must be at least 1.7.x.
-Version 1.7.9 is out and it works great. Grafana 6.5.2 also works great,
-and any version older than 6.4.x is going to give you problems.
-UniFi Poller should be at least version 1.6.3 if you are seeking help.
+old firmware) and `443` (or just omitted) if you are using a unifios device (UDM-Pro, UDM, UXG, etc)
 
 ### Check Log Files
 
@@ -43,13 +34,12 @@ If you are a Docker user then check out [Dozzle](https://dozzle.dev/)
 
 Many users make typos in their data source. Sometimes on the URLs, sometimes on the passwords.
 This will cause data to not show up and the dashboards may provide red error messages.
- Most data sources do not have paths; just `http://ip:port`.
+Most data sources do not have paths; just `http://ip:port`.
 
 ### Double-Check Passwords
 
-The default username used to be `influxdb`, but has been changed to `unifipoller`.
 Keep this in mind when setting things up. Can't tell you how many times someone had
-issues only to find a bad password. Check it, check it again; log in with it yourself.
+issues only to find a bad password. Check it, check it again; **log in with it yourself**.
 The poller log should give you clues if this is the problem.
 
 ### Dashboard Variables

documentation/docs/install/cloudkey.md

@@ -45,21 +45,21 @@ Add user to influx; [from here](https://v2.docs.influxdata.com/v2.0/users/create
 
 ```shell
 influx -host localhost -port 8086
-CREATE DATABASE unifi
-USE unifi
+CREATE DATABASE unpoller
+USE unpoller
 CREATE USER unifipoller WITH PASSWORD 'unifipoller' WITH ALL PRIVILEGES
-GRANT ALL ON unifi TO unifipoller
+GRANT ALL ON unpoller TO unifipoller
 ```
 
 :::note
-For InfluxDB on a CloudKey it is *highly* advisable to add a retention policy to
+For InfluxDB on a CloudKey it is _highly_ advisable to add a retention policy to
 prevent the database from growing in uncontrollably.
 :::
 
 #### Install Unpoller
 
 Linux repository hosting provided by
-[![packagecloud](https://docs.golift.io/integrations/packagecloud-full.png "PackageCloud.io")](http://packagecloud.io)
+[![packagecloud](https://docs.golift.io/integrations/packagecloud-full.png 'PackageCloud.io')](http://packagecloud.io)
 
 Install the Go Lift package repo and Unpoller with this command:
 
@@ -70,7 +70,7 @@ curl -s https://golift.io/repo.sh | sudo bash -s - unpoller
 ### Current Firmware: `unifios`
 
 There is an existing suite for installing `podman` containers to run on `unifios` -
-see [here](https://github.com/boostchicken/udm-utilities).  At the time of writing  we are not
+see [here](https://github.com/boostchicken/udm-utilities). At the time of writing we are not
 aware of any user implementing Unpoller using this method, but it should be straightforward.
 
 ## Configuration