Installation sur Windows (Procédure détaillée)
Cette page décrit la procédure d’installation de Fess sur un environnement Windows. Elle documente la méthode d’installation à l’aide du package ZIP.
Avertissement
Pour les environnements de production, nous ne recommandons pas l’utilisation d’Opensearch intégré. Veuillez obligatoirement configurer un serveur Opensearch externe.
Prérequis
La configuration requise décrite dans Configuration requise doit être satisfaite
Java 21 doit être installé
Opensearch 3.3.2 doit être disponible (ou nouvelle installation)
La variable d’environnement Windows
JAVA_HOMEdoit être configurée de manière appropriée
Vérification de l’installation de Java
Ouvrez l’invite de commandes ou Powershell et vérifiez la version de Java avec la commande suivante.
Invite de commandes
C:\> java -version
Powershell
Ps C:\> java -version
Vérifiez que Java 21 ou ultérieur est affiché.
Configuration des variables d’environnement
Configuration de la variable d’environnement
JAVA_HOMEConfigurez le répertoire d’installation de Java comme
JAVA_HOME.Exemple
JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-21.0.1.12-hotspot
Ajout à la variable d’environnement
PATHAjoutez
%JAVA_HOME%\binà la variable d’environnementPATH.
Astuce
Méthode de configuration des variables d’environnement :
Ouvrir les « Paramètres » depuis le menu « Démarrer »
Cliquer sur « système » → « Informations système » → « Paramètres système avancés »
Cliquer sur le bouton « Variables d’environnement »
Configurer dans « Variables système » ou « Variables utilisateur »
Étape 1 : Installation d’Opensearch
Téléchargement d’Opensearch
Téléchargez le package ZIP pour Windows depuis Download Opensearch.
Décompressez le fichier ZIP téléchargé dans un répertoire arbitraire.
Exemple
C:\opensearch-3.3.2
Note
Nous recommandons de choisir un répertoire dont le chemin ne contient pas de caractères japonais ou d’espaces.
Installation des plugins Opensearch
Ouvrez l’invite de commandes avec des privilèges d’administrateur et exécutez les commandes suivantes.
C:\> cd C:\opensearch-3.3.2
C:\opensearch-3.3.2> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.3.2
C:\opensearch-3.3.2> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.3.2
C:\opensearch-3.3.2> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.3.2
C:\opensearch-3.3.2> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.3.2
Important
Les versions des plugins doivent correspondre à la version d’Opensearch. Dans l’exemple ci-dessus, toutes sont spécifiées en 3.3.2.
Configuration d’Opensearch
Ouvrez config\opensearch.yml avec un éditeur de texte et ajoutez les paramètres suivants.
# Chemin pour la synchronisation de configuration (spécifier en chemin absolu)
configsync.config_path: C:/opensearch-3.3.2/data/config/
# Désactivation du plugin de sécurité (environnement de développement uniquement)
plugins.security.disabled: true
Avertissement
Note importante sur la sécurité
plugins.security.disabled: true ne doit être utilisé que dans les environnements de développement ou de test. Pour les environnements de production, veuillez activer le plugin de sécurité d’Opensearch et configurer une authentification et une autorisation appropriées. Pour plus de détails, consultez Configuration de la sécurité.
Note
sous Windows, utilisez / plutôt que \ comme séparateur de chemin. Écrivez C:/opensearch-3.3.2/data/config/ plutôt que C:\opensearch-3.3.2\data\config\.
Astuce
Autres paramètres recommandés
cluster.name: fess-cluster
node.name: fess-node-1
network.host: 0.0.0.0
discovery.type: single-node
Étape 2 : Installation de Fess
Téléchargement de Fess
Téléchargez le package ZIP pour Windows depuis le site de téléchargement.
Décompressez le fichier ZIP téléchargé dans un répertoire arbitraire.
Exemple
C:\fess-15.3.2
Note
Nous recommandons de choisir un répertoire dont le chemin ne contient pas de caractères japonais ou d’espaces.
Configuration de Fess
Ouvrez bin\fess.in.bat avec un éditeur de texte et ajoutez ou modifiez les paramètres suivants.
set sEARCH_ENGINE_HTTP_URL=http://localhost:9200
set FEss_DICTIONARY_PATH=C:/opensearch-3.3.2/data/config/
Note
si vous exécutez Opensearch sur un autre hôte, modifiez
sEARCH_ENGINE_HTTP_URLavec le nom d’hôte ou l’adresse IP appropriés.Utilisez
/comme séparateur de chemin.
Vérification de l’installation
Vérifiez que les fichiers de configuration ont été correctement modifiés.
Invite de commandes
C:\> findstr "sEARCH_ENGINE_HTTP_URL" C:\fess-15.3.2\bin\fess.in.bat
C:\> findstr "FEss_DICTIONARY_PATH" C:\fess-15.3.2\bin\fess.in.bat
Étape 3 : Démarrage
Pour la procédure de démarrage, consultez Démarrage, arrêt et configuration initiale.
Enregistrement en tant que service Windows (optionnel)
En enregistrant Fess et Opensearch en tant que services Windows, vous pouvez les configurer pour qu’ils démarrent automatiquement au démarrage du système.
Note
Pour l’enregistrement en tant que service Windows, vous devez utiliser un outil tiers (tel que NssM). Pour les procédures détaillées, consultez la documentation de chaque outil.
Exemple d’utilisation de NssM
Téléchargez et décompressez NssM (Non-sucking service Manager).
Enregistrement d’Opensearch en tant que service
C:\> nssm install Opensearch C:\opensearch-3.3.2\bin\opensearch.bat
Enregistrement de Fess en tant que service
C:\> nssm install Fess C:\fess-15.3.2\bin\fess.bat
Configuration des dépendances de service (Fess dépend d’Opensearch)
C:\> sc config Fess depend= Opensearch
Démarrage des services
C:\> net start Opensearch C:\> net start Fess
Configuration du pare-feu
Ouvrez les ports nécessaires dans le Pare-feu Windows Defender.
Ouvrez « Panneau de configuration » → « Pare-feu Windows Defender » → « Paramètres avancés »
Créez une nouvelle règle dans « Règles de trafic entrant »
Type de règle : Port
Protocole et port : TCP, 8080
Action : Autoriser la connexion
Nom : Fess Web Interface
Ou exécutez dans Powershell
Ps C:\> New-NetFirewallRule -DisplayName "Fess Web Interface" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow
Dépannage
Conflit de numéros de port
si les ports 8080 ou 9200 sont déjà utilisés, vous pouvez le vérifier avec la commande suivante
C:\> netstat -ano | findstr :8080
C:\> netstat -ano | findstr :9200
Modifiez le numéro de port utilisé ou arrêtez le processus en conflit.
Limitation de la longueur des chemins
sous Windows, il existe une limitation de la longueur des chemins. Nous recommandons d’installer dans un chemin aussi court que possible.
Exemple
C:\opensearch (recommandé)
C:\Program Files\opensearch-3.3.2 (non recommandé - chemin trop long)
Java n’est pas reconnu
si une erreur s’affiche avec la commande java -version :
Vérifiez que la variable d’environnement
JAVA_HOMEest correctement configuréeVérifiez que
%JAVA_HOME%\binest inclus dans la variable d’environnementPATHRedémarrez l’invite de commandes pour appliquer les paramètres
Étapes suivantes
Une fois l’installation terminée, consultez les documents suivants :
Démarrage, arrêt et configuration initiale - Démarrage de Fess et configuration initiale
Configuration de la sécurité - Configuration de la sécurité pour les environnements de production
Dépannage - Dépannage
Questions fréquemment posées
Q : L’exploitation sur Windows server est-elle recommandée ?
R : Oui, l’exploitation sur Windows server est possible. Lors de l’exploitation sur Windows server, enregistrez-le en tant que service Windows et configurez une surveillance appropriée.
Q : Quelle est la différence entre les versions 64 bits et 32 bits ?
R : Fess et Opensearch ne prennent en charge que la version 64 bits. Ils ne fonctionnent pas sur Windows 32 bits.
Q : Comment gérer les chemins contenant des caractères japonais ?
R : Dans la mesure du possible, veuillez installer dans un chemin ne contenant pas de caractères japonais ou d’espaces. si vous devez absolument utiliser un chemin japonais, vous devez échapper correctement le chemin dans les fichiers de configuration.