Technische Information - Versionsgeschichte

Hibo98 am 8. Juli 2024 um 15:51 Uhr

2024-07-08T15:51:58Z

← Nächstältere Version		Version vom 8. Juli 2024, 15:51 Uhr
Zeile 95:		Zeile 95:

	== Registrierung ==		== Registrierung ==
	'''URL:''' ~~http~~://register.freifunk-dresden.de/bot.php?registerkey=		'''URL:''' https://selfsigned.register.freifunk-dresden.de/bot.php?registerkey=

	registerkey ist wie folgt definiert: ([0-9a-f][0-9a-f]:){32}<br/>		registerkey ist wie folgt definiert: ([0-9a-f][0-9a-f]:){32}<br/>

Creme am 18. Oktober 2019 um 15:08 Uhr

2019-10-18T15:08:20Z

← Nächstältere Version		Version vom 18. Oktober 2019, 15:08 Uhr
Zeile 1:		Zeile 1:
			[[Category:Dokumentation]]
	Technische Informationen liefern Antworten für den Aufbau eigner Knoten.<br/>		Technische Informationen liefern Antworten für den Aufbau eigner Knoten.<br/>

Erik am 2. Januar 2019 um 19:52 Uhr

2019-01-02T19:52:48Z

← Nächstältere Version		Version vom 2. Januar 2019, 19:52 Uhr
Zeile 117:		Zeile 117:
	Gleiches MUSS beim Server beachtet und implementiert sein.		Gleiches MUSS beim Server beachtet und implementiert sein.

	== Berechnung IP Adressen ==		== Berechnung der IP Adressen ==
	Jeder Knoten erhält eine IP Adresse aus dem 10.~~200er~~ IP Bereich. Diese leitet sich von der Knotennummer ab, die vom Registrator zurückgegeben wird.<br>		Jeder Knoten erhält eine IP Adresse aus dem 10.200.x.x IP-Bereich. Diese leitet sich von der Knotennummer ab, die vom Registrator zurückgegeben wird.<br>
	Es darf niemals eine ~~eigen~~ ausgedachte Knotennummer verwendet werden, da es sonst zu Dopplungen im Netz und damit zu IP-Konflikten kommt.<br>		Es darf niemals eine selbst ausgedachte Knotennummer verwendet werden, da es sonst zu Dopplungen im Netz und damit zu IP-Konflikten kommt.<br>
	Die Folge wäre eine Nichterreichbarkeit von einzelnen oder sogar mehreren Routern.		Die Folge wäre eine Nichterreichbarkeit von einzelnen oder sogar mehreren Routern.

	'''ACHTUNG:''' Bitte nutzt NIEMALS eine eigene Knotennummer !!!		'''ACHTUNG:''' Bitte nutzt NIEMALS eine eigene Knotennummer !!!

Erik am 2. Januar 2019 um 19:51 Uhr

2019-01-02T19:51:29Z

← Nächstältere Version		Version vom 2. Januar 2019, 19:51 Uhr
Zeile 96:		Zeile 96:
	'''URL:''' http://register.freifunk-dresden.de/bot.php?registerkey=		'''URL:''' http://register.freifunk-dresden.de/bot.php?registerkey=

	registerkey ist ~~wiefolgt~~ definiert: ([0-9a-f][0-9a-f]:){32}<br/>		registerkey ist wie folgt definiert: ([0-9a-f][0-9a-f]:){32}<br/>
	(Beispiel: 00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff)		(Beispiel: 00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff)


	Dieser Key '''MUSS''' im gesamten Freifunknetz von Dresden eindeutig sein. In der Firmware wird dieser aus		Dieser Key '''MUSS''' im gesamten Freifunknetz von Dresden eindeutig sein. In der Firmware wird dieser aus
	einem Zufallswert und der ~~md5sum~~ der ~~Netzwerk Informationen~~ erzeugt. Die Netzwerkinformationen enthalten unter		einem Zufallswert und der MD5-Prüfsumme der Netzwerkinformationen erzeugt. Die Netzwerkinformationen enthalten unter
	anderem die MAC Adresse, welche eindeutig ist.		anderem die MAC Adresse, welche eindeutig ist.

Zeile 111:		Zeile 111:
	'''Hinweis:''' Die Registrierung eines Knotens (Router oder Server) muss wenigstens 1 mal pro Stunde erfolgen.		'''Hinweis:''' Die Registrierung eines Knotens (Router oder Server) muss wenigstens 1 mal pro Stunde erfolgen.

	Der Registrator kann unter ~~umständen~~ eine '''neue Knotennummer''' zurück liefern, welche unmittelbar zu einer		Der Registrator kann unter Umständen eine '''neue Knotennummer''' zurück liefern, welche unmittelbar zu einer
	neuen IP Adresse für den Knoten führen muss.<br>		neuen IP Adresse für den Knoten führen muss.<br>

Erik am 2. Januar 2019 um 19:48 Uhr

2019-01-02T19:48:03Z

Stephan: /* Registrierung */

2018-08-07T20:07:18Z

Registrierung

← Nächstältere Version		Version vom 7. August 2018, 20:07 Uhr
Zeile 107:		Zeile 107:
	key2=$(ip link \| grep ether \| md5sum \| cut -d' ' -f1 \| sed 's#$..$#\1:#g;s#:$##')		key2=$(ip link \| grep ether \| md5sum \| cut -d' ' -f1 \| sed 's#$..$#\1:#g;s#:$##')
	key="$key1:$key2"		key="$key1:$key2"


			'''Hinweis:''' Die Registrierung eines Knotens (Router oder Server) muss wenigstens 1 mal pro Stunde erfolgen.

			Der Registrator kann unter umständen eine '''neue Knotennummer''' zurück liefern, welche unmittelbar zu einer
			neuen IP Adresse für den Knoten führen muss.<br>

			In der Firmware wird die neue Knotennummer gespeichert und der Router wird neu gestartet.<br>
			Gleiches MUSS beim Server beachtet und implementiert sein.

	== Berechnung IP Adressen ==		== Berechnung IP Adressen ==

Stephan: /* Registrierung */

2018-08-07T20:03:28Z

Registrierung

← Nächstältere Version		Version vom 7. August 2018, 20:03 Uhr
Zeile 100:		Zeile 100:


	Dieser Key '''MUSS''' im gesamten Freifunknetz von Dresden eindeutig sein. In der Firmware wird dieser aus ~~dem ssh-fingerprint~~ und der md5sum der Netzwerk Informationen erzeugt.		Dieser Key '''MUSS''' im gesamten Freifunknetz von Dresden eindeutig sein. In der Firmware wird dieser aus
			einem Zufallswert und der md5sum der Netzwerk Informationen erzeugt. Die Netzwerkinformationen enthalten unter
			anderem die MAC Adresse, welche eindeutig ist.

	~~<code>~~		key1=$(dd if=/dev/urandom bs=16 count=1 2>/dev/null \| hexdump -e '16/1 "%02x:"' \| sed 's#:$##')
	key1=$(dd if=/dev/urandom bs=16 count=1 2>/dev/null \| hexdump -e '16/1 "%02x:"' \| sed 's#:$##')~~<br/>~~		key2=$(ip link \| grep ether \| md5sum \| cut -d' ' -f1 \| sed 's#$..$#\1:#g;s#:$##')
	key2=$(ip link \| grep ether \| md5sum \| cut -d' ' -f1 \| sed 's#$..$#\1:#g;s#:$##')~~<br/>~~		key="$key1:$key2"
	key="$key1:$key2"
	~~</code>~~

	key1 wird vom Randomgenerator erzeugt, welcher ziemlich eindeutig sein sollte. Falls es aber bei gleichen Routertypen doch zu gleichen Werten kommen sollte, wird der key2 über die Netzwerkkonfiguration ermittelt, welches die die MAC der Netzwerkkarten einschließt. Da jeder Router eine andere MAC besitzt, wird hier eine garantierte Eindeutigkeit erreicht.

	== Berechnung IP Adressen ==		== Berechnung IP Adressen ==

Stephan: /* Berechnung IP Adressen */

2018-08-07T19:59:23Z

Berechnung IP Adressen

Änderungen zeigen

Stephan: /* Sysinfo */

2018-04-18T09:41:51Z

Sysinfo

← Nächstältere Version		Version vom 18. April 2018, 09:41 Uhr
Zeile 54:		Zeile 54:
	Der aktuelle Zustand eines Routers kann über die folgende URL abgefragt werden.		Der aktuelle Zustand eines Routers kann über die folgende URL abgefragt werden.
	[[sysinfo-json\|http://<router-ip>/sysinfo-json.cgi]]		[[sysinfo-json\|http://<router-ip>/sysinfo-json.cgi]]
			[[sysinfo-json\|http://<router-ip>/sysinfo.json]] (ab Firmware 4.2.18)
	Diese json Datenstruktur wird unter anderem vom Freifunkserver (freifunk-dresden.de) abgefragt, um die Hotspot-Liste und Kartendaten zu generieren.		Diese json Datenstruktur wird unter anderem vom Freifunkserver (freifunk-dresden.de) abgefragt, um die Hotspot-Liste und Kartendaten zu generieren.

Stephan: /* Infrastruktur */

2017-09-18T13:48:12Z

Infrastruktur

← Nächstältere Version		Version vom 18. September 2017, 13:48 Uhr
Zeile 90:		Zeile 90:

	= Infrastruktur =		= Infrastruktur =
	* [[~~Infrastructure\|~~Infrastruktur]] aktuell ist es eine lose Sammlung von Stichpunkten, welche nach und nach in eine Dokumentation der Firmware/Server Infrastruktur verwandelt wird. Diese Dokumentation beschreibt die externen Abhängigkeiten, das Zusammenspiel der Freifunkkomponenten (Server,Router,Dienste...).		* [[Infrastruktur]] aktuell ist es eine lose Sammlung von Stichpunkten, welche nach und nach in eine Dokumentation der Firmware/Server Infrastruktur verwandelt wird. Diese Dokumentation beschreibt die externen Abhängigkeiten, das Zusammenspiel der Freifunkkomponenten (Server,Router,Dienste...).

	== Registrierung ==		== Registrierung ==

← Nächstältere Version		Version vom 2. Januar 2019, 19:48 Uhr
Zeile 2:		Zeile 2:

	= Allgemeines =		= Allgemeines =
	Falls ein Knoten nicht '''Kriterien''' erfüllt, kann dieser das Freifunk Netz erheblich stören.<br/> Da das Netz möglichst offen bleiben soll, ist ein ~~Knotenauschluss~~ nicht so leicht möglich. Ansonsten wären wir gezwungen Registrierungsmaßnahmen vorzusehen, ~~so dass~~ kein Knoten unerlaubt teilnehmen kann. Das würde aber den Ausbau des Netzes erheblich behindern.		Falls ein Knoten nicht die '''Kriterien''' erfüllt, kann dieser das Freifunk-Netz erheblich stören.<br/> Da das Netz möglichst offen bleiben soll, ist ein Knotenausschluss nicht so leicht möglich. Ansonsten wären wir gezwungen Registrierungsmaßnahmen vorzusehen, sodass kein Knoten unerlaubt teilnehmen kann. Das wollen wir nicht einführen, denn es würde aber den Ausbau des Netzes erheblich behindern.


	* [[Kanalwahl]]		* [[Kanalwahl]]
	* [[Knoten Spezifikation]] Soll ein ~~eigner~~ Knoten aufgebaut werden, so muss dieser die [[Knoten Spezifikation]] erfüllen, um ihn im Freifunk Dresden Netzwerk einbinden zu dürfen.		* [[Knoten Spezifikation]] Soll ein eigener Knoten aufgebaut werden, so muss dieser die [[Knoten Spezifikation]] erfüllen, um ihn im Freifunk-Dresden-Netzwerk einbinden zu dürfen.

	== Knotennummer durch Registrierung eines Knotens anfordern ==		== Knotennummer durch Registrierung eines Knotens anfordern ==
	Im Freifunknetz Dresden muss sich ein Knoten automatisch und regelmäßig am Registrierungsservice melden.<br/>		Im Freifunknetz Dresden muss sich ein Knoten automatisch und regelmäßig beim Registrierungsservice melden.<br/>
	Die Knotennummern sind in Nutzungsbereiche unterteilt:		Die Knotennummern sind in Nutzungsbereiche unterteilt:

Zeile 17:		Zeile 17:
	! Start !! End !! Nutzungsbereich		! Start !! End !! Nutzungsbereich
	\|-		\|-
	\| 0 \|\| 256 \|\| VServer fest vergeben		\| 0 \|\| 256 \|\| VServer, Nummer fest vergeben
	\|-		\|-
	\| 900 \|\| 999 \|\| spezial: temporäre Knotennummer		\| 900 \|\| 999 \|\| spezial: temporäre Knotennummer für Freifunkrouter im Autosetup
	\|- style="color: gray; background-color: lightgrey"		\|- style="color: gray; background-color: lightgrey"
	\| 1000 \|\| \|\| spezial: Startpunkterkennung für Registration Service		\| 1000 \|\| \|\| spezial: Startpunkterkennung für Registration-Service
	\|-		\|-
	\| 1001 \|\| 50999 \|\| Knotennummer für ~~Offizielle~~ Firmware: Vergeben durch Registration Service		\| 1001 \|\| 50999 \|\| Knotennummer für offizielle Firmware: Vergeben durch Registration-Service
	\|- style="color: gray; background-color: lightgrey"		\|- style="color: gray; background-color: lightgrey"
	\| 51000 \|\| \|\| spezial: Startpunkterkennung für Registration Service		\| 51000 \|\| \|\| spezial: Startpunkterkennung für Registration-Service
	\|-		\|-
	\| 51001 \|\| 59999 \|\| Knotennummer für alternative Knoten oder eigengebaute Firmware		\| 51001 \|\| 59999 \|\| Knotennummer für alternative Knoten oder eigengebaute Firmware
Zeile 40:		Zeile 40:

	* <span style="color: orange">Erstmalige Knotennummer</span>		* <span style="color: orange">Erstmalige Knotennummer</span>
	Nach der Registrierung erhält der Freifunk Knoten eine freie Knotennummer. Abhängig davon, ob die Registrierung		Nach der Registrierung erhält der Freifunk-Knoten eine freie Knotennummer. Abhängig davon, ob die Registrierung
	durch die ~~Originalfirmware~~ oder einem alternativen Aufbau erfolgt, wird eine Knotennummer aus unterschiedlichen Bereichen vergeben. Dieses dient zur Verbesserung der Störanfälligkeit. Alternative Knoten (oder selbst erzeugte Firmware aus dem GitHub-Repository) dürfen nur Nummern ab 51000 verwenden.		durch die Original-Firmware oder einem alternativen Aufbau erfolgt, wird eine Knotennummer aus unterschiedlichen Bereichen vergeben. Dieses dient zur Verbesserung der Störanfälligkeit. Alternative Knoten (oder selbst erzeugte Firmware aus dem GitHub-Repository) dürfen nur Nummern ab 51000 verwenden.


	* <span style="color: orange">Automatische Neuzuweisung</span>		* <span style="color: orange">Automatische Neuzuweisung</span>
	Knotennummern können jederzeit neu zugewiesen werden. In diesem Fall ist es '''absolut notwendig''', dass die daraus resultierende ~~Neuberechung~~ der IP-Bereiche (Adressen) '''sofort''' erfolgt und angewendet wird.<br/> Bei Verschiebungen von Knotenbereichen, kann somit das Netz ohne Nutzereingriff umgeordnet werden. Dies war bereits notwendig.<br />Daraus ergibt sich die Notwendigkeit der regelmäßigen ~~Regiestrierung~~ eines Freifunk Knotens.		Knotennummern können jederzeit neu zugewiesen werden. In diesem Fall ist es '''absolut notwendig''', dass die daraus resultierende Neuberechnung der IP-Bereiche (Adressen) '''sofort''' erfolgt und angewendet wird.<br/> Bei Verschiebungen von Knotenbereichen kann somit das Netz ohne Nutzereingriff umgeordnet werden. Dies war bereits notwendig.<br />Daraus ergibt sich die Notwendigkeit der regelmäßigen Registrierung eines Freifunk-Knotens.


	* <span style="color: orange">Regelmäßige Registrierungsplicht</span>		* <span style="color: orange">Regelmäßige Registrierungsplicht</span>
	Jeder Freifunk Knoten, ob Original Firmware oder Alternativknoten '''muss''', sich regelmäßig registrieren.<br/>Die Registrierung sorgt für die Reservierung der Knotennummer aktuell für die nächsten 4 Wochen. Nach dieser Zeit wird diese Knotennummer wieder frei und kann an andere Knoten vergeben werden.<br/>Das ~~Interval~~ für eine Registrierung ist 1h-5h zur vorhergehenden Registration.<br/>Ein Knoten, der somit eine bereits vergebene Knotennummer verwendet, erlangt keinen Zugang zum Netz, da ein IP Konflikt eintreten würde. In diesem Fall muss der Knoten über das eigene Internet (nicht über das Freifunknetz) auf den Registrierungsservice ~~zu greifen~~.		Jeder Freifunk-Knoten, ob Original-Firmware oder Alternativknoten '''muss''', sich regelmäßig registrieren.<br/>Die Registrierung sorgt für die Reservierung der Knotennummer aktuell für die nächsten 4 Wochen. Nach dieser Zeit wird diese Knotennummer wieder frei und kann an andere Knoten vergeben werden.<br/>Das Intervall für eine Registrierung ist 1h-5h zur vorhergehenden Registration.<br/>Ein Knoten, der somit eine bereits vergebene Knotennummer verwendet, erlangt keinen Zugang zum Netz, da ein IP-Konflikt eintreten würde. In diesem Fall muss der Knoten über das eigene Internet (nicht über das Freifunknetz) auf den Registrierungsservice zugreifen.

	== Sysinfo ==		== Sysinfo ==
Zeile 64:		Zeile 64:
	== Übertragungsgeschwindigkeiten ==		== Übertragungsgeschwindigkeiten ==
	=== Backbone (fastd) ===		=== Backbone (fastd) ===
	''fastd'' ist ein VPN Dienst, welcher für die Backbone-Verbindung zwischen Router-Server, Server-Server oder Router-Router verwendet wird. Die folgenden Werte ~~Router~~ (~~von~~ [https://projects.universe-factory.net/projects/fastd/wiki/Benchmarks Fastd-Projekt] entnommen) wurden auf Routern mit Openwrt ermittelt, wobei ausschließlich ''fastd'' lief, um die maximale Geschwindigkeit zu ermitteln. Da die Freifunk-Firmware weitere Komponenten (Firewall,Routing,...) beinhaltet, sind ~~diese~~ Werte niedriger.		''fastd'' ist ein VPN Dienst, welcher für die Backbone-Verbindung zwischen Router-Server, Server-Server oder Router-Router verwendet wird. Die folgenden Werte (vom [https://projects.universe-factory.net/projects/fastd/wiki/Benchmarks Fastd-Projekt] entnommen) wurden auf Routern mit Openwrt ermittelt, wobei ausschließlich ''fastd'' lief, um die maximale Geschwindigkeit zu ermitteln. Da die Freifunk-Firmware weitere Komponenten (Firewall,Routing,...) beinhaltet, sind die Werte auf einem Freifunkrouter niedriger.
	Bei einer schmalen Internetanbindung wird die Geschwindigkeit weiter beschränkt.		Bei einer schmalen Internetanbindung wird die Geschwindigkeit weiter beschränkt.