Hood-Verwaltung: Unterschied zwischen den Versionen

Aus Freifunk Franken
Wechseln zu:Navigation, Suche
K (Rokufukka-iō verschob die Seite HoodVerwaltung nach Hood-Verwaltung)
 
(6 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 6: Zeile 6:


=== Neue Hood mit Community absprechen ===
=== 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.
Wenn es eine neue Hood geben soll, sollte dies immer mit der Community abgesprochen werden. Dazu am besten eine Mail an die franken-gateway oder auch an die franken [[Mailinglisten|Mailingliste]] schicken.


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"''
Zunächst sollte eine 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 und nachhaltig verantwortlich ist.


=== Community in der Community-API eintragen ===
=== Community in der Community-API eintragen ===
Dafür muss auf GitHub in der [https://github.com/FreifunkFranken/community.franken.freifunk.net/blob/master/communitys_franken.json Frenaken-Communities-Datei] ein neuer Eintrag für die neue Community angelegt werden.
Dafür muss auf GitHub in der [https://github.com/FreifunkFranken/community.franken.freifunk.net/blob/master/communitys_franken.json Franken-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 das "node create_community_files.js" aufgerufen werden um die neue Community-Datei zu erstellen.


Danach muss die neue Community-Datei im Projekt "[https://github.com/FreifunkFranken/freifunkfranken-community freifunkfranken-community]" commitet werden.
Danach muss die neue Community-Datei im Projekt "[https://github.com/FreifunkFranken/freifunkfranken-community freifunkfranken-community]" commitet werden.
Zeile 26: Zeile 26:
Als erstes muss ein IP Bereich für die neue Hood reserviert werden. Dies geschieht, indem man einfach einen Eintrag in der [[Portal:Netz|Netz-Tabelle]] vornimmt.
Als erstes muss ein IP Bereich für die neue Hood reserviert werden. Dies geschieht, indem man einfach einen Eintrag in der [[Portal:Netz|Netz-Tabelle]] vornimmt.


=== Gateways konfigureiren ===
=== Gateways konfigurieren ===
Es ist sinnvoll beim anlegen einer neuen Hood auch gleich einen oder mehrere [[Freifunk-Gateway_aufsetzen|Gateways Server aufzusetzen]] um die bestehende Infrastruktur zu entlasten.
Es ist sinnvoll beim anlegen einer neuen Hood auch gleich einen oder mehrere [[Freifunk-Gateway_aufsetzen|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.
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 ===
=== Gateway der Hood zuordnen ===
Zeile 42: Zeile 40:
* als "name" sollte der Dateinamen der [https://github.com/FreifunkFranken/freifunkfranken-community Community-API-Datei] (ohne .json) vergeben werden. Z.B. "bamberg" oder "fuerth".
* als "name" sollte der Dateinamen der [https://github.com/FreifunkFranken/freifunkfranken-community 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  [[Portal:Netz|Netz-Tabelle]] reserviert wurde.
* Als "net" muss die selbe IP-Range eingetragen werden, die auch in der  [[Portal:Netz|Netz-Tabelle]] reserviert wurde.
* Als Geo-Koordinaten sind die Koordinaten der Community aus der [https://github.com/FreifunkFranken/freifunkfranken-community Community-API-Datei] zu vergeben.
* Als Geo-Koordinaten sollte ein sinnvoller Mittelpunkt der neuen Hood gewählt werden. Da es bei der Einteilung der Hoods um eine möglichst "gerechte" Aufteilung der Knoten unter den Gatewayservern geht, muss dieser Mittelpunkt mit den anderen Hoods abgesprochen werden und muss nicht zwingend mit dem Ort der Community aus der [https://github.com/FreifunkFranken/freifunkfranken-community Community-API-Datei] übereinstimmen.


Ab jetzt sollten die neuen Gateways automatisch an die Knoten der Region verteilt werden.
Ab jetzt sollten die neuen Gateways automatisch an die Knoten der Region verteilt werden.


[[Kategorie:Technik]]
[[Kategorie:Technik]]

Aktuelle Version vom 5. März 2019, 15:44 Uhr

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, sollte dies immer mit der Community abgesprochen werden. Dazu am besten eine Mail an die franken-gateway oder auch an die franken Mailingliste schicken.

Zunächst sollte eine 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 und nachhaltig verantwortlich ist.

Community in der Community-API eintragen

Dafür muss auf GitHub in der Franken-Communities-Datei ein neuer Eintrag für die neue Community angelegt werden.

Danach muss das "node create_community_files.js" aufgerufen 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 konfigurieren

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.

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 sollte ein sinnvoller Mittelpunkt der neuen Hood gewählt werden. Da es bei der Einteilung der Hoods um eine möglichst "gerechte" Aufteilung der Knoten unter den Gatewayservern geht, muss dieser Mittelpunkt mit den anderen Hoods abgesprochen werden und muss nicht zwingend mit dem Ort der Community aus der Community-API-Datei übereinstimmen.

Ab jetzt sollten die neuen Gateways automatisch an die Knoten der Region verteilt werden.