Cómo resolver problemas de Zarafa en linux

 Le preguntamos  Gemini, la inteligencia artificial de Google, cómo resolver problemas de Zarafa en linux

Explicanos detalladamente cómo resolver problemas de Zarafa en linux

Los problemas en Zarafa provienen habitualmente de fallos de comunicación MAPI entre sus demonios, problemas de conexión con MariaDB/MySQL, errores de la extensión PHP-MAPI o bloqueos en la entrega de correo con Postfix.

Ubicación de Registros (Logs) y Diagnóstico Rápido

Servicio	Archivo de Log Principal	Comando de Monitoreo
Servidor Core	/var/log/zarafa/server.log	sudo tail -f /var/log/zarafa/server.log
Agente de Entrega	/var/log/zarafa/dagent.log	sudo tail -f /var/log/zarafa/dagent.log
Cola de Salida	/var/log/zarafa/spooler.log	sudo tail -f /var/log/zarafa/spooler.log
Pasarela IMAP/POP3	/var/log/zarafa/gateway.log	sudo tail -f /var/log/zarafa/gateway.log
Interfaz WebApp	/var/log/apache2/error.log / /var/log/nginx/error.log	sudo tail -f /var/log/apache2/error.log

1. Fallo en zarafa-server (No inicia o se detiene constantemente)

Causa: Conexión rechazada a la base de datos, archivo de socket bloqueado o permisos incorrectos en el almacenamiento de adjuntos.

Solución:

Comprueba la conexión manual a MariaDB/MySQL con los datos de /etc/zarafa/server.cfg:

Bash

mysql -u zarafa -pPasswordZarafa123 -h localhost zarafa

Si el servicio falló repentinamente, elimina archivos de socket o PID huérfanos que impiden el arranque:

Bash

sudo rm -f /var/run/zarafa.pid /var/run/zarafa

Asegura los permisos del directorio de datos si los adjuntos se guardan en disco (attachment_storage = files):

Bash

sudo chown -R zarafa:zarafa /var/lib/zarafa/

Inicia el servidor en primer plano con depuración activa para ver el fallo exacto en pantalla:

Bash

sudo zarafa-server -F -c /etc/zarafa/server.cfg

2. Error MAPI / Página en blanco en Zarafa WebApp

Causa: La extensión php-mapi no está cargada en PHP o el servidor web no puede comunicarse con la interfaz MAPI en el puerto 236 o socket local.

Solución:

Confirma que el módulo MAPI de PHP está habilitado:

Bash

php -m | grep mapi

Revisa la configuración de conexión en /etc/zarafa/webapp/config.php:

PHP

define("DEFAULT_SERVER", "http://localhost:236/zarafa");

Reinicia el servidor web e intérprete PHP:

Bash

sudo systemctl restart apache2

# O si usas PHP-FPM:

sudo systemctl restart php7.4-fpm

3. Los correos entrantes rebotan (Fallo en zarafa-dagent)

Causa: Postfix no puede transferir los mensajes al agente de entrega o el usuario no existe en el almacén MAPI.

Solución:

Revisa el log de transporte en Postfix: sudo tail -f /var/log/mail.log.

Valida la existencia y detalles del usuario de destino en el directorio Zarafa:

Bash

sudo zarafa-admin --details usuario

Prueba una simulación de entrega local para verificar la respuesta del agente:

Bash

sudo zarafa-dagent -e usuario -f /ruta/al/correo_prueba.eml

4. Correos salientes no se envían (zarafa-spooler)

Causa: El proceso zarafa-spooler está detenido o no puede conectar al MTA local (Postfix en el puerto 25).

Solución:

Confirma que Postfix escucha en el puerto 25 local:

Bash

nc -zv 127.0.0.1 25

Verifica que /etc/zarafa/spooler.cfg apunta al servidor SMTP correcto:

Ini, TOML

smtp_server = localhost

smtp_port = 25

Reinicia el servicio de cola de salida:

Bash

sudo systemctl restart zarafa-spooler

5. Buzones huérfanos y mantenimiento con zarafa-fsck

Causa: Al eliminar o desvincular un usuario, su almacén MAPI queda flotante en la base de datos sin propietario.

Solución:

Lista todos los almacenes huérfanos registrados:

Bash

sudo zarafa-admin --list-orphans

Vincula nuevamente un almacén a un usuario existente mediante su GUID:

Bash

sudo zarafa-admin --hook-store <GUID_DEL_ALMACEN -u <NOMBRE_USUARIO>

Ejecuta la herramienta de consistencia de archivos para detectar y reparar incoherencias en las carpetas MAPI:

Bash

sudo zarafa-fsck -u <NOMBRE_USUARIO>

¿Cómo deseas continuar diagnosticando tu servidor?

Analizar registro de depuración

Guía de migración a Kopano