Configuración del servidor

Packet for query is too large (MySQL)

Si obtiene un error como este:

Packet for query is too large (1708726 > 1048576).
You can change this value on the server by setting the 'max_allowed_packet' variable.

Debe modificar el archivo de configuración de su servidor MySQL y aumentar el valor de la propiedad max_allowed_packet. No olvide reiniciar MySQL tras cualquier cambio en este archivo. En distribuciones basadas en Debian, como Ubuntu, este archivo de configuración se encuentra en /etc/mysql/my.cnf.

No se puede conectar desde otro equipo de la red

Si expone el puerto 8080 de Tomcat, asegúrese de que está enlazado a su IP; el valor del parámetro “address” debería ser “0.0.0.0” en $TOMCAT_HOME/conf/server.xml:

<Connector port="8080" address="0.0.0.0" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

Error al descargar un documento como PDF

Este error suele estar causado por la configuración del servicio de OpenOffice o LibreOffice.

Error de certificado SSL de IMAP

Primero obtenga el certificado con el comando openssl y después impórtelo con:

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

El servidor de OpenKM no tiene conexión directa a Internet

Si necesita un proxy para acceder a Internet, edite su archivo “/etc/bash.bashrc” como root y ponga estas líneas al final de su archivo “/etc/bash.bashrc”:

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

Puede omitir username:password si su servidor proxy no tiene contraseña.

Acceso denegado al instalar OpenKM como servicio en Windows 7

El intérprete de comandos funciona de forma ligeramente distinta en Vista. Por defecto, al ejecutar cmd.exe no se otorgan derechos de administrador. Para evitarlo, cree un acceso directo a cmd.exe en el escritorio, abra Propiedades > pestaña Compatibilidad y marque la casilla de derechos de administrador. Así podrá realizar tareas de administración desde la línea de comandos.

Problemas con la codificación de caracteres

Si su idioma tiene caracteres no ASCII y se muestran como caracteres ilegibles, tiene un problema de codificación.

Compruebe el archivo $TOMCAT/bin/setenv.sh o $TOMCAT/bin/setenv.bat. Debería tener establecido el parámetro de la JVM “-Dfile.encoding=utf-8”.

Errores de PermGen

Si ve este error:

java.lang.OutOfMemoryError: PermGen space

Edite su “$TOMCAT_HOME/bin/setenv.sh” (o “$TOMCAT_HOME/bin/setenv.bat” si utiliza Windows) y aumente el valor del parámetro de la JVM “-XX:MaxPermSize”:

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

Consulte también Presenting the Permanent Generation.

LDAP Sizelimit exceeded

Está causado porque bindDN tiene un límite de tamaño para cada consulta LDAP.

En OpenLDAP, la solución es aumentar el límite de bindDN, por ejemplo (para cambiar el límite de tamaño del usuario que utiliza la conexión LDAP de OpenKM)

limits dn.exact="cn=reader,ou=accounts,ou=admins,dc=example,dc=com" size=100000

Consulte también OpenLDAP Limits.

Al usar un proxy IIS se obtiene el error 404 o 404.15

Al utilizar IIS como servidor web, por defecto tiene un límite para la cadena de consulta (query string) enviada al servidor; si se supera el límite, se obtiene una pantalla de error en el lado del cliente:

En el lado del servidor obtenemos un error más detallado:

Para resolver este problema debemos aumentar el tamaño máximo de la cadena de consulta en el servidor web:

Abra el Administrador de Internet Information Services (IIS).
En el panel Conexiones, vaya a conexión > sitio > aplicación, o al directorio para el que desee modificar la configuración de filtrado de solicitudes.
En el panel Inicio, haga doble clic en Filtrado de solicitudes.

Haga clic en Editar configuración de características… en el panel Acciones.

Cambie la longitud máxima de la cadena de consulta:

Más información en el foro de OpenKM.

IIS obtiene IOException: Internal Server Error al subir un archivo

Solución uno

Cambie el “Maximum allowed content lenght (Bytes)” en los parámetros de configuración de IIS:

Solución dos

Vaya a la carpeta webapps
Edite el archivo web.config y añada lo siguiente bajo , donde “2097151” es el máximo permitido en IIS:

<system.web>
   <httpRuntime maxRequestLength="2097151" />
</system.web>

Si no existe web.config, cree uno a partir de un archivo de texto y añada lo siguiente:

<configuration>
   <system.web>
      <httpRuntime maxRequestLength="2097151" />
   </system.web>
</configuration>

Zoho falla con la conexión SSL

Para utilizar la integración con Zoho debe configurar su servidor para que entregue por sí mismo toda la cadena de certificados, porque el cliente de Zoho no busca la cadena. Nuestra solución es reconfigurar APR en Tomcat para que entregue la cadena de la CA por separado del certificado del servidor.

El archivo de configuración “$TOMCAT_HOME/conf/server.xml” queda así:

<!-- Define a SSL HTTP/1.1 Connector on port 8443
     This connector uses the JSSE configuration, when using APR, the
     connector should be using the OpenSSL style configuration
     described in the APR documentation -->

   <Connector port="8443" address="0.0.0.0" protocol="HTTP/1.1" SSLEnabled="true"
              maxThreads="150" scheme="https" secure="true" acceptCount="100"
              enableLookups="false" clientAuth="true" sslProtocol="SSLv3"
              SSLCipherSuite="ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:!LOW:!SSLv2:!EXPORT"
              SSLCertificateFile="/home/openkm/tomcat-7.0.27/cert/serverpublic.pem"
              SSLCertificateKeyFile="/home/openkm/tomcat-7.0.27/cert/serverprivate.pem"
              SSLCertificateChainFile="/home/openkm/tomcat-7.0.27/cert/serverpublicchain.pem"
              allowUnsafeLegacyRenegotiation="false"
           />

URL de CMIS incorrecta tras un proxy Nginx

Utilice esta configuración:

location /OpenKM/ {
   proxy_pass http://127.0.0.1:8080/OpenKM/;
   proxy_redirect off;

   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

Sigar java.lang.UnsatisfiedLinkError: problema conocido en Windows

Si tiene OpenOffice o LibreOffice configurado y obtiene el error “sigar java.lang.UnsatisfiedLinkError”, probablemente le falta la “ruta de sigar” en la variable de entorno “PATH”.

Caused by: java.lang.UnsatisfiedLinkError: org.hyperic.sigar.Sigar.getSigNum(Ljava/lang/String;)I
  at org.hyperic.sigar.Sigar.getSigNum(Native Method)
  at org.hyperic.sigar.Sigar.kill(Sigar.java:275)

Edite su variable de entorno general “PATH” y añada su carpeta “$TOMCAT_HOME\lib\sigar\”, por ejemplo así: PATH=…;C:\tomcat-7.0.27\lib\sigar

WARN net.sf.ehcache.hibernate.strategy.AbstractReadWriteEhcacheAccessStrategy

Si ve este mensaje:

A soft-locked cache entry was expired by the underlying Ehcache.
If this happens regularly you should consider increasing the cache timeouts and/or capacity limit

¿Experimenta algún problema de rendimiento o de usabilidad como consecuencia de esta advertencia? Si no es así, parece que debería tratarla simplemente como lo que es: una advertencia.

En caso contrario, parece que la solución es aumentar el valor de maxElementsInMemory para tener en cuenta la diferencia entre lo que se almacena en caché y lo que realmente se utiliza.

OpenOffice no se inicia en Windows

A veces no es fácil conseguir que OpenKM inicie el servicio soffice, por varios y extraños motivos que dependen de su versión de Windows y de otras configuraciones específicas del servidor.

Ante todo, asegúrese de que la ruta de OpenOffice está correctamente configurada en el parámetro “system.openoffice.path” de Administration > Configuration parameters >.

Asegúrese de que no hay otra instancia de soffice.bin en ejecución. Si hay otra instancia de soffice.bin en ejecución, OpenKM no podrá iniciar su propio servicio soffice. Revise los procesos en ejecución en Windows o utilice una herramienta como Process Explorer.

Detenga el cortafuegos y otras posibles herramientas que puedan impedir el inicio del servicio soffice, por ejemplo el antivirus.

Pruebe a iniciar la aplicación desde la línea de comandos en “%TOMCAT_HOME/bin”:

$ catalina.bat run