Solucionar el fallo del servicio Python del motor de búsqueda Kopano

Comience con el registro de fallos, no con el índice de búsqueda. En un servidor Kopano Core clásico, el motor de búsqueda es el kopano-searchservicio. El paquete fuente de Debian describe esta generación como un indexador basado en procesos construido sobre python-kopano. Se conecta a kopano-server, mantiene índices de búsqueda por tienda y puede llamar opcionalmente a herramientas de análisis de archivos adjuntos. Revise el paquete fuente de Kopano Search . Un módulo de Python faltante, una discrepancia en el socket del servidor, un problema de permisos o espacio en disco, o un analizador de archivos adjuntos que falla pueden causar diferentes síntomas. Reiniciar o eliminar todo el índice antes de identificar el fallo puede ocultar evidencia útil y generar más trabajo.

Esta guía abarca las instalaciones que ejecutan el kopano-searchdemonio clásico, incluyendo versiones anteriores de Kopano Core. La documentación de Kopano disponible actualmente para este servicio corresponde a Kopano Core 8.0, mientras que las páginas man archivadas de Ubuntu cubren versiones anteriores, como la 8.7. Confirme la versión de Kopano instalada y su manual local antes de ejecutar comandos específicos de la versión. Las implementaciones de Kopano Cloud o en contenedores pueden usar nombres de servicio y procedimientos de administración diferentes.

¿Qué debes comprobar antes de cambiar nada?

Necesitas acceso a la consola con permisos para leer los registros y la configuración de Kopano. Antes de editar la configuración o modificar los archivos de índice, anota la versión del paquete y crea una copia de seguridad de la configuración correspondiente. No copies la ruta del índice de otro servidor: las rutas predeterminadas y configuradas difieren entre las versiones del paquete. El manual del administrador de Kopano describe /etc/kopano/search.cfglos archivos de índice por tienda, el socket del servicio y el análisis de archivos adjuntos; también advierte sobre los riesgos de modificar los archivos de índice mientras el servicio está en ejecución. La sección de configuración de búsqueda de Kopano es la referencia principal para estos ajustes.

1. Confirma que kopano-search realmente se está bloqueando.

En un sistema que utiliza systemd, inspeccione la unidad y las entradas de registro recientes:

sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 100 --no-pager

Busque intentos de inicio repetidos, un código de salida, un rastreo de pila de Python o una excepción final específica. La última línea de un rastreo de pila suele ser más útil que la primera, ya que indica el error que detuvo el proceso. Si su instalación utiliza los scripts de inicio de SysV antiguos, verifique sudo service kopano-search statuse inspeccione el archivo de registro configurado o el registro del sistema. El servicio puede registrar información en un archivo o en syslog, según la configuración search.cfg, por lo que un registro vacío no demuestra que no se haya producido ningún error.

Guarda las líneas de registro relevantes antes de reiniciar. Si el servicio finaliza y systemd lo vuelve a iniciar, querrás saber si todos los intentos fallan en la misma etapa o si un evento en particular desencadenó el fallo.

2. Compruebe si el servicio de búsqueda puede acceder al servidor de Kopano.

El demonio de búsqueda debe conectarse al socket correcto del servidor Kopano. Verifique ambos servicios y compare los valores de socket configurados:

sudo systemctl status kopano-server --no-pager
sudo grep -E '^(server_socket|search_socket|search_enabled)[[:space:]]*='   /etc/kopano/server.cfg /etc/kopano/search.cfg

El conjunto exacto de claves presentes puede variar según la versión. En la configuración clásica de Core, search_enabled = yeshabilita la búsqueda de texto completo en server.cfg; search_socketle indica al servidor dónde contactar con el servicio de búsqueda. La server_socketconfiguración del servicio de búsqueda apunta al servidor Kopano. Una discrepancia, un socket faltante o un servidor detenido pueden producir errores de conexión que parecen un fallo de búsqueda. El servidor puede recurrir a la búsqueda directa en la base de datos mientras el socket de búsqueda no esté disponible, pero la indexación de texto completo no se restablece hasta que el servicio de búsqueda esté en buen estado.

3. Asociar los paquetes de Python con la compilación de Kopano.

kopano-searchUtiliza las bibliotecas Python de Kopano y los componentes nativos de MAPI. ImportErrorPuede aparecer un error de biblioteca compartida faltante o de carga de módulo después de una actualización parcial, un cambio de repositorio o una instalación manual de un paquete Python. Registre los paquetes instalados y el intérprete utilizado por el ejecutable empaquetado:

dpkg-query -W 'kopano-search' 'python*kopano*' 'python*mapi*' 2>/dev/null
p=$(command -v kopano-search) && head -n 1 "$p"

El segundo comando solo es útil si kopano-searchse encuentra en la ruta de la shell actual. Compare estos detalles con el repositorio y las instrucciones de instalación del conjunto de paquetes Kopano que utiliza. Si el servidor se administra con RPM, contenedores o un dispositivo de proveedor, utilice las herramientas de paquetes de esa plataforma en lugar de los comandos de Debian mencionados anteriormente.

No repare un servidor Kopano empaquetado ejecutando sudo pip installPython del sistema. Python-MAPI incluye componentes nativos, y mezclarlos con paquetes de Python no relacionados puede provocar que el intérprete encuentre módulos incompatibles. Restaure o reinstale los paquetes Kopano correspondientes desde el mismo repositorio de confianza, luego reinicie el servicio y revise el registro. Si la máquina se actualizó a través de varias versiones del sistema operativo, verifique que el repositorio de Kopano sea compatible con esa combinación de sistema operativo y Python antes de intentar reinstalar un paquete.

4. Comprobar permisos, espacio libre y análisis de archivos adjuntos.

Lea la configuración de index_path, log_file, tmp_path, y la configuración del analizador de adjuntos en /etc/kopano/search.cfg. Confirme que el sistema de archivos tenga espacio libre y que la cuenta de servicio pueda escribir donde la configuración lo espera. Por ejemplo:

df -h /var/lib/kopano /var/log
sudo namei -l /var/lib/kopano/search

Reemplace el directorio de índice de ejemplo con el valor de su propia configuración. Errores como "permiso denegado", "espacio insuficiente" o la creación fallida de un archivo temporal indican problemas de acceso al almacenamiento, en lugar de un fallo general de Python. Restaure el propietario y los permisos previstos utilizando la configuración predeterminada del paquete documentada en su servidor; no cambie la propiedad de forma recursiva en todos los directorios /var/lib/kopanosin verificar qué otros servicios los utilizan.

Si el rastreo o la sincronización implican la extracción de archivos adjuntos, verifique si index_attachments = yesy examine index_attachment_parserla base de datos del analizador y las utilidades externas que llama. El manual de Kopano explica que el contenido de los archivos adjuntos se convierte a texto mediante un script configurado y que se pueden establecer límites de tamaño, memoria y CPU para los archivos adjuntos. Como diagnóstico, puede configurar temporalmente index_attachments = no, reiniciar el servicio y ver si cesa el fallo. Esto desactiva la búsqueda dentro del contenido de los archivos adjuntos; no desactiva la indexación del cuerpo del mensaje. Si el fallo desaparece, repare el analizador o la dependencia específicos antes de volver a habilitar la indexación de archivos adjuntos.

5. Reconstruya solo el índice de la tienda afectada cuando los registros indiquen daños en el índice.

La reindexación es apropiada cuando el servicio se inicia correctamente, pero falla repetidamente al abrir o actualizar el índice de una tienda, o cuando los registros de Kopano identifican ese índice específico como dañado. No es la primera solución para un error de importación de Python, una discrepancia de socket o un disco lleno.

El manual de administración de Kopano indica que se debe detener el proceso kopano-searchantes de eliminar el archivo de índice de una tienda individual. También describe un archivo de estado en el directorio de índices, por lo que no se debe eliminar todo el directorio ni todos los índices de usuario como una reparación rutinaria. Primero, realice una copia de seguridad del archivo de índice correspondiente y confirme la identidad y la ruta del usuario o la tienda. Si su man kopano-searchdocumentación local contempla esta --reindexopción, utilice la sintaxis compatible con el paquete para reconstruir una tienda; el formato de la opción varía entre las compilaciones archivadas. El manual de Ubuntu Focal, por ejemplo, documenta una opción de reindexación dirigida e indica que el demonio debe estar en ejecución.

Una reconstrucción completa puede consumir espacio en disco y CPU, y los resultados de búsqueda pueden estar incompletos mientras se actualiza la indexación. Si no está seguro de qué archivo de almacenamiento está afectado, deténgase antes de eliminar nada y recopile el registro de servicio, las versiones de los paquetes y la configuración index_pathpara un administrador de Kopano o un canal de soporte.

6. Reinicie y verifique el resultado.

Una vez corregida la causa, reinicie únicamente el servicio de búsqueda:

sudo systemctl restart kopano-search
sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 50 --no-pager

Para una instalación de SysV, utilice el comando de servicio documentado en dicho paquete. Confirme que el proceso permanece activo, que el mismo rastreo de errores ya no se repite y que el socket de búsqueda aparece después de la indexación inicial. Kopano indica que el socket podría no crearse hasta que se haya generado el índice inicial. Pruebe una búsqueda de correo normal y, si la indexación de archivos adjuntos está habilitada, pruebe con un archivo adjunto conocido solo después de que se haya reparado el analizador.

Guía de diagnóstico rápido

La solución más fiable se basa en el error que aparece en el registro: reparar el entorno del paquete en caso de fallos de importación de Python, restaurar el socket correcto en caso de fallos de conexión, corregir la ruta o el analizador específicos en caso de errores de acceso y extracción, y reindexar solo cuando la evidencia indique que los datos del índice están dañados. Los manuales de Kopano disponibles cubren versiones anteriores de Core, por lo que conviene utilizarlos junto con el manual del paquete en lugar de asumir que todas las implementaciones actuales utilizan el mismo gestor de servicios o la misma sintaxis de opciones.