GettingStarted

Getting Started

Welcome to the DFA Quickstart Guide. This guide provides you with the bare minimum steps required to get up and running.

Prerequisites

Python 3.6 or newer

$ python3 --version
Python 3.6.9

Extended XML KSDR Software

Chances are, if you're using this software, you'll using it with a Kerberos SDR. If that's the case you'll need a modified version of the software which produces a complete XML output which provides all the data DFA requires. Go to the link below and follow the installation instructions.

https://github.com/ckoval7/kerberossdr

If you're using DFA with simulated data, you will not need the Kerberos SDR software.

Download

git clone https://github.com/ckoval7/df-aggregator.git

Install

cd df-aggregator
pip3 install -r requirements.txt

Starting the Application

1. ./df-aggregator.py -d newdatabasename.db
2. Open a browser and connect to http://127.0.0.1:8080

Add receivers through the WebUI

1. Open the hamburger menu in the upper right of the map.
   • 
2. Under 'Receivers', click the plus '+'
   • 
3. Enter the URL for the XML data of your receiver.
   • For example, http://192.168.1.4:8081/DOA_value.html
   • 
4. Click the save icon.
   • 

Optional Items

Receivers List

There are times where you may have a large number of receivers to work with. The first time you run DFA, it would be easier to create a text file with a list of URLs rather than entering them one at a time in the WebUI.

Simply enter each URL on a new line, give the file a useful name, and use the -r switch when starting DFA.

http://192.168.1.4:8081/DOA_value.html
http://192.168.2.4:8081/DOA_value.html
http://192.168.3.4:8081/DOA_value.html

./df-aggregator.py -d newdatabasename.db -r myreceivers.txt

Connecting from other hosts

By default, DFA is only accessible on the same computer it's running on. Making it accessible to other hosts can be accomplished by using the --ip= switch at program start. You can either give it the IP address of a specific interface, or use 0.0.0.0 to make it available on all interfaces.

./df-aggregator.py -d newdatabasename.db --ip=0.0.0.0

If you are still unable to reach DFA from other computers, you may need to update your firewall rules. Please use the commands appropriate for your firewall software.

Changing the port number

There are many situations where the default port number, 8080, might not work for you. For example, you might want to run the KerberosSDR software and DFA on the same computer. Use the --port= switch. Choose any ports greater than 1024, ports below 1024 require root privileges.

./df-aggregator.py -d newdatabasename.db --port=9001