PDF Converter Plugin 5.6

The installation has the following steps. It is supposed the File Indexation Plugin 3.2 is installed.

1. PDFConverterPlugin : Follow the PluginManager installation process. Then restart the site.
2. OpenOffice installation and startup.
3. JODConverter web service installation and startup.
4. PDFConverter configuration.

OpenOffice installation and startup

1. Download OpenOffice 4.0 (or greater), and install it as explained in OpenOffice documentation.
2. Add the program sub directory of OpenOffice home directory to the path.
3. Launch OpenOffice to listen on port 8100 : soffice -headless -nofirststartwizard -accept="socket,port=8100;urp;"

NB : In the current version of the plugin, it's up to the system administrator to schedule Open Office launch at startup and to monitor it.

JODConverter web service installation, configuration and startup

The plugin is requesting a webservice, provided by a webapp named JODConverter (stands for Java OpenDocument Converter). This webapp has to be deployed on the same machine as OpenOffice, but the PDFConverter plugin calls the webservice remotely, then it's possible to install OpenOffice and JODConverter on another machine than the one of the JCMS application (but it is not mandatory).

The web service is provided by a J2EE webapp. You may either use the webapp embedded in a Tomcat unzipping jodconverter-tomcat-2.2.2.zip (make sure a convenient JDK is installed and JAVA_HOME is configured), or deploy the webapp jodconverter-webapp-2.2.2.zip in your favorite J2EE app server (even in the same app server as JCMS, but with a different context-path).

To restrict the acces to the web service, use a firewall. The web service does not provide restriction for a IP range. If needed, it's possible to create a SSL connection between the PDFConverterPlugin and the JODConverter web service.

There is a maximum size for incoming file in JODConverter web service. This may be modified. The default value is 4MB. The value to modify is in the XML file <jodconverter_webapp_base_dir>/WEB-INF/applicationContext.xml. Edit the value in \\beans\bean[@id=fileUpload]\property[@name=sizeMax]\value and set this to the maximum number of Bytes for the incomming files (8388608 for 8MB), and restart the webapp.

Installation of JODConverter embedded in tomcat

1. Install a JDK 1.5
2. Download jodconverter-tomcat-2.2.2.zip
3. Unzip jodconverter-tomcat-2.2.2.zip
4. Start the web service with jodconverter-tomcat-2.2.2/bin/startup.bat or jodconverter-tomcat-2.2.2/bin/startup.sh

PDFConverter configuration

In the PDFConverter properties interface :

    Admin space > Operation > Plugin Manager > PDF Converter Plugin >

       Administration > Properties,

set the value of the property OpenOffice conversion Web Service to <JODConverter_webapp_base_url>/converter/service.

It's possible to test the conversion service by calling the following url in a browser : <JODConverter_webapp_base_url>/converter.

This plugin requires JCMS 7.1 and is compatible with JCMS 8 and JCMS 9