Server Installation/vhost-admin - Versionsgeschichte

MathiasMahnke: /* Debian-Host anlegen */

2019-01-05T19:41:16Z

Debian-Host anlegen

← Nächstältere Version		Version vom 5. Januar 2019, 19:41 Uhr
Zeile 37:		Zeile 37:

	== Debian-Host anlegen ==		== Debian-Host anlegen ==
	<code>vhost-admin.sh create-debian ~~foo~~ ~~192.168.5.23~~</code>		<code>vhost-admin.sh create-debian <hostname> <opennet-mesh-ip></code>
	* ein Debian-basiertes System wird via ''debootstrap'' auf einem LVM-Volume vorbereitet		* ein Debian-basiertes System wird via ''debootstrap'' auf einem LVM-Volume vorbereitet
	* Netzwerk wird vorkonfiguriert:		* Netzwerk wird vorkonfiguriert:
	** eth0: oben angegebene IP-Adresse (Bridge ins ~~opennet-VLAN~~ in ~~der Frieda~~)		** eth0: oben angegebene IP-Adresse (Bridge ins Opennet Mesh Bridge)
	*** die IP muss zuvor unter [[Server]] reserviert werden		*** die IP muss zuvor unter [[Server]] reserviert werden
	** eth1: DHCP-Client (nur wirksam, falls eine WAN-Bridge vorhanden ist)		** eth1: DHCP-Client (nur wirksam, falls eine WAN Bridge vorhanden ist)
	** olsrd: automatischer Start für eth0		** olsrd: automatischer Start für eth0
	* root-Schlüssel des Virtualisierungsservers wird importiert		* root-Schlüssel des Virtualisierungsservers wird importiert
	* der Hostname ~~(''foo'')~~ wird für die Namen der LVM-Volumes und des libvirt-Hosts verwendet		* der Hostname wird für die Namen der LVM-Volumes und des libvirt-Hosts verwendet

	== OpenWrt-Host anlegen ==		== OpenWrt-Host anlegen ==

Lars: Details zur br-virt-wan-Bridge und Formatierungen

2017-10-22T22:51:37Z

Details zur br-virt-wan-Bridge und Formatierungen

← Nächstältere Version		Version vom 22. Oktober 2017, 22:51 Uhr
Zeile 7:		Zeile 7:

	= Einrichtung =		= Einrichtung =
	Die [[Server_Installation/Ansible\|ansible-Rolle]] ''virtualization-server'' sorgt für die Installation der notwendigen Pakete, die Übertragung des ''vhost-admin''-Skripts, sowie (einmalig) die Übertragung eines libvirt-Templates für neue Hosts. Beachte eventuell die [[Server_Installation/Ansible#virtualization-server\|Dokumentation der ansible-Rolle]] für eventuell erforderliche ansible-Host-Variablen (z.B. die Auswahl der VM-Image-Verwaltung (LVM oder Datei)).		Die [[Server_Installation/Ansible\|ansible-Rolle]] ''virtualization-server'' sorgt für die Installation der notwendigen Pakete, die Übertragung des ''vhost-admin''-Skripts, sowie (einmalig) die Übertragung eines libvirt-Templates für neue Hosts. Beachte eventuell die [[Server_Installation/Ansible#virtualization-server\|Dokumentation der ansible-Rolle]] für eventuell erforderliche ansible-Host-Variablen (z.B. die Auswahl der VM-Image-Verwaltung: LVM oder Datei).

	Folgende nachträgliche Anpassungen auf dem Virtualisierungsserver sind wahrscheinlich empfehlenswert:		Folgende nachträgliche Anpassungen auf dem Virtualisierungsserver sind wahrscheinlich empfehlenswert:
Zeile 24:		Zeile 24:
	bridge_ports eth0		bridge_ports eth0
	iface br-wan inet6 auto		iface br-wan inet6 auto
			* Bridge für virtuelle WAN-Interfaces konfigurieren, falls die VMs über den Virtualisierungsserver ins Internet routen sollen:
			auto br-virt-wan
			iface br-virt-wan inet static
			address 172.16.1.1
			netmask 255.255.255.0
			bridge_ports none
			iface br-virt-wan inet6 auto
	* eventuell in der Datei ''/etc/libvirt/qemu/_template.xml'' Anpassungen vornehmen (z.B. Anpassung der Bridge-Namen oder Hinzufügen der optionalen WAN-Bridge)		* eventuell in der Datei ''/etc/libvirt/qemu/_template.xml'' Anpassungen vornehmen (z.B. Anpassung der Bridge-Namen oder Hinzufügen der optionalen WAN-Bridge)

Zeile 42:		Zeile 49:
	== OpenWrt-Host anlegen ==		== OpenWrt-Host anlegen ==
	<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 latest</code>		<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 latest</code>
	** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet		* ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet
	*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'' - siehe <code>vhost-admin.sh list-ap-firmware-versions</code>)		** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'' - siehe <code>vhost-admin.sh list-ap-firmware-versions</code>)
	** ein LVM-Image wird als Datenträger erzeugt		* ein LVM-Image wird als Datenträger erzeugt
	** mit openwrt-Images vom Typ ''x86-combined-squashfs'' (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-x86-generic-combined-squashfs.img.gz]]) funktioniert die Firmware-Aktualisierung aus dem laufenden System heraus (eventuell gilt das auch für anderen Firmware-Formate)		* mit openwrt-Images vom Typ ''x86-combined-squashfs'' (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-x86-generic-combined-squashfs.img.gz]]) funktioniert die Firmware-Aktualisierung aus dem laufenden System heraus (eventuell gilt das auch für anderen Firmware-Formate)
	*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)		** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)
	** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)		* das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)
	** nach dem Starten des virtuellen Hosts (<code>virsh start ap1-23</code>) ist er unter der gewählten IP in der gesamten OLSR-Wolke erreichbar		* nach dem Starten des virtuellen Hosts (<code>virsh start ap1-23</code>) ist er unter der gewählten IP in der gesamten OLSR-Wolke erreichbar
	*** die IP muss zuvor unter [[Opennet_Nodes]] reserviert werden		** die IP muss zuvor unter [[Opennet_Nodes]] reserviert werden

	== Host löschen ==		== Host löschen ==
	<code>vhost-admin.sh remove ap1-23</code>		<code>vhost-admin.sh remove ap1-23</code>
	** das virtuelle System (debian- oder openwrt-basiert) wird gestoppt und inklusive der LVM-Images ohne Nachfrage gelöscht		* das virtuelle System (debian- oder openwrt-basiert) wird gestoppt und inklusive der LVM-Images ohne Nachfrage gelöscht

Lars: Anmerkungen beantwortet

2017-05-15T21:47:33Z

Anmerkungen beantwortet

← Nächstältere Version		Version vom 15. Mai 2017, 21:47 Uhr
Zeile 41:		Zeile 41:

	== OpenWrt-Host anlegen ==		== OpenWrt-Host anlegen ==
	<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 latest ~~(??)~~</code>		<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 latest</code>
	** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet		** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet
	*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'')		*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'' - siehe <code>vhost-admin.sh list-ap-firmware-versions</code>)
	** ein LVM-Image wird als Datenträger erzeugt		** ein LVM-Image wird als Datenträger erzeugt
	** ~~das~~ openwrt-~~Image sollte~~ vom ~~Type~~ ''x86-combined-squashfs'' ~~(warum?) sein~~ (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-x86-generic-combined-squashfs.img.gz]])		** mit openwrt-Images vom Typ ''x86-combined-squashfs'' (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-x86-generic-combined-squashfs.img.gz]]) funktioniert die Firmware-Aktualisierung aus dem laufenden System heraus (eventuell gilt das auch für anderen Firmware-Formate)
	*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)		*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)
	** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)		** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)

MathiasMahnke: /* OpenWrt-Host anlegen */

2017-05-15T18:33:57Z

OpenWrt-Host anlegen

← Nächstältere Version		Version vom 15. Mai 2017, 18:33 Uhr
Zeile 41:		Zeile 41:

	== OpenWrt-Host anlegen ==		== OpenWrt-Host anlegen ==
	<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 ~~https://downloads.opennet-initiative.de/openwrt/stable/~~latest~~/x86/openwrt-$version-x86-generic-combined-ext4.img.gz~~ (??)</code>		<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 latest (??)</code>
	** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet		** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet
	*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'')		*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'')

MathiasMahnke: /* OpenWrt-Host anlegen */

2017-05-15T18:32:50Z

OpenWrt-Host anlegen

← Nächstältere Version		Version vom 15. Mai 2017, 18:32 Uhr
Zeile 41:		Zeile 41:

	== OpenWrt-Host anlegen ==		== OpenWrt-Host anlegen ==
	<code>vhost-admin.sh create-ap ap1-23 192.168.1.23</code>		<code>vhost-admin.sh create-ap ap1-23 192.168.1.23 https://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-$version-x86-generic-combined-ext4.img.gz (??)</code>
	** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet		** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet
	*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.4.5'')		*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.5.x'')
	** ein LVM-Image wird als Datenträger erzeugt		** ein LVM-Image wird als Datenträger erzeugt
	** das openwrt-Image sollte vom Type ''x86-combined-squashfs'' sein (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/~~0.5.1~~/x86/openwrt-x86-generic-combined-squashfs.img.gz]])		** das openwrt-Image sollte vom Type ''x86-combined-squashfs'' (warum?) sein (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/latest/x86/openwrt-x86-generic-combined-squashfs.img.gz]])
	*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)		*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)
	** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)		** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)

MathiasMahnke: /* OpenWRT-Host anlegen */

2017-05-07T18:12:29Z

OpenWRT-Host anlegen

← Nächstältere Version		Version vom 7. Mai 2017, 18:12 Uhr
Zeile 40:		Zeile 40:
	* der Hostname (''foo'') wird für die Namen der LVM-Volumes und des libvirt-Hosts verwendet		* der Hostname (''foo'') wird für die Namen der LVM-Volumes und des libvirt-Hosts verwendet

	== ~~OpenWRT~~-Host anlegen ==		== OpenWrt-Host anlegen ==
	<code>vhost-admin.sh create-ap ap1-23 192.168.1.23</code>		<code>vhost-admin.sh create-ap ap1-23 192.168.1.23</code>
	** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet		** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet

Lars: Präzisierung der Konfiguration

2017-05-07T12:23:50Z

Präzisierung der Konfiguration

← Nächstältere Version		Version vom 7. Mai 2017, 12:23 Uhr
Zeile 7:		Zeile 7:

	= Einrichtung =		= Einrichtung =
	Die [[Server_Installation/Ansible\|ansible-Rolle]] ''virtualization-server'' sorgt für die Installation der notwendigen Pakete, die Übertragung des ''vhost-admin''-Skripts, sowie (einmalig) die Übertragung eines libvirt-Templates für neue Hosts. Beachte die [[Server_Installation/Ansible#virtualization-server\|Dokumentation der ansible-Rolle]] für eventuell erforderliche ansible-Host-Variablen (z.B. ~~den~~ ~~Namen~~ der ~~LVM~~-~~Gruppe~~).		Die [[Server_Installation/Ansible\|ansible-Rolle]] ''virtualization-server'' sorgt für die Installation der notwendigen Pakete, die Übertragung des ''vhost-admin''-Skripts, sowie (einmalig) die Übertragung eines libvirt-Templates für neue Hosts. Beachte eventuell die [[Server_Installation/Ansible#virtualization-server\|Dokumentation der ansible-Rolle]] für eventuell erforderliche ansible-Host-Variablen (z.B. die Auswahl der VM-Image-Verwaltung (LVM oder Datei)).

	Folgende nachträgliche Anpassungen auf dem Virtualisierungsserver sind wahrscheinlich empfehlenswert:		Folgende nachträgliche Anpassungen auf dem Virtualisierungsserver sind wahrscheinlich empfehlenswert:

Lars: Beschreibung des vhost-manage-Skripts

2017-05-07T12:08:22Z

Beschreibung des vhost-manage-Skripts

Neue Seite

= Überblick =
Wir verwenden auf Opennet-Virtualisierungsserver (siehe [[Opennet Server]]) ein (selbsterstelltes) Skript zur vereinfachten Verwaltung von virtuellen Hosts. Dies erlaubt uns die Erzeugung und Löschung von VMs via Komandozeile.

Das Skript geht von folgenden Voraussetzungen aus:
* KVM-basierte Virtualisierung (via libvirt)
* Ablage der Host-Dateisysteme: LVM oder einfache Datei-Images

= Einrichtung =
Die [[Server_Installation/Ansible|ansible-Rolle]] ''virtualization-server'' sorgt für die Installation der notwendigen Pakete, die Übertragung des ''vhost-admin''-Skripts, sowie (einmalig) die Übertragung eines libvirt-Templates für neue Hosts. Beachte die [[Server_Installation/Ansible#virtualization-server|Dokumentation der ansible-Rolle]] für eventuell erforderliche ansible-Host-Variablen (z.B. den Namen der LVM-Gruppe).

Folgende nachträgliche Anpassungen auf dem Virtualisierungsserver sind wahrscheinlich empfehlenswert:
* Bridge für das Mesh-Interface konfigurieren:
auto br-mesh
iface br-mesh inet static
address 192.168.10.6
netmask 255.255.0.0
bridge_ports none
* Bridge für das WAN-Interface konfigurieren, falls die VMs direkt mit diesem Netz verbunden werden sollen:
auto br-wan
iface br-wan inet static
address 139.30.241.XXX
netmask 255.255.255.0
gateway 139.30.241.1
bridge_ports eth0
iface br-wan inet6 auto
* eventuell in der Datei ''/etc/libvirt/qemu/_template.xml'' Anpassungen vornehmen (z.B. Anpassung der Bridge-Namen oder Hinzufügen der optionalen WAN-Bridge)

= Anlegen oder Löschen von Hosts =
Das Skript ''vhost-admin.sh'' ermöglicht die vereinfachte Erzeugung und Löschung virtueller Hosts.

== Debian-Host anlegen ==
<code>vhost-admin.sh create-debian foo 192.168.5.23</code>
* ein Debian-basiertes System wird via ''debootstrap'' auf einem LVM-Volume vorbereitet
* Netzwerk wird vorkonfiguriert:
** eth0: oben angegebene IP-Adresse (Bridge ins opennet-VLAN in der Frieda)
*** die IP muss zuvor unter [[Server]] reserviert werden
** eth1: DHCP-Client (nur wirksam, falls eine WAN-Bridge vorhanden ist)
** olsrd: automatischer Start für eth0
* root-Schlüssel des Virtualisierungsservers wird importiert
* der Hostname (''foo'') wird für die Namen der LVM-Volumes und des libvirt-Hosts verwendet

== OpenWRT-Host anlegen ==
<code>vhost-admin.sh create-ap ap1-23 192.168.1.23</code>
** ein openwrt-basiertes System wird mittels eines herunterzuladenden Images vorbereitet
*** das Image kann auch als Firmware-Release-Version angegeben werden (z.B. ''0.4.5'')
** ein LVM-Image wird als Datenträger erzeugt
** das openwrt-Image sollte vom Type ''x86-combined-squashfs'' sein (z.B. [[http://downloads.opennet-initiative.de/openwrt/stable/0.5.1/x86/openwrt-x86-generic-combined-squashfs.img.gz]])
*** lokale Dateien können via <code>file://DATEINAME</code> referenziert werden (siehe <code>man curl</code>)
** das Skript konfiguriert die Netzwerk-Interfaces des AP entsprechend der eingebundenen Hausnetze (eth0: olsr-Mesh, kein LAN)
** nach dem Starten des virtuellen Hosts (<code>virsh start ap1-23</code>) ist er unter der gewählten IP in der gesamten OLSR-Wolke erreichbar
*** die IP muss zuvor unter [[Opennet_Nodes]] reserviert werden

== Host löschen ==
<code>vhost-admin.sh remove ap1-23</code>
** das virtuelle System (debian- oder openwrt-basiert) wird gestoppt und inklusive der LVM-Images ohne Nachfrage gelöscht