Ir al contenido

Configuración del servidor

El paquete para la consulta es demasiado grande (MySQL)

Sección titulada «El paquete para la consulta es demasiado grande (MySQL)»

Si obtiene un error como este:

Ventana de terminal
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 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

Sección titulada «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" />

Para determinar el problema, ejecute esta consulta:

SELECT * FROM OKM_CRON_TAB WHERE HOUR(CT_LAST_BEGIN) >= 2 and HOUR(CT_LAST_BEGIN) < 3 OR HOUR(CT_LAST_END) >= 2 and HOUR(CT_LAST_END) < 3;

Una vez que podamos ver las entradas de crontab afectadas, pueden corregirse ejecutando las siguientes sentencias:

-- UPDATE OKM_CRON_TAB SET CT_LAST_BEGIN = ADDTIME(CT_LAST_BEGIN, '1:00'), CT_LAST_END = ADDTIME(CT_LAST_END, '1:00')
-- WHERE HOUR(CT_LAST_BEGIN) >= 2 and HOUR(CT_LAST_BEGIN) < 3 OR HOUR(CT_LAST_END) >= 2 and HOUR(CT_LAST_END) < 3;
UPDATE OKM_CRON_TAB SET CT_LAST_BEGIN = ADDTIME(CT_LAST_BEGIN, '1:00') WHERE HOUR(CT_LAST_BEGIN) >= 2 and HOUR(CT_LAST_BEGIN) < 3;
UPDATE OKM_CRON_TAB SET CT_LAST_END = ADDTIME(CT_LAST_END, '1:00') WHERE HOUR(CT_LAST_END) >= 2 and HOUR(CT_LAST_END) < 3;

Este error suele deberse a que LibreOffice no está instalado o a una instalación incompleta del paquete.

Primero, obtenga el certificado con el comando openssl, y luego importe el certificado con lo siguiente:

Ventana de terminal
$ 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.

Sección titulada «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 del 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 la codificación de caracteres

Sección titulada «Problemas con la codificación de caracteres»

Si su idioma tiene caracteres no ASCII y se muestran como caracteres extraños, 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”.

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.

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

En OpenLDAP, la solución es aumentar el límite del 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.

Detrás de un proxy IIS, puede obtener el error 404 o 404.15

Sección titulada «Detrás de un proxy IIS, puede obtener el error 404 o 404.15»

Al usar IIS como servidor web, por defecto limita la longitud de la cadena de consulta enviada al servidor. Si se supera 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 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:


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

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

Sección titulada «IIS obtiene 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.

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

  • 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

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

Sección titulada «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í, debería tratarlo simplemente como un aviso.

En caso contrario, 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 realmente se está usando.