Installation & Exploitation

Apparence

Intégration système et lancement des services ​

Lancement des services ​

transformation-server peut être lancé sous forme de service systemd ou sous forme de service Supervisor.

Lancement par systemd ​

Enregistrement pour lancement par systemd ​

  • Copier les fichiers lib/systemd/*.{service,timer} de description des services de transformation-server :
# cp $TE_HOME/lib/systemd/ted.service                 /usr/lib/systemd/system/

# cp $TE_HOME/lib/systemd/te-rendering-server.service /usr/lib/systemd/system/
# cp $TE_HOME/lib/systemd/te-request-server.service   /usr/lib/systemd/system/
# cp $TE_HOME/lib/systemd/te-tika-server.service      /usr/lib/systemd/system/

# cp $TE_HOME/lib/systemd/ted-cleantmpfiles.timer     /usr/lib/systemd/system/
# cp $TE_HOME/lib/systemd/ted-cleantmpfiles.service   /usr/lib/systemd/system/

  • Par défaut, ces fichiers de services systemd sont prévus pour un transformation-server installé dans /opt/transformation-server avec exécution des services sous l'utilisateur système te (c.f. TE_SERVER_USER) :

    • vérifier le répertoire des directives ExecStart pour correspondre à celui de votre répertoire d'installation ;
    • vérifier les directives User et Group pour référencer l'utilisateur système sous lequel seront exécutés les services.

  • Activer la target principale ted.service :

# systemctl enable ted.service

Démarrage/Arrêt des services TE ​

L'ensemble des services de transformation-server sont contrôlés via la target principale ted.service qui contrôlera à son tour les différents sous-services (te-rendering-server, te-request-server, et te-tika-server).

  • Démarrer la target ted.service :
# systemctl start ted.service
  • Pour arrêter les services :
# systemctl stop ted.service
  • Pour redémarrer tous les services :
# systemctl restart ted.service

Voir le statut des services ​

# systemctl status ted
# systemctl status te-rendering-server
# systemctl status te-request-server
# systemctl status te-tika-server

Lancement par Supervisor ​

Enregistrement pour lancement par Supervisor ​

  • Copier le fichier de description ted.conf dans le répertoire de configuration de Supervisor :

    • Sur Debian/Ubuntu :

      # cp $TE_HOME/lib/supervisord/ted.conf /etc/supervisor/conf.d/ted.conf

    • Sur RedHat/CentOS :

      # cp $TE_HOME/lib/supervisord/ted.conf /etc/supervisor.d/ted.ini

  • Par défaut, ce fichier de services Supervisor est prévu pour un transformation-server installé dans /opt/transformation-server avec exécution des services sous l'utilisateur système te (c.f. TE_SERVER_USER) :

    • vérifier le répertoire des directives command pour correspondre à celui de votre répertoire d'installation ;
    • vérifier la directive user pour référencer l'utilisateur système sous lequel seront exécutés les services.

  • Activer le groupe de service ted :

# supervisorctl reread
# supervisorctl add ted

Démarrage/Arrêt des services TE ​

L'ensemble des services de transformation-server peuvent être contrôlés via le groupe ted:* qui contrôlera à son tour les différents sous-services (te-rendering-server, te-request-server, et te-tika-server).

  • Démarrer le groupe de services ted:* :
# supervisorctl start ted:\*
  • Pour arrêter les services :
# supervisorctl stop ted:\*
  • Pour redémarrer tous les services :
# supervisorctl restart ted:\*

Voir le statut des services ​

# supervisorctl status ted:\*

Vérification des moteurs de transformation (bin/ted check) ​

Le script bin/ted permet de lancer une vérification des moteurs de transformations. Pour cela, il faut démarrer le serveur, et ensuite exécuter la commande suivante :

# $TE_HOME/bin/ted check

* Checking conversion from ODT to PDF...
  Ok: '/tmp/test.odtn27155.pdf' (7957 bytes)

* Checking conversion from ODT to PDF/A-1...
  Ok: '/tmp/test.odtQ27176.pdfa' (14430 bytes)

* Checking conversion from ODT to TXT...
  Ok: '/tmp/test.odtu27199.txt' (22 bytes)

[etc.]

Nettoyage des répertoires de travail (bin/ted cleantmpfiles) ​

L'option cleantmpfiles permet de supprimer les répertoires de travail des transformation nommés te-tasks-*, présents dans le répertoire $TE_WORK_DIR et qui ont plus de 7 jours (valeur par défaut).

# $TE_HOME/bin/ted cleantmpfiles

Le paramètre de la fonction permet de spécifier une autre durée (exprimée en jours).

Exemple : suppression des fichiers temporaires de plus de 15 jours

# $TE_HOME/bin/ted cleantmpfiles 15

Pour effectuer un nettoyage régulièrement, vous pouvez placer l'exécution de cette commande dans une crontab ou bien utiliser le service et le timer systemd ted-cleantmpfiles :

  • Pour les système supportant les timers systemd :

    # systemctl enable ted-cleantmpfiles.timer
# systemctl start ted-cleantmpfiles.timer

  • Pour les autres système, via une crontab :

    0 0 * * * * te /opt/transformation-server/bin/ted cleantmpfiles