Setup:Installationsanleitung/Systemvorbereitung/Linux/Apache und PHP

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.

Falls der Hinweis "Benutzer ist nicht in der sudoers-Datei" erscheint, "su" im Terminal ausführen. Vor einem Befehl ein "sudo" schreiben.

Einleitung

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.

Installation

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

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

            

Konfiguration von PHP

Nach erfolgter Installation konfigurieren Sie nun zuerst PHP. Öffnen Sie hierzu mit einem Texteditor Ihrer Wahl (vi, nano) die php.ini, die sich bei dem hier referenzierten Debian im Verzeichnis /etc/php/7.3/apache2 befindet. Oder über den Terminal mit sudo nano /etc/php/7.4/apache2/php.ini öffnen.

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

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.

Um einen VirtualHost für BlueSpice zu konfigurieren gehen Sie bitte wie folgt vor:

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.

Bei Fehlenden Rechten zum Speichern:

1. Öffnen Sie einen Texteditor Ihrer Wahl.
2. 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 als bluespice.conf ab unter einen beliebigen Dateipfad und verlassen Sie diese wieder.
5. Führen Sie im Terminal den Befehl sudo mv /IhrDateipfad/bluespice.conf /etc/apache2/sites-available aus.

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 an (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.

Nächster Schritt

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