Configuración del servidor

El paquete de la consulta es demasiado grande (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.

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

No es posible 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 porque LibreOffice no está instalado o por una instalación incompleta de paquetes.

Error de certificado SSL de IMAP

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

$ keytool -import -alias mail.yourcompany.com -keystore //usr/lib/jvm/java-11-openjdk-amd64/lib/security/cacerts -file imapd.pem

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

Si necesita un proxy para acceder a Internet, edite su fichero “/etc/bash.bashrc” como root 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 usuario y la contraseña si su servidor proxy no requiere autenticación.

Problemas con las codificaciones de caracteres

Si su idioma tiene caracteres no-ASCII y se muestran como caracteres extraños, tiene un problema de codificación.

Revise 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 fichero “$TOMCAT_HOME/bin/setenv.sh” (o “$TOMCAT_HOME/bin/setenv.bat” si usa Windows) y aumente el valor del parámetro de la JVM “-XX:MaxPermSize”:

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

Vea también Presenting the Permanent Generation.

Se ha excedido el límite de tamaño de LDAP

Esto ocurre 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 usado por la conexión LDAP de OpenKM):

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

Vea también OpenLDAP Limits.

Tras el proxy IIS, puede obtener el error 404 o 404.15

Cuando se usa IIS como servidor web, por defecto limita la longitud de la cadena de consulta enviada al servidor. Si se excede el límite, verá una pantalla de error en el lado del cliente:

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

Para resolver este problema, necesitamos 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 connection > site > application o directorio para el que quiere modificar la configuración de filtrado de peticiones.
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:

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

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

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

Solución uno

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

Solución dos

Vaya a la carpeta webapps
Edite el fichero 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 hay ningún 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

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

¿Está experimentando algún problema de rendimiento o usabilidad debido a este aviso? Si no es así, trátelo simplemente como un aviso.

Si no, parece que la solución es aumentar el tamaño de maxElementsInMemory para tener en cuenta la diferencia entre lo que está en caché y lo que se está usando.