Wichtig!Der Webserver liefert Ihre BlueSpice-Installation an die Browser der Benutzer aus. Ohne einen Webserver ist BlueSpice nicht verwendbar. Der Quelltext von BlueSpice basiert auf der Scriptsprache "PHP". Dies muss ebenfalls auf Ihrem Server installiert werden, um BlueSpice betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.

Einleitung[Bearbeiten | Quelltext bearbeiten]

Unter Linux stehen Ihnen als Webserver Apache oder Nginx zur Verfügung. Generell kann BlueSpice auch mit Nginx betrieben werden, in dieser Dokumentation wird allerdings nur Apache im Detail behandelt. Selbstverständlich können Sie bei entsprechender Fachkenntnis auch Nginx installieren und entsprechend der hier dokumentierten VirtualHost-Konfiguration des Apache betreiben.

Hinweis:Falls Ihr Benutzer kein Sudoer ist, tippen sie ein "su" in das Terminal und schreiben "ie vor jedem Befehl ein sudo.


Installation[Bearbeiten | Quelltext bearbeiten]

hint.png
In den folgenden Anleitungsschritten wird nicht unbedingt die aktuell zuletzt unterstützte Version von PHP verwendet und dient nur beispielhaft für die aktuell unterstützten Versionen, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.

Installieren Sie Apache und PHP über die Paketverwaltung Aptitude mit folgenden Schritten:

apt update; \
apt install apache2 \
    libapache2-mod-php8.1 \
    php8.1 \
    php8.1-cli \
    php8.1-common \
    php8.1-curl \
    php8.1-gd \
    php8.1-intl \
    php8.1-json \
    php8.1-mbstring \
    php8.1-mysql \
    php8.1-opcache \
    php8.1-tidy \
    php8.1-xml \
    php8.1-zip; \
apt clean

Je nach Bedarf können weitere PHP-Erweiterungen notwendig sein, z.B. für eine LDAP-Anbindung.

Konfiguration von PHP[Bearbeiten | Quelltext bearbeiten]

Nach erfolgter Installation konfigurieren Sie nun zuerst PHP. Wechseln sie durch das Terminal zuerst in das Verzeichnis /etc/php/8.1/apache2 und führen dann die php.ini Datei über den Befehl nano php.ini aus.

Suchen Sie folgende Einstellungen und ändern die Werte entsprechend. Sollte eine Einstellung mit einem vorangestellten Semikolon auskommentiert sein, so entfernen Sie dieses bitte.

date.timezone = Europe/Berlin
max_execution_time = 600
post_max_size = 128M
upload_max_filesize = 128M

Den Wert für date.timezone setzen Sie bitte entsprechend Ihrer eigenen Zeitzone.

Speichern und verlassen Sie die php.ini wieder.

Konfiguration von Apache[Bearbeiten | Quelltext bearbeiten]

Hinweis:In dieser Dokumentation wird von der empfohlenen Installation mit ShortURL ausgegangen. Hierbei befindet sich das Wurzelverzeichnis des Webservers in /var/www/bluespice, der eigentliche Source-Code von BlueSpice aber in /var/www/bluespice/w. Diese Konfiguration ist entsprechend hierauf ausgelegt.


Mehrere Virtual Hosts

Diese Anleitung gilt für Fälle, in denen BlueSpice auf einem dedizierten Server installiert wird. Wenn Sie andere virtuelle Hosts konfiguriert haben, müssen Sie möglicherweise einen Alias für den Unterordner /w/ angeben. Fügen Sie hierfür folgende Zeile zur http-spezifischen Konfiguration von Apache hinzu: Alias /w/ /path/to/w/ (z.B.: Alias /w/ /var/www/html/example.com/w/).

Um einen VirtualHost für BlueSpice zu konfigurieren:

  1. Wechseln Sie in das Verzeichnis /etc/apache2/sites-available.
  2. Öffnen Sie in einem Texteditor Ihrer Wahl die noch nicht existierende Datei bluespice.conf und legen diese dadurch an. Kopieren Sie den kompletten Inhalt folgender Datei in diese neue Konfigurationsdatei:
    1. Bei BlueSpice free: apache_vhost_bluespice_free.txt
    2. Bei BlueSpice pro: apache_vhost_bluespice_pro.txt
  3. Ersetzen Sie in den Zeilen 3 und 4 "SERVERNAME" und "SERVERALIAS" entsprechend Ihrem Servernamen und Ihrer Domain. Wird der Server explizit mit nur einem VirtualHost für BlueSpice betrieben so können Sie diese beiden Zeilen auch komplett entfernen.
  4. Speichern Sie die Datei ab und verlassen Sie diese wieder.

Löschen Sie den per default während der Apache-Installation angelegten VirtualHost mit dem Befehl a2dissite 000-default. Anschließend aktivieren Sie den soeben angelegten VirtualHost mit dem Befehl a2ensite bluespice.

Aktivieren Sie jetzt bitte noch das Module Rewrite, das wir in der bluespice.conf konfiguriert haben, indem Sie folgenden Befehl eingeben: a2enmod rewrite

Legen Sie nun das Verzeichnis /var/www/bluespice mit dem Code (mkdir /var/www/bluespice) und starten Sie Apache neu mit dem Befehl service apache2 restart.

Rufen Sie nun die URL Ihres BlueSpice-Servers auf. Bei korrekter Konfiguration sollte Apache die Anfrage mit der Fehlermeldung "Not found" beantworten, was zu diesem Zeitpunkt der Installation vollkommen korrekt ist.

Apache: Not found

Nächster Schritt[Bearbeiten | Quelltext bearbeiten]

Haben Sie all diese Schritte erfolgreich abgeschlossen können Sie zum nächsten Schritt "MariaDB" weiter gehen.



Feedback zur Dokumentation ist im Community-Forum möglich.