Anforderungen

Anforderungen

Installation via Docker

Es ist möglich Part-DB via Docker/Docker-Compose zu installieren, dann müssen diese und die Schritte auf der "Installations"-Seite nicht befolgt werden. Für weitere Infos siehe https://github.com/Part-DB/Part-DB-docker (bisher nur auf Englisch verfügbar)

---

Damit Part-DB einwandfrei läuft, müssen folgende Kriterien erfüllt sein:

• Webserver mit mindestens 20MB Platz (mit Footprint-Bilder mindestens 60MB)
• PHP >= 5.6.0 empfohlen, (niedrigere Versionen nicht getestet, minimum 5.4.0), empfohlen wird php7 mit PDO inkl. MySQL Plugin und MBStrings, weiterhin wird die Gettext-Erweiterung benötigt. Empfohlen wird auch die Installation der Intl-Erweiterung und der curl-Erweiterung
• Empfohlen wird die Installation eines Caches (wie php7.0-opcache) um die Performance zu erhöhen
• MySQL/MariaDB Datenbank mit der Speicherengine InnoDB
• Webbrowser mit JavaScript und HTML5 Unterstützung.

Installation der notwendigen Serverkomponenten

Wenn Sie Ihren eigenen Webserver aufsetzten möchten, finden Sie hier eine kleine Anleitung. Der Server kann dabei ein physischer Computer im Netzwerk, oder auch nur eine virtuelle Maschine (z.B. VirtualBox oder VMware) sein. Sie können Part-DB aber auch auf einem Webspace installieren, den Sie bei einem Hoster mieten, sofern dieser die Anforderungen von Part-DB erfüllt. Dann brauchen Sie die Serverkomponenten nicht selber zu installieren, sondern können direkt mit der Installation von Part-DB beginnen.

Debian / Ubuntu

Alle erforderlichen Komponenten können über das Terminal installiert werden (oder auch im Software-Center):

• PHP7: sudo apt-get install apache2 php7.0 mysql-server php7.0-mysql php7.0-curl libapache2-mod-php7.0 phpmyadmin php7.0-opcache php7.0-gettext php7.0-intl
• PHP5: sudo apt-get install apache2 php5 mysql-server php5-mysql php5-curl libapache2-mod-php5 php5-gettext php5-intl phpmyadmin

Bei der Installation von MySQL wird nach einem Passwort für den MySQL-Benutzer "root" gefragt. Lassen Sie dieses Feld auf keinen Fall leer, sonst haben Sie später keinen Zugriff über phpMyAdmin! Dieses Passwort (das nicht mit dem Passwort des System-Benutzers "root" übereinstimmen muss) brauchen Sie, um sich später über phpMyAdmin einzuloggen.

Bei der Installation von phpMyAdmin werden Sie eventuell mit Fragen konfrontiert. Diese sollten wie folgt beantwortet werden:

• Frage: Welchen Webserver möchten Sie automatisch konfigurieren?
  • Antwort: apache2
• Frage: Möchten Sie phpMyAdmin mit "dbconfig-common" konfigurieren?
  • Antwort: Ja
• Frage: Passwort des administrativen Datenbank-Benutzers?
  • Antwort: Das gleiche Passwort, das man für den Benutzer "root" bei der Installation von MySQL angegeben hat
• Frage: MySQL-Anwendungspasswort für phpMyAdmin?
  • Antwort: Ohne Eingabe einfach OK (bzw. Enter) drücken

Weitere Informationen und Installationsanleitungen gibts (speziell für Ubuntu) im ubuntuusers Wiki: Apache, PHP, MySQL, MySQL-Werkzeuge

Apache konfigurieren

Part-DB verwendet ".htaccess"-Dateien, um gewisse Verzeichnisse vor unerlaubtem Zugriff zu schützen. Diese werden aber in der Standardkonfiguration von Apache meistens nicht berücksichtigt, was ein Sicherheitsrisiko darstellt! Diese Einstellung sollte unbedingt geändert werden.

Zusätzlich empfiehlt es sich, "Directory Listing" global zu deaktivieren, damit die Dateien und Verzeichnisse des Webservers nicht über den Webbrowser durchsucht werden können.

Unter Debian/Ubuntu wird dies folgendermassen gemacht:

sudo gedit /etc/apache2/sites-available/default

Dort im Block "<Directory /var/www/> ... " die Zeile "AllowOverride None" durch "AllowOverride All", und "Options Indexes [...]" durch "Options -Indexes [...]" ersetzen. Datei speichern und schliessen. Danach Apache neu starten:

sudo service apache2 restart

Nähere Informationen dazu gibts z.B. hier: https://help.ubuntu.com/community/EnablingUseOfApacheHtaccessFiles

PHP konfigurieren

Die Standardeinstellungen von PHP sind in der Regel ganz in Ordnung. Möchte man aber auch etwas grössere Dateien hochladen können (z.B. Dateianhänge in Part-DB), muss man eventuell das Dateigrössen-Limit für Uploads anpassen. Dies macht man in der Datei "php.ini", welche sich bei Debian-basierten Betriebssystemen im Verzeichnis "/etc/php5/apache2/" befindet.

sudo gedit /etc/php5/apache2/php.ini

In dieser Datei nach dem Stichwort "upload_max_filesize" suchen und den Wert entsprechend anpassen. Ausserdem müssen die Werte "post_max_size" und "memory_limit" mindestens gleich gross sein wie "upload_max_filesize".

Installation überprüfen

Ob Apache erfolgreich installiert wurde, kann man überprüfen, indem man auf dem Server die Seite http://localhost im Webbrowser aufruft. Hier muss die Meldung "It works!" erscheinen.

Ob phpMyAdmin und MySQL korrekt funktionieren, kann man überprüfen, indem man sich auf http://localhost/phpmyadmin mit dem MySQL Benutzer "root" und dem bei der Installation von MySQL angegebenen Passwort einloggt.

Die Adresse http://localhost funktioniert jeweils nur auf dem Server selbst. Die genannten Webseiten können aber auch von anderen PCs, die sich im gleichen Netzwerk wie der Server befinden, aufgerufen werden. Dann müssen Sie "localhost" durch die IP-Adresse des Servers ersetzen.

Falls phpMyAdmin nicht aufgerufen werden kann, muss eventuell noch ein Symbolischer Link erzeugt werden: sudo ln -s /usr/share/phpmyadmin /var/www/phpmyadmin

Installation der Sprachdateien

Falls die gewünschte Sprache für Part-DB noch nicht installiert ist, kann man sie noch nachinstallieren. Dies ist meistens nicht notwendig, da man normalerweise das Betriebssystem ja schon in derjenigen Sprache installiert, die man nachher benutzen möchte. Es kann aber mal sein dass man nur ein englisches Betriebssystem zur Verfügung hat, dann muss man die deutschen Sprachdateien noch manuell installieren.

Dies sollte mit folgendem Befehl möglich sein:

sudo locale-gen de_DE.utf8

Damit wird die Sprache "Deutsch (Deutschland)" installiert. Es kann sein, dass man "de_DE.utf8@euro" eingeben muss, damit das Eurozeichen als Währungssymbol verwendet wird.

Unter Windows ist dies nicht (zumindest unter Apache) nicht nötig, dort wird immer die Sprache des Systems verwendet.

Installation von Part-DB

Ist die Installation der Serverkomponenten erfolgreich abgeschlossen, kann man nun mit der Installation von Part-DB beginnen. Wie das geht, ist hier beschrieben.