Skip to content

[DE] 2. Installation

Jump to bottom
SkyhawkXava edited this page Jan 14, 2020 · 21 revisions

| ⌂ | ☰ | ◁ | ▷ |

2.1 Vorbemerkung/Voraussetzungen
2.2 Systemvoraussetzungen
2.2.1 Webserver
2.2.2 PHP
2.3 Installation
2.3.1 Linux & Co.
2.3.2 Microsoft Windows und IIS
2.4 Anpassung der Konfigurationsdatei SEPXXXXXXXXXXX.cnf.xml

2.1 Vorbemerkung/Voraussetzungen

Als Basis dient ein Webserver. Dieser kann entweder auf einem separaten Server laufen oder mittels freetz auf der FRITZ!Box selbst. Es wird somit vorausgesetzt, dass bereits ein Webserver mit PHP zur Verfügung steht.

2.2 Systemvoraussetzungen:

  • Standalone Webserver ("Apache 2", "Microsoft IIS") oder "freetz" auf der FRITZ!Box.
  • "PHP" Version 5.3 oder höher mit den Erweiterungen/Modulen libcurl, libxml und mbstring.

2.2.1 Webserver

Die Praxis hat gezeigt, dass sowohl "Apache 2" als auch "Microsoft IIS" als Webserver geeignet sind.

2.2.2 PHP

fritzco wird in der Skriptsprache PHP entwickelt, entsprechend muss PHP auf dem Webserver zur Verfügung stehen.

Benötigte Erweiterungen/Module:

fritzco benötigt folgende Erweiterungen/Module:

2.3 Installation

2.3.1 Linux & Co.

Hinweis: Nachfolgendes Vorgehen bzw. die nachfolgenden Konsolenbefehle gehen davon aus, dass eine "Debian"-Distribution oder eine darauf aufbauende Distribution installiert ist. Benutzernamen und Gruppen sowie Pfade und ggf. Paketnamen sind an die eigene "Linux"-Installation bzw. die jeweils installierten Distribution anzupassen.

  1. Prüfen, ob der "Apache 2"-Webserver installiert ist. Zum Beispiel mit einem der nachfolgenden Konsolenbefehlen:

    dpkg --get-selections | grep apache

    oder

    dpkg -l apache2

    oder

    aptitude show apache2

  2. Wenn der "Apache 2"-Webserver nicht installiert ist, folgenden Befehl in der Konsole ausführen:

    sudo apt-get -y install apache2

  3. Prüfen, ob "PHP" installiert ist, zum Beispiel mit einem der nachfolgenden Konsolenbefehlen:

    dpkg --get-selections | grep php

    oder

    dpkg -l php-common

    oder

    aptitude show php-common

  4. Wenn "PHP" noch nicht installiert ist, dann mit folgenden Befehlen in der Konsole installieren:

    sudo apt-get update
    sudo apt-get -y install php-common php-curl php-xml php-mbstring

  5. Prüfen, ob die "PHP"-Erweiterungen/-Module mbstring und libcurl bereits installiert sind. Zum Beispiel mit einem der nachfolgenden Konsolenbefehle:

    dpkg --get-selections | egrep '(php-mbstring|php-curl|php-xml)'

    oder

    dpkg -l php-curl und dpkg -l php-mbstring und dpkg -l php-xml

    oder

    aptitude show php-curl und aptitude show php-mbstring und aptitude show php-xml

  6. Wenn die "PHP"-Erweiterungen/-Module libcurl oder mbstring noch nicht installiert sind, diese nachinstallieren und aktivieren.

    Zunächst sudo apt-get update in der Konsole ausführen.

    Wenn das Paket php-curl nicht installiert sein sollte, dann anschließend

    sudo apt-get -y install php-curl

    in der Konsole ausführen.

    Wenn das Paket php-mbstring nicht installiert sein sollte, dann anschließend

    sudo apt-get -y install php-mbstring

    in der Konsole ausführen.

    Wenn das Paket php-mbstring nicht installiert sein sollte, dann anschließend

    sudo apt-get -y install php-xml

    in der Konsole ausführen.

  7. Aktuelles Release von fritzco unter

    herunterladen und (beispielsweise im "Home"-Verzeichnis ~) speichern.

  8. In der Konfigurationsdatei des "Apache 2"-Webservers prüfen wo sich das Root-Verzeichnis des Webservers befindet. In der Regel ist die entsprechende Konfigurationsdatei unter /etc/apache2/sites-available/000-default.conf zu finden. Oder folgenden Befehl in der Konsole ausführen:

    cat /etc/apache2/sites-available/000-default.conf | grep DocumentRoot

  9. Den Inhalt des heruntergeladenen Zip-Archivs im Root-Verzeichnis des Webservers – entweder in das Stammverzeichnis oder in einen Unterordner – entpacken. Hierzu mit dem Konsolenbefehl

    cd /[Verzeichnispfad]

    in das Verzeichnis wechseln und dort den Konsolenbefehl

    unzip ./fritzco1-2.zip -d /[Pfad zum Apache 2-Dokumentenroot]

    ausführen.

  10. Prüfen, welcher Benutzer den Webserver-Prozess (Daemon/Dienst) ausführt. Bei "Debian" sollten der Benutzer und die Gruppe des "Apache 2"-Prozesses (daemon-Prozess) www-data lauten. Dies kann in der Konfigurationsdatei des "Apache 2" (/etc/apache2/apache2.conf) mit nachfolgendem Konsolenbefehl geprüft werden:

    cat /etc/apache2/envvars | egrep '(APACHE_RUN_USER|APACHE_RUN_GROUP)'

  11. Diesem Benutzer auf alle Unterordner und Dateien Leserechte und für die Unterordner ./books/ und ./log/ zusätzlich Schreibrechte mit nachfolgenden Konsolenbefehlen zuweisen.

    sudo chown -R www-data:wwwdata /var/www/html/fritzco
    sudo chmod -R 544 /var/www/html/fritzco
    sudo chmod -R 744 /var/www/html/fritzco/books
    sudo chmod -R 744 /var/www/html/fritzco/log

  12. Konfiguration in den Konfigurationsdateien im Unterordner ./config/ vornehmen.

  13. Die Konfiguratonsdatei SEPXXXXXXXXXXX.cnf.xml des Telefons auf dem TFTP-Server wie weiter unten beschrieben anpassen.

2.3.2 Microsoft Windows und IIS

Hinweis: Zur Verwendung auf einem "Windows"-Server mit "IIS" ("Internet Informationsdienste") muss "PHP" als "Handler" hinzugefügt und die nötigen Module aktiviert werden.

  1. Download der aktuellen "PHP"-Dateien als "NonThreadSafe":

  2. Erstellen eines neuen Ordners unter %programfiles%\PHP.

  3. Entpacken der zuvor heruntergeladenen "PHP"-Dateien in den neu erstellten Ordner %programfiles%\PHP.

  4. Öffnen des "Internet Informationsdienste (IIS)"-Managers und Aufrufen des lokalen Servers.

  5. Öffnen der "Handlerzuordnungen" und Auswahl "Modulzuordnung hinzufügen...".

  6. Konfiguration für "PHP":

    • Anforderungspfad: *.php
    • Modul: FastCgiModule
    • Ausführbare Datei: %programfiles%\PHP\php-cgi.exe
    • Name: PHPFastCGI

  7. Den Ordner %programfiles%\PHP im "Explorer" mit folgenden Schritten öffnen:

    1. Die Tasten [Windows-Taste]+[E] gleichzeitig drücken.
    2. Die Tasten [ALT]+[E] gleichzeitig drücken.
    3. In dem nun fokussierten Eingabefeld (Adressfeld) den Pfad %programfiles%\PHP eingeben und mit der [ENTER]-Taste bestätigen.

  8. Die Datei php.ini-production in einem Editor (z. B. mit "Notepad++") öffnen.

  9. Die Datei mit Datei▷Speichern unter... in den Ordner %programfiles%\PHP unter dem Dateinamen php.ini speichern. (Den Editor jetzt noch nicht schließen.)

  10. In der noch im Editor geöffneten Datei %programfiles%\PHP\php.ini die nachfolgenden Parameter entkommentieren bzw. hinzufügen:

    • Zeile 589: error_log = syslog (Kann im Produktivbetrieb wieder entfernt werden.)
    • Zeile 915: extension = "%programfiles%\PHP\ext\php_curl.dll"
    • Zeile 924: extension = "%programfiles%\PHP\ext\php_mbstring.dll"
      (Hinweis: Die Zeilennummern können abweichen)

  11. Datei speichern (üblicherweise mit [STRG]+[S]) und den Editor schließen.

  12. Im "Explorer" das "Root"-Verzeichnis C:\inetpub\wwwroot des "IIS"-Webservers öffnen.

    1. Die Tasten [Windows-Taste]+[E] gleichzeitig drücken.
    2. Die Tasten [ALT]+[E] gleichzeitig drücken.
    3. In dem nun fokussierten Eingabefeld (Adressfeld) den Pfad C:\inetpub\wwwroot eingeben und mit der [ENTER]-Taste bestätigen.

  13. Im nun geöffneten "Root"-Verzeichnis des "IIS"-Webservers eine neue Datei mit dem Dateinamen test.php erstellen.

  14. Die Datei mit einem Editor (z. B. "Notepad++") öffnen und folgenden Inhalt einfügen:

        <?php
            phpinfo();
        ?>

  1. Datei speichern (üblicherweise mit [STRG]+[S]) und den Editor beenden.

  2. Einen beliebigen Webbrowser (z. B. "Mozilla Firefox") starten und die URL

    öffnen.

  3. Nun auf der angezeigten Webseite prüfen, ob die nötigen Module libcurl und mbstring aktiviert sind.

  4. Wenn die Prüfung negativ ausfällt, nochmals die die Konfigurationsdatei %programfiles%\PHP\php.ini in einem Editor öfnnen und mit Schritt Nr. 10 fortsetzen.

  5. Aktuelles Release von fritzco unter

    herunterladen.

  6. Den Speicherort der heruntergeladenen ZIP-Datei (üblicherweise %USERPROFILE%\Downloads) im "Explorer" öffnen.

    1. Die Tasten [Windows-Taste]+[E] gleichzeitig drücken.
    2. Die Tasten [ALT]+[E] gleichzeitig drücken.
    3. In dem nun fokussierten Eingabefeld (Adressfeld) den Pfad %USERPROFILE%\Downloads eingeben und mit der [ENTER]-Taste bestätigen.

  7. Die fritzco-ZIP-Datei in das "Root"-Verzeichnis des "IIS"-Webservers unter C:\inetpub\wwwroot entpacken.

  8. Setzen der Berechtigung "Schreiben" für die Unterordner \books und \log für den Benutzer IIS_IUSRS.

  9. Konfiguration in den Konfigurationsdateien im Unterordner \config vornehmen.

  10. Die Konfiguratonsdatei SEPXXXXXXXXXXX.cnf.xml des Telefons auf dem TFTP-Server wie weiter unten beschrieben anpassen.

2.4 Anpassung der Konfigurationsdatei SEPXXXXXXXXXXX.cnf.xml

Folgendes in die Konfigurationsdatei SEPXXXXXXXXXXX.cnf.xml des Telefons auf dem TFTP-Server hinzufügen:

    <phoneServices>
        <provisioning>2</provisioning>
        <phoneService  type="1" category="0">
            <name>Telefonbuch</name>
            <url>http://yourServer.abc/directory.php</url>
            <vendor></vendor>
            <version></version>
        </phoneService>
    </phoneServices>
Clone this wiki locally