Todo sobre el motor de búsqueda en Liferay: Elasticsearch

Elasticsearch es el motor de búsqueda nativo de Liferay DXP y permite indexar contenidos, aplicar filtros y mejorar la relevancia de los resultados. Su integración ha evolucionado con Elasticsearch 8, Sidecar y OpenSearch, mientras que Liferay Enterprise Search añade funciones avanzadas como Search Blueprints y búsqueda semántica con IA.

¿Qué es Elasticsearch y qué relación tiene con Liferay?

Elasticsearch es un motor distribuido de búsqueda y análisis diseñado para indexar grandes cantidades de información y recuperar resultados con rapidez y relevancia.

En Liferay DXP, Elasticsearch funciona como el motor encargado de crear y consultar los índices de búsqueda. Cuando se publica o modifica contenido en el portal, Liferay envía la información correspondiente al motor de búsqueda para que pueda ser localizada posteriormente.

Esto afecta a numerosos tipos de información gestionados por la plataforma, entre ellos:

• contenidos web y Commerce
• documentos y archivos.
• Liferay blogs.
• páginas.
• categorías y etiquetas.
• Productos de Commerce.
• objetos y entidades personalizadas.
• otros contenidos indexables desarrollados sobre Liferay.

La búsqueda que ve el usuario en un portal Liferay es, por tanto, el resultado de la interacción entre la plataforma y el motor de búsqueda.

Liferay mantiene Elasticsearch como su motor de búsqueda nativo y documenta su instalación y conexión como infraestructura independiente para entornos productivos.

¿Para qué utiliza Liferay Elasticsearch?

Elasticsearch no se limita a localizar una palabra dentro de un contenido. Su integración con Liferay permite construir experiencias de búsqueda más complejas.

Entre sus principales funciones se encuentran:

• Búsqueda de texto completo: Permite localizar contenidos teniendo en cuenta los términos introducidos por el usuario y los diferentes campos que Liferay ha enviado al índice. La relevancia determina qué resultados deberían aparecer antes dependiendo de factores como la coincidencia con los términos buscados, el campo donde aparecen o las reglas de búsqueda configuradas.
• Filtros y facetas: Las facetas permiten filtrar progresivamente los resultados por atributos como tipo de contenido, categoría, etiqueta, fecha, sitio, usuario u otros campos indexados, lo que resulta especialmente útil en portales con grandes volúmenes de información, intranets, catálogos documentales o plataformas de comercio electrónico.
• Sugerencias y experiencia de búsqueda: La arquitectura de búsqueda de Liferay también permite trabajar con sugerencias, sinónimos, rankings de resultados y diferentes configuraciones orientadas a mejorar la relevancia.
• Indexación personalizada: Los desarrolladores pueden incorporar nuevos campos al índice, modificar cómo se indexan determinadas entidades o implementar comportamientos de búsqueda específicos para cada proyecto. Por ello, la arquitectura de Elasticsearch debe plantearse como una parte relevante del diseño técnico de un portal Liferay y no únicamente como un servicio auxiliar.

Compatibilidad entre Liferay y Elasticsearch

Uno de los aspectos clave al configurar Elasticsearch es comprobar su compatibilidad con la versión y el nivel de actualización de Liferay:

Desde Liferay DXP 2026.Q1 se utiliza un connector nativo para Elasticsearch 8 y se requiere la versión 8.19 o superior, mientras que Elasticsearch 7 deja de estar soportado. En versiones anteriores, la compatibilidad depende del patch level y del connector utilizado. Por ello, antes de cualquier instalación o actualización es recomendable consultar la Search Engine Compatibility Matrix de Liferay.

Elasticsearch Sidecar y Elasticsearch remoto: ¿qué diferencia hay?

La forma en que Liferay ejecuta Elasticsearch también ha cambiado con el tiempo.

En versiones anteriores de Liferay se utilizaba un Elasticsearch embebido dentro de la plataforma. A partir de Liferay 7.3 este funcionamiento fue sustituido por Elasticsearch Sidecar, que ejecuta el servidor de Elasticsearch como un proceso independiente.

Actualmente pueden distinguirse principalmente dos escenarios:

Elasticsearch Sidecar

Sidecar facilita el desarrollo al proporcionar un motor de búsqueda preconfigurado sin necesidad de desplegar infraestructura externa. Desde Liferay 7.3 utiliza por defecto el puerto 9201 y está pensado únicamente para entornos locales y de prueba, no para producción.

Elasticsearch remoto

En producción, Elasticsearch debe desplegarse como una infraestructura independiente y conectarse con Liferay, lo que permite gestionar de forma separada aspectos como nodos, recursos, almacenamiento, seguridad, copias de seguridad, rendimiento y monitorización. Esta separación es especialmente importante en portales con grandes volúmenes de usuarios o contenidos.

¿Cómo conectar Liferay con Elasticsearch?

La configuración exacta depende de la versión de Liferay y del connector utilizado, pero el proceso general sigue una lógica común.

1. Comprobar la compatibilidad

Antes de instalar Elasticsearch hay que identificar:

• versión exacta de Liferay.
• patch level o quarterly release.
• versión compatible de Elasticsearch.
• connector necesario.

No es recomendable actualizar Elasticsearch de manera independiente sin comprobar previamente esta relación.

2. Instalar Elasticsearch

En producción debe prepararse una instancia o un clúster de Elasticsearch independiente de Liferay.

También deben instalarse los plugins que requiera la versión correspondiente. La documentación actual de Liferay incluye, entre otros, plugins de análisis lingüístico como ICU, Kuromoji, Smart Chinese Analysis y Stempel.

3. Configurar el connector de Liferay

Liferay utiliza archivos de configuración OSGi para establecer la conexión con Elasticsearch.

En Liferay DXP 2026.Q1 se utiliza una entrada de configuración nativa de Elasticsearch 8. En releases anteriores se mantiene la configuración asociada al connector Elasticsearch 7 incluso en determinados escenarios donde el servidor ejecuta Elasticsearch 8.

Entre los parámetros relevantes se encuentran la activación del modo de producción y las direcciones de los nodos que forman el clúster.

Una configuración simplificada puede incluir conceptos como:

productionModeEnabled=»true»

networkHostAddresses=[«https://elasticsearch:9200»]

Los valores reales dependerán de la infraestructura, la versión instalada y la configuración de seguridad.

4. Comprobar la conexión

Una vez configurado el connector, Liferay permite revisar el estado del motor desde el panel de administración de búsqueda.

En Control Panel → Configuration → Search pueden consultarse datos como:

• proveedor del motor.
• versión del cliente.
• conexión activa.
• estado del clúster.
• nodos disponibles.
• versión de cada nodo.

5. Reindexar cuando sea necesario

Después de determinadas instalaciones, migraciones o cambios importantes puede ser necesario reconstruir los índices de Liferay.

La reindexación debe planificarse teniendo en cuenta el tamaño del portal y el impacto que pueda tener sobre Elasticsearch y el resto de la infraestructura.

Buenas prácticas para Elasticsearch en producción

Una arquitectura de búsqueda adecuada debe ir más allá de conseguir que Liferay pueda conectarse correctamente con Elasticsearch.

• Separar Liferay y Elasticsearch: Elasticsearch debería ejecutarse fuera del servidor de Liferay para poder gestionar y escalar ambos sistemas de forma independiente.
• Dimensionar correctamente el clúster: El número de nodos y los recursos disponibles deben responder al volumen real de información, las necesidades de disponibilidad y el número de consultas. No existe una configuración universal válida para todos los proyectos.
• Proteger la comunicación: En producción debe asegurarse la comunicación entre Liferay y Elasticsearch mediante los mecanismos de autenticación y cifrado correspondientes. La documentación de Liferay recomienda proteger esta comunicación cuando se conecta con un servidor Elasticsearch productivo.
• Planificar las copias de seguridad: Aunque gran parte de los índices de Liferay puede reconstruirse a partir de la base de datos, determinados datos relacionados con la configuración de búsqueda pueden requerir protección adicional. Liferay recomienda realizar snapshots de Elasticsearch antes de los procesos de actualización y presta especial atención a aquellos datos almacenados exclusivamente en los índices de búsqueda.
• Controlar la reindexación: Una reindexación completa puede generar una carga importante sobre Liferay, Elasticsearch y la base de datos. En proyectos de gran tamaño conviene planificar estos procesos y evitar ejecutarlos de forma indiscriminada en momentos de elevada actividad.

Elasticsearch 8 y la evolución de Liferay DXP

La llegada de Elasticsearch 8 representa uno de los principales cambios respecto a las primeras implementaciones de Liferay 7.

Elasticsearch 7 ha llegado al final de su ciclo de vida y Liferay DXP 2026.Q1 ya trabaja con un connector nativo de Elasticsearch 8. Para actualizar a esta versión de Liferay es necesario contar previamente con Elasticsearch 8.19 o superior.

Esto significa que una actualización de Liferay no debería abordarse únicamente como una actualización de la propia plataforma.

En proyectos que todavía utilicen Elasticsearch 7 es necesario revisar también:

• versión actual del motor;
• connector instalado;
• configuración de Elasticsearch;
• plugins;
• seguridad;
• índices existentes;
• snapshots;
• estrategia de reindexación;
• compatibilidad con la nueva release.

La actualización del motor de búsqueda debe formar parte del plan global de evolución de Liferay.

¿Puede utilizarse OpenSearch con Liferay?

Elasticsearch ya no es la única opción disponible para determinados proyectos.

A partir de Liferay DXP 2025.Q1, Liferay permite utilizar OpenSearch como motor de búsqueda mediante su connector correspondiente. Elasticsearch continúa siendo el motor nativo de Liferay, mientras que OpenSearch se incorpora como alternativa para arquitecturas que requieren esta tecnología.

A la hora de elegir entre ambos motores deben analizarse factores como:

La elección no debería realizarse únicamente en función del motor. También hay que comprobar qué funcionalidades de Liferay Enterprise Search se necesitan y si están disponibles en la arquitectura elegida.

Búsqueda por palabras clave y búsqueda semántica en Liferay

Liferay ha evolucionado desde la búsqueda tradicional por palabras clave, basada en relevancia, sinónimos, filtros, facetas y reglas personalizadas, hacia una verdadera búsqueda semántica, capaz de interpretar el significado y la intención de las consultas aunque no exista una coincidencia exacta de términos. Esta funcionalidad está disponible de forma general en Liferay Enterprise Search desde Liferay DXP 2026.Q1, inicialmente con OpenAI como proveedor de embeddings y con otras opciones como txtai o Hugging Face.

¿Cómo funciona la búsqueda semántica con Elasticsearch?

En la búsqueda semántica, el contenido y las consultas se transforman en embeddings, representaciones numéricas que permiten detectar similitudes de significado aunque no coincidan exactamente las mismas palabras. Así, una consulta sobre “gestionar documentos de empleados” puede relacionarse con contenidos sobre “gestión documental para recursos humanos”.

Liferay incorpora este enfoque mediante Search Blueprints, que permiten ejecutar búsquedas semánticas o combinarla con la búsqueda tradicional, la relevancia y las reglas de negocio. De este modo, es posible aplicar modelos híbridos sin sustituir por completo la búsqueda por palabras clave.

La importancia de diseñar correctamente la búsqueda en Liferay

La arquitectura de búsqueda debe definirse desde las primeras fases del proyecto para evitar problemas posteriores de relevancia, rendimiento, escalabilidad, indexación, navegación o mantenimiento. Para ello, conviene establecer qué contenidos se indexarán, qué filtros y facetas se utilizarán, qué reglas de relevancia se aplicarán y qué volumen de consultas deberá soportar el sistema.

También es necesario planificar la infraestructura de Elasticsearch, la monitorización, las copias de seguridad y el uso de funciones avanzadas como Search Blueprints o búsqueda semántica. El objetivo no es solo indexar contenidos, sino ofrecer una experiencia de búsqueda útil, estable y escalable.

Liferay y Elasticsearch en proyectos empresariales

Liferay DXP permite desarrollar portales, intranets y plataformas digitales con requisitos muy distintos. En aquellos proyectos donde existen grandes volúmenes de contenidos o donde localizar la información rápidamente es crítico, Elasticsearch pasa a formar parte de la arquitectura principal de la solución.

La evolución de Liferay también ha aumentado las posibilidades disponibles: Elasticsearch 8, OpenSearch, Liferay Enterprise Search, Search Blueprints y búsqueda semántica permiten adaptar cada vez más el comportamiento del buscador al contexto de negocio.

Pero esta flexibilidad también hace necesario revisar cuidadosamente la compatibilidad entre versiones, la infraestructura del motor de búsqueda y la estrategia de actualización.

En hiberus contamos con un equipo especializado en Liferay DXP que trabaja en el diseño, desarrollo, migración y evolución de plataformas digitales empresariales. Si necesitas actualizar una instalación de Liferay, migrar Elasticsearch, optimizar el rendimiento del buscador o diseñar una nueva arquitectura de búsqueda, podemos ayudarte a definir e implementar la solución más adecuada para tu proyecto.