Setup:Installationsanleitung/Systemvorbereitung/Linux/Apache und PHP: Unterschied zwischen den Versionen

[freigegebene Version][freigegebene Version]
(Markierung: 2017-Quelltext-Bearbeitung)
(Markierung: 2017-Quelltext-Bearbeitung)


icon required.png
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.

Installation[Bearbeiten | Quelltext bearbeiten]

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

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

Konfiguration von PHP[Bearbeiten | Quelltext bearbeiten]

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

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]

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.

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.

Apache: Not found

{{DISPLAYTITLE:Installation von Apache und PHP}}
        
        __TOC__
        

        {{Vorlage:Important|text=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==
        
        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:
        
<pre>
        
        apt update; \
        
        apt install apache2 \
        
            libapache2-mod-php7.3 \
        
            php7.3 \
        
            php7.3-cli \
        
            php7.3-common \
        
            php7.3-curl \
        
            php7.3-gd \
        
            php7.3-intl \
        
            php7.3-json \
        
            php7.3-mbstring \
        
            php7.3-mysql \
        
            php7.3-opcache \
        
            php7.3-tidy \
        
            php7.3-xml; \
        
        apt clean
        </pre>
        

        ==Konfiguration von PHP==
        
        Nach erfolgter Installation konfigurieren Sie nun zuerst PHP. Öffnen Sie hierzu mit einem Texteditor Ihrer Wahl (nano, vi) die <code>php.ini</code>, die sich bei dem hier referenzierten Debian im Verzeichnis <code>/etc/php/7.3/apache2</code> befindet.
        

        Suchen Sie folgende Einstellungen und ändern die Werte entsprechend. Sollte eine Einstellung mit einem vorangestellten Semikolon auskommentiert sein, so entfernen Sie dieses bitte.
        
<pre>
        
        date.timezone = Europe/Berlin
        
        max_execution_time = 600
        
        post_max_size = 128M
        
        upload_max_filesize = 128M
        </pre>
        

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

        Speichern und verlassen Sie die php.ini wieder.
        

        ==Konfiguration von Apache==
        
        {{Vorlage:Hint|text=In dieser Dokumentation wird von der empfohlenen Installation mit [https://www.mediawiki.org/wiki/Manual:Short_URL ShortURL] ausgegangen. Hierbei befindet sich das Wurzelverzeichnis des Webservers in <code>/var/www/bluespice</code>, der eigentliche Source-Code von BlueSpice aber in <code>/var/www/bluespice/w</code>. Diese Konfiguration ist entsprechend hierauf ausgelegt.}}
        

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

        # Wechseln Sie in das Verzeichnis <code>/etc/apache2/sites-available</code>.
        
        # Öffnen Sie in einem Texteditor Ihrer Wahl die noch nicht existierende Datei <code>bluespice.conf</code> und legen diese dadurch an. Kopieren Sie den kompletten Inhalt folgender Datei in diese neue Konfigurationsdatei:
        
        ## Bei BlueSpice free: [[:Medium:Setup:apache_vhost_bluespice_free.txt|apache_vhost_bluespice_free.txt]]
        
        ## Bei BlueSpice pro: [[:Medium:Setup:apache_vhost_bluespice_pro.txt|apache_vhost_bluespice_pro.txt]]
        
        # 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.
        
        # 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 <code>a2dissite 000-default</code>. Anschließend aktivieren Sie den soeben angelegten VirtualHost mit dem Befehl <code>a2ensite bluespice</code>.
        

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

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

        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.
            

            [[Datei:Setup:apache not found.png|400px|border|Apache: Not found]]
Zeile 64: Zeile 64:
  
 
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.
 
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.
 +
 +
[[Datei:Setup:apache not found.png|400px|border|Apache: Not found]]

Anhänge

Diskussionen