There’re several ways to install it, we use to install in Ubuntu but can be used any other Linux flavor.
Enable the partner repository:
sudo su
vi /etc/apt/sources.lst
Uncomment the following lines:
deb http://archive.canonical.com/ubuntu lucid partner
deb-src http://archive.canonical.com/ubuntu lucid partner
Install needed packages:
Execute on terminal the command
$ sudo aptitude install sun-java6-bin sun-java6-jdk sun-java6-jre imagemagick openoffice.org-core openoffice.org-java-common openoffice.org-writer openoffice.org-impress openoffice.org-calc swftools tesseract-ocr
set the Java Home environment variable
vi /etc/environment
add this line at the end of the file:
JAVA_HOME="/usr/lib/jvm/java-6-sun/"
Now update the environment variables:
# source /etc/environment
Install OpenKM
Download (
http://www.openkm.com/Download.html) OpenKM 5.0.x + JBoss 4.2.3.GA bundle and uncompress on your file system disk (a good option is to uncompress under /opt/).
Execute on terminal the command
$ unzip OpenKM-5.0.x-JBoss-4.2.3.GA.zip
For document preview you need add these two entries in the OpenKM.cfg file:
system.openoffice=on
system.swftools.pdf2swf=/usr/bin/pdf2swf
You can configure OpenKM to use a remote server for OpenOffice document conversion:
system.openoffice.server=http://localhost:8080/converter/convert
Or you can configure OpenOffice.org listen port and a maximun conversion tasks:
system.openoffice.path=/usr/lib/openoffice
system.openoffice.tasks=5
system.openoffice.port=2222
Note that system.openoffice.tasks and system.openoffice.port have already a default value and is not needed to be set.
Enabling OCR
To enable OCR you must put the files system path of OCR engine:
system.ocr=/usr/local/bin/tesseract
Enable PS to SWF conversion
To enable postscript document preview, OpenKM need to convert PS files to SWF using the ps2pdf utility from Ghostscript:
system.ghostscript.ps2pdf=/usr/bin/ps2pdf
Enable image preview
To enable image preview, you need to install que ImageMagick convert utility and configure:
system.imagemagick.convert=/usr/bin/convert
Configuring chat service
By default chat and autologin are enabled. In order to enable or disable values can be "on" or "off".
chat.enabled=off
chat.autologin=off
Check
http://wiki.openkm.com/index.php/Application_configuration for more information
First login
Execute the file /opt/jboss-4.2.3.GA/bin/run.sh to run OpenKM + JBoss application server.
If you want your OpenKM installation to be accessed from other computers add the -b 0.0.0.0 command line parameter (see Basic application knowledge)
Open on a client browser the URL
http://localhost:8080/OpenKM/.
Autenticate to OpenKM using user "okmAdmin" with password "admin".
Note: From OpenKM 5.x there's a property definition in OpenKM.cfg to create automatically database. Once the tables are created, change the hibernate.hbm2ddl property from create to none. Do it after first time running, in other case all repository it'll be deleted and created in next OpenKM starting.
Please take a look at
http://forum.openkm.com/ if you have any problem