ffho-respondd/README.md

respondd Status for Servers

A gluon compatible status script for respondd in python.

Dependencies

• lsb_release
• ethtool
• python3.3
• python3-netifaces
• batman-adv

Setup

config.json

Startparameter for ext-respondd. Copy config.json.example to config.json and change it to match your server configuration. (cp config.json.example config.json)

• batman (string) (Needed: typical bat0)
• bridge (string) (Needed: typical br-client)
• mesh-wlan (array of string) (Optional: Ad-Hoc batman-Mesh)
• mesh-vpn (array of string) (Optional: fastd, GRE, L2TP batman-Mesh)
• fastd_socket (string) (Optional: needed for uplink-flag)

alias.json

Aliases to overwrite the returned server data. Copy alias.json.example to alias.json and input e.g. owner information. (cp alias.json.example alias.json)

The JSON content matches one block of the nodes.json, which is outputted by e.g. the HopGlass-Server.

respondd.service

Register respondd as a systemd service

cp respondd.service.example /lib/systemd/system/respondd.service
# modify the path inside of the respondd.service if needed
systemctl daemon-reload
systemctl enable respondd
systemctl start respondd

Notes

Add this to your aliases.json in your HopGlass-Server if this a gateway.

  "gw2": {
    "nodeinfo": {
      "hostname": "Gateway 2",
      "node_id": "gw2"
    },
    "flags": {
      "gateway": true
    }
  }

Related projects

Collecting data from respondd:

• yanic from Freifunk Bremen written in Go
• HopGlass Server written in Node.js

Respondd for servers:

• ext-respondd from Freifunk Gera-Greiz
• ffnord-alfred-announce from FreiFunkNord
• py-respondd
• respondd from Freifunk Bremen (just a proof of concept)