Freifunk Kreis Groß-Gerau e.V. Dokumentation & Wiki

Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== VMware Offloader ======
Dieser Wiki-Artikel beschreibt die Installation eines Offloaders als virtuelle Maschine auf einem VMware ESXi Host.

__Eckdaten:__\\
ESXi Version: **6.0.0** \\
VM-Type: **32bit** \\
Image: **gluon-ffda-1.2.3-x86-generic.vmdk**

===== Installation =====
==== Gluon Image ====
Zuerst besorgen wir uns das passende aktuelle Image für das gewählte Freifunk Netz. Hier wurde das Image von FF Darmstadt genommen.

https://firmware.darmstadt.freifunk.net/?q=x86%E2%81%A3%20VMware%C2%A032bit%E2%81%A3%20alle%E2%81%A3%20Erstinstallation\\
https://firmware.darmstadt.freifunk.net/images/stable/factory/gluon-ffda-1.2.3-x86-generic.vmdk\\

Das Image speichern wir zuerst einmal auf die lokale Festplatte.

==== Netzwerkadapter der VM ====
An dieser Stelle muss man entscheiden, welche Netzwerke der Offloader später braucht. Hier ist die Entscheidung zu fällen **zwei** oder **drei** Netzwerkadapter dem Offloader zur Verfügung zu stellen. Diese Konfiguration **muss vor dem ersten Start** der virtuellen Maschine korrekt eingestellt sein. Spätere Änderungen werden wohl nicht korrekt verarbeitet!

**Siehe weiter unten:** [[wiki:faq:vmware-offloader#Netzwerkadapter|Details Netzwerkadapter]]

//Wenn man sich alle Optionen offen halten will, sollte man die Installation gleich mit 3 Netzwerkadaptern machen. Damit hat man dann jederzeit die Option zwischen **Client LAN** und **LAN Mesh** zu wechseln, bzw. es komplett parallel zu nutzen.//
==== Anlegen der VM ====
Da das Image nur die virtuelle Festplatte enthält, müssen wir zuerst noch eine virtuelle Maschine auf dem ESXi Host anlegen. Diese Einstellungen betreffen die 64bit Version des Images, das hier sehr stabil und performant läuft.

Die folgenden Abbildungen stammen aus der VMWare GUI ab Version 6.0.0. Die virtuelle Maschine kann natürlich auch per vShere Client angelegt werden.

**VM erstellen/registrieren** --> Neue virtuelle Maschine erstellen
Wir vergeben einen eindeutigen **Namen** und wählen als Typ **Linux** und Version **Anderes Linux System (32 Bit)**

{{:wiki:faq:offloader-1.png?direct&400|}}

In der nächsten Maske wählen wir den gewünschten **Datastore** aus und **weiter**.

Jetzt noch die Konfiguration der **VM**, hier gibt es einiges zu beachten. Als erstes entfernen wir die nicht benötigte Hardware, **Festplatte**, **USB-Controller**, **CD/DVD Laufwerk**, **Diskettenlaufwerk**, etc.

Übrig bleiben **CPU**, **Arbeitsspeicher**, **Grafikkarte** und die **Netzwerkadapter**

**CPU**: Bisher reicht hier ein Kern aus, bei einer E5-2520 CPU mit 2,40 GHz \\
**Arbeitsspeicher**: Mit 512 MB sollte man locker klar kommen \\
**Netzwerkadapter**: Am besten **drei** Netzwerkadapter zuweisen, diese müssen später in Unterschiedlichen Netzen liegen!

{{:wiki:faq:offloader-2.png?direct&400|}}

Die Erstellung der VM wird jetzt abgeschlossen. Die VM **nicht** starten.

Als nächstes laden wir das lokal gespeicherte Gluon Image (.vmdk) in den neu erstellten Ordner der virtuellen Maschine. Dazu verwenden wir den **Datenspeicherbrowser** in der GUI oder dem vSphere Client.

Jetzt bearbeiten wir die Einstellungen der virtuellen Maschine, und fügen eine **vorhandene Festplatte** hinzu. Der Dialog führt uns über den Datastore in den Ordner der VM zur **.vmdk Datei**. Die VM **nicht** starten. Wichtig ist, die Festplatte als **IDE 0** einzubinden, nicht über SCSI!

{{:wiki:faq:offloader-7.png?direct&400|}}

===== Netzwerkadapter =====
Diese Entscheidung ist vor dem Anlegen bzw. dem ersten Start der VM zu treffen, da die Konfiguration vor dem ersten Start stimmen muss.

==== zwei Adapter ====
Der Offloader braucht einen Netzwerkadapter als **WAN Interface** und einen als **LAN Interface**. Dabei spielt es erstmal keine Rolle ob auf dem LAN Interface direkt Clients connecten sollen, oder hier ein LAN-Mesh stattfinden soll.
==== drei Adapter ====
Soll später sowohl ein **LAN-Mesh** wie auch **LAN Clients** gleichzeitig bedient werden können, benötigen wir einen dritten Netzwerkadapter.

In der Regel werden bei virtuellen Umgebungen die Netzwerkadapter entweder als physikalische Adapter über einen eigenen vSwitch, oder als Portgruppen (virtuelle (V)LAN's) über einen vSwitch angebunden. Details dazu erspare ich mir, wer Virtualisierung einsetzt sollte sich hier auskennen.

Die Anleitung geht von **drei Netzwerkadaptern** aus, die als Portgruppen auf einem vSwitch angelegt werden. Zwei werden später für die beiden LAN Versionen verwendet, das dritte Interface geht als WAN zu einer Internet Verbindung.

Anlegen einer Portgruppe für **LAN Mesh**, die VLAN ID ist den eigenen Gegebenheiten anzupassen. Wichtig sind den **Promiscuous Mode** und die **MAC Adressenänderungen** zuzulassen.

{{:wiki:faq:offloader-3.png?direct&400|}}

**Bei 3 Netzwerkadaptern:** Anlegen einer weiteren Portgruppe für **LAN Clients**, die VLAN ID ist den eigenen Gegebenheiten anzupassen. Wichtig sind den **Promiscuous Mode** und die **MAC Adressenänderungen** zuzulassen.

{{:wiki:faq:offloader-4.png?direct&400|}}

Man kann an dieser Stelle auch eine dritte Portgruppe für **WAN** anlegen, falls man über ein eigens VLAN zu einem Router möchte. In der Regel dürfte es aber bereits eine Portgruppe geben, die Internetzugang über einen DHCP-Server zur Verfügung stellt. Auch in dieser Portgruppe muss zwingend der **Promiscuous Mode** zugelassen werden!

===== Der erste Start der VM =====
Vor dem ersten Start prüfen wir noch einmal die Konfiguration der virtuellen Maschine, die jetzt so aussehen sollte:

{{:wiki:faq:offloader-5.png?direct&400|}}

Die Offloader VM sollte normal starten (im Konsolenfenster überprüfen), nach einem **Enter** im Konsolenfenster sollte uns **LEDE** begrüßen.

{{:wiki:faq:offloader-6.png?direct&400|}}

Jetzt brauchen wir einen **Client** als PC oder VM mit einem Browser, den wir in den ersten Netzwerkadapter **FF LAN Mesh** hinein verbinden. Auf diesem Netzwerkadapter läuft ein **DHCP SERVER** und der Client sollte eine IP-Adresse aus dem Netz **192.168.1.xx** bekommen.

Jetzt verbinden wir uns mit dem Browser auf das Web-Interface **http://192.168.1.1** der Gluon VM für die Grundkonfiguration. Die Konfiguration muss ich hier sicherlich nicht beschreiben, wichtig wäre die Entscheidung ob auf dem LAN **Mesh** aktiviert wird oder nicht. \\
Sollte die Variante mit den drei Netzwerkadaptern gewählt worden sein, muss hier unbedingt **LAN Mesh** aktiviert werden.

Die Konfiguration wird, wie bei jedem Gluon Freifunk Router, komplett durchgeführt und abgeschlossen. Den angezeigten Key muss man in der Regel von der Community frei schalten lassen.

===== Neustart / Betrieb =====
Jeder Neustart führt jetzt in den Betriebszustand. Das heißt, am //zweiten// Netzwerkadapter **FF WAN** muss ein DHCP Server verfügbar sein, der eine Adresse vergibt und den Weg ins Internet zur Verfügung stellt.

Über den //ersten// Netzwerkadapter wird jetzt das Client Netz angebunden. Bei der **drei Adapterkonfiguration** ist auf diesem Netzwerk **Mesh aktiv** für weitere Gluon Freifunk Knoten.

===== Dritter Netzwerkadapter =====
In der normalen Konfiguration haben wir immer nur zwei Adapter zur Verfügung, in der Regel **eth0** für die Clients und **eth1** für den WAN Anschluss.

Jetzt wollen wir aber auf den **dritten Adapter** noch das normale **Freifunk Client Netz** legen. Der Adapter heißt **eth2** und ist wie folgt über die Konsole (oder SSH) zu konfigurieren:

  uci set network.client.ifname='local-port bat0 eth2'
  uci commit network
  /etc/init.d/network restart  

Das war es auch schon, damit haben wir den **Freifunk Offloader** auf Basis von **WMware ESXi 6.0.0** am laufen.

Je nach Host, bzw. CPU-Typ, sind hier Durchsatzraten größer als 100 MBit ohne Probleme möglich.

====== Tipps & Tricks ======

Das 64bit Image lief hier nicht stabil, das 32bit schon. Daher ist diese im Moment bei mir die erste Wahl.

Da die virtuelle Maschine keinen Reset-Taster kennt, hier noch kurz die Info, wie man ihn für den nächsten Start aktiviert. Zu beachten ist, das die Konfiguration dann zwingend über den **ersten Netzwerkadapter eth0** erfolgen muss.

  uci set gluon-setup-mode.@setup_mode[0].configured='0'
  uci commit
  reboot

----
[[.:start|zurück]]