Xetux Docs
POSAdmin

Resolución de Error GC Overhead Limit Exceeded

Guía técnica para solucionar el colapso de la JVM en POSADMIN mediante el ajuste de los parámetros de memoria inicial y máxima en Tomcat.

Este error ocurre cuando la Máquina Virtual de Java (JVM) que soporta el portal POSADMIN agota su memoria asignada. El sistema entra en un ciclo infinito donde el recolector de basura (Garbage Collector) intenta liberar espacio sin éxito, consumiendo recursos de CPU y congelando la aplicación.

Síntoma: La aplicación deja de responder y se muestra el mensaje java.lang.OutOfMemoryError: GC overhead limit exceeded.

Causa Técnica

El servicio xbackend (Apache Tomcat) se instala frecuentemente con valores de memoria insuficientes para entornos de producción:

  • Initial memory pool (Xms): 128 MB (Predeterminado)
  • Maximum memory pool (Xmx): 256 MB (Predeterminado)

Estos límites resultan críticos ante cargas de trabajo medias o consultas de reportes extensos en POSADMIN.

Procedimiento de Solución

Acceso al Directorio de Binarios

Navegar a la ruta de instalación del servidor backend:

C:\Xetux-Server\tomcat-backend\bin

Apertura del Panel de Control de Tomcat

Ejecutar el comando de configuración vinculado al servicio interno de Xetux:

tomcat9w.exe //ES//xbackend

Ajuste de Parámetros de Memoria

En la pestaña Java de la ventana emergente, modificar los valores en la sección inferior:

  1. Initial memory pool: Cambiar a 512 MB.
  2. Maximum memory pool: Cambiar a 1024 MB (o superior según la RAM disponible en el servidor).

Hacer clic en Apply y posteriormente en OK.

Reinicio del Servicio

  1. Abrir el Administrador de Servicios (services.msc).
  2. Localizar el servicio Apache Tomcat 9.0 xbackend.
  3. Seleccionar Reiniciar.

Validación

Tras el reinicio, intente acceder nuevamente a POSADMIN y realizar las acciones que provocaban el error. El sistema debería operar con fluidez al disponer de un margen de memoria 4 veces superior al inicial.
ParámetroValor AnteriorValor Recomendado
Initial memory (Xms)128 MB512 MB
Maximum memory (Xmx)256 MB1024 MB
Copyright © 2026