2.4 CLI de contrôle du TE

2.4.1 Démarrage/Arrêt des services de TE (ted start) (ted stop)

Démarrage ted start

Le script démarre les services OpenOffice, Tika et TE (communication et transformation).

# $TE_HOME/bin/ted start
Starting (te-ooo-server) OOO server (LibreOffice 5.4)... 20307
Starting (te-tika-server) Tika server... 20366
Starting (te-request-server) TE Request server... 20417
Starting (te-rendering-server) TE Rendering server... 20475
 * Starting ted service:  OK

Le script ted lance les quatre services, et affiche leur PID. Les erreurs d'activation sont signalées sur la console de lancement.

Arrêt ted stop

Le script arrête les services TE (communication et transformation), Tika et OpenOffice.

# $TE_HOME/bin/ted stop
Stopping (te-request-server) TE Request server... 20417
Stopping (te-rendering-server) TE Rendering server... 20475
Stopping (te-tika-server) Tika server... 20366
Stopping (te-ooo-server) OOO server (LibreOffice 5.4)... 20307
 * Stopping ted service:  OK

Il est aussi possible de contrôler chacun de service indépendamment en spécifiant son nom :

# $TE_HOME/bin/ted stop te-ooo-server
Stopping (te-ooo-server) OOO server (LibreOffice 5.4)... 20631
 * Stopping ted service:  OK

# $TE_HOME/bin/ted start te-ooo-server
Starting (te-ooo-server) OOO server (LibreOffice 5.4)... 21096
 * Starting ted service:  OK

2.4.2 Statut des services de TE (ted status)

# $TE_HOME/bin/ted status
(te-request-server) TE Request server running (20743)
(te-rendering-server) TE Rendering server running (20801)
(te-tika-server) Tika server running (20692)
(te-ooo-server) OOO server (LibreOffice 5.4) running (20631)

Le script ted affiche pour chacun des quatre services s'ils sont en fonction ou non, et leur PID (Process Identifier).

Il est aussi possible d'interroger le status d'un service spécifique en spécifiant son nom :

# $TE_HOME/bin/ted status te-ooo-server
(te-ooo-server) OOO server (LibreOffice 5.4) running (21096)

2.4.3 Vérification des moteurs de transformation (ted check)

Le script ted permet de lancer une vérification des moteurs de transformations. Pour cela, il faut démarrer le serveur (voir ted start), 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.]

Si le nom d'hôte/nom de domaine du système est mal configuré, les temps de conversion peuvent être long du fait de timeouts de résolution de noms lors de la connexion au serveur OOo. Pour corriger cela, le nom d'hôte (tel que retourné par la commande hostname) et le nom de domaine (tel que retourné par la commande dnsdomainname) doivent être corrects, et que le fichier /etc/hosts est correctement renseigné.

2.4.4 Nettoyage des répertoires de travail (ted cleantmpfiles)

L'option cleantmpfiles permet de supprimer les répertoires de travail des transformation nommés te-task-*, 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 pour supprimer les fichiers temporaires de plus de 15 jours :

# $TE_HOME/bin/ted cleantmpfiles 15

Pour effectuer le nettoyage régulièrement, La commande peut être placée dans une crontab.

2.4.5 Automatisation des démarrages/arrêts

Pour que TE démarre, et s'arrête, lors du démarrage, et l'arrêt, du système, le script ted doit être intégré au système d'initialisation de votre serveur.

Exemple pour les distributions de type RedHat et Debian :

Distribution de type RedHat

Les distributions de type RedHat utilisent la commande chkconfig pour administrer les scripts rc/init.

Faire un lien symbolique de $TE_HOME/bin/ted dans le répertoire /etc/rc.d/init.d/ :

# ln -sf $TE_HOME/bin/ted /etc/rc.d/init.d/ted

Enregistrer ted :

# chkconfig --add ted
# chkconfig ted on
# chkconfig --list ted
ted             0:arrêt 1:arrêt 2:marche        3:marche        4:marche        5:marche        6:arrêt

Distribution de type Debian

Les distributions de type Debian utilisent la commande update-rc.d pour administrer les scripts rc/init.

Faire un lien symbolique de $TE_HOME/bin/ted dans le répertoire /etc/init.d/ :

# ln -sf $TE_HOME/bin/ted /etc/init.d/ted

Enregistrer ted :

# update-rc.d ted defaults
Adding system startup for /etc/init.d/ted ...
 /etc/rc0.d/K20ted -> ../init.d/ted
 /etc/rc1.d/K20ted -> ../init.d/ted
 /etc/rc6.d/K20ted -> ../init.d/ted
 /etc/rc2.d/S20ted -> ../init.d/ted
 /etc/rc3.d/S20ted -> ../init.d/ted
 /etc/rc4.d/S20ted -> ../init.d/ted
 /etc/rc5.d/S20ted -> ../init.d/ted