Neukunde

Neukunde / neues Projekt

Diese Seite ist der rote Faden für die Einrichtung eines neuen MegBes-Projekts. Sie führt von den ersten Angaben bis zur Übergabe. Technische Einzelheiten stehen auf den jeweils verlinkten Fachseiten – hier geht es vor allem darum, was als Nächstes zu tun ist und woran du erkennst, dass eine Etappe abgeschlossen ist.

Nicht jedes Projekt benötigt alle hier genannten Bausteine. Wenn beispielsweise kein lokaler MegBes-Server vorgesehen ist, können die entsprechenden Schritte übersprungen werden.

Der Weg zum fertigen Projekt

1. Projekt und Ansprechpartner erfassen
2. Betriebsart und benötigte Komponenten festlegen
3. Öffentliche MegBes-Seite bereitstellen
4. Technik am Standort vorbereiten
5. Stationen anbinden
6. Gesamtsystem abnehmen und dokumentieren

1. Projekt beginnen

Ziel dieser Etappe: Alle Beteiligten sprechen über dasselbe Projekt, und die wichtigsten Ansprechpartner sind bekannt.

Lege zunächst in der Projektübersicht eine eigene Projektseite an. Verwende dafür den Namen, unter dem das Projekt später auch intern wiedergefunden werden soll.

Auf der Projektseite sollten mindestens diese Angaben stehen:

Angabe	Beispiel oder Erläuterung
Kunde und Projektname	Museum Beispielstadt – Dauerausstellung
Technischer Projektschlüssel	Kurzer, eindeutiger Name ohne Leerzeichen, z. B. beispielstadt
Zuständige Personen	Projektleitung, technische Betreuung und Ansprechpartner vor Ort
Geplanter Betriebsbeginn	Eröffnung, Testbetrieb oder Übergabetermin
Anzahl der Stationen	Einschließlich Reserve- oder Teststationen
Aktueller Stand	Planung, Einrichtung, Test oder Betrieb

Der technische Projektschlüssel wird später unter anderem für Container, Konfigurationsdateien und Adressen verwendet. Er sollte deshalb früh festgelegt und danach nicht mehr geändert werden.

Weiter, wenn … eine Projektseite vorhanden ist, der Projektschlüssel feststeht und mindestens je ein organisatorischer und technischer Ansprechpartner bekannt ist.

2. Gemeinsam festlegen, wie das Projekt funktionieren soll

Ziel dieser Etappe: Die grundlegenden Entscheidungen sind getroffen, bevor Server oder Container eingerichtet werden.

Was sollen Besucherinnen und Besucher sehen?

Kläre, welche Informationen auf der MegBes-Seite erscheinen sollen, zum Beispiel:

• aktuelle Verfügbarkeit oder Zustände der Stationen,
• Hinweise zu einzelnen Angeboten,
• eine für das Projekt gestaltete Oberfläche,
• mehrere Sprachen.

Halte Gestaltungswünsche, Sprachen und besondere Inhalte auf der Projektseite fest.

Wie wird die Seite aufgerufen?

Entscheide zwischen den üblichen Betriebsarten:

• Direkter Zugriff: Die Seite ist ohne vorherige Prüfung erreichbar.
• Zugriff über Ticket-Monitor: Der Aufruf wird anhand der vorgesehenen Berechtigung freigegeben.

Eine verständliche Gegenüberstellung steht unter Bedienung und Authentifizierung.

Welche Technik wird benötigt?

Prüfe gemeinsam mit der technischen Betreuung:

• Wird nur die öffentliche MegBes-Seite benötigt?
• Gibt es vor Ort einen lokalen MegBes-Server?
• Wie melden die Stationen ihren Zustand – insbesondere per UDP oder über einen anderen vorgesehenen Weg?
• Wird für den Standort DynDNS oder eine feste öffentliche Adresse benötigt?
• Wer kann Änderungen an Router, Firewall und Standortnetz freigeben?

Weiter, wenn … Betriebsart, benötigte Komponenten, Stationenzahl und Verantwortlichkeiten für das Standortnetz feststehen.

Noch nicht weitermachen, wenn … unklar ist, ob ein lokaler Server benötigt wird oder wer Router- und Firewall-Änderungen genehmigen darf. Diese Entscheidungen beeinflussen den gesamten weiteren Aufbau.

3. Die öffentliche Seite vorbereiten

Ziel dieser Etappe: Das Projekt ist über seine spätere öffentliche Adresse erreichbar und zeigt die richtige Konfiguration.

Gehe in dieser Reihenfolge vor:

1. Lege die gewünschte Adresse fest, normalerweise <projekt>.megbes.de.
2. Erstelle die Projektkonfiguration im Repository tinetronics/megbes-config. Die benötigten Felder sind unter Konfiguration beschrieben.
3. Stelle unter Plesk einen eigenen megbes-external-Container für das Projekt bereit. Die technische Anleitung steht unter Megbes-external unter Plesk.
4. Verknüpfe Domain, Zertifikat und Container.
5. Öffne die Adresse im Browser und kontrolliere Inhalt, Gestaltung und Verhalten.

Verwende grundsätzlich eine freigegebene Release-Version. Zugangsdaten, Tokens, private Schlüssel und vollständige DynDNS-Aktualisierungsadressen gehören nicht ins Wiki oder in die Projektkonfiguration, sondern in den vorgesehenen Passwortmanager.

Weiter, wenn …

• die öffentliche Adresse per HTTPS ohne Zertifikatswarnung erreichbar ist,
• die richtige Projektoberfläche erscheint,
• die vereinbarte Zugriffsart funktioniert,
• keine Zugangsdaten in Wiki, Repository oder Containerbeschreibung abgelegt wurden.

4. Den Standort vorbereiten

Ziel dieser Etappe: Der lokale MegBes-Server ist zuverlässig erreichbar und kann mit den Stationen sowie der öffentlichen Seite kommunizieren.

Dieser Abschnitt entfällt, wenn das Projekt keinen lokalen MegBes-Server benötigt.

Vor dem Aufbau klären

Besorge oder bestätige zunächst:

• Standort und Hardware des Servers,
• feste interne IP-Adresse,
• DNS- und Gateway-Angaben,
• Zugang zum Router beziehungsweise eine zuständige Kontaktperson,
• DynDNS-Name, falls erforderlich,
• Liste der Stationen mit Namen und IP-Adressen,
• geplante Sicherung und verantwortliche Person.

Server in sinnvollen Etappen einrichten

1. Ubuntu installieren und aktualisieren: Ubuntu installieren und Ubuntu aktualisieren
2. Eine feste interne Adresse einrichten: Feste IP-Adresse unter Ubuntu
3. Docker installieren und prüfen: Docker installieren
4. megbes-internal mit der Projektkonfiguration starten: Megbes-internal
5. Router, DynDNS und erforderliche Weiterleitungen einrichten: DynDNS und Router
6. Zertifikate einrichten oder übertragen: Zertifikate

Führe nach jeder Etappe einen kurzen Funktionstest durch. So ist bei einem Fehler sofort klar, in welchem Abschnitt er entstanden ist.

Weiter, wenn …

• der Server nach einem Neustart wieder erreichbar ist,
• der interne Container selbstständig startet,
• die Projektkonfiguration geladen wird,
• die benötigte Verbindung zwischen Standort und öffentlicher Seite funktioniert,
• keine unnötigen Dienste oder Ports aus dem Internet erreichbar sind.

5. Stationen Schritt für Schritt anbinden

Ziel dieser Etappe: Jede Station erscheint eindeutig und mit dem richtigen Zustand im System.

Beginne nicht sofort mit allen Stationen. Nimm zuerst eine gut erreichbare Teststation:

1. Vergib oder bestätige Namen und IP-Adresse der Station.
2. Trage sie in der Projektkonfiguration ein.
3. Richte die vorgesehene Zustandsmeldung ein.
4. Prüfe den Signalweg vom Gerät bis zur Anzeige. Hilfestellung: UDP und Stationszustände und Routing und Signalweg.
5. Simuliere mindestens einen Zustandswechsel und kontrolliere die Anzeige.

Wenn die Teststation zuverlässig funktioniert, übertrage das Vorgehen auf die übrigen Stationen. Arbeite die Stationsliste einzeln ab und markiere jede geprüfte Station auf der Projektseite.

Weiter, wenn … jede Station eindeutig zugeordnet ist, Zustandsänderungen korrekt erscheinen und ein Neustart der Station beziehungsweise des lokalen Servers erfolgreich getestet wurde.

6. Gemeinsame Abnahme

Ziel dieser Etappe: Das System funktioniert nicht nur technisch, sondern auch im vorgesehenen Arbeitsalltag.

Führe die Abnahme möglichst gemeinsam mit einer verantwortlichen Person des Projekts durch.

Besucheransicht

• Öffnet sich die richtige Seite auf Smartphone und einem normalen Rechner?
• Sind Texte, Logos, Farben und Sprachen korrekt?
• Ist die Bedienung verständlich?
• Funktioniert die vereinbarte Zugriffsart?

Technischer Betrieb

• Werden alle Stationen mit dem richtigen Namen und Zustand angezeigt?
• Werden Ausfall, Rückkehr und Neustart einer Teststation korrekt erkannt?
• Starten Server und Container nach einem Neustart automatisch?
• Sind HTTPS und Zertifikatskette fehlerfrei?
• Sind nur die tatsächlich benötigten Ports erreichbar?

Betrieb und Wiederherstellung

• Ist festgelegt, wer Störungen zuerst prüft?
• Sind Sicherung und Wiederherstellung beschrieben und mindestens einmal geprüft?
• Sind Zugangsdaten vollständig im Passwortmanager hinterlegt?
• Ist die eingesetzte Release-Version dokumentiert?

Für den späteren Betrieb dient Wartung, Backups und Fehlerdiagnose als zentrale Arbeitsseite. Der Status-Monitor hilft bei der laufenden Übersicht.

Das Projekt ist bereit zur Übergabe, wenn … alle Abnahmepunkte entweder bestätigt oder als bekannte Restpunkte mit Verantwortlichem und Termin dokumentiert sind.

7. Projekt sauber übergeben

Ergänze zum Abschluss die Projektseite um:

• öffentliche und interne Adressen ohne geheime Bestandteile,
• eingesetzte Container und Release-Versionen,
• Stationsliste,
• Betriebsart und besondere Konfiguration,
• zuständige Personen,
• Datum und Ergebnis der Abnahme,
• bekannte Restpunkte,
• Verweise auf Sicherung, Passwortmanager-Eintrag und weitere Betriebsdokumentation.

Setze den Projektstatus in der Projektübersicht anschließend auf Betrieb.

Wenn etwas nicht wie erwartet funktioniert

Gehe vom letzten erfolgreichen Prüfpunkt aus zurück. Prüfe zunächst nur den betroffenen Abschnitt, statt mehrere Komponenten gleichzeitig zu ändern.

Eine hilfreiche Reihenfolge ist:

1. Ist die betroffene Station oder der Server eingeschaltet und im Netz erreichbar?
2. Läuft der zuständige Container?
3. Ist die richtige Projektkonfiguration geladen?
4. Funktioniert der Signalweg zwischen Station, lokalem Server und öffentlicher Seite?
5. Gibt es aktuelle Meldungen in den Container-Protokollen oder im Status-Monitor?

Dokumentiere Ursache und Lösung auf der Projektseite, wenn der Fehler projektspezifisch war. Allgemein wiederverwendbare Erkenntnisse gehören nach Wartung, Backups und Fehlerdiagnose.