2.1 Pré-requis

2.1.1 Logiciels

PostgreSQL >= 9.x

Le TE utilise la base de donnée pour stocker les informations de gestion des travaux. Cette base de donnée peut être locale (sur le même serveur) ou distante.

PHP >= 5.4 (cli)

TE est écrit en PHP et nécessite donc l'interpréteur PHP (php-cli) avec les extensions suivantes :

curl
gettext
json
pcntl
pgsql
posix
SimpleXML

Java Runtime Environment 7 (ou 8)

TE nécessite un environnement Java 7 (ou 8) pour utiliser l'API Java d'OpenOffice en mode serveur et Apache Tika. Il est mis à disposition soit par OpenJDK ou par Oracle.

OpenOffice (4.1.4) ou LibreOffice (5.x)

TE nécessite Apache OpenOffice ou LibreOffice.

1.4.1 Les versions de LibreOffice 5.2, 5.3 et 5.4 ont été testées et sont compatibles.

Des différences peuvent exister dans le support et le rendu des documents entre OpenOffice et LibreOffice. Le choix de l'utilisation de l'un ou l'autre vous incombe donc en fonction de votre utilisation.

tika-server-1.16.jar

TE nécessite l'outil tika-server du projet Apache Tika pour l'extraction de texte (voir tika-server). À la date de rédaction de ces pré-requis, la version actuellement disponible et préconisée est la 1.16.

a2ps et ps2pdf14

TE utilise les outils a2ps et ps2pdf14 pour les conversions texte vers PDF. Ils sont fournis par a2ps et Ghostscript.

convert

TE utilise l'outil de conversion d'image convert (fourni par ImageMagick).

zip et unzip

TE utilise les commandes zip et unzip (fournie par Info-ZIP).

Script /lib/lsb/init-functions

TE utilise le script /lib/lsb/init-functions présent sur les systèmes Linux compatibles "Linux Standard Base". Dans le cas où ce script ne serait pas présent, il est possible qu'un paquet fournisse cette fonctionnalité (redhat-lsb sur les distribution RedHat Enterprise Linux par exemple).

2.1.2 Base de donnée TE

Le serveur TE utilise une base de données pour stocker les travaux qu'il gère et les logs associés.
Cette base peut être sur la machine hébergeant le serveur TE lui même ou sur un machine tierce.

2.1.2.1 Créer une base te sur votre serveur de base de données

# su postgres -c psql
postgres=# CREATE DATABASE "te" WITH OWNER "dynacaseowner";

2.1.2.2 Créer/ajouter le service postgresql pour l'accès à cette base te

# vi ${PGSYSCONFDIR}/pg_service.conf
 
...
 
[te]
host=127.0.0.1
port=5432
user=dynacaseowner
password=password
dbname=te

Note : La valeur de ${PGSYSCONFDIR} est dépendante de votre distribution, et peut être trouvée avec la commande : pg_config --sysconfdir.

2.1.2.3 Valider l'accès à la base de donnée te

# PGSERVICE=te psql
te=# \q

2.1.2.4 Paramétrage de la base de données te

2.1.2.4.1 Nombre maximum de connections

Le service TE comprend deux processus qui tournent en continue (te_request_server et te_request_renderer). Chacun de ces processus ouvre et maintient une connexion ouverte sur la base de donnée.

Ensuite, à chaque fork (pour le traitement d'un client pour te_request_server, ou le traitement d'une tâche pour te_request_renderer) une nouvelle connexion est faite sur la base de données.

Le nombre maximum de connections (max_connections) à la base de données est donc donné par la formule¹ :

Nombre max de connections Postgresql = 2 + REQUEST_MAX_CLIENT + RENDERING_MAX_CLIENT