Installation - diggybell/piaware-tools GitHub Wiki

Table of Contents

Installing PiAware Tools

Download PiAware Tools

The PiAware Tools are available from GitHub. Change to the directory where you want to install the source code. The following command will retrieve the source code.

git clone https://github.com/diggybell/piaware-tools.git
This will create a source directory called piaware-tools. You will need to know this directory in later steps.

Set Up Your System

PiAware Tools were designed to require a basic set of packages on your system prior to installation. Most Linux systems will already have most of the requirements installed.

System Requirements

PiAware Tools requires that you have PHP installed on your system. This can be done using the package manager on your Linux distribution if it is not already installed.

For Rasbian (or other Debian) installation, use the following command.

sudo apt install php
For RedHat compatible installation, use the following command.
sudo def install php

Configuring PHP

PHP utilizes a configuration file in /etc/php.ini to set system-specific settings for PHP. There is one entry in this file called include_path that needs to be modified. Locate that line and add the the path to a directory under your PiAware Tools installation.

include_path=".:<path to PiAware Tools>/DigTech/lib"

Configuring Your System

Creating Databases

The PiAware Tools will update a MySQL/MariaDB database to store long term tracking information on aircraft and flights. These databases must be created as part of the installation.

FAA Registration Database

The required tables will be created by the [FAAImport|FAA] utility but the database must be created first. This can be down with the following commands.

$ mysql
mysql> CREATE DATABASE faa;
mysql> exit
After you have created this database you should populate the database with the FAA data set. This is done using the FAA Import utility. The instructions on the linked page will walk you through that process.
  • Note: You must populate the FAA database before creating the PiAware database.

PiAware Tools History Database

One of the key features of PiAware Tools is the ability to extract information from the PiAware data for analysis. This is done using a MySQL/MariaDB database. Initial setup of PiAware Tools requires the creation of this database. The following commands will create and configure the database.

cd <path to piaware-tools>/sql
mysql piaware < schema.sql
mysql piaware < triggers.sql
mysql piaware < functions.sql
mysql faa < views.sql
mysql faa < faa-classification-data.sql
mysql faa < faa-adsb-quality-data.sql

Web Server

PiAware Tools should be able to utilize Apache, NGINX, or LightHTTPD installations.

Simple Method

If you have a web server in /var/www/html, you can easily connect PiAware Tools by creating a symbolic link.

sudo ln -s <path to PiAware Tools>/piaware-tools piaware-tools
You should be able to access PiAware Tools using a URL similar to this.
http://<your host name or IP address>/piaware-tools

or

https://<your host name or IP address>/piaware-tools

Apache Web Server

TBD

Setting Up CRON Tasks

Some of the PiAware Tools components can be executed using CRON. The instructions for each of the components is contained in the detailed instructions for the component.

ADSB Import

ADSB Update

Flight Builder

FAA Import

Configuring DigTech Tools

Full instructions for setting up the DigTech tools is available at this link.

DigTech Installation

⚠️ **GitHub.com Fallback** ⚠️