Menu

Choix de la méthode d’installation

Cette page décrit une vue d’ensemble des méthodes d’installation de Fess. Veuillez sélectionner la méthode d’installation appropriée en fonction de votre environnement.

Avertissement

Note importante pour les environnements de production

Pour les environnements de production ou les tests de charge, nous ne recommandons pas l’utilisation d’OpenSearch intégré. Veuillez obligatoirement configurer un serveur OpenSearch externe.

Vérification des prérequis

Avant de commencer l’installation, veuillez vérifier la configuration requise.

Pour plus de détails, consultez Configuration requise.

Comparaison des méthodes d’installation

Fess peut être installé selon les méthodes suivantes. Veuillez sélectionner en fonction de votre environnement et de votre utilisation.

Méthode Système d’exploitation Usage recommandé Documentation détaillée
Docker Linux, Windows, macOS Environnement de développement/évaluation, configuration rapide Installation avec Docker (Détails)
TAR.GZ Linux, macOS Environnement nécessitant une personnalisation Installation sur Linux (Procédure détaillée)
RPM RHEL, CentOS, Fedora Environnement de production (basé sur RPM) Installation sur Linux (Procédure détaillée)
DEB Debian, Ubuntu Environnement de production (basé sur DEB) Installation sur Linux (Procédure détaillée)
ZIP Windows Développement/production sur environnement Windows Installation sur Windows (Procédure détaillée)

Caractéristiques de chaque méthode d’installation

Version Docker

Avantages :

  • Configuration la plus rapide possible

  • Gestion des dépendances non nécessaire

  • Idéal pour la création d’environnements de développement

  • Démarrage et arrêt faciles des conteneurs

Inconvénients :

  • Connaissance de Docker requise

Environnement recommandé : Environnements de développement, d’évaluation, POC, production

Détails : Installation avec Docker (Détails)

Packages Linux (TAR.GZ/RPM/DEB)

Avantages :

  • Hautes performances en environnement natif

  • Gestion possible en tant que service système (RPM/DEB)

  • Personnalisation fine possible

Inconvénients :

  • Installation manuelle de Java et OpenSearch requise

  • Configuration nécessitant un effort

Environnement recommandé : Environnement de production, environnement nécessitant une personnalisation

Détails : Installation sur Linux (Procédure détaillée)

Version Windows (ZIP)

Avantages :

  • Fonctionne en environnement Windows natif

  • Aucun installateur nécessaire

Inconvénients :

  • Installation manuelle de Java et OpenSearch requise

  • Configuration nécessitant un effort

Environnement recommandé : Développement/évaluation sur environnement Windows, exploitation en production sur Windows Server

Détails : Installation sur Windows (Procédure détaillée)

Flux d’installation de base

Pour toutes les méthodes d’installation, le flux de base est le même.

  1. Vérification de la configuration requise

    Consultez Configuration requise pour confirmer que la configuration requise est satisfaite.

  2. Téléchargement du logiciel

    Téléchargez Fess depuis le site de téléchargement.

    Pour la version Docker, obtenez le fichier Docker Compose.

  3. Configuration d’OpenSearch

    Pour les versions autres que Docker, vous devez configurer OpenSearch séparément.

    • Installation d’OpenSearch 3.3.2

    • Installation des plugins requis

    • Modification des fichiers de configuration

  4. Configuration de Fess

    • Installation de Fess

    • Modification des fichiers de configuration (informations de connexion à OpenSearch, etc.)

  5. Démarrage et vérification

    • Démarrage du service

    • Vérification du fonctionnement en accédant via un navigateur

    Pour plus de détails, consultez Démarrage, arrêt et configuration initiale.

Composants requis

Pour exécuter Fess, les composants suivants sont nécessaires.

Application Fess

Il s’agit du système de recherche plein texte principal. Il fournit des fonctionnalités telles que l’interface Web, le crawler et l’indexeur.

OpenSearch

OpenSearch est utilisé comme moteur de recherche.

  • Version compatible : OpenSearch 3.3.2

  • Plugins requis :

    • opensearch-analysis-fess

    • opensearch-analysis-extension

    • opensearch-minhash

    • opensearch-configsync

Important

Les versions d’OpenSearch et des plugins doivent correspondre. Une incompatibilité de version peut causer des erreurs de démarrage ou des comportements inattendus.

Java (sauf version Docker)

Pour les versions TAR.GZ/ZIP/RPM/DEB, Java 21 ou ultérieur est requis.

  • Recommandé : Eclipse Temurin

  • OpenJDK 21 ou ultérieur peut également être utilisé

Note

Pour la version Docker, Java est inclus dans l’image Docker, donc aucune installation séparée n’est nécessaire.

Étapes suivantes

Après avoir vérifié la configuration requise, veuillez sélectionner la méthode d’installation appropriée.

  1. Configuration requise - Vérification de la configuration requise

  2. Sélection de la méthode d’installation :

  3. Démarrage, arrêt et configuration initiale - Démarrage de Fess et configuration initiale

  4. Configuration de la sécurité - Configuration de la sécurité (pour les environnements de production)

Questions fréquemment posées

Q : OpenSearch est-il obligatoire ?

R : Oui, il est obligatoire. Fess utilise OpenSearch comme moteur de recherche. Pour la version Docker, il est configuré automatiquement, mais pour les autres méthodes, vous devez l’installer manuellement.

Q : Peut-on effectuer une mise à niveau depuis une version antérieure ?

R : Oui, c’est possible. Pour plus de détails, consultez Procédure de mise à niveau.

Q : Peut-on configurer avec plusieurs serveurs ?

R : Oui, c’est possible. Fess et OpenSearch peuvent être exécutés sur des serveurs séparés. De plus, en configurant OpenSearch en cluster, vous pouvez améliorer la haute disponibilité et les performances.

Téléchargements

Fess et les composants associés peuvent être téléchargés depuis :

Informations de version

Cette documentation concerne les versions suivantes :

  • Fess : 15.3.2

  • OpenSearch : 3.3.2

  • Java : 21 ou ultérieur

  • Docker : 20.10 ou ultérieur

  • Docker Compose : 2.0 ou ultérieur

Pour la documentation des versions précédentes, veuillez consulter la documentation de chaque version.