OnPremise / Self Hosted

Dieses Dokument beschreibt die technischen Voraussetzungen für den Betrieb von Campus Events in einer Self-Hosted-Umgebung (OnPremise).

Für einen stabilen und performanten Betrieb sollte der Server mindestens folgende Anforderungen erfüllen:

• Prozessor: Mehrkern-Architektur (Multi-Core).
• Arbeitsspeicher (RAM): Die Menge des benötigten Arbeitsspeichers ist vom zu erwartenden Traffic abhängig. Als Basis empfehlen wir mindestens 4 GB freien RAM für die Applikationsdienste.
• Speicherplatz: Mindestens 50 GB freier Speicherplatz für den Programmcode, die Anwendungsdaten (Uploads etc.) sowie lokale Backups.

• Verantwortung: Die laufende Wartung des Betriebssystems, inklusive der Installation von Sicherheitsupdates für das System und die installierten Dienste (PHP, Apache, Datenbank etc.), liegt in der Verantwortung des Server-Administrators auf Kundenseite.
• Zeitsynchronisation: Der Server sollte über NTP synchronisiert sein. Die Systemzeitzone sollte auf Europe/Berlin eingestellt sein.
• Locales: Die Locale de_DE.UTF-8 muss installiert und verfügbar sein.

PHP & Datenbank

Unsere Software wird kontinuierlich weiterentwickelt. Die folgende Tabelle zeigt die benötigten Versionen für die jeweiligen Releases.

Die folgenden Module müssen für PHP (sowohl FPM als auch CLI) installiert und aktiviert sein:

• bcmath, ctype, curl, gd, iconv, igbinary, imagick, intl, json, ldap, mbstring, mysql (pdo_mysql), opcache, readline, redis, soap, xml, xsl, zip
• Hinweis zu imap: Das imap-Modul wird bis PHP 8.3 benötigt, entfällt jedoch ab PHP 8.4.

Abweichend von Standardwerten müssen folgende Einstellungen gesetzt sein:

• memory_limit = 512MB (oder höher)
• allow_url_fopen = true
• Der Befehl php -v auf der Konsole muss dieselbe Version zurückgeben, die auch vom Webserver verwendet wird. Bei mehreren PHP-Versionen auf einem Server muss die CLI-Version der Produktivumgebung entsprechen.

Unsere Software ist jeweils gegen eine bestimmte PHP-Version entwickelt und getestet. Es kann erforderlich sein, dass die PHP-Version zum Livegang oder für ein Update durch den Server-Administrator angehoben werden muss. Dies wird von uns rechtzeitig angekündigt und koordiniert.

• Erforderlich für Campus Events ab v5.0 und Campus Mails ab v4.0.
• Unterstützt werden die von Symfony unterstützten Redis-Verbindungsarten.
• Der Redis-Server kann insbesondere angebunden werden über:
  • TCP/IP (Host und Port)
  • Unix-Domain-Socket
  • Authentifizierung mittels Benutzer/Passwort (ACL) oder Passwort
  • TLS-verschlüsselte Verbindungen
  • Redis Sentinel
  • Redis Cluster
• Die konkrete Konfiguration erfolgt über eine Redis-DSN entsprechend der Symfony-Dokumentation.
• Eine persistente Speicherung der Redis-Daten ist für den Betrieb unserer Software nicht erforderlich.
• Die Redis-Instanz darf gemeinsam mit anderen Anwendungen genutzt werden.

Weitere Informationen zur unterstützten DSN-Syntax: https://symfony.com/doc/current/components/cache/adapters/redis_adapter.html#configure-the-connection

Die Software ist ausschließlich für den Betrieb mit Apache optimiert und getestet.

• Module: mod_rewrite muss aktiv sein.
• Konfiguration: FollowSymLinks muss erlaubt sein (Symlinks außerhalb der Webroot müssen erreichbar sein).
• Logs: Die Apache-Error-Logs müssen für den Applikations-User auffindbar sein (idealerweise per Symlink im Home-Verzeichnis).

Um einen reibungslosen Deployment-Prozess zu gewährleisten, wird folgende Struktur (basierend auf Deployer) vorausgesetzt:

/var/www/html/campus-events/produktiv/

• backups/
• releases/ (enthält die einzelnen Programmversionen in Unterordnern)
• shared/ (enthält release-übergreifende Daten wie Uploads oder Konfigurationen)
• current (Symlink auf das aktuell aktive Release in releases/)

Der Document Root des Webservers muss auf das public/-Verzeichnis des aktuellen Releases zeigen:
/var/www/html/campus-events/produktiv/current/public

Wir empfehlen, auch bei nur einem System die Trennung in produktiv und staging im Pfad beizubehalten.

• Der SSH-User für das Deployment benötigt volle Schreibrechte im Projektverzeichnis.
• Falls dieser User nicht identisch mit dem User des Webserver-Prozesses (z. B. www-data) ist, muss sudo für diesen User passwortlos funktionieren, um Berechtigungen anzupassen.

Dieser Inhalt ist erst nach dem Login sichtbar.

• Die Applikation benötigt zur Zeit zwei Cronjobs, die minütlich ausgeführt werden müssen.
• Diese sollten idealerweise in /etc/crontab eingetragen werden. Bei abweichenden Orten ist ein Kommentar in /etc/crontab zwingend erforderlich.

• Die Verantwortung für die Datensicherung (Datenbank und Dateien) liegt beim Kunden.
• Empfehlung: Mindestens tägliche Sicherung mit einer Aufbewahrungsfrist von 7 Tagen.
• Die Wiederherstellung (Restore) muss im Bedarfsfall zeitnah durch den Kunden durchgeführt werden können.

Für den Versand von E-Mails (z. B. Bestätigungen, Systembenachrichtigungen) werden folgende Zugangsdaten benötigt:

• Versand (SMTP): Eine funktionierende SMTP-Konfiguration (Host, Port, User, Passwort, Verschlüsselung) ist zwingend erforderlich.
• Empfang/Prüfung (IMAP): Wir empfehlen dringend die zusätzliche Bereitstellung eines IMAP-Zugangs (kann dasselbe Postfach wie für SMTP sein). Dies ermöglicht uns eine automatisierte Überprüfung des Mailversands.

Wir übernehmen keine Verantwortung für:

• Einrichtung und Verlängerung von SSL-Zertifikaten.
• Allgemeine Apache- oder PHP-Konfigurationen außerhalb dieser Spezifikation.
• Berechtigungsprobleme auf Dateisystemebene oder Netzwerkstörungen.