Help Document for KootNet Sensor Units

KootNet Sensors requires a Raspberry Pi to utilize Sensors but can be installed on Ubuntu or Debian in
order to use the “Sensor Control” web interface for managing up to 20 other remote Kootnet Sensors.

To make your own sensor, find the instructions on the Programs Website.
** Note: Additional hardware sensors for the Raspberry Pi are optional **

Managing the sensor locally from Raspbian

Terminal
The installer creates a shortcut “Kootnet Sensors – Configuration & Test” for adjusting configurations and testing the sensors.
The following configurations are edited through the ‘Configuration & Test’ shortcut.
It can also be access directly by running the following command in a terminal.

sudo bash /opt/kootnet-sensors/scripts/edit_sensor_config.sh

• Login used to access restricted pages in the Web Portal

• Sensors General Configuration

• Installed Sensors
  
  

At the end of the reconfiguration it restarts the service and displays the new configuration and current sensor readings in the terminal.
** Note: It is recommended to use the Web Portal for configuring the sensor, due to its ease of use **

HTTPS Web Portal
The sensor’s web portal allows you to interact with the local sensor, manage up to 20 remote sensors and configure it’s settings (Minus the Web Portal’s login credentials). You can access the portal from any web browser (Chrome recommended) by going to https://IP-Address:10065 on the local network. Replace “IP-Address” with the sensor’s actual IP. If you are accessing the web portal from the sensor itself, there is a shortcut in the accessories menu or you can go to https://localhost:10065 in the local web browser.

Program Auto Start
Kootnet Sensors automatically starts and restarts as a systemd service.

Run the following command in a terminal to disable and stop Kootnet Sensors.
sudo systemctl disable KootnetSensors && sudo systemctl stop KootnetSensors

To re-enable and start the service, run the following command.
sudo systemctl enable KootnetSensors && sudo systemctl start KootnetSensors

Locations
KootNet sensor program – /opt/kootnet-sensors/
SQLite3 Database (Holds all recorded data) - /home/kootnet_data/SensorRecordingDatabase.sqlite
Configuration Files - /etc/kootnet/

• installed_sensors.conf – Supported & enabled sensors

• main_config.conf – General configuration

• trigger_variances.conf – Trigger Variance configuration

SSL Files for HTTPS - /opt/kootnet-sensors/http_server/ssl_files/

• kootnet_default.key – Private Key

• kootnet_default.csr – Certificate Signing Request

• kootnet_default.crt – Certificate

Log Files - /home/kootnet_data/logs/

• Primary_log.txt – Program logs

• Network_log.txt – Network related logs

• Sensors_log.txt – Sensor hardware logs

Clean Upgrade Service Scripts

These 2x Upgrade scripts uninstall the systemd service, deletes Kootnet Sensors program & shortcuts then finally re-installs the program by the chosen method. The configuration and data files remain untouched. ** Note: If the script is unable to access the location it is installing from, Re-installation will fail and the sensor will not start until you re-run the regular installer **

HTTPS Clean Upgrade

sudo bash /home/kootnet_data/scripts/clean_upgrade_http.sh

SMB (Windows Share) Clean Upgrade
** DO NOT USE UNTIL YOU SETUP THE SMB LOCATION IN THE SCRIPT ITSELF **

sudo bash /home/kootnet_data/scripts/clean_upgrade_smb.sh

Uninstall Sensor Software
Sensor data & logs are left on the system.

sudo apt-get remove kootnet-sensors