Troubleshooting

Error downloading document as PDF

Code: OKM-004006
Message: conversion failed: could not save output document; OOo errorCode: 2074

This error occurs when you want to download a document as PDF and there is some error with OpenOffice.org. Perhaps the OpenOffice.org installation has some missing components. Try to install these packages:

$ aptitude install openoffice.org2-l10n-es openoffice.org-java openoffice.org-java-common openoffice.org

Code: OKM-004013
Message: connection failed: socket,host=localhost,port=8100,tcpNoDelay=1:java.net.ConnectException: Connection refused'

This error occurs when you want to download a document as PDF and there is some error with OpenOffice.org connection. Perhaps there is no OpenOffice.org running in server mode (headless). See Third-party software integration: OpenOffice.org for more info.

OpenKM not deployed due to a webservice error

Perhaps your computer have no Internet access? JBoss tries to validate WSDL descriptors on application deployment, can't access to DTD and throws an exception. This is a know JBoss issue. More on JBoss webservices at http://jboss.org/community/docs/DOC-10823.

A workaround is disabling webservices in OpenKM:

• Stop JBoss.
• Delete the folder $JBOSS_HOME/server/default/deploy/OpenKM.ear/OpenKM.war/WEB-INF/classes/es/git/openkm/ws.
• Start JBoss again.

It should solve the deployment problem. If the EAR is not exploded you can browse it with Midnight Commander (from Linux). or WinRAR (from Windows).

Error when click on "Copy to clipboard"

To enable JavaScript "Copy to clipboard" buttons on Firefox and Mozilla, enter the following line into browser address bar: "about:config"

The list of preferences should open in browser window. Click right mouse button somewhere in active part of preference list window and choose New > Boolean option from context menu. Paste the following Preference name into the New boolean value window input box: "signed.applets.codebase_principal_support"

Error opening contextual menu - right click on firefox"

I right-click on a document, but OpenKM contextual menu is hidden by the browser. If you use Firefox, go to Edit → Preferences → Content, check "Active JavaScript", click on "Advanced" and check "Deactivate or replace contextual menus" option.

The Administration tab is empty

This is a known bug of IExplorer. Switch to Firefox: its JavaScript engine also is faster, so your OpenKM experience will be better. Or access it from Tools → Show administration. Or point your browser to http://localhost/OpenKM/es.git.openkm.backend.Main/.

IMAP SSL certificate error

First obtained my certificate with the openssl command and after this import the certificate with:

keytool -import -alias mail.yourcompany.com -keystore /etc/java-6-sun/security/cacerts -file imapd.pem

You have to restart JBoss to refresh the SSL certifications. See also: http://confluence.atlassian.com/display/JIRA/Connecting+to+SSL+services

Unable to run Scanner appler under Linux

If you enable the Java Console and see this error:

java.lang.UnsatisfiedLinkError: uk.co.mmscomputing.util.JarLib.loadX: Could not find library [libjsane.so]

You have to install the libsane-dev package:

$ sudo aptitude install libsane-dev

Some PDF file not shown in preview

Perhaps the PDF is copy protected. Hence, you're not allowed to convert it.

FATAL   PDF disallows copying

If you created this PDF using Acrobat Distiller, try switching the copy protection checkbox off. If you can't disable the protection you can modify the 'pdf2swf source code to disable this check (see http://www.foolabs.com/xpdf/cracking.html).

Other problem may be due to complex PDF documents.

ERROR This file is too complex to render- SWF only supports 65536 shapes at once

You can invoke the pdf2swf utility with the -s poly2bitmap option. The generated document quality is worse, but you can see it at least. This can be simplified to be used by OpenKM in the preview generation. Create a script called pdf2swf_wrapper.sh:

#!/bin/bash

/usr/bin/pdf2swf -s poly2bitmap $*

And don't forget to change the OpenKM.cfg file:

system.pdf2swf=/path/to/pdf2swf_wrapper.sh

Export to zip file gives wrong charset

This issue is correcte since OpenKM 4.1-RC2 and exported zip archives should be opened without problems from WinZip 14 at least. But you may have an issue in Ubuntu Linux. The problem is the unzip package, which should be compiled with a patch to enable UTF-8 chars in file names. You can find a patched unzip for Ubuntu/Debian at http://packages.ubuntu.com/jaunty/unzip. To keep informed about the progress in this issue, go to Bug #10979: unzip does not support UTF-8 filenames.