Installation von Softwarepaketen

Benötigt

OpenJDK 8

FACT-Finder benötigt Java 8. Mit der OpenJDK-Variante haben wir die besten Erfahrungen gemacht, so dass wir dieses empfehlen.

Leider befindet sich dies nicht im Debian 8 Repository, so dass es über das Backports Repository bezogen werden muss. Hierzu muss in der Datei /etc/apt/sources.list folgender Eintrag ergänzt werden:

deb http://http.debian.net/debian jessie-backports main

Im Anschluss muss nun apt-get die neuen Informationen abholen und man kann Java 8 installieren

sudo apt-get update
sudo apt install openjdk-8-jre-headless

Danach sollte über java -version geprüft werden, ob Java 8 korrekt installiert wurde. Die Ausgabe sollte etwa wie folgt aussehen:

openjdk version "1.8.0_121"
OpenJDK Runtime Environment (build 1.8.0_121-8u121-b13-1~bpo8+1-b13)
OpenJDK 64-Bit Server VM (build 25.121-b13, mixed mode)

Apache Tomcat 8

Alle drei FACT-Finder Anwendungen sind Java-Webanwendungen, weswegen diese in einem Applicationserver betrieben werden müssen. Hierzu benutzen wir Apache Tomcat 8. Generell ist auch Tomcat 7 möglich, dann ist jedoch darauf zu achten, dass mindestens die Version 7.0.56 verwendet wird.

Tomcat lässt sich auch über ein Paket installieren:

sudo apt-get install tomcat8 tomcat8-admin

Locale

FACT-Finder verwendet im Kern standardmäßig die Locale en_US.utf8 und en_US.iso88591, so dass diese auf dem System installiert sein müssen. Bitte überprüfen Sie daher ob mindestens eine der Locales installiert ist, dies lässt sich über den unteren Befehl durchführen.

locale -a

Sollte keine der Locales auf dem System vorhanden sein, müssen Sie diese noch über das Menü installieren, welches sich nach Eingabe des unteren Befehls öffnet. Es ist nicht notwendig, dass eine der Locales als Systemstandard gesetzt wird.

Nach Eingabe des unteren Befehls öffnet ein Fenster, indem Sie die Locale installieren können. Als Systemstandard muss diese nicht gesetzt sein.

sudo dpkg-reconfigure locales

PostgreSQL 9.4 (bei Personalisierung im Clusterbetrieb)

Sollten Sie das Personalisierungsmodul im Clusterbetrieb nutzen wollen, so ist PostgreSQL in der Version 9.4 zwingend vorausgesetzt. Andere Versionen werden nicht unterstützt.

Empfohlen

OpenMP/Libgomp

FACT-Finder unterstützt die OpenMP-Bibliothek (http://openmp.org/wp/). Mit Hilfe dieser Bibliothek kann der FACT-Finder Kern einzelne Suchanfragen parallelisiert abarbeiten. Mehrere Suchanfragen arbeitet FACT-Finder auch ohne OpenMP parallel ab. Eine Installation ist daher erst ratsam, wenn das System über mehrere Kerne verfügt.

Für einen stabilen Betrieb muss mindestens Version 4.5 installiert werden. Wir empfehlen die Version 4.9 einzusetzen, die auch bereits von Debian 8 verwendet wird.

sudo apt-get install libgomp1

Für Windows finden sie das Paket unter folgenden Links: 32 Bit, 64 Bit.

libtcmalloc

Auf einigen Systemen haben wir über längere Zeit einen Anstieg des Speicherverbrauchs beobachtet, welcher durch Einsatz eines anderen Garbage Collectors vermieden worden konnte. Zusätzlich hat sich durch die Verwendung von tcmalloc die Performance verbessert, so dass wir diesen empfehlen.

sudo apt-get install libtcmalloc-minimal4

tcmalloc kann wie folgt ergänzt werden, damit man weiß, wie das aktiviert und getestet werden kann:

Fügen Sie die Exportzeile hinzu, z.b. unter /usr/share/tomcat8/bin/setenv.sh oder einem tomcat-ini Skript in /etc setzen (etc/default/tomcat8) via

export LD_PRELOAD=/usr/lib/libtcmalloc_minimal.so.4

Neustart des Tomcat und Prüfung über 

grep malloc /proc/[TOMCAT-PROCESS-ID]/maps

Werden hier Einträge ausgegeben, so waren Installation und Aktivierung erfolgreich.

PostgreSQL 9.4 (bei Personalisierung ohne Clusterbetrieb)

Sollten Sie das Personalisierungsmodul ohne Clusterbetrieb nutzen, so empfehlen wir trotzdem PostgreSQL in der Version 9.4 um einen korrekten Betrieb zu gewährleisten.

Weitere Hinweise

Server mit mehr als vier Kernen

Wenn Server mit mehr als 4 Kernen verwendet werden, ist es meist sinnvoll, die Kerne pro Anfrage auf 4 zu begrenzen und lieber mehrere Anfragen parallel zu verarbeiten, weil die Verteilung der Arbeit auf mehr als 4 Kerne und das Zusammenführen der Teilergebnisse sonst den Gewinn an Geschwindigkeit wieder auffrisst.

Fügen Sie die Exportzeile hinzu, z.b. unter /usr/share/tomcat8/bin/setenv.sh oder einem tomcat-ini Skript in /etc setzen (etc/default/tomcat8) via

e

Firewalleinstellungen prüfen

Sie sollten zur Einrichtung eines FACT-Finder-Servers prüfen, ob der Port, auf dem später der Tomcat laufen soll (Standardeinstellung: 8080), in der Firewall freigeschaltet und somit von außen erreichbar ist.

Synchronisation der Uhrzeit

Die erweiterte Authentifizierung von FACT-Finder verwendet unter anderem einen Zeitstempel, um Replay-Attacken vorzubeugen. Daher muss die Uhrzeit auf dem Server-System synchronisiert sein. Hierfür empfehlen wir chrony, was ebenfalls als Debian-Paket über unteren Befehl installiert werden kann.

sudo apt-get install chrony