Cómo solucionar problemas de Znuny en linux

Le preguntamos a Gemini, la inteligencia artificial de Google  cómo solucionar problemas de Zbuby en linux

Explicanos detalladamente cómo solucionar problemas de Znuny en linux

Cuando Znuny (el robusto sucesor de OTRS) decide ponerse difícil, generalmente no se debe a un fallo en su código, sino a una desincronización en su ecosistema: el demonio interno, los módulos de Perl, la caché o, el enemigo número uno de todo administrador de sistemas, los permisos de archivos.

Al ser un sistema de nivel empresarial basado en Perl, su arquitectura es muy estricta. Aquí tienes la guía técnica paso a paso para diagnosticar, depurar y solucionar problemas en Znuny como un experto.

1. La Herramienta Suprema: otrs.Console.pl

El 90% de las tareas de reparación en Znuny se gestionan desde su CLI integrada.

[!CRITICAL]

Regla de oro inquebrantable: Nunca ejecutes estos comandos como root. Si lo haces, cambiarás el propietario de los archivos de caché y el servidor web (Apache/Nginx) no podrá leerlos, provocando un Error 500 inmediato. Usa siempre el usuario otrs.

Bash

# Cambia al entorno del usuario otrs

sudo -u otrs /opt/otrs/bin/otrs.Console.pl

Si ejecutas este comando sin argumentos, desplegará el catálogo completo de herramientas de diagnóstico. Las más importantes para resolver problemas están bajo el espacio de nombres Maint::.

2. El Síntoma #1: Los tickets no se actualizan ni entran correos

Si la interfaz web funciona pero el sistema parece "sordo y mudo" (no descarga correos, no envía notificaciones, las tareas programadas no se ejecutan), el Znuny Daemon se ha detenido o está bloqueado.

El Daemon es el motor que procesa todas las colas de eventos en segundo plano.

Diagnóstico y solución:

Bash

# Verificar si el demonio está vivo

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status

# Si está detenido o responde de forma errática, reinícialo:

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl stop

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start

3. El Clásico "Error 500" o Pantalla Blanca (Permisos)

Si acabas de restaurar una copia de seguridad, migrar el servidor o (accidentalmente) ejecutaste un comando como root, los permisos del sistema de archivos se habrán roto. Znuny bloquea la ejecución si detecta que el servidor web (www-data) no es dueño o no tiene acceso de lectura/escritura a sus directorios críticos.

La solución definitiva:

Znuny cuenta con un script especializado que restablece la estructura de permisos correcta para los directorios var/, Kernel/ y los archivos de configuración:

Bash

cd /opt/otrs

sudo bin/otrs.SetPermissions.pl --web-group=www-data

4. La Interfaz se ve "Rota" o los Menús no Despliegan

Si tras instalar un paquete (opm), actualizar el sistema o modificar el archivo Config.pm la web pierde los estilos CSS o el JavaScript falla, el problema está en la caché del Loader. Znuny precompila estos archivos para mejorar la velocidad.

Forzar la reconstrucción visual:

Bash

# 1. Eliminar la caché de datos general

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete

# 2. Limpiar la caché del cargador de CSS y JS

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup

# 3. Reconstruir la configuración del sistema

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Config::Rebuild

5. Atascos en la Cola de Correos (Mail Queue)

Si un agente envía un ticket con un archivo adjunto gigantesco o malformado, la cola de salida de correo puede atascarse, impidiendo que salgan las notificaciones del resto de los usuarios.

Comandos de rescate para el correo:

Bash

# Listar los correos retenidos en la cola de salida

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --list

# Forzar el envío de los correos pendientes

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --send

# Si un correo específico está rompiendo el bucle, puedes eliminarlo de la cola:

sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Email::MailQueue --delete --message-id=X

6. Revisión de Dependencias de Perl tras una Actualización del SO

A veces, un comando general apt upgrade en el servidor Linux actualiza la versión de Perl o de sus librerías compartidas, dejando a Znuny sin acceso a módulos críticos (como los de conexión a bases de datos o encriptación SSL).

Verificar la salud de Perl:

Bash

sudo /opt/otrs/bin/otrs.CheckModules.pl

Revisa el output con atención. Si algún módulo marcado como Required aparece como Not installed, instálalo inmediatamente usando el gestor de paquetes de tu distribución (por ejemplo, sudo apt install libjson-xs-perl).

Tabla de Referencia Rápida de Errores

Qué observas	Causa probable	Acción correctora
Log: "Can't write /opt/otrs/var/..."	Conflicto de privilegios en Linux.	Ejecuta otrs.SetPermissions.pl.
"Database connection broken"	MariaDB se quedó sin conexiones o el paquete es muy grande.	Sube max_allowed_packet = 64M en tu my.cnf.
Falta el botón de "Responder"	El ticket está bloqueado por otro agente o la respuesta automática no tiene plantilla.	Revisa el estado del ticket en la DB o asigna una plantilla al flujo de trabajo.
Los cambios en el SysConfig no se aplican	La caché del despliegue sigue activa.	Ejecuta Maint::Config::Rebuild.

Dónde buscar si el sistema no arranca (Logs)

Si la pantalla sigue en blanco y la consola de Znuny no responde, el error está registrado a nivel de servidor web o de sistema operativo. Monitorea estos archivos en tiempo real mientras intentas recargar la página:

Log de Apache/Nginx: tail -f /var/log/apache2/error.log (Esencial para ver fallos de comunicación con mod_perl).

Log de Znuny: tail -f /opt/otrs/var/log/otrs.log (Ideal para ver rechazos de credenciales SMTP/IMAP).

¿Estás lidiando actualmente con un código de error específico en el archivo otrs.log o el problema comenzó inmediatamente después de aplicar una actualización del sistema operativo?