MegBes Wiki - Benutzerbeiträge [de]

Hauptseite

2026-08-04T20:49:22Z

Clawtronics: Ausführliche Installations- und Wartungsanleitungen verlinkt

__NOTOC__
= MegBes-Wiki =

'''MegBes''' ist ein System zur Steuerung von Medienstationen und anderen Geräten in Ausstellungen. Es kann grundsätzlich alle Geräte ansprechen, die UDP-Signale direkt empfangen oder über eine geeignete Schnittstelle umsetzen können, beispielsweise BrightSign-Player, PCs und Raspberry Pis.

== Systemüberblick ==

Der typische Signalweg lautet:

Web-Frontend oder App → megbes-external → megbes-internal → UDP → Medienstation

* [[Architektur|Architektur und Signalweg]]
* [[Komponenten|Komponenten des Systems]]
* [[Betrieb und Releases|Betrieb, Ubuntu und Releases]]
* [[Projektübersicht|Aktive Projekte]]
* [[Sicherheit|Sicherheits- und Dokumentationsregeln]]

== Einrichtung und Betrieb ==

Die folgenden Bereiche werden aus der bisherigen Dokumentation überarbeitet und schrittweise ergänzt:

* [[Neukunde|Neukunde / neues Projekt]]
* [[Megbes-internal|megbes-internal installieren und starten]]
* [[Ubuntu aktualisieren|Ubuntu regelmäßig aktualisieren]]
* [[Ubuntu-LTS-Upgrade|Ubuntu auf die nächste LTS-Version aktualisieren]]
* [[Feste IP-Adresse unter Ubuntu|feste IP-Adresse unter Ubuntu]]
* [[Docker installieren|Docker auf Ubuntu installieren]]
* Konfiguration von megbes-external unter Plesk
* Netzwerk, Routing und DynDNS
* Zertifikate
* Medienstationen und Ausstellungshardware
* Wartung, Backups und Fehlerdiagnose

== Aktueller Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Nicht alle Projekte verwenden bereits diesen Stand. Der tatsächlich installierte Release wird deshalb je Projekt dokumentiert. Maßgebliche technische Quelle ist das private GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes].

== Wichtiger Hinweis ==

Passwörter, Tokens, private Schlüssel, vollständige Zugangsdaten und geheime Update-URLs dürfen nicht im Wiki gespeichert werden. Siehe [[Sicherheit]].

[[Kategorie:MegBes]]

== Technische Referenz ==

* [[Softwaremodule|Softwaremodule und Build]]
* [[Konfiguration|Projektkonfiguration]]
* [[UDP und Stationszustände|UDP und Stationszustände]]

Megbes-internal

2026-08-04T20:48:41Z

Clawtronics: Ausführliche DAU-sichere Arbeitsanleitung angelegt

= megbes-internal installieren und starten =

Diese Anleitung beschreibt die projektspezifische Einrichtung von `megbes-internal` auf dem Server beim Kunden. Sie setzt eine installierte aktuelle Ubuntu-LTS-Version, eine feste IP-Adresse und eine funktionierende Docker-Installation voraus.

== Voraussetzungen ==

* [[Ubuntu aktualisieren|Ubuntu ist vollständig aktualisiert]]
* [[Feste IP-Adresse unter Ubuntu|feste lokale IP-Adresse ist eingerichtet und getestet]]
* [[Docker installieren|Docker ist installiert und mit `hello-world` geprüft]]
* Projekt ist in `megbes-config` eingetragen
* External-Adresse, Internal-Port, Subnetz, UDP-Port und Stations-Timer sind festgelegt
* projektbezogene Zertifikate sind erzeugt
* freizugebender MegBes-Release ist festgelegt

== 1. Projektwerte sammeln ==

Vor dem ersten Befehl diese Tabelle in der Projektseite ausfüllen:

{| class="wikitable"
! Wert
! Projektwert
|-
| technisches Projektkürzel ||
| Linux-Benutzername ||
| Container-Name ||
| Host-TCP-Port ||
| Container-TCP-Port || 8080
|-
| UDP-Port ||
| lokales Subnetz ohne letzte Hostnummer ||
| Pfad der Umgebungsdatei ||
| Pfad des Zertifikatsordners ||
| Docker-Image || `tinetronics/megbes-internal`
|-
| Release ||
| projektspezifischer Stations-Timer ||
|}

== 2. Ordner anlegen ==

Beispiel – Platzhalter ersetzen:

mkdir -p /home/<Benutzer>/megbes/<Projekt>/certs
chmod 700 /home/<Benutzer>/megbes/<Projekt>/certs

Kontrolle:

ls -ld /home/<Benutzer>/megbes/<Projekt>/certs

== 3. Umgebungsdatei anlegen ==

Datei öffnen:

nano /home/<Benutzer>/megbes/<Projekt>/<Projekt>.env

Bereinigte Vorlage:

LOCALNETWORK_SUB_NETWORK=<lokales-Subnetz>
LOCALNETWORK_UDP_PORT=<UDP-Port>
MEGBES_SSL=true
MNGMT_HEADER=<Name-des-Management-Headers>
MNGMT_KEY=<im-Passwortmanager>
MAIL_SMTP_PORT=<SMTP-Port>
MAIL_SMTP_HOST=<SMTP-Server>
MAIL_SENDER_ADDRESS=<Absenderadresse>
MAIL_SENDER_PASSWORD=<im-Passwortmanager>
MAIL_RECIPIENTADDRESSES=<Empfaengeradresse>
SERVER_SSL_KEYSTORE=/opt/app/keys/keystore.jks
SERVER_SSL_KEYSTOREPASSWORD=<im-Passwortmanager>
SERVER_SSL_KEYSTORETYPE=JKS
SERVER_SSL_TRUSTSTORE=/opt/app/keys/truststore.jks
SERVER_SSL_TRUSTSTOREPASSWORD=<im-Passwortmanager>
SERVER_SSL_CLIENTAUTH=need
MEGBES_INTERNAL_STATION_CONTROLLED=<true-oder-false>
STATION_TIMER_SECONDS=<Projektwert>

Die Schreibweise der Variablennamen nicht verändern. Platzhalter vollständig ersetzen. Keine Kommentare hinter Werte schreiben, sofern nicht sicher bekannt ist, dass die Laufzeit sie unterstützt.

Datei schützen:

chmod 600 /home/<Benutzer>/megbes/<Projekt>/<Projekt>.env
ls -l /home/<Benutzer>/megbes/<Projekt>/<Projekt>.env

Erwartete Rechte sind `-rw-------`.

== 4. Zertifikate übertragen ==

Key- und Truststore in den Zertifikatsordner kopieren, beispielsweise mit WinSCP. Danach auf dem Server prüfen:

ls -l /home/<Benutzer>/megbes/<Projekt>/certs

Die in der Umgebungsdatei genannten Dateinamen müssen exakt mit den übertragenen Dateien übereinstimmen. Groß-/Kleinschreibung ist unter Linux relevant.

Dateien vor unberechtigtem Zugriff schützen:

chmod 600 /home/<Benutzer>/megbes/<Projekt>/certs/*

== 5. Bei Docker Hub anmelden, falls erforderlich ==

docker login --username <Docker-Benutzername>

Das Passwort wird anschließend verdeckt abgefragt. Es darf nicht direkt in die Befehlszeile geschrieben werden. Falls das Image ohne Anmeldung geladen werden kann, ist dieser Schritt nicht erforderlich.

== 6. Gewünschtes Image laden ==

docker pull tinetronics/megbes-internal:<RELEASE>

Beispiel für den aktuellen Release-Namen:

docker pull tinetronics/megbes-internal:AUGUST-2026-2-RELEASE

Vor dem produktiven Einsatz muss geprüft sein, ob dieses Projekt tatsächlich diesen Release erhalten soll.

Kontrolle:

docker image ls tinetronics/megbes-internal

== 7. Container starten ==

Allgemeine Vorlage – jeden Platzhalter ersetzen:

docker run -d \
--restart unless-stopped \
-p <HOST-TCP-PORT>:8080 \
-p <UDP-PORT>:<UDP-PORT>/udp \
--env-file /home/<Benutzer>/megbes/<Projekt>/<Projekt>.env \
--name megbes-internal-<Projekt> \
-v /home/<Benutzer>/megbes/<Projekt>/certs:/opt/app/keys \
tinetronics/megbes-internal:<RELEASE>

Vor Enter die fertige Befehlszeile mit den Projektwerten vergleichen. Keine Vorlage eines anderen Kunden ungeprüft übernehmen.

== Bedeutung der Parameter ==

; `docker run -d`
: Erstellt und startet den Container im Hintergrund.

; `--restart unless-stopped`
: Startet den Container nach Docker- oder Serverneustarts automatisch, außer er wurde zuvor bewusst manuell gestoppt.

; `-p <HOST-TCP-PORT>:8080`
: Leitet den projektspezifischen TCP-Port des Servers auf Port 8080 im Container.

; `-p <UDP-PORT>:<UDP-PORT>/udp`
: Stellt den UDP-Port für Status- und Init-Meldungen bereit. Host-, Container- und Umgebungswert müssen zusammenpassen.

; `--env-file ...`
: Übergibt die geschützte Projektkonfiguration.

; `--name ...`
: Vergibt einen eindeutigen Container-Namen.

; `-v ...:/opt/app/keys`
: Bindet den Zertifikatsordner des Servers in den Container ein.

; `tinetronics/megbes-internal:<RELEASE>`
: Legt Image und Release fest.

== 8. Start kontrollieren ==

docker ps

Der neue Container muss mit dem Zustand `Up` erscheinen.

Logs prüfen:

docker logs --tail 100 megbes-internal-<Projekt>

Bei fortlaufender Anzeige:

docker logs --follow megbes-internal-<Projekt>

Mit `Strg+C` wird nur die Loganzeige beendet, nicht der Container.

== 9. Konfiguration kontrollieren ==

Neustartregel:

docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' megbes-internal-<Projekt>

Erwartet:

unless-stopped

Portzuordnungen:

docker port megbes-internal-<Projekt>

Eingebundene Ordner:

docker inspect -f '{{json .Mounts}}' megbes-internal-<Projekt>

Inspect-Ausgaben können interne Pfade und Konfigurationsdetails enthalten; nicht ungeprüft ins Wiki kopieren.

== 10. Funktionstest ==

# Erreichbarkeit vom vorgesehenen External-System testen.
# Status-Monitor prüfen.
# abgestimmten ungefährlichen Stationsbefehl senden.
# prüfen, dass ausschließlich die richtige Station reagiert.
# Init-/Statusmeldung testen.
# bei stationsgesteuerten Projekten Zustände und Timer prüfen.

== 11. Neustarttest ==

sudo reboot

Nach erneuter Anmeldung:

systemctl status docker --no-pager
docker ps
docker logs --tail 100 megbes-internal-<Projekt>

Container und Kommunikation müssen automatisch wieder funktionieren.

== Typische Fehler ==

; Container erscheint nicht in `docker ps`
: Mit `docker ps -a` auch beendete Container anzeigen und anschließend Logs lesen.

; `port is already allocated`
: Der gewählte Host-Port ist bereits belegt. Mit `docker ps` und `sudo ss -lntup` prüfen; keinen zufälligen anderen Port wählen, ohne External-Konfiguration und Router anzupassen.

; Zertifikatsfehler
: Dateinamen, Mount-Pfad, Kennwörter und Zuordnung zum Projekt prüfen.

; Image kann nicht geladen werden
: Release-Schreibweise und Docker-Hub-Anmeldung prüfen.

; Neustartschleife
: `docker ps -a` und `docker logs` prüfen. Nicht wiederholt neue Container mit anderen Namen erzeugen.

== Projektdokumentation ==

Container-Name, Ports, Subnetz, Release, Dateipfade, Stations-Timer, Installationsdatum und Testergebnis auf der Projektseite eintragen. Geheimwerte ausschließlich im Passwortmanager speichern.

[[Kategorie:MegBes]]
[[Kategorie:megbes-internal]]
[[Kategorie:Installation]]

Ubuntu-LTS-Upgrade

2026-08-04T20:48:41Z

Clawtronics: Ausführliche DAU-sichere Arbeitsanleitung angelegt

= Ubuntu-LTS-Upgrade =

Ein LTS-Upgrade wechselt den Server auf die nächste Ubuntu-LTS-Version. Es ist deutlich umfangreicher als eine normale Aktualisierung mit `apt upgrade` und benötigt Backup, Wartungsfenster und vollständigen MegBes-Funktionstest.

Grundlage ist die [https://documentation.ubuntu.com/server/how-to/software/upgrade-your-release/ offizielle Ubuntu-Anleitung]. Es kann immer nur auf die jeweils nächste LTS-Version aktualisiert werden; LTS-Versionen dürfen nicht übersprungen werden.

== Nicht spontan durchführen ==

Vor dem Upgrade erforderlich:

* ausdrückliches Wartungsfenster
* Zugriff auf lokale Konsole oder gesicherter Vor-Ort-Zugriff
* aktuelle Sicherung von Konfigurationen, Zertifikaten und persistenten Daten
* dokumentierte Container, Images, Ports und Volumes
* ausreichend freier Speicherplatz
* geprüfter Rückweg oder Neuinstallationsplan

== 1. Ausgangszustand erfassen ==

lsb_release -a
uname -r
df -h
sudo docker ps -a
sudo docker images
sudo docker volume ls
sudo docker inspect <Containername> > <Projekt>-container-inspect.json

Die erzeugte Inspect-Datei kann sensible Umgebungswerte enthalten. Sie geschützt ablegen und nicht ins Wiki kopieren.

== 2. Backup erstellen und prüfen ==

Mindestens sichern:

* projektspezifische Umgebungsdatei
* Zertifikatsordner
* Container-Startbefehl beziehungsweise Inspect-Daten
* persistente Docker-Volumes, sofern vorhanden
* Netplan-Konfiguration
* weitere kundenspezifische Skripte

Ein `docker export` allein ist kein vollständiges Backup von Volumes oder Host-Dateien.

== 3. Aktuelles Release vollständig aktualisieren ==

sudo apt update
sudo apt dist-upgrade -o APT::Get::Always-Include-Phased-Updates=true

Beide Befehle müssen ohne Fehler enden. Danach Neustartbedarf prüfen und gegebenenfalls neu starten:

if [ -f /run/reboot-required ]; then sudo reboot; fi

Nach dem Neustart Docker und MegBes erneut prüfen.

== 4. Upgrade-Paket sicherstellen ==

sudo apt install update-manager-core

Prüfen, ob nur LTS-Upgrades angeboten werden:

grep '^Prompt=' /etc/update-manager/release-upgrades

Für Produktionsserver soll normalerweise erscheinen:

Prompt=lts

== 5. Release-Upgrade starten ==

sudo do-release-upgrade

Den Prozess nicht unbeaufsichtigt lassen. Vor der endgültigen Bestätigung zeigt Ubuntu geplante Installationen und Entfernungen an.

Bei Fragen zu geänderten Konfigurationsdateien nicht blind antworten. Angepasste Netzwerk-, SSH- oder Docker-Konfigurationen im Zweifel behalten und die betroffene Datei notieren.

Die Option `-d` für Entwicklungs-Releases darf auf Produktivsystemen nicht verwendet werden.

== 6. Neustart durchführen ==

Am Ende fordert Ubuntu zu einem Neustart auf. Erst danach ist das Upgrade abgeschlossen.

sudo reboot

== 7. Nachprüfung ==

lsb_release -a
uname -r
systemctl --failed
sudo systemctl status docker --no-pager
sudo docker ps
sudo docker logs --tail 100 <Containername>

Danach den vollständigen MegBes-Funktionstest durchführen:

# External erreicht Internal.
# Testbefehl erreicht die richtige Station.
# Stationsstatus funktioniert.
# Zertifikatsverbindung funktioniert.
# Status-Monitor meldet das Projekt erreichbar.
# Server- und Container-Neustart funktionieren.

== 8. Docker-Paketquelle prüfen ==

Während eines LTS-Upgrades können fremde Paketquellen deaktiviert werden. Prüfen:

sudo apt update
apt policy docker-ce

Docker nicht neu installieren, wenn die vorhandene Installation und die Container funktionieren. Eine Änderung erst nach Sicherung und Prüfung durchführen.

== Dokumentation ==

Auf der Projektseite eintragen:

* alte und neue Ubuntu-Version
* Datum und Wartungsfenster
* Backup-Ablage
* Besonderheiten während des Upgrades
* Docker-Version und Containerstatus
* Ergebnis aller Funktionstests

[[Kategorie:MegBes]]
[[Kategorie:Ubuntu]]
[[Kategorie:Wartung]]

Feste IP-Adresse unter Ubuntu

2026-08-04T20:48:41Z

Clawtronics: Ausführliche DAU-sichere Arbeitsanleitung angelegt

= Feste IP-Adresse unter Ubuntu =

Diese Anleitung beschreibt die dauerhafte Vergabe einer festen IPv4-Adresse auf einem Ubuntu-LTS-Server mit Netplan. Sie basiert auf der [https://documentation.ubuntu.com/server/explanation/networking/configuring-networks/ offiziellen Ubuntu-Netzwerkdokumentation].

'''Warnung:''' Eine falsche Netzwerkkonfiguration kann die SSH-Verbindung sofort unterbrechen. Wenn möglich, die Änderung an der lokalen Konsole durchführen oder sicherstellen, dass jemand vor Ort Zugriff auf Tastatur und Bildschirm hat.

== Voraussetzungen und benötigte Werte ==

Vor Beginn müssen diese projektspezifischen Werte bekannt sein:

* Name der Netzwerkschnittstelle, zum Beispiel `enp1s0`
* gewünschte IP-Adresse mit Präfix, zum Beispiel `<IP-Adresse>/24`
* Standard-Gateway, meist die Adresse des Routers
* mindestens ein DNS-Server
* Bestätigung, dass die IP-Adresse nicht bereits verwendet wird

Beispielwerte aus anderen Kundenprojekten dürfen nicht ungeprüft übernommen werden.

== 1. Aktuellen Zustand erfassen ==

ip address
ip route
sudo netplan status -a

Den Namen der tatsächlich verbundenen Schnittstelle notieren. `lo` ist nur die interne Loopback-Schnittstelle und darf nicht verwendet werden.

Vorhandene Netplan-Dateien anzeigen:

ls -l /etc/netplan

Inhalt sichern:

sudo cp -a /etc/netplan /etc/netplan.backup-$(date +%Y%m%d-%H%M%S)

== 2. Freie IP-Adresse sicherstellen ==

Die Adresse mit Kundennetz-Dokumentation und Router abgleichen. Zusätzlich kann vor der Vergabe getestet werden:

ping -c 4 <geplante-IP-Adresse>

Keine Antwort beweist nicht sicher, dass die Adresse frei ist; manche Geräte beantworten keinen Ping. Die Router-/DHCP-Liste bleibt maßgeblich.

== 3. Netplan-Datei bearbeiten ==

Eine eindeutige Datei anlegen:

sudo nano /etc/netplan/99-megbes-static.yaml

Beispiel – alle Werte in spitzen Klammern ersetzen:

network:
version: 2
renderer: networkd
ethernets:
<Schnittstelle>:
dhcp4: false
addresses:
- <IP-Adresse>/<Praefix>
routes:
- to: default
via: <Gateway-Adresse>
nameservers:
addresses:
- <DNS-Server-1>
- <DNS-Server-2>

Typischer Präfix für ein Netz mit der Maske `255.255.255.0` ist `/24`. Dies ist aber vor Ort zu prüfen.

In `nano` speichern mit `Strg+O`, Enter und schließen mit `Strg+X`.

Dateirechte setzen:

sudo chmod 600 /etc/netplan/99-megbes-static.yaml

== 4. Syntax prüfen ==

sudo netplan generate

Wenn keine Ausgabe erscheint, wurde die Syntax grundsätzlich akzeptiert. Bei YAML-Fehlern Einrückung und Doppelpunkte kontrollieren. YAML verwendet Leerzeichen, keine Tabulatoren.

== 5. Konfiguration sicher testen ==

sudo netplan try

Netplan aktiviert die neue Konfiguration vorübergehend und wartet auf eine Bestätigung. Bleibt die Verbindung bestehen und funktionieren die Tests, innerhalb der angezeigten Frist mit Enter bestätigen. Bei Verlust der Verbindung wird die Änderung normalerweise automatisch zurückgerollt.

Von einem zweiten Fenster aus testen:

ping -c 4 <Gateway-Adresse>
getent hosts download.docker.com

== 6. Dauerhaften Zustand kontrollieren ==

ip address show <Schnittstelle>
ip route
resolvectl status <Schnittstelle>

Erwartet werden:

* die geplante IP-Adresse
* eine Default-Route über den vorgesehenen Router
* die eingetragenen DNS-Server

== 7. Neustarttest ==

sudo reboot

Danach über die neue Adresse anmelden und erneut prüfen:

ip address
ip route
getent hosts download.docker.com

== Typische Fehler ==

; SSH-Verbindung verloren
: Ablauf von `netplan try` abwarten. Falls keine Rückkehr erfolgt, lokale Konsole verwenden und die Sicherung unter `/etc/netplan.backup-...` wiederherstellen.

; `Permissions for ... are too open`
: `sudo chmod 600 /etc/netplan/99-megbes-static.yaml` ausführen.

; YAML-Fehler
: ausschließlich Leerzeichen verwenden und Einrückung exakt prüfen.

; IP funktioniert lokal, Internetnamen nicht
: DNS-Einträge und `resolvectl status` prüfen.

== Dokumentation ==

Auf der Projektseite festhalten:

* Schnittstellenname
* IP-Adresse und Präfix
* Gateway und DNS-Server
* Name der Netplan-Datei
* Datum des Neustarttests

[[Kategorie:MegBes]]
[[Kategorie:Ubuntu]]
[[Kategorie:Netzwerk]]

Neukunde

2026-08-04T20:45:08Z

Clawtronics: Interne Servereinrichtung mit konkreten Befehlen und Prüfungen erweitert

= Neukunde / neues Projekt =

Diese Seite beschreibt den vollständigen Ablauf zur Einrichtung eines neuen MegBes-Kunden beziehungsweise eines neuen Projekts. Projektspezifische Werte werden zunächst gesammelt und anschließend in den jeweils maßgeblichen Systemen eingetragen.

'''Wichtig:''' Passwörter, Tokens, private Schlüssel und geheime Update-URLs dürfen nicht auf dieser Seite oder einer Projektseite gespeichert werden. Dafür ist ausschließlich der vorgesehene Passwortmanager zu verwenden.

== 1. Projekt festlegen ==

Vor Beginn sind mindestens zu bestimmen:

* vollständiger Projekt- und Kundenname
* eindeutiges technisches Projektkürzel
* zuständige Personen bei tinetronics
* gewünschte Bedienoberfläche
* Art der Anmeldung:
** Anmeldung über Ticket-Monitor
** direkter Zugriff ohne Ticket-Monitor, wie beim Subprojekt MiQua Guide
** gegebenenfalls weitere projektspezifische Variante
* Anzahl und Art der Medienstationen
* Stationsnummern und benötigte UDP-Befehle
* lokales Subnetz und gewünschter UDP-Port
* projektspezifischer Stations-Timer

Anschließend eine neue Seite in der [[Projektübersicht]] anlegen.

== 2. Domains und Erreichbarkeit ==

Im Regelfall werden zwei Adressen benötigt:

; Externe Adresse
: Subdomain für `megbes-external`, beispielsweise `<projekt>.megbes.de`.

; Interne Erreichbarkeit
: DynDNS-Adresse oder eine andere dauerhaft erreichbare Adresse für `megbes-internal`, beispielsweise `<projekt>-dyndns.megbes.de`.

Für die externe Subdomain ist der DNS-Eintrag auf den zentralen Plesk-Server zu richten. Die konkrete Zieladresse muss vor der Einrichtung anhand der aktuellen IONOS-/Plesk-Konfiguration geprüft werden und wird nicht als allgemeiner Festwert im Wiki hinterlegt.

Für die interne Seite wird bevorzugt IONOS DynDNS eingesetzt. Alternative Anbieter sind nur zu verwenden, wenn dies technisch erforderlich ist.

== 3. Projektkonfiguration in GitHub ==

Im privaten Repository `tinetronics/megbes-config` sind die produktiven Konfigurationen anzupassen.

=== megbes-external-config.json ===

Für das Projekt werden mindestens gepflegt:

* technischer Projektschlüssel
* Kommunikationsprotokoll zum internen Server
* Adresse von `megbes-internal`
* Port von `megbes-internal`
* bei Projekten mit zentraler Anmeldung: initialer Administratorname und verschlüsseltes Administratorpasswort

Das Administratorpasswort darf niemals im Klartext eingetragen werden. Die Verschlüsselung erfolgt mit dem vorgesehenen Werkzeug des Status-Monitors.

=== megbes-status-config.json ===

Das Projekt wird zusätzlich mit seiner internen und externen Adresse in die Status-Konfiguration aufgenommen.

=== Prüfung ===

# JSON-Syntax prüfen.
# Änderungen nachvollziehbar committen.
# Änderungen über den vereinbarten Git-Prozess bereitstellen.
# Nach der Übernahme die betroffenen Dienste kontrolliert neu laden.

Siehe auch [[Konfiguration]].

== 4. megbes-external unter Plesk ==

Für jedes Projekt wird auf dem zentralen IONOS-Server ein eigener Docker-Container betrieben.

# Neue externe Subdomain in Plesk anlegen.
# TLS-Zertifikat für die Subdomain einrichten.
# Docker-Container aus dem freigegebenen `megbes-external`-Image erstellen.
# Container eindeutig nach dem Projekt benennen.
# automatischen Start nach einem Serverneustart aktivieren.
# erforderliche Umgebungsvariablen anhand der aktuellen freigegebenen Vorlage setzen.
# Zertifikatsdateien beziehungsweise Volumes korrekt einbinden.
# automatische Portzuordnung nach der initialen Einrichtung deaktivieren.
# Docker-Proxy-Regel von der Subdomain auf den Container einrichten.
# Container starten und Protokoll auf Fehler prüfen.

Der einzusetzende Release wird bewusst festgelegt. Ein neuer Kunde erhält grundsätzlich den aktuell freigegebenen Release, sofern kein bekannter projektspezifischer Grund dagegenspricht.

== 5. Zertifikate ==

Projektbezogene Zertifikate werden über den Status-Monitor erstellt und entsprechend der dortigen Anleitung installiert.

Zu prüfen sind:

* Zertifikat gehört zum richtigen Projekt und zur richtigen Adresse.
* Zertifikatsdateien liegen am vorgesehenen Ablageort.
* Container-Volume zeigt auf den korrekten Ordner.
* Kennwörter sind ausschließlich im Passwortmanager und in der geschützten Laufzeitkonfiguration hinterlegt.
* Verbindung wird nach dem Neustart erfolgreich getestet.

== 6. Interner Server beim Kunden ==

Für jedes Projekt wird beim Kunden ein eigener Server für `megbes-internal` eingerichtet. Die folgenden Schritte sind in dieser Reihenfolge abzuarbeiten.

=== 6.1 Ubuntu installieren und anmelden ===

Die jeweils aktuelle Ubuntu-LTS-Version installieren. Während der Installation:

* eindeutigen Servernamen nach dem Projektschema vergeben
* Administrationsbenutzer anlegen
* OpenSSH-Server installieren
* keine unnötigen Zusatzpakete auswählen
* Installationsmedium nach Aufforderung entfernen

Nach dem Neustart lokal oder per SSH anmelden.

=== 6.2 Aktuelle Ubuntu-Version prüfen ===

lsb_release -a

Falls der Befehl fehlt:

cat /etc/os-release

Prüfen, ob tatsächlich die vorgesehene LTS-Version installiert ist.

=== 6.3 System vollständig aktualisieren ===

Zuerst aktuelle Paketlisten abrufen:

sudo apt update

Der Befehl muss ohne Zeilen mit `E:` oder `Error` enden. Danach verfügbare Aktualisierungen installieren:

sudo apt upgrade

Die Paketliste prüfen und die Rückfrage mit `Y` beziehungsweise `J` bestätigen. Nach Abschluss den Neustartbedarf prüfen:

if [ -f /run/reboot-required ]; then cat /run/reboot-required; else echo "Kein Neustart erforderlich"; fi

Falls ein Neustart erforderlich ist:

sudo reboot

Danach neu anmelden und prüfen:

systemctl --failed

Die vollständige Anleitung einschließlich Fehlerbehandlung und Funktionstest steht unter [[Ubuntu aktualisieren]].

=== 6.4 Feste lokale IP-Adresse einrichten ===

Die Netzwerkschnittstelle, IP-Adresse, Netzmaske, Gateway und DNS-Server anhand der Kundennetz-Dokumentation bestimmen. Keine Beispieladresse ungeprüft übernehmen. Die konkrete Anleitung folgt unter [[Feste IP-Adresse unter Ubuntu]].

Nach der Änderung Verbindung, Gateway und DNS testen:

ip address
ip route
ping -c 4 <Gateway-Adresse>
getent hosts download.docker.com

=== 6.5 Docker installieren ===

Docker aus der offiziellen Docker-Paketquelle installieren. Nicht mehr die veraltete GPG-/Repository-Anleitung aus dem Word-Dokument verwenden.

Die vollständige Schrittfolge steht unter [[Docker installieren]]. Abschließend müssen diese Prüfungen erfolgreich sein:

docker --version
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world

=== 6.6 Projektordner vorbereiten ===

Einen eindeutig benannten Ordner für die geschützten Zertifikatsdateien anlegen. Beispiel – Benutzer und Projektkürzel anpassen:

mkdir -p /home/<Benutzername>/certs/<Projektkürzel>
chmod 700 /home/<Benutzername>/certs/<Projektkürzel>

Anschließend kontrollieren:

ls -ld /home/<Benutzername>/certs/<Projektkürzel>

=== 6.7 Projektbezogene Dateien übertragen ===

Benötigt werden mindestens:

* projektspezifische Umgebungsdatei
* Key- und Truststore beziehungsweise aktuell verwendete Zertifikatsdateien
* dokumentierter Container-Name
* festgelegter External-/Internal-Port
* UDP-Port und lokales Subnetz
* freigegebener Release

Dateien nach dem Übertragen mit `ls -l` kontrollieren. Geheimnisdateien dürfen nicht für alle Benutzer lesbar sein.

=== 6.8 megbes-internal starten ===

Der projektspezifische Docker-Befehl wird anhand der geprüften Vorlage erstellt. Keine Befehlszeile eines anderen Kunden ungeprüft kopieren. Vor dem Start insbesondere kontrollieren:

* Container-Name
* External-zu-Container-Port
* UDP-Port
* Pfad und Name der Umgebungsdatei
* Zertifikats-Volume
* Docker-Image und Release
* Neustartregel `unless-stopped`

Die ausführliche Anleitung folgt unter [[megbes-internal]].

=== 6.9 Start prüfen ===

sudo docker ps
sudo docker logs --tail 100 <Containername>

Der Container muss `Up` sein. Wiederholte Exceptions, Zertifikats- oder Verbindungsfehler müssen vor dem nächsten Schritt behoben werden.

=== 6.10 Neustarttest ===

Server kontrolliert neu starten:

sudo reboot

Danach neu anmelden und prüfen:

sudo systemctl status docker --no-pager
sudo docker ps

Der MegBes-Container muss aufgrund der Neustartregel automatisch wieder laufen.
== 7. Router, DynDNS und Portfreigabe ==

Am Kundenrouter sind – abhängig vom Projekt – folgende Punkte einzurichten:

* feste Zuordnung für den internen Server
* DynDNS-Konfiguration
* erforderliche TCP-Portfreigabe zu `megbes-internal`
* gegebenenfalls kundenspezifische Firewall-Regeln

Der externe Port, der interne Port und die in `megbes-external-config.json` eingetragene Portnummer müssen zueinander passen.

Router-Zugangsdaten und geheime DynDNS-Update-URLs gehören ausschließlich in den Passwortmanager.

== 8. Medienstationen ==

Für jede Station sind zu erfassen:

* Stationsnummer
* Gerätetyp
* lokale IP-Adresse
* unterstützte UDP-Befehle
* verwendeter UDP-Port
* Art der Bedienung und Anmeldung
* Verhalten bei `IDLE`, `TOUCHSCREEN`, `REMOTE` und gegebenenfalls `OPEN`
* erwartete Init-/Statusmeldung

Siehe [[UDP und Stationszustände]].

== 9. Abnahme und Funktionstest ==

Vor Übergabe müssen mindestens folgende Prüfungen erfolgreich sein:

# externe Projektadresse ist per HTTPS erreichbar.
# vorgesehene Anmeldung beziehungsweise der direkte Zugriff funktioniert.
# `megbes-external` erreicht `megbes-internal`.
# Befehle erreichen die richtige Station.
# Start, Stopp und weitere projektspezifische Befehle funktionieren.
# Stationszustände und Timer verhalten sich wie vereinbart.
# Neustart von externem und internem Container wurde getestet.
# Neustart des internen Servers wurde getestet.
# Status-Monitor erkennt die Projektinstanzen.
# Status-/Init-Meldungen erreichen den vorgesehenen Empfänger.
# Fehler und Besonderheiten sind auf der Projektseite dokumentiert.

== 10. Projektdokumentation abschließen ==

Auf der Projektseite werden anschließend mindestens eingetragen:

* Domains und technische Projektschlüssel
* Container-Namen
* Ports und Netzwerkbereiche
* installierte Releases von External und Internal
* Server- und Stationshardware
* Stations-Timer
* Datum und Ergebnis des letzten Funktionstests
* Besonderheiten und offene Aufgaben
* Verweis auf die zugehörigen Einträge im Passwortmanager – niemals die Geheimwerte selbst

[[Kategorie:MegBes]]
[[Kategorie:Einrichtung]]
[[Kategorie:Checkliste]]

Docker installieren

2026-08-04T20:45:08Z

Clawtronics: Ausführliche DAU-sichere Arbeitsanleitung angelegt

= Docker installieren =

Diese Anleitung beschreibt die Installation von Docker Engine auf einem neuen Ubuntu-LTS-Server für `megbes-internal`. Sie basiert auf der [https://docs.docker.com/engine/install/ubuntu/ offiziellen Docker-Dokumentation].

== Voraussetzungen ==

* unterstützte 64-Bit-Ubuntu-LTS-Version
* Benutzerkonto mit `sudo`-Berechtigung
* funktionierende Internet- und DNS-Verbindung
* zuvor vollständig aktualisiertes System gemäß [[Ubuntu aktualisieren]]

'''Achtung bei bestehenden Servern:''' Nicht ungeprüft Docker-Pakete entfernen oder neu installieren. Auf einem bereits produktiv eingesetzten System zunächst Container, Images, Volumes und Installationsquelle erfassen.

== 1. Prüfen, ob Docker bereits installiert ist ==

docker --version

Zusätzlich:

systemctl status docker --no-pager

Wenn eine Docker-Version angezeigt wird und der Dienst läuft, nicht einfach erneut installieren. Stattdessen vorhandene Installation und Projektzustand dokumentieren.

== 2. Systemarchitektur und Ubuntu-Version prüfen ==

dpkg --print-architecture
cat /etc/os-release

Für die üblichen internen Server wird normalerweise `amd64` angezeigt. Bei Raspberry Pi kann `arm64` erscheinen.

== 3. Voraussetzungen installieren ==

sudo apt update
sudo apt install ca-certificates curl

Die Installation mit `Y` beziehungsweise `J` bestätigen, falls APT nachfragt.

== 4. Verzeichnis für Paket-Schlüssel anlegen ==

sudo install -m 0755 -d /etc/apt/keyrings

Der Befehl legt das Verzeichnis an und setzt passende Leserechte.

== 5. Offiziellen Docker-Schlüssel laden ==

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Prüfen, ob die Datei vorhanden ist:

ls -l /etc/apt/keyrings/docker.asc

Es muss eine Datei mit einer Größe größer als null Byte angezeigt werden.

== 6. Offizielle Docker-Paketquelle einrichten ==

Den folgenden Block vollständig kopieren und ausführen:

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Danach Paketlisten neu laden:

sudo apt update

=== Erfolgskriterium ===

In der Ausgabe erscheint die Docker-Paketquelle ohne Signatur- oder HTTP-Fehler.

== 7. Docker Engine installieren ==

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Die vorgeschlagenen Änderungen prüfen und bestätigen.

== 8. Docker-Dienst prüfen ==

sudo systemctl status docker --no-pager

Erwarteter Zustand:

Active: active (running)

Falls Docker nicht läuft:

sudo systemctl start docker
sudo systemctl status docker --no-pager

Autostart prüfen und gegebenenfalls aktivieren:

sudo systemctl enable docker

== 9. Testcontainer starten ==

sudo docker run --rm hello-world

Docker lädt ein kleines Testimage und startet es. Die Ausgabe muss sinngemäß `Hello from Docker!` enthalten. Durch `--rm` wird der Testcontainer nach dem Lauf automatisch entfernt.

== 10. Optional: Docker ohne sudo verwenden ==

Für den vorgesehenen Administrationsbenutzer:

sudo usermod -aG docker "$USER"

Danach vollständig abmelden und erneut anmelden. Alternativ wirkt für die aktuelle Sitzung:

newgrp docker

Anschließend testen:

docker ps

'''Sicherheitshinweis:''' Mitglieder der Gruppe `docker` besitzen praktisch weitreichende Rechte auf dem Server. Nur ausdrücklich autorisierte Administrationskonten hinzufügen.

== 11. Installationsstand dokumentieren ==

docker --version
docker compose version
sudo docker info

Für die Projektseite notieren:

* Ubuntu-Version und Architektur
* Docker-Version
* Installationsdatum
* Name des Administrationsbenutzers
* Ergebnis des `hello-world`-Tests

== Typische Fehler ==

; `Could not resolve host`
: Internetverbindung und DNS prüfen.

; `NO_PUBKEY` oder Signaturfehler
: Schlüsseldatei und `Signed-By`-Pfad kontrollieren; nicht mit unsicheren APT-Optionen umgehen.

; `permission denied while trying to connect to the Docker daemon socket`
: Befehl zunächst mit `sudo` ausführen oder Gruppenmitgliedschaft nach vollständiger Neuanmeldung prüfen.

; Docker startet nicht
: Details anzeigen:

sudo journalctl -u docker --no-pager -n 100

Fehler nicht durch Löschen von `/var/lib/docker` „beheben“; dort können produktive Images, Container und Volumes liegen.

== Nächster Schritt ==

Nach erfolgreicher Installation folgt die Einrichtung von [[megbes-internal]].

[[Kategorie:MegBes]]
[[Kategorie:Docker]]
[[Kategorie:Installation]]

Ubuntu aktualisieren

2026-08-04T20:45:08Z

Clawtronics: Ausführliche DAU-sichere Arbeitsanleitung angelegt

= Ubuntu aktualisieren =

Diese Anleitung beschreibt die regelmäßige Aktualisierung eines bestehenden Ubuntu-Servers innerhalb derselben Ubuntu-Version, beispielsweise Ubuntu 24.04 LTS. Ein Wechsel auf die nächste LTS-Version ist ein größerer Eingriff und wird getrennt unter [[Ubuntu-LTS-Upgrade]] dokumentiert.

Die Befehle orientieren sich an der [https://documentation.ubuntu.com/server/how-to/software/package-management/ offiziellen Ubuntu-Server-Dokumentation].

== Voraussetzungen ==

* Zugriff auf die lokale Konsole oder per SSH
* Benutzerkonto mit `sudo`-Berechtigung
* funktionierende Internetverbindung
* bei einem laufenden Kundensystem: vereinbartes Wartungsfenster
* bekannte Container-Namen und aktueller Betriebszustand

'''Nicht während des Ausstellungsbetriebs beginnen.''' Updates können Dienste neu starten oder einen Neustart des Servers erforderlich machen.

== 1. Am Server anmelden ==

Bei einer SSH-Verbindung wird auf dem eigenen Rechner beispielsweise eingegeben:

ssh <Benutzername>@<IP-Adresse-des-Servers>

Beispiel:

ssh tinetronics@192.168.14.200

Beim ersten Verbindungsaufbau muss der angezeigte Fingerabdruck mit den Projektunterlagen beziehungsweise der lokalen Konsole verglichen werden. Nicht ungeprüft bestätigen.

== 2. Ausgangszustand dokumentieren ==

Ubuntu-Version anzeigen:

lsb_release -a

Falls `lsb_release` nicht verfügbar ist:

cat /etc/os-release

Freien Speicherplatz prüfen:

df -h

Die Systempartition `/` darf nicht nahezu voll sein. Sind nur noch wenige Gigabyte frei oder steht die Belegung bei etwa 90 Prozent oder höher, zunächst Speicherplatz prüfen und nicht blind aktualisieren.

Wenn MegBes bereits läuft, Zustand der Container festhalten:

sudo docker ps

Es müssen die erwarteten Container mit dem Zustand `Up` erscheinen. Container-Namen und verwendete Images für die Projektdokumentation notieren.

== 3. Paketlisten aktualisieren ==

sudo apt update

Dieser Befehl installiert noch nichts. Er lädt lediglich die aktuelle Liste verfügbarer Pakete aus den eingerichteten Paketquellen.

=== Erfolgskriterium ===

Der Befehl endet ohne Zeilen mit `E:` beziehungsweise `Error`. Hinweise auf verfügbare Aktualisierungen sind normal.

=== Bei Fehlern ===

* `Temporary failure resolving ...`: DNS oder Internetverbindung prüfen.
* falsches Datum beziehungsweise Zertifikatsfehler: Systemzeit mit `date` prüfen.
* Fehler einer fremden Paketquelle: nicht einfach ignorieren; Quelle und Projektdokumentation prüfen.
* `Could not get lock`: Es läuft bereits eine Paketverwaltung oder ein automatisches Update. Einige Minuten warten und erneut prüfen. Keine Lock-Dateien manuell löschen.

Bei einem Fehler in diesem Schritt nicht mit dem Upgrade fortfahren.

== 4. Verfügbare Aktualisierungen ansehen ==

apt list --upgradable

Die Liste dient zur Kontrolle. Meldungen über phasenweise zurückgehaltene Pakete können unter Ubuntu normal sein; diese Pakete werden später automatisch freigegeben.

== 5. Aktualisierungen installieren ==

sudo apt upgrade

APT zeigt vor der Installation eine Zusammenfassung und fragt normalerweise nach einer Bestätigung. Die Liste kurz prüfen und dann mit `Y` beziehungsweise `J` und Enter bestätigen.

Während der Installation können Dialoge erscheinen. Bei Fragen zum Ersetzen einer bereits angepassten Konfigurationsdatei im Zweifel die vorhandene lokale Version behalten und den Dateinamen für eine spätere Prüfung notieren.

=== Erfolgskriterium ===

Der Befehl kehrt ohne Fehlermeldung zur Eingabeaufforderung zurück. Anschließend erneut ausführen:

sudo apt update
apt list --upgradable

Eine kleine Zahl phasenweise zurückgehaltener Pakete ist möglich. Echte Fehler oder nicht fertig konfigurierte Pakete müssen untersucht werden.

== 6. Neustartbedarf prüfen ==

if [ -f /run/reboot-required ]; then cat /run/reboot-required; else echo "Kein Neustart erforderlich"; fi

Wird `System restart required` oder eine vergleichbare Meldung angezeigt, ist ein Neustart erforderlich.

Bei einem Kundensystem vor dem Neustart noch einmal prüfen:

sudo docker ps

Dann neu starten:

sudo reboot

Die SSH-Verbindung wird dabei beendet. Zwei bis fünf Minuten warten und erneut verbinden.

== 7. System nach dem Neustart prüfen ==

Ubuntu-Version und Kernel anzeigen:

lsb_release -a
uname -r

Fehlgeschlagene Systemdienste anzeigen:

systemctl --failed

Im Idealfall erscheint `0 loaded units listed`. Falls Dienste fehlgeschlagen sind, deren Namen notieren und vor der Freigabe untersuchen.

Docker prüfen:

sudo systemctl status docker --no-pager
sudo docker ps

Der Docker-Dienst muss `active (running)` sein und die erwarteten MegBes-Container müssen wieder den Zustand `Up` zeigen.

Protokoll des internen Containers prüfen; Container-Namen anpassen:

sudo docker logs --tail 100 <Containername>

Auf wiederholte Exceptions, Zertifikatsfehler, Verbindungsfehler oder Neustartschleifen achten.

== 8. MegBes-Funktion testen ==

# Erreichbarkeit von `megbes-internal` prüfen.
# Status-Monitor kontrollieren.
# mindestens eine ungefährliche Teststation beziehungsweise einen abgestimmten Testbefehl aufrufen.
# prüfen, dass genau die erwartete Station reagiert.
# bei stationsgesteuerten Projekten Statuswechsel und Rücksetzung prüfen.

== 9. Dokumentieren ==

Auf der Projektseite eintragen:

* Datum und ausführende Person
* Ubuntu-Version vor und nach der Aktualisierung
* ob ein Neustart erforderlich war
* Docker- und MegBes-Funktionstest
* Auffälligkeiten und noch offene Maßnahmen

== Abgrenzung: vollständiges Release-Upgrade ==

`sudo apt upgrade` hält das System innerhalb seines vorhandenen Ubuntu-Releases aktuell. Es wechselt beispielsweise nicht automatisch von Ubuntu 22.04 LTS auf 24.04 LTS. Dafür ist ein geplantes [[Ubuntu-LTS-Upgrade]] mit Backup und längerer Ausfallzeit erforderlich.

[[Kategorie:MegBes]]
[[Kategorie:Ubuntu]]
[[Kategorie:Wartung]]

Hauptseite

2026-08-04T20:35:29Z

Clawtronics: Navigation zur Neukunden-Checkliste korrigiert

__NOTOC__
= MegBes-Wiki =

'''MegBes''' ist ein System zur Steuerung von Medienstationen und anderen Geräten in Ausstellungen. Es kann grundsätzlich alle Geräte ansprechen, die UDP-Signale direkt empfangen oder über eine geeignete Schnittstelle umsetzen können, beispielsweise BrightSign-Player, PCs und Raspberry Pis.

== Systemüberblick ==

Der typische Signalweg lautet:

Web-Frontend oder App → megbes-external → megbes-internal → UDP → Medienstation

* [[Architektur|Architektur und Signalweg]]
* [[Komponenten|Komponenten des Systems]]
* [[Betrieb und Releases|Betrieb, Ubuntu und Releases]]
* [[Projektübersicht|Aktive Projekte]]
* [[Sicherheit|Sicherheits- und Dokumentationsregeln]]

== Einrichtung und Betrieb ==

Die folgenden Bereiche werden aus der bisherigen Dokumentation überarbeitet und schrittweise ergänzt:

* [[Neukunde|Neukunde / neues Projekt]]
* Installation eines internen Servers
* Konfiguration von megbes-external und megbes-internal
* Netzwerk, Routing und DynDNS
* Zertifikate
* Medienstationen und Ausstellungshardware
* UDP-Protokoll und Stationszustände
* Wartung, Backups und Fehlerdiagnose

== Aktueller Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Nicht alle Projekte verwenden bereits diesen Stand. Der tatsächlich installierte Release wird deshalb je Projekt dokumentiert. Maßgebliche technische Quelle ist das private GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes].

== Wichtiger Hinweis ==

Passwörter, Tokens, private Schlüssel, vollständige Zugangsdaten und geheime Update-URLs dürfen nicht im Wiki gespeichert werden. Siehe [[Sicherheit]].

[[Kategorie:MegBes]]

== Technische Referenz ==

* [[Softwaremodule|Softwaremodule und Build]]
* [[Konfiguration|Projektkonfiguration]]
* [[UDP und Stationszustände|UDP und Stationszustände]]

Hauptseite

2026-08-04T20:35:02Z

Clawtronics: Neukunden-Checkliste prominent verlinkt

__NOTOC__
= MegBes-Wiki =

'''MegBes''' ist ein System zur Steuerung von Medienstationen und anderen Geräten in Ausstellungen. Es kann grundsätzlich alle Geräte ansprechen, die UDP-Signale direkt empfangen oder über eine geeignete Schnittstelle umsetzen können, beispielsweise BrightSign-Player, PCs und Raspberry Pis.

== Systemüberblick ==

Der typische Signalweg lautet:

Web-Frontend oder App → megbes-external → megbes-internal → UDP → Medienstation

* [[Architektur|Architektur und Signalweg]]
* [[Komponenten|Komponenten des Systems]]
* [[Betrieb und Releases|Betrieb, Ubuntu und Releases]]
* [[Projektübersicht|Aktive Projekte]]
* [[Sicherheit|Sicherheits- und Dokumentationsregeln]]

== Einrichtung und Betrieb ==

Die folgenden Bereiche werden aus der bisherigen Dokumentation überarbeitet und schrittweise ergänzt:

* [[Neukunde|Neukunde / neues Projekt]]`n* Installation eines internen Servers
* Einrichtung eines neuen Projekts
* Konfiguration von megbes-external und megbes-internal
* Netzwerk, Routing und DynDNS
* Zertifikate
* Medienstationen und Ausstellungshardware
* UDP-Protokoll und Stationszustände
* Wartung, Backups und Fehlerdiagnose

== Aktueller Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Nicht alle Projekte verwenden bereits diesen Stand. Der tatsächlich installierte Release wird deshalb je Projekt dokumentiert. Maßgebliche technische Quelle ist das private GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes].

== Wichtiger Hinweis ==

Passwörter, Tokens, private Schlüssel, vollständige Zugangsdaten und geheime Update-URLs dürfen nicht im Wiki gespeichert werden. Siehe [[Sicherheit]].

[[Kategorie:MegBes]]

== Technische Referenz ==

* [[Softwaremodule|Softwaremodule und Build]]
* [[Konfiguration|Projektkonfiguration]]
* [[UDP und Stationszustände|UDP und Stationszustände]]

Neukunde

2026-08-04T20:35:02Z

Clawtronics: Zentrale Checkliste für neue Kunden und Projekte angelegt

Konfiguration

2026-08-04T20:30:26Z

Clawtronics: MiQua Guide als Subprojekt dokumentiert

= Konfiguration =

== Grundsatz ==

Die maßgebliche Projektkonfiguration befindet sich im privaten Repository `tinetronics/megbes-config`. Das Wiki beschreibt Bedeutung und Pflege der Felder, ersetzt aber nicht die aktuelle Konfigurationsdatei.

== megbes-external-config ==

Die produktive Konfiguration enthält je Projekt einen eigenen Eintrag. Der aktuelle Stand umfasst unter anderem:

* `gse`
* `miqua`
* `bayam`
* `limes`
* `nowalux`
* `miquaguide` – aktives Subprojekt von MiQua mit direktem Stationszugriff ohne Anmeldung am Ticket-Monitor
* `tine`
* `hon`
* `messe`
* `gkp`

Zusätzlich existieren lokale Entwicklungs- beziehungsweise Testeinträge.

Zu den projektspezifischen Feldern gehören:

* Kommunikationsprotokoll zum internen Server
* Adresse des internen Servers
* Port des internen Servers
* bei Projekten mit zentraler Authentifizierung: initialer Administratorname und verschlüsseltes Administratorpasswort

Passwörter dürfen nur in der von MegBes erwarteten verschlüsselten Form in die Projektkonfiguration aufgenommen werden. Der Klartext gehört ausschließlich in den Passwortmanager.

== megbes-status-config ==

Die Status-Konfiguration ordnet den Projekten jeweils die internen und externen Dienste beziehungsweise Adressen zu. Sie dient dem zentralen Status-Monitor zur Prüfung der Projektinstanzen.

== Authentifizierungsvarianten ==

Nicht alle Projektvarianten verwenden denselben Anmeldeweg. Das Subprojekt `miquaguide` kann Stationen direkt ansprechen, ohne dass sich der Nutzer über einen Ticket-Monitor anmeldet. Das Fehlen von Administratorfeldern in einem Konfigurationseintrag kann daher beabsichtigt sein und darf nicht automatisch als unvollständige Konfiguration bewertet werden.
== Änderung einer Projektkonfiguration ==

# betroffenen Projekteintrag eindeutig bestimmen
# aktuellen Stand sichern und Änderung nachvollziehbar dokumentieren
# JSON-Syntax prüfen
# Geheimwerte nicht in Klartext eintragen
# Änderung über den vorgesehenen Git-Prozess bereitstellen
# betroffene Container kontrolliert neu laden oder starten
# External-, Internal- und Stationsfunktion testen
# Ergebnis und Datum auf der Projektseite dokumentieren

== Benennung ==

Die Bezeichner im Repository können von den im Alltag verwendeten Kürzeln abweichen, beispielsweise `nowalux` für LUX. Auf Projektseiten sollen deshalb sowohl Anzeigename als auch technischer Konfigurationsschlüssel angegeben werden.

[[Kategorie:MegBes]]
[[Kategorie:Konfiguration]]

Projektübersicht

2026-08-04T20:30:26Z

Clawtronics: MiQua Guide als Subprojekt dokumentiert

= Projektübersicht =

Alle nachfolgend aufgeführten Projekte sind aktiv. Technische Betriebsdaten werden schrittweise auf getrennten Projektseiten ergänzt. Geheimwerte werden niemals im Wiki gespeichert.

{| class="wikitable sortable"
! Projekt
! Status
! Release external
! Release internal
! Letzte Prüfung
|-
| tine || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| HON || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| GSE || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| MiQua || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| BayAM || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| GKP || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| LUX || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| Limes || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| Messe || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|}

== MiQua Guide ==

'''MiQua Guide''' ist ein aktives Subprojekt von MiQua und kein eigenständiges Kundenprojekt. Es besitzt in der technischen Konfiguration den Schlüssel `miquaguide`. Der Guide kann die Stationen direkt ansprechen, ohne dass sich der Nutzer zuvor über einen Ticket-Monitor anmeldet.
== Inhalt einer Projektseite ==

Jede Projektseite soll mindestens enthalten:

* vollständiger Projektname und internes Kürzel
* verantwortliche Ansprechpartner innerhalb von tinetronics
* Domain von megbes-external
* DynDNS-Adresse oder interne Erreichbarkeit
* Container-Namen und Portzuordnungen
* installierte Releases
* eingesetzte Server- und Stationshardware
* projektspezifischer Stations-Timer
* Datum und Ergebnis der letzten Funktionsprüfung
* bekannte Besonderheiten und offene Aufgaben

Zugangsdaten, Tokens und Schlüssel werden durch einen Verweis auf den Passwortmanager ersetzt.

[[Kategorie:MegBes]]
[[Kategorie:Projekte]]

Hauptseite

2026-08-04T20:27:18Z

Clawtronics: Technische Referenz ergänzt

__NOTOC__
= MegBes-Wiki =

'''MegBes''' ist ein System zur Steuerung von Medienstationen und anderen Geräten in Ausstellungen. Es kann grundsätzlich alle Geräte ansprechen, die UDP-Signale direkt empfangen oder über eine geeignete Schnittstelle umsetzen können, beispielsweise BrightSign-Player, PCs und Raspberry Pis.

== Systemüberblick ==

Der typische Signalweg lautet:

Web-Frontend oder App → megbes-external → megbes-internal → UDP → Medienstation

* [[Architektur|Architektur und Signalweg]]
* [[Komponenten|Komponenten des Systems]]
* [[Betrieb und Releases|Betrieb, Ubuntu und Releases]]
* [[Projektübersicht|Aktive Projekte]]
* [[Sicherheit|Sicherheits- und Dokumentationsregeln]]

== Einrichtung und Betrieb ==

Die folgenden Bereiche werden aus der bisherigen Dokumentation überarbeitet und schrittweise ergänzt:

* Installation eines internen Servers
* Einrichtung eines neuen Projekts
* Konfiguration von megbes-external und megbes-internal
* Netzwerk, Routing und DynDNS
* Zertifikate
* Medienstationen und Ausstellungshardware
* UDP-Protokoll und Stationszustände
* Wartung, Backups und Fehlerdiagnose

== Aktueller Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Nicht alle Projekte verwenden bereits diesen Stand. Der tatsächlich installierte Release wird deshalb je Projekt dokumentiert. Maßgebliche technische Quelle ist das private GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes].

== Wichtiger Hinweis ==

Passwörter, Tokens, private Schlüssel, vollständige Zugangsdaten und geheime Update-URLs dürfen nicht im Wiki gespeichert werden. Siehe [[Sicherheit]].

[[Kategorie:MegBes]]

== Technische Referenz ==

* [[Softwaremodule|Softwaremodule und Build]]
* [[Konfiguration|Projektkonfiguration]]
* [[UDP und Stationszustände|UDP und Stationszustände]]

Konfiguration

2026-08-04T20:26:57Z

Clawtronics: Technische Dokumentation aus aktuellem Quellcode

= Konfiguration =

== Grundsatz ==

Die maßgebliche Projektkonfiguration befindet sich im privaten Repository `tinetronics/megbes-config`. Das Wiki beschreibt Bedeutung und Pflege der Felder, ersetzt aber nicht die aktuelle Konfigurationsdatei.

== megbes-external-config ==

Die produktive Konfiguration enthält je Projekt einen eigenen Eintrag. Der aktuelle Stand umfasst unter anderem:

* `gse`
* `miqua`
* `bayam`
* `limes`
* `nowalux`
* `miquaguide`
* `tine`
* `hon`
* `messe`
* `gkp`

Zusätzlich existieren lokale Entwicklungs- beziehungsweise Testeinträge.

Zu den projektspezifischen Feldern gehören:

* Kommunikationsprotokoll zum internen Server
* Adresse des internen Servers
* Port des internen Servers
* bei Projekten mit zentraler Authentifizierung: initialer Administratorname und verschlüsseltes Administratorpasswort

Passwörter dürfen nur in der von MegBes erwarteten verschlüsselten Form in die Projektkonfiguration aufgenommen werden. Der Klartext gehört ausschließlich in den Passwortmanager.

== megbes-status-config ==

Die Status-Konfiguration ordnet den Projekten jeweils die internen und externen Dienste beziehungsweise Adressen zu. Sie dient dem zentralen Status-Monitor zur Prüfung der Projektinstanzen.

== Änderung einer Projektkonfiguration ==

# betroffenen Projekteintrag eindeutig bestimmen
# aktuellen Stand sichern und Änderung nachvollziehbar dokumentieren
# JSON-Syntax prüfen
# Geheimwerte nicht in Klartext eintragen
# Änderung über den vorgesehenen Git-Prozess bereitstellen
# betroffene Container kontrolliert neu laden oder starten
# External-, Internal- und Stationsfunktion testen
# Ergebnis und Datum auf der Projektseite dokumentieren

== Benennung ==

Die Bezeichner im Repository können von den im Alltag verwendeten Kürzeln abweichen, beispielsweise `nowalux` für LUX. Auf Projektseiten sollen deshalb sowohl Anzeigename als auch technischer Konfigurationsschlüssel angegeben werden.

[[Kategorie:MegBes]]
[[Kategorie:Konfiguration]]

UDP und Stationszustände

2026-08-04T20:26:57Z

Clawtronics: Technische Dokumentation aus aktuellem Quellcode

= UDP und Stationszustände =

== Zweck ==

`megbes-internal` setzt Anforderungen von `megbes-external` in UDP-Signale für die Geräte im lokalen Ausstellungsnetz um. Das Zielgerät kann ein BrightSign-Player, PC, Raspberry Pi oder jedes andere Gerät sein, das das vereinbarte UDP-Signal verarbeitet.

== Steuerbefehl ==

Der interne Server erhält eine Kombination aus Stationsnummer und Befehl. Aus der Stationsnummer wird innerhalb des projektspezifischen Subnetzes die Zieladresse bestimmt; der Befehl wird als UDP-Nutzlast an das Gerät gesendet.

Der konkrete UDP-Port und das lokale Subnetz sind projektbezogene Konfigurationswerte. Sie dürfen nicht aus einem anderen Projekt übernommen werden, ohne die örtliche Netzstruktur zu prüfen.

== Stationsgesteuerter Modus ==

Im stationsgesteuerten Modus melden die Medienstationen ihren Zustand per UDP an `megbes-internal`. Die Funktion muss bei `megbes-external` und `megbes-internal` aktiviert sein.

Der aktuelle Code kennt folgende Zustände:

{| class="wikitable"
! Zustand
! UDP-Schlüsselwort
! Bedeutung im aktuellen Code
|-
| `IDLE` || `idle` || Station ist frei und kann übernommen werden.
|-
| `TOUCHSCREEN` || `touchscreen` || Station wird lokal über den Touchscreen benutzt.
|-
| `REMOTE` || `remote` || Station wurde einer angemeldeten Fernbedienung beziehungsweise einem Benutzer zugeordnet.
|-
| `OPEN` || `open` || Station ist unabhängig von der normalen Benutzersperre freigegeben; Statusabfrage und Steuerung werden nicht durch die übliche Belegungsprüfung blockiert.
|}

Beispiel für eine Zustandsmeldung:

<code>touchscreen: <Stationsnummer></code>

== Init-Meldung ==

Eine UDP-Nachricht mit dem Schlüsselwort `init` wird als Start-/Statusmeldung einer Medienstation verarbeitet und kann eine Informationsmail auslösen. Inhalt und Empfänger sind projektspezifisch zu konfigurieren.

== Timer ==

Der Timer ist ein Fallback gegen dauerhaft blockierte Stationen und kann je Projekt überschrieben werden. Der Quellcode enthält zwei unterschiedliche Standardwerte:

* stationsgesteuerte Zustandsverwaltung in `megbes-internal`: 1.800 Sekunden
* nicht stationsgesteuerte Sperrlogik in `megbes-external`: 180 Sekunden

Diese Werte gelten nur, wenn das betreffende Projekt keinen eigenen Wert setzt. Der tatsächlich konfigurierte Wert gehört auf die Projektseite.

== Status-Endpunkte ==

`megbes-internal` stellt Endpunkte zum Abfragen, Initialisieren und Zurücksetzen eines Stationszustands bereit. `megbes-external` reicht die benötigten Aufrufe kontrolliert weiter. Konkrete Header- und Authentifizierungswerte werden aus Sicherheitsgründen nicht im allgemeinen Wiki dokumentiert.

[[Kategorie:MegBes]]
[[Kategorie:Schnittstellen]]

Softwaremodule

2026-08-04T20:26:57Z

Clawtronics: Technische Dokumentation aus aktuellem Quellcode

= Softwaremodule =

Der aktuelle Quellcode von MegBes ist als Maven-Projekt mit mehreren Modulen aufgebaut. Der maßgebliche Stand befindet sich im privaten Repository `tinetronics/megbes`.

== common ==

Gemeinsam verwendete Datenmodelle, Konfigurationsklassen, Logging-, Mail-, Zertifikats- und Sicherheitsfunktionen. Dieses Modul wird von mehreren Diensten verwendet.

== external ==

Implementiert `megbes-external`. Das Modul stellt die zentralen HTTP-Endpunkte bereit, übernimmt Authentifizierung und Benutzer-/Stationslogik und kommuniziert mit dem projektspezifischen `megbes-internal`.

== internal ==

Implementiert `megbes-internal`. Das Modul nimmt Aufrufe von `megbes-external` entgegen, verwaltet bei Bedarf Stationszustände und sendet die eigentlichen UDP-Signale in das lokale Ausstellungsnetz.

== client ==

Enthält die statischen Web-Oberflächen und JavaScript-Dateien für Anmeldung, Ticketdarstellung, Hub und Stationsbedienung. Es existieren Varianten mit und ohne Authentifizierung sowie für stationsgesteuerte Projekte.

== status ==

Implementiert den Status-Monitor. Zu den erkennbaren Funktionen gehören:

* Status- und Verbindungstests
* Anzeige interner Aufrufprotokolle
* Erstellung, Installation, Download und Löschung von Zertifikaten
* Ver- und Entschlüsselungswerkzeuge für Konfigurationswerte
* Aktivierung und Deaktivierung bestimmter Mail-Informationen

== utils ==

Enthält kleine Hilfsprogramme zum Senden von UDP-Testsignalen für `init`, `idle`, `touchscreen` und `open`.

== release-builder ==

Hilfsmodul zur Erstellung der Releases.

== Build und Veröffentlichung ==

Der aktuelle Build verwendet Java 25 und GitHub Actions. Bei Änderungen am Branch `master` werden die Module gebaut und Snapshot-Docker-Images für `megbes-external`, `megbes-internal` und den Status-Monitor veröffentlicht. Produktive Releases werden gesondert versioniert; die Historie steht in `version.txt`.

[[Kategorie:MegBes]]
[[Kategorie:Software]]

Projektübersicht

2026-08-04T20:11:04Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

= Projektübersicht =

Alle nachfolgend aufgeführten Projekte sind aktiv. Technische Betriebsdaten werden schrittweise auf getrennten Projektseiten ergänzt. Geheimwerte werden niemals im Wiki gespeichert.

{| class="wikitable sortable"
! Projekt
! Status
! Release external
! Release internal
! Letzte Prüfung
|-
| tine || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| HON || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| GSE || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| MiQua || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| BayAM || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| GKP || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| LUX || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| Limes || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|-
| Messe || aktiv || noch zu erfassen || noch zu erfassen || noch zu erfassen
|}

== Inhalt einer Projektseite ==

Jede Projektseite soll mindestens enthalten:

* vollständiger Projektname und internes Kürzel
* verantwortliche Ansprechpartner innerhalb von tinetronics
* Domain von megbes-external
* DynDNS-Adresse oder interne Erreichbarkeit
* Container-Namen und Portzuordnungen
* installierte Releases
* eingesetzte Server- und Stationshardware
* projektspezifischer Stations-Timer
* Datum und Ergebnis der letzten Funktionsprüfung
* bekannte Besonderheiten und offene Aufgaben

Zugangsdaten, Tokens und Schlüssel werden durch einen Verweis auf den Passwortmanager ersetzt.

[[Kategorie:MegBes]]
[[Kategorie:Projekte]]

Sicherheit

2026-08-04T20:11:04Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

= Sicherheit =

== Keine Geheimnisse im Wiki ==

Auch dieses interne Wiki ist kein Passwortmanager. Folgende Inhalte dürfen hier nicht gespeichert werden:

* Passwörter
* API- und Zugriffstokens
* private Schlüssel
* geheime DynDNS-Update-URLs
* vollständige Datenbank-Verbindungszeichenfolgen mit Zugangsdaten
* entschlüsselbare Zertifikatskennwörter
* Sitzungstokens oder Authentifizierungs-Cookies

Im Wiki werden ausschließlich Variablennamen und neutrale Platzhalter verwendet, zum Beispiel:

<code>MAIL_SENDER_PASSWORD=<im Passwortmanager hinterlegt></code>

== Trennung von Dokumentation und Geheimnissen ==

Das Wiki beschreibt:

* Zweck eines Geheimwerts
* betroffene Komponente
* verantwortliches Konto oder System
* Ablageort im vorgesehenen Passwortmanager
* Verfahren zur Rotation und zum Funktionstest

Der konkrete Wert wird ausschließlich im dafür vorgesehenen Passwortmanager gespeichert.

== Rotation ==

Bei einer Rotation gilt grundsätzlich:

# betroffene Systeme und Abhängigkeiten erfassen
# neuen Wert erzeugen und sicher ablegen
# Konfigurationen kontrolliert aktualisieren
# Anwendung oder Container neu starten, falls erforderlich
# Funktion prüfen
# alten Wert widerrufen
# Datum und Ergebnis dokumentieren, jedoch niemals den Geheimwert

== Konfigurationsbeispiele ==

Vor dem Einfügen von Konfigurationen, Protokollen oder Screenshots müssen Passwörter, Tokens, Schlüssel, Zugangsdaten und personenbezogene Informationen entfernt werden.

== Git-Verlauf ==

Ein aus dem aktuellen Dateistand gelöschtes Geheimnis kann weiterhin im Git-Verlauf vorhanden sein. Ein offengelegter Wert muss deshalb rotiert werden; bloßes Löschen genügt nicht.

[[Kategorie:MegBes]]
[[Kategorie:Sicherheit]]

Betrieb und Releases

2026-08-04T20:11:04Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

= Betrieb und Releases =

== Maßgebliche Quellen ==

* Anwendung und Releases: privates GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes]
* Projektkonfiguration: privates GitHub-Repository [https://github.com/tinetronics/megbes-config tinetronics/megbes-config]

Das Wiki erläutert Abläufe und Zusammenhänge. Bei technischen Detailwerten haben der aktuelle Repository-Stand und die tatsächlich laufende Projektkonfiguration Vorrang.

== Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Bestandsprojekte können bewusst oder vorübergehend ältere Releases verwenden.

Bei jedem Projekt sollen mindestens folgende Angaben gepflegt werden:

* installierter Release von megbes-external
* installierter Release von megbes-internal
* Datum der letzten Aktualisierung
* Ergebnis des Funktionstests
* bekannte projektspezifische Abweichungen

Ein Projekt darf nicht allein aufgrund eines neuen verfügbaren Releases ungeprüft aktualisiert werden. Vorher sind Konfiguration, Zertifikate, Schnittstellen und projektspezifische Besonderheiten zu prüfen.

== Ubuntu ==

Für neue interne Server wird die jeweils aktuelle '''Ubuntu-LTS-Version''' verwendet. Bestehende Systeme werden möglichst aktuell und innerhalb eines unterstützten LTS-Zweigs gehalten.

Vor einem Upgrade sind mindestens erforderlich:

# vollständige Sicherung der relevanten Konfigurationen und persistenten Daten
# Erfassung der laufenden Container, Images, Volumes und Portzuordnungen
# Prüfung des aktuellen System- und Docker-Status
# Planung eines Wartungsfensters
# Funktionstest von Docker, megbes-internal und der Kommunikation zu den Stationen nach dem Upgrade

== Projektspezifische Parameter ==

Stations-Timer, Ports, Domains und weitere Laufzeitparameter sind projektabhängig. Sie werden nicht als globaler Standard dokumentiert, sondern auf der jeweiligen Projektseite beziehungsweise in der maßgeblichen Konfiguration.

[[Kategorie:MegBes]]
[[Kategorie:Betrieb]]

Komponenten

2026-08-04T20:11:03Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

= Komponenten =

== Software ==

; megbes-external
: Zentral betriebene Anwendung. Pro Kunde beziehungsweise Projekt existiert ein eigener Docker-Container unter Plesk.

; megbes-internal
: Anwendung auf dem lokalen Server des Kunden. Sie setzt eingehende Anforderungen in UDP-Signale für das Ausstellungsnetz um.

; Web-Frontend oder App
: Bedienoberfläche, über die Besucher, Aufsicht oder Servicepersonal Funktionen einer Medienstation auslösen können.

; Projektkonfiguration
: Zuordnung von Projekten, internen Servern, Stationen und weiteren Parametern. Maßgebliche Quelle ist das private Repository `tinetronics/megbes-config`.

== Typische Infrastruktur beim Kunden ==

* interner Server mit einer aktuell unterstützten Ubuntu-LTS-Version
* Docker-Laufzeitumgebung
* Router und projektspezifische Portfreigabe
* DynDNS oder eine andere dauerhaft erreichbare Adresse
* projektbezogene Zertifikate
* lokales Netzwerk für Server und Medienstationen

== Typische Ausstellungshardware ==

* BrightSign-Player
* PCs
* Raspberry Pis, auch als UDP-zu-GPIO-Umsetzer
* Relaismodule
* Ticket-Monitore
* USB-WLAN-Adapter für nachgerüstete Medienstationen

== Grundsatz ==

Konkrete Modelle und Ausführungen sind projektabhängig. Kundenspezifische Angaben werden auf den jeweiligen Projektseiten dokumentiert.

[[Kategorie:MegBes]]
[[Kategorie:Komponenten]]

Architektur

2026-08-04T20:11:03Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

= Architektur =

== Überblick ==

MegBes besteht aus einer zentral betriebenen externen Ebene, einer lokalen internen Ebene beim jeweiligen Kunden und den angeschlossenen Medienstationen.

Web-Frontend oder App
↓
megbes-external (zentral bei IONOS/Plesk)
↓
megbes-internal (Server beim Kunden)
↓
UDP im Ausstellungsnetz
↓
BrightSign, PC, Raspberry Pi oder anderes UDP-fähiges Gerät

== megbes-external ==

* Läuft zentral auf einem IONOS-Server unter Plesk.
* Für jeden Kunden beziehungsweise jedes Projekt wird ein eigener Docker-Container betrieben.
* Nimmt Anforderungen des Web-Frontends oder einer App entgegen.
* Ordnet die Anforderung dem betreffenden Projekt und internen Server zu.
* Projektbezogene Konfigurationen werden im privaten Repository [https://github.com/tinetronics/megbes-config tinetronics/megbes-config] verwaltet.

== megbes-internal ==

* Läuft bei jedem Kunden auf einem eigenen Server.
* Befindet sich im lokalen Netzwerk der Ausstellung.
* Nimmt die für das Projekt bestimmten Anforderungen entgegen.
* Wandelt Steuerbefehle in UDP-Signale um und sendet diese an die Medienstationen.

== Medienstationen ==

MegBes ist nicht auf einen bestimmten Gerätetyp beschränkt. Entscheidend ist, dass das Zielgerät UDP-Signale empfangen oder über eine passende Zusatzkomponente umsetzen kann. Typische Empfänger sind:

* BrightSign-Player
* Windows- oder Linux-PCs
* Raspberry Pis
* relaisgesteuerte Stationen
* weitere netzwerkfähige Steuerungen

== Projektspezifische Ausprägung ==

Domains, Ports, Stationszuordnungen, Timer und installierte Releases können je Projekt abweichen. Diese Angaben gehören auf die jeweilige Projektseite und dürfen nicht als globaler Standard verallgemeinert werden.

[[Kategorie:MegBes]]
[[Kategorie:Architektur]]

Hauptseite

2026-08-04T20:11:03Z

Clawtronics: Grundstruktur des neuen MegBes-Wikis

__NOTOC__
= MegBes-Wiki =

'''MegBes''' ist ein System zur Steuerung von Medienstationen und anderen Geräten in Ausstellungen. Es kann grundsätzlich alle Geräte ansprechen, die UDP-Signale direkt empfangen oder über eine geeignete Schnittstelle umsetzen können, beispielsweise BrightSign-Player, PCs und Raspberry Pis.

== Systemüberblick ==

Der typische Signalweg lautet:

Web-Frontend oder App → megbes-external → megbes-internal → UDP → Medienstation

* [[Architektur|Architektur und Signalweg]]
* [[Komponenten|Komponenten des Systems]]
* [[Betrieb und Releases|Betrieb, Ubuntu und Releases]]
* [[Projektübersicht|Aktive Projekte]]
* [[Sicherheit|Sicherheits- und Dokumentationsregeln]]

== Einrichtung und Betrieb ==

Die folgenden Bereiche werden aus der bisherigen Dokumentation überarbeitet und schrittweise ergänzt:

* Installation eines internen Servers
* Einrichtung eines neuen Projekts
* Konfiguration von megbes-external und megbes-internal
* Netzwerk, Routing und DynDNS
* Zertifikate
* Medienstationen und Ausstellungshardware
* UDP-Protokoll und Stationszustände
* Wartung, Backups und Fehlerdiagnose

== Aktueller Release-Stand ==

Der aktuellste bekannte Release ist '''AUGUST-2026-2-RELEASE'''. Nicht alle Projekte verwenden bereits diesen Stand. Der tatsächlich installierte Release wird deshalb je Projekt dokumentiert. Maßgebliche technische Quelle ist das private GitHub-Repository [https://github.com/tinetronics/megbes tinetronics/megbes].

== Wichtiger Hinweis ==

Passwörter, Tokens, private Schlüssel, vollständige Zugangsdaten und geheime Update-URLs dürfen nicht im Wiki gespeichert werden. Siehe [[Sicherheit]].

[[Kategorie:MegBes]]