Module de conversion PDF 4.0

L'installation se fait en plusieurs étapes. On suppose que le module d'indexation 3.2 est installé.

1. PDFConverterPlugin : suivre le processus d'installation de la gestion des modules JCMS, puis redémarrer le site JCMS.
2. Installation et démarrage d'OpenOffice.
3. Installation et démarrage  du service web JODConverter.
4. Configuration du module PDFConverter.

Installation et démarrage de OpenOffice

1. Télécharger OpenOffice 3.0 (ou version ultérieure), et réaliser l'installation comme expliqué dans la documentation de OpenOffice.
2. Ajouter le sous-répertoire program du répertoire d'installation de OpenOffice dans le path système.
3. Lancer OpenOffice pour écouter sur le port 8100 de la manière suivante : soffice -headless -nofirststartwizard -accept="socket,port=8100;urp;"

NB : Dans la version actuelle du plugin, c'est à l'administrateur système de plannifier le démarrage et de monitorer OpenOffice.

Installation, configuration et démarrage du service web JODConverter

Ce module repose sur un service web mis à disposition par une webapp J2EE appelée JODConverter (pour Java OpenDocument Converter). Cette webapp doit être déployée sur la même machine qu'OpenOffice, mais le module PDFConverter peut appeler le service web à distance. De cette manière, il est possible d'installer OpenOffice et JODConverter sur une autre machine que celle sur laquelle fonctionne l'application JCMS.

Le service web est produit par une webapp J2EE. On peut utiliser la webapp préinstallé dans Tomcat en décompressant jodconverter-tomcat-2.2.2.zip (assurez vous néanmoins q'un JDK soit installé et que la variable JAVA_HOME soit correctement configurée), ou bien déployer la webapp jodconverter-webapp-2.2.2.zip dans votre server d'application J2EE préféré (même dans le même serveur d'application que JCMS, avec un context path distinct).

Pour restreindre l'accés au service web, il est possible d'utiliser un firewall. Le web service ne fournit pas de restriction en fonction de la plage d'adresse IP de la requête. Si besoin est, il est possible d'établir une connexion SSL entre le module PDFConverter et le service web JODConverter.

Il y a une taille maximale concernant les fichiers soumis au service web JODConverter. Cette taille maximale peut être modifiée. La valeur par défaut est 4Mo. Cette valeur est à modifier dans le fichier XML suivant <jodconverter_webapp_base_dir>/WEB-INF/applicationContext.xml. Editer la valeur \\beans\bean[@id=fileUpload]\property[@name=sizeMax]\value et positionnez là au nombre maximum d'octets pour les fichiers soumis (8388608 pour 8MB), puis redémarrez la webapp.

Installation de JODConverterthe 

1. Installer un JDK 1.5
2. Télécharger jodconverter-tomcat-2.2.2.zip
3. Décompresser jodconverter-tomcat-2.2.2.zip
4. Démarrer le service web avec jodconverter-tomcat-2.2.2/bin/startup.bat ou jodconverter-tomcat-2.2.2/bin/startup.sh

Configuration de PDFConverter

Dans l'interface des propriétés :

    Espace d'administration > Exploitation > Gestion des modules >

       Module de conversion PDF > Administration > Propriétés,

positionner la valeur de la propriété Service Web de conversion OpenOffice à <JODConverter_webapp_base_url>/converter/service.

Il est possible de tester le service de conversion en appelant l'url dans un navigateur : <JODConverter_webapp_base_url>/converter.