ffmap-backend/README.md

73 lines
2.1 KiB
Markdown
Raw Normal View History

2014-06-21 20:18:41 +02:00
# Data for Freifunk Map, Graph and Node List
2014-06-21 20:04:14 +02:00
2015-03-24 18:06:54 +01:00
[![Build Status](https://travis-ci.org/ffnord/ffmap-backend.svg?branch=master)](https://travis-ci.org/ffnord/ffmap-backend)
2015-04-02 18:52:00 +02:00
ffmap-backend gathers information on the batman network by invoking :
2015-03-21 01:26:56 +01:00
2015-04-02 18:52:00 +02:00
* batctl (might require root),
2015-03-21 01:26:56 +01:00
* alfred-json and
* batadv-vis
2015-04-02 18:52:00 +02:00
In order to use alfred-json and batadv-vis make sure the user running this
backend is allowed to access alfred's socket.
2014-06-21 20:04:14 +02:00
2015-04-02 18:52:00 +02:00
The output will be written to a directory (`-d output`).
2014-06-21 20:04:14 +02:00
2015-04-02 18:52:00 +02:00
Run `backend.py --help` for a quick overview of all available options.
2014-06-21 20:04:14 +02:00
For the script's regular execution add the following to the crontab:
2015-04-02 18:52:00 +02:00
2014-06-21 20:18:41 +02:00
<pre>
2015-04-12 12:07:48 +02:00
* * * * * backend.py -d /path/to/output -a /path/to/aliases.json --vpn ae:7f:58:7d:6c:2a d2:d0:93:63:f7:da
2014-06-21 20:18:41 +02:00
</pre>
2015-03-21 01:26:56 +01:00
# Data format
## nodes.json
{ 'nodes': {
node_id: { 'flags': { flags },
'firstseen': isoformat,
'lastseen': isoformat,
'nodeinfo': {...}, # copied from alfred type 158
'statistics': {
'uptime': double, # seconds
'memory_usage': double, # 0..1
'clients': double,
'rootfs_usage': double, # 0..1
'loadavg': double,
'gateway': mac
}
},
...
}
'timestamp': isoformat
}
### flags (bool)
- online
- gateway
2015-04-01 23:31:34 +02:00
# Removing owner information
If you'd like to redact information about the node owner from `nodes.json`,
you may use a filter like [jq]. In this case, specify an output directory
different from your webserver directory, e.g.:
./backend.py -d /ffmap-data
Don't write to files generated in there. ffmap-backend uses them as its
database.
After running ffmap-backend, copy `graph.json` to your webserver. Then,
filter `nodes.json` using `jq` like this:
jq '.nodes = (.nodes | with_entries(del(.value.nodeinfo.owner)))' \
< /ffmap-data/nodes.json > /var/www/data/nodes.json
This will remove owner information from nodes.json before copying the data
to your webserver.
[jq]: https://stedolan.github.io/jq/