Hood-Verwaltung
Diese Seite befindet sich noch im Entwurfsstadium.
Hilf mit sie zu verbessern!
Neue Hood anlegen
Neue regionale Gruppe (Community) erstellen
Neue Hood mit Community absprechen
Wenn es eine neue Hood geben soll muss dies immer mit dem Kernteam von freifunk-Franken (franken-dev Liste) abgesprochen werden, da dies ohne Zusammenarbeit nicht möglich ist. Als allererstes sollte eine aber lokale "Community" existieren. Dies ist unabhängig von der technischen Hood und dient dazu eine regional eigenständige Gruppe zu definieren, die in Zukunft auch für Ihre Hood zuständig ist.
Wir haben uns selbst auferlegt, dass so eine Community mindestens aus drei Leuten mit mindestens drei Knoten bestehen muss. "Ein Knoten macht noch keine Community"
Community in der Community-API eintragen
Dafür muss auf GitHub in der Frenaken-Communities-Datei ein neuer Eintrag für die neue Community angelegt werden.
Danach muss das "node create_community_files.js" aufgerugen werden um die neue Community-Datei zu erstellen.
Danach muss die neue Community-Datei im Projekt "freifunkfranken-community" commitet werden.
Die neu erstellte Datei muss dann im weltweiten Community-Verzeichnis eingetragen werden. Dazu ist ein Pull-Request zu erstellen.
Wird dieser Pull-Request gemerged taucht die neue Community im Verzeichnis auf freifunk.net auf.
Hood technisch anlegen
IP-Range reservieren
Als erstes muss ein IP Bereich für die neue Hood reserviert werden. Dies geschieht, indem man einfach einen Eintrag in der Netz-Tabelle vornimmt.
Gateways konfigureiren
Es ist sinnvoll beim anlegen einer neuen Hood auch gleich einen oder mehrere Gateways Server aufzusetzen um die bestehende Infrastruktur zu entlasten. Zusätzlich sollten aber auch bestehende Gateways für diese Hood eingerichtet werden um ein Backup zu haben.
Bitte ergänzen: Detailierte Erklärung was auf dem Gateway getan werden muss um einen neuen IP-Bereich zu verteilen.
Gateway der Hood zuordnen
Nach der Konfiguration des Gateways muss dieser in der Tabelle "nodes" eingetragen werden. Als Hood muss hier die neue Nummer der anzulegenden Hood eingetragen werden.
Bitte ergänzen: Woher kommt der "key" in der Datenbank? Muss der Eintrag manuell erfolgen oder trägt sich der neue Gateway hier automatisch ein?
Neue Hood anlegen
Nachdem es mindestens einen Gateway-Server in der neuen Hood gibt kann die Hood in der Tabelle "hoods" angelegt werden:
- Als "id" muss eine eindeutige Zahl vergeben werden.
- als "name" sollte der Dateinamen der Community-API-Datei (ohne .json) vergeben werden. Z.B. "bamberg" oder "fuerth".
- Als "net" muss die selbe IP-Range eingetragen werden, die auch in der Netz-Tabelle reserviert wurde.
- Als Geo-Koordinaten sind die Koordinaten der Community aus der Community-API-Datei zu vergeben.
Ab jetzt sollten die neuen Gateways automatisch an die Knoten der Region verteilt werden.