Método de Instalación
Fess proporciona distribuciones como archivo ZIP, paquetes RPM/DEB e imágenes Docker. Al utilizar Docker, puede configurar fácilmente Fess en Windows, Mac, etc.
Nota
Esta página explica la configuración en Windows con Docker. Los usuarios de Linux o macOS pueden seguir pasos similares, pero la instalación de Docker Desktop varía según la plataforma. Para más detalles, consulte la documentación de Docker.
Al construir un entorno de operación, asegúrese de consultar Guía de Instalación de Fess. Para conocer los requisitos del sistema, consulte Requisitos del Sistema.
Advertencia
Notas importantes para el entorno de producción
No se recomienda ejecutar con OpenSearch integrado en entornos de producción o pruebas de carga. Asegúrese de construir un servidor OpenSearch externo.
Resumen de la Configuración
Siga estos pasos en orden:
Instalar Docker Desktop
Configurar el sistema operativo (ajustar vm.max_map_count)
Descargar los archivos de inicio de Fess
Iniciar Fess y verificar el funcionamiento
Instalación de Docker Desktop
Si Docker Desktop no está instalado, instálelo siguiendo el siguiente procedimiento.
Descarga
Descargue el instalador del sistema operativo correspondiente en Docker Desktop.
Ejecución del Instalador
Haga doble clic en el instalador descargado para iniciar la instalación.
Asegúrese de que «Install required Windows components for WSL 2» o «Install required Enable Hyper-V Windows Features» esté seleccionado, y haga clic en el botón OK.
Una vez completada la instalación, haga clic en el botón «close» para cerrar la pantalla.
Inicio de Docker Desktop
Haga clic en «Docker Desktop» en el menú de Windows para iniciarlo.
Después de iniciar Docker Desktop, se mostrarán los términos de uso, marque «I accept the terms» y haga clic en el botón «Accept».
Aparecerá una guía para iniciar el tutorial, pero haga clic en «Skip tutorial» para omitirlo. Al hacer clic en «Skip tutorial», se mostrará el Dashboard.
Configuración
Para que OpenSearch se pueda ejecutar como contenedor Docker, ajuste el valor de «vm.max_map_count» en el sistema operativo. Dado que el método de configuración difiere según el entorno utilizado, consulte «Set vm.max_map_count to at least 262144» para cada método de configuración.
Configuración de Fess
Creación de archivos de inicio
Cree una carpeta apropiada y descargue compose.yaml y compose-opensearch3.yaml.
Nota
compose-opensearch3.yaml es un archivo de configuración adicional para usar OpenSearch 3.x. Se usa en combinación con compose.yaml.
También puede obtenerlos con el comando curl de la siguiente manera:
Inicio de Fess
Inicie Fess con el comando docker compose.
Abra el símbolo del sistema, navegue a la carpeta donde se encuentra el archivo compose.yaml y ejecute el siguiente comando:
Nota
El inicio puede tardar varios minutos. Puede verificar los registros con el siguiente comando:
Puede finalizar la visualización de registros con Ctrl+C.
Verificación de Funcionamiento
Nota
Una vez completado el inicio, acceda a las siguientes URLs en su navegador para verificar:
Búsqueda: http://localhost:8080/
Interfaz de administración: http://localhost:8080/admin/
El nombre de usuario/contraseña de la cuenta de administrador predeterminada es admin/admin.
Advertencia
Nota importante sobre seguridad
Asegúrese de cambiar la contraseña predeterminada. Especialmente en entornos de producción, se recomienda encarecidamente cambiar la contraseña inmediatamente después del primer inicio de sesión.
La cuenta de administrador es gestionada por el servidor de aplicaciones. La interfaz de administración de Fess determina como administrador a los usuarios autenticados con el rol fess en el servidor de aplicaciones.
Otros
Detención de Fess
Para detener Fess, ejecute el siguiente comando en la carpeta donde inició Fess:
Para detener y eliminar contenedores:
Advertencia
Para eliminar también los volúmenes con el comando down, agregue la opción -v. En este caso, todos los datos se eliminarán, así que tenga cuidado.
Cambio de contraseña de administrador
Puede cambiar la contraseña en la pantalla de edición de usuario de la interfaz de administración.
Acceda a http://localhost:8080/admin/ e inicie sesión.
Seleccione «Usuario» en el menú superior derecho.
Abra la página de edición del usuario admin y cambie la contraseña.
Próximos Pasos
Una vez configurado Fess, consulte la siguiente documentación para continuar:
Inicio, Detención y Configuración Inicial — Inicio, detención y configuración detallada
Guía del Administrador de Fess — Guía del administrador (configuración de rastreo, gestión de usuarios, etc.)
Guia de Usuario de Fess — Guía del usuario (cómo buscar)
Si encuentra algún problema, consulte Solución de Problemas.