Difference between revisions of "Troubleshooting"

From OpenKM Documentation
Jump to: navigation, search
Line 1: Line 1:
'''Code: OKM-004006, Message: conversion failed: could not save output document; OOo errorCode: 2074'''
+
== 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:
 
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:
Line 5: Line 6:
 
  $ aptitude install openoffice.org2-l10n-es openoffice.org-java openoffice.org-java-common openoffice.org
 
  $ 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'''
+
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.
 
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.
  
'''I start JBoss but OpenKM is not deployed due to a webservice error.'''
+
== 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 [http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4125074 know JBoss issue]. More on JBoss webservices at http://jboss.org/community/docs/DOC-10823.
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 [http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4125074 know JBoss issue]. More on
 
JBoss webservices at http://jboss.org/community/docs/DOC-10823.
 
  
 
A workaround is disabling webservices in OpenKM:
 
A workaround is disabling webservices in OpenKM:
Line 22: Line 21:
 
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).
 
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).
  
'''I select a document and click on "Copy to clipboard" button to copy the URL, but the browser show an error message.'''
+
== 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"
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:
 
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:
Line 30: Line 28:
 
If you use Firefox, go to Edit → Preferences → Content, check "Active JavaScript", click on "Advanced" and check "Deactivate or replace contextual menus" option.
 
If you use Firefox, go to Edit → Preferences → Content, check "Active JavaScript", click on "Advanced" and check "Deactivate or replace contextual menus" option.
  
'''I want to administer OpenKM, but Administration tab is empty.'''
+
== 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:
  
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/.
+
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
  
 
[[Category: Installation Guide]]
 
[[Category: Installation Guide]]

Revision as of 13:37, 8 February 2010

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" 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