Difference between revisions of "Troubleshooting"

From OpenKM Documentation
Jump to: navigation, search
Line 194: Line 194:
  
 
'''The solution is make some changes on registry:'''
 
'''The solution is make some changes on registry:'''
1- Create a file called ss_download_patch.reg
+
* Create a file called ss_download_patch.reg
2- Copy the contents
+
* Copy the contents
 +
 
 
  REGEDIT4
 
  REGEDIT4
 
  [HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings]
 
  [HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings]
Line 203: Line 204:
 
  "SSLPragmaNoCache"=dword:00000001  
 
  "SSLPragmaNoCache"=dword:00000001  
  
3-And execute it
+
* And execute it
4-Then you must restarting your OS to take some effect.
+
* Then you must restarting your OS to take some effect.
  
 
== Configure jboss https / SSL ==
 
== Configure jboss https / SSL ==

Revision as of 13:02, 5 October 2011

This is a compilation of most common OpenKM user problems with its solution. If you have any other problem not listed here, please take a look at http://forum.openkm.com/ to be helped by our community. Also you can request professional support at http://www.openkm.com/Contact.

Can't access OpenKM from other computers

By default, JBoss only listen for connections on localhost. If you want to access from other computer, you need to start JBoss passing the parameter -b 0.0.0.0

GNU/Linux

./bin/run.sh -b 0.0.0.0 

Windows

\bin\run.bat -b 0.0.0.0

Other options

./bin/run.sh -Djboss.bind.address=0.0.0.0

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 $*

Make it executable:

$ chmod +x pdf2swf_wrapper.sh

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

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

See SWFTools for more info.

Random errors in preview

We have detected errors in special with Firefox under Linux, because the Flash plugin is quite old or you have installed the GNASH flash plugin and not the original from Adobe. To fix this, install the "Flash Aid" plugin under Firefox and run the wizard. It will install the right Flash Plugin version into your preferred browser.

Export to zip file gives wrong charset

This issue is corrected 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.

Also you can try to install the port of the 7-Zip compression tool for Linux:

$ sudo aptitude install p7zip-full

Jackrabbit: Bad check digit

If you've got some problem like this when starting OpenKM

2010-06-03 17:56:14,640 ERROR [org.apache.jackrabbit.webdav.simple.DavResourceImpl] Error while importing resource: java.io.IOException: cannot read item dd85e9b7-6398-4720-a00d-87374467e4f9
2010-06-03 17:56:14,640 WARN  [org.apache.jackrabbit.core.lock.LockManagerImpl] Bad lock token: Bad check digit.

Probably you got a problem with the crappy LVM setup that was responsible for this problem. Fresh installation could solve the problem!

Take a look at forum post at http://forum.openkm.com/viewtopic.php?f=3&t=3806&start=0

Errors caused by proxy configuration / Error OKM-009006

If you've configured OpenKM under a proxy, sometimes is needed to set jboss params to indicate it, because could be some connection errors in rpc calls.

-Dhttp.proxyHost=x.x.x.x -Dhttp.proxyPort=yyyy

Microsoft Office Addin disappears after restarting Office

Could be a problem with default template ( normal.dot ) to solve it:

  • Open normal.dot
  • Go to menu tools / personalize / Tool bars
  • Open OpenKM toolbar
  • Save normal.dot

OpenKM server has no direct Internet connection

If you need a proxy to access Internet, edit your /etc/bash.bashrc file as root and put these line at the end of your /etc/bash.bashrc file :

export http_proxy=http://username:password@proxyserver.net:port/
export ftp_proxy=http://username:password@proxyserver.net:port/

You can omit the username:password, if your proxy server has no password.

But may be the server is can't access Internet at all. In this case you will have problems when validating $JBOSS_HOME/PropertyGroups.xml. Read Property Groups definition to see there is a easy solution. Also edit OpenKM.cfg and set:

update.info=off

Access denied installing OpenKM as service on Windows 7

The command shell works slightly differently in Vista. By default when you run cmd.exe, it does not give administrator rights. To get around it, create a shortcut to cmd.exe on desktop, open Properties, Compatibility tab and check box for Administrator rights. Then you can do admin stuff on cmd line. More information here Configure JBoss service

Problems with character encodings

If your language has non-ASCII chars and they are displayed as garbage you have a problem with encodings. To solve it, you have to edit the JBoss start script.


Nota advertencia.png This process, as described here will destroy OpenKM database and will create a new one. Be careful! If you want a non-destructive way of achieve this, you need to delete actual inserted translations and insert them again.

In case of Linux, edit the file $JBOSS_HOME/bin/run.sh and change the line:

 JAVA_OPTS="-Xms256m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=256m"

By this others:

 JAVA_OPTS="-Xms256m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=256m -Dfile.encoding=utf-8"

In case of Windows, edit the file $JBOSS_HOME/bin/run.bat and change the line:

 set JAVA_OPTS=%JAVA_OPTS% -Dprogram.name=%PROGNAME%

By this others:

 set JAVA_OPTS=%JAVA_OPTS% -Dprogram.name=%PROGNAME% -Dfile.encoding=utf-8

You need to stop JBoss, delete the $JBOSS_HOME/server/default/data/hypersonic folder and start JBoss again. Now the OpenKM database will be created again and the language translation will be imported right.

Checking error "Document name is different"

This is a known error in Internet Explorer family. To disable name mismatch check, take a look at Disable document name mismatch check.

Error dowloading files under IE with https / SSL

There's a very older bug from version 5.5 until our days that seems Microsoft has not decided to solve, that causes a problem downloading files with IE behind SSL protocol ( the force may be with you, hope some day will decide to solve it).

The problem is caused by "Cache-control: no-cache HTTP header to the response message", obviously that's valid for any browser except IE family ... other Microsoft IE hidden feature ?

Can see some supporting and forum information about it: http://support.microsoft.com/kb/815313 http://www.sibsoft.net/forum/post1670.html http://support.microsoft.com/kb/323308 http://support.microsoft.com/kb/316431 http://support.microsoft.com/kb/323308

The solution is make some changes on registry:

  • Create a file called ss_download_patch.reg
  • Copy the contents
REGEDIT4
[HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings]
"DisableCachingOfSSLPages"=dword:00000000
"BypassSSLNoCacheCheck"=dword:00000001
"BypassHTTPNoCacheCheck"=dword:00000001
"SSLPragmaNoCache"=dword:00000001 
  • And execute it
  • Then you must restarting your OS to take some effect.

Configure jboss https / SSL

We encorage using apache proxy to port 80 or 443 and not expose directly jboss ports, due could be some security bugs doing it. For each people who decide exposing jboss ports there's some problem with IE and https / SSL jboss configuration. To solve it:

Edit the file $JBOSS_HOME/server/default/deploy/jboss-web.deployer/server.xml and uncomment

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
               maxThreads="150" scheme="https" secure="true"
                keystorePass="XxXxXxXx"
               clientAuth="false" sslProtocol="TLS" />

You need to generate some keystorePass

Error in uploader / scanner applet

To provide a more complete information in order to determine the issue, please activate the Java Console. Read How do I enable and view the Java Console? for more info.

PermGen errors

If you see this error when executing OpenKM:

java.lang.OutOfMemoryError: PermGen space

Edit your $JBOSS_HOME/bin/run.sh (or $JBOSS_HOME/bin/run.bat if using Windows) and set the JAVA_OPTS variable to this value:

JAVA_OPTS="-Xms256m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=256m"

See also [Presenting the Permanent Generation].