We apologize for untranslated text, you can use the Google Translation button to get an automatic translation of the web page in the language of your choice.

PDF Converter Plugin 2.1


This plugin converts most of usual files format (doc, xls, ppt, ...) to PDF.

The plugin is based on :

  • OpenOffice 2.3 (or greater), launched as a service;
  • JODConverter 2.2 API.
  • The File indexer plugin 3.2. Version 2.1 of the PDF converter is good for File indexer plugin version 3.2.

Warning! This production license of this module is not free. Licensees of JCMS Universal. can use it in production environment.


The installation has the following steps. It is supposed the File Indexation Plugin 3.1 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 2.3 (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.0.zip (make sure a convenient JDK is installed and JAVA_HOME is configured), or deploy the webapp jodconverter-webapp-2.2.0.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.0.zip
  3. Unzip jodconverter-tomcat-2.2.0.zip
  4. Start the web service with jodconverter-tomcat-2.2.0/bin/startup.bat or jodconverter-tomcat-2.2.0/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.


PDF Converter Plugin - Version 2.1


  • [code]Generics are used
  • [PDFCONV-9] - Add a quick access to the PDF version of a FileDocument
  • [PDFCONV-10] - Add a simple way to regenerate PDF - add a metadata about the date of the PDF
  • Add Live update of properties
  • Add a log to tell when the PDF converter is available while it was not previously
  • Bug : File DONOTERASE.txt was referenced as DONOTERASE.TXT in plugin.xml, then the file was unreachable under Unix OS

PDF Converter Plugin - Version 2.0

  • Compatibility with JCMS 6.0 and FPP 3.0

PDF Converter Plugin - Version 1.1

New Feature

  • Test avalability of OpenOffice with an simple text file. (used by FileProcessor 2.2 or more)

PDF Converter Plugin - Version 1.0.2


  • Operation is considered as good if PDF already exists

PDF Converter Plugin - Version 1.0.1


  • [PDFCONV-6] - Some IllegalThreadStateException thrown


  • [PDFCONV-7] - Sometimes, exception arise because of HttpClient SoSocket Timeout

PDF Converter Plugin - Version 1.0

New Feature

  • [PDFCONV-1] - [functionnality]Create a processor that make conversion in PDF through OpenOffice
  • [PDFCONV-3] - Create a parser for all files processed by the PDFConverter based on the associated PDF


  • [PDFCONV-4] - Converter only on main leader if file replication is deactivated


1. May I use Open Office 3.0 ?

You may use Open Office 3.0. But if it is installed on a Linux server, because of a bug of OpenOffice, it is mandatory to use JODConverter 2.2.2.


  • 2.1
  • Stable
  • JCMS 6.0 SP1
Certified by Jalios
  • Yes
  • Module payant
  • Jalios Support
  • Jalios SA
  • Jalios
  • 1.27 MB
  • 3/6/09
Required Plugins
File Indexing
v 3.3.2