Configuración del servidor

The packet for the query is too large (MySQL)

Si obtiene un error como este:

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

Debe modificar el fichero 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 fichero. En las distribuciones basadas en Debian, como Ubuntu, este fichero de configuración se encuentra en /etc/mysql/my.cnf.

No es posible conectarse 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 LibreOffice.

Error del certificado SSL de IMAP

En primer lugar, obtenga el certificado con el comando openssl y, después, impórtelo con lo siguiente:

$ 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 como root su fichero “/etc/bash.bashrc” y añada estas líneas al final de su fichero “/etc/bash.bashrc”:

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

Puede omitir el nombre de usuario y la contraseña si su servidor proxy no los requiere.

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 solucionarlo, cree un acceso directo a cmd.exe en el escritorio, abra la pestaña Propiedades > Compatibilidad y marque la casilla de derechos de administrador. Después podrá realizar tareas administrativas en la línea de comandos.

Problemas con la codificación de caracteres

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

Compruebe el fichero $TOMCAT/bin/setenv.sh o $TOMCAT/bin/setenv.bat. Debería establecer 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 Size limit exceeded

Esto se debe a que el bindDN tiene un límite de tamaño para cada consulta LDAP.

En OpenLDAP, la solución consiste en aumentar el límite del bindDN; por ejemplo, cambie el límite de tamaño del usuario utilizado por 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.

Detrás del proxy IIS se obtiene el error 404 o 404.15

Cuando se utiliza IIS como servidor web, este tiene un límite para la cadena de consulta enviada al servidor. Si se supera el límite, se muestra 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 Internet Information Services (IIS) Manager.
En el panel Connections, vaya a la conexión > sitio > aplicación o al directorio para el que desea modificar la configuración del filtrado de solicitudes.
En el panel Home, haga doble clic en Request Filtering.

Haga clic en Edit Feature Settings… en el panel Actions.

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

Encontrará más información en el foro de OpenKM.

IIS obtiene IOException: Internal Server Error al subir un fichero o el error HTTP 413 Request Entity Too Large

Este error puede aparecer al subir un documento grande a OpenKM.

Primera solución

Cambie el valor “Maximum allowed content length (Bytes)” en la configuración de IIS:

Segunda solución

Vaya a la carpeta webapps
Edite el fichero web.config y añada lo siguiente dentro de , 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 fichero de texto y añada lo siguiente:

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

URL incorrecta de CMIS detrás del 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;
}

Problema conocido de Sigar java.lang.UnsatisfiedLinkError en Windows

Si tiene configurado OpenOffice o LibreOffice y obtiene el error “sigar java.lang.UnsatisfiedLinkError”, probablemente ha omitido 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: 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

Si no experimenta ningún problema de rendimiento o de usabilidad debido a esta advertencia, trátela como una simple advertencia.

En caso contrario, parece que la solución consiste en aumentar el tamaño de maxElementsInMemory para compensar la diferencia entre lo que se almacena en caché y lo que se utiliza.

LibreOffice no se inicia en Windows.

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

En primer lugar, asegúrese de que la ruta de OpenOffice está correctamente configurada en Administration > Configuration parameters > parámetro “system.openoffice.program”.

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 servicio soffice. Compruebe los procesos en ejecución en Windows o utilice una herramienta como Process Explorer.

Detenga el cortafuegos y otras herramientas que puedan impedir que el servicio soffice se inicie, por ejemplo, el software antivirus.

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

$ catalina.bat run