Third-party software integration:

From OpenKM Documentation
(Redirected from
Jump to: navigation, search


OpenKM can convert some document types to PDF. This is a great help if need to read an Microsoft Office / document and you don't have the software installed in the computer.

Nota clasica.png OpenKM has been roughly tested with recent build of and LibreOffice, but in more recent Linux distros the most common used is LibreOffice.

In a recent Ubuntu or Debian release, you can install it simply as:

 $ sudo aptitude install


 $ sudo aptitude install libreoffice

In a recent Redhat/CentOS 6/7 or Fedora release, you can use:

sudo yum install libreoffice libreoffice-headless

To configure OpenKM and LibreOffice integration you have several configuration properties, but the most important one is system.openoffice.path with should be set to the OpenOffice (/usr/lib/openoffice) or LibreOffice (/usr/lib/libreoffice) installation path.

Learn more about OpenOffice / LibreOffice configuration parameters at Enable integration.

OpenKM 5.1

Configuration parameters are the same as OpenKM 5.0, but in this case they should not go into OpenKM.cfg file, but they are stored at database and configured at Administration > Configuration.

You can also configure OpenKM to use a remote server for OpenOffice document conversion.


Nota clasica.png This feature is under development and actually not released for public testing.

Nota idea.png If you have problems with OpenOffice / LibreOffice integration, take a look at OpenOffice configuration issues.

OpenKM 5.0

In this OpenKM some things changes. You can configure listen port and a maximun conversion tasks:


In case of LibreOffice and Linux, the system.openoffice.path property should be set to /usr/lib/libreoffice. Note that system.openoffice.tasks and system.openoffice.port have already a default value and is not needed to be set.

Nota advertencia.png Starting from OpenKM 5.0 you don't need to start as a service because OpenKM will take case of this. You only need to set the system.openoffice configuration property in OpenKM.cfg to the path of a working installation.




system.openoffice.path=C:/Program Files/ 3


system.openoffice.path=C:\\Program Files\\ 3

Nota idea.png If you have problems with OpenOffice / LibreOffice integration, take a look at OpenOffice configuration issues.

OpenKM 4.x and older versions

You need an installation in the OpenKM server, and also this application has to be running in server mode (also known as headless). In Debian / Ubuntu, depending of you version you will have to install an X11 virtual server or not:

$ apt-get install xvfb

And start it using this command:

$ xvfb-run /usr/lib/openoffice/program/soffice -headless -accept="socket,host=,port=8100;urp;" -nofirststartwizard

From 2.3, it is not necessary the X11 virtual server but you should install these packages:

$ aptitude install

But before of this, you must enable a couple of repositories:

 deb hardy-updates universe
 deb hardy-updates multiverse

This script simplifies the start process (For security reasons, you should no start as root):

/usr/lib/openoffice/program/soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" -nologo
 -headless -nofirststartwizard will listen at port 8100, so you can check that the application has started running this:

$ netstat -putan | grep 8100

Also you can configure as a service with this script:

# headless server script
# chkconfig: 2345 80 30
# description: headless openoffice server script
# processname: openoffice
# Author: Vic Vijayakumar
# Modified by Paco Avila and Federico Ch. Tomasczik
set -e
case "$1" in
        if [ -f $PIDFILE ]; then
            echo "OpenOffice headless server has already started."
            sleep 5
        echo "Starting OpenOffice headless server"
        $SOFFICE -headless -nologo -nofirststartwizard -accept="socket,host=,port=8100;urp" & > /dev/null 2>&1
        touch $PIDFILE
        if [ -f $PIDFILE ]; then
            echo "Stopping OpenOffice headless server."
            killall -9 soffice && killall -9 soffice.bin
            rm -f $PIDFILE
        echo "Openoffice headless server is not running."
        echo "Usage: $0 {start|stop}"
        exit 1
exit 0

Change the permissions to this file:

$ chmod 0755 /etc/init.d/openoffice

Install openoffice init script links:

For Debian based distros like Ubuntu

$ update-rc.d openoffice defaults

For RedHat based distros like CentOS

$ chkconfig --add openoffice

And this script will launch on every system reboot. Also you can launch it manually this way:

$ /etc/init.d/openoffice start

More info at:


Install Windows Server 2003 Resource Kit Tools in your computer for example at c:\tools

Create a openoffice service cd c:\tools

instsrv openoffice c:\tools\srvany.exe

Modify system registry using regedit, got to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\openoffice

Add key Parameters

Into Parameters add mew parameters key Application as REG_SZ ( String value ) with your server soffice.exe path, for example C:\Archivos de programa\ 3\program\soffice.exe

Into Parameter add new parameters key AppParameters as REG_SZ with value -nofirststartwizard -nologo -headless -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager

To start service type:

net start openoffice

To ensure service is well installed:

netstat -anp tcp

To delete the service type:

sc delete openoffice

More info at: