Procédure de désinstallation
Cette page décrit la procédure de désinstallation complète de Fess.
Avertissement
Notes importantes avant la désinstallation
La désinstallation supprimera toutes les données
si vous avez des données importantes, veuillez obligatoirement effectuer une sauvegarde
Pour les procédures de sauvegarde, consultez Procédure de mise à niveau
Préparation avant la désinstallation
Récupération de la sauvegarde
Veuillez sauvegarder les données nécessaires :
Données de configuration
Téléchargez depuis « système » → « sauvegarde » dans l’écran d’administration
Configuration d’exploration
si nécessaire, exportez la configuration d’exploration
Fichiers de configuration personnalisés
Version TAR.GZ/ZIP
$ cp -r /path/to/fess/app/WEB-INF/conf /backup/ $ cp -r /path/to/fess/app/WEB-INF/classes /backup/
Version RPM/DEB
$ sudo cp -r /etc/fess /backup/
Arrêt des services
Avant la désinstallation, arrêtez tous les services.
Version TAR.GZ/ZIP
$ ps aux | grep fess
$ kill <fess_pid>
$ kill <opensearch_pid>
Version RPM/DEB
$ sudo systemctl stop fess.service
$ sudo systemctl stop opensearch.service
Version Docker
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down
Désinstallation de la version TAR.GZ/ZIP
Étape 1 : suppression de Fess
supprimez le répertoire d’installation
$ rm -rf /path/to/fess-15.3.2
Étape 2 : suppression d’Opensearch
supprimez le répertoire d’installation d’Opensearch
$ rm -rf /path/to/opensearch-3.3.2
Étape 3 : suppression du répertoire de données (optionnel)
Par défaut, le répertoire de données se trouve dans le répertoire d’installation de Fess, mais si vous avez spécifié un emplacement différent, supprimez également ce répertoire
$ rm -rf /path/to/data
Étape 4 : suppression du répertoire de journaux (optionnel)
supprimez les fichiers journaux
$ rm -rf /path/to/fess/logs
$ rm -rf /path/to/opensearch/logs
Désinstallation de la version RPM
Étape 1 : Désinstallation de Fess
Désinstallez le package RPM
$ sudo rpm -e fess
Étape 2 : Désinstallation d’Opensearch
$ sudo rpm -e opensearch
Étape 3 : Désactivation et suppression des services
Avec chkconfig
$ sudo /sbin/chkconfig --del fess
$ sudo /sbin/chkconfig --del opensearch
Avec systemd
$ sudo systemctl disable fess.service
$ sudo systemctl disable opensearch.service
$ sudo systemctl daemon-reload
Étape 4 : suppression du répertoire de données
Avertissement
L’exécution de cette opération supprimera complètement toutes les données d’index et la configuration.
$ sudo rm -rf /var/lib/fess
$ sudo rm -rf /var/lib/opensearch
Étape 5 : suppression des fichiers de configuration
$ sudo rm -rf /etc/fess
$ sudo rm -rf /etc/opensearch
Étape 6 : suppression des fichiers journaux
$ sudo rm -rf /var/log/fess
$ sudo rm -rf /var/log/opensearch
Étape 7 : suppression des utilisateurs et groupes (optionnel)
Pour supprimer les utilisateurs et groupes système
$ sudo userdel fess
$ sudo groupdel fess
$ sudo userdel opensearch
$ sudo groupdel opensearch
Désinstallation de la version DEB
Étape 1 : Désinstallation de Fess
Désinstallez le package DEB
$ sudo dpkg -r fess
Pour supprimer complètement y compris les fichiers de configuration
$ sudo dpkg -P fess
Étape 2 : Désinstallation d’Opensearch
$ sudo dpkg -r opensearch
Ou pour supprimer y compris les fichiers de configuration
$ sudo dpkg -P opensearch
Étape 3 : Désactivation des services
$ sudo systemctl disable fess.service
$ sudo systemctl disable opensearch.service
$ sudo systemctl daemon-reload
Étape 4 : suppression du répertoire de données
Avertissement
L’exécution de cette opération supprimera complètement toutes les données d’index et la configuration.
$ sudo rm -rf /var/lib/fess
$ sudo rm -rf /var/lib/opensearch
Étape 5 : suppression des fichiers de configuration (si dpkg -P n’a pas été utilisé)
$ sudo rm -rf /etc/fess
$ sudo rm -rf /etc/opensearch
Étape 6 : suppression des fichiers journaux
$ sudo rm -rf /var/log/fess
$ sudo rm -rf /var/log/opensearch
Étape 7 : suppression des utilisateurs et groupes (optionnel)
Pour supprimer les utilisateurs et groupes système
$ sudo userdel fess
$ sudo groupdel fess
$ sudo userdel opensearch
$ sudo groupdel opensearch
Désinstallation de la version Docker
Étape 1 : suppression des conteneurs et réseaux
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down
Étape 2 : suppression des volumes
Avertissement
L’exécution de cette opération supprimera complètement toutes les données.
Vérification de la liste des volumes
$ docker volume ls
suppression des volumes liés à Fess
$ docker volume rm fess-es-data
$ docker volume rm fess-data
Ou suppression groupée de tous les volumes
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down -v
Étape 3 : suppression des images (optionnel)
Pour supprimer les images Docker et libérer de l’espace disque
$ docker images | grep fess
$ docker rmi codelibs/fess:15.3.2
$ docker images | grep opensearch
$ docker rmi opensearchproject/opensearch:3.3.2
Étape 4 : suppression du réseau (optionnel)
suppression du réseau créé par Docker Compose
$ docker network ls
$ docker network rm <network_name>
Étape 5 : suppression des fichiers Compose
$ rm compose.yaml compose-opensearch3.yaml
Vérification de la désinstallation
Vérifiez que tous les composants ont été supprimés.
Vérification des processus
$ ps aux | grep fess
$ ps aux | grep opensearch
si rien ne s’affiche, les processus sont arrêtés.
Vérification des ports
$ sudo netstat -tuln | grep 8080
$ sudo netstat -tuln | grep 9200
Vérifiez que les ports ne sont pas utilisés.
Vérification des fichiers
Version TAR.GZ/ZIP
$ ls /path/to/fess-15.3.2 # Vérifiez que le répertoire n'existe pas
Version RPM/DEB
$ ls /var/lib/fess # Vérifiez que le répertoire n'existe pas
$ ls /etc/fess # Vérifiez que le répertoire n'existe pas
Version Docker
$ docker ps -a | grep fess # Vérifiez que le conteneur n'existe pas
$ docker volume ls | grep fess # Vérifiez que le volume n'existe pas
Vérification des packages
Version RPM
$ rpm -qa | grep fess
$ rpm -qa | grep opensearch
Version DEB
$ dpkg -l | grep fess
$ dpkg -l | grep opensearch
si rien ne s’affiche, les packages ont été supprimés.
Désinstallation partielle
supprimer uniquement Fess en conservant Opensearch
si vous utilisez également Opensearch pour d’autres applications, vous pouvez supprimer uniquement Fess.
Arrêt de Fess
suppression du package ou du répertoire de Fess
suppression du répertoire de données de Fess (
/var/lib/fess, etc.)Ne pas supprimer Opensearch
supprimer uniquement Opensearch en conservant Fess
Avertissement
si vous supprimez Opensearch, Fess ne fonctionnera plus. Veuillez modifier la configuration pour vous connecter à un autre cluster Opensearch.
Arrêt d’Opensearch
suppression du package ou du répertoire d’Opensearch
suppression du répertoire de données d’Opensearch (
/var/lib/opensearch, etc.)Mise à jour de la configuration de Fess pour spécifier un autre cluster Opensearch
Dépannage
Impossible de supprimer le package
symptôme :
Erreur avec rpm -e ou dpkg -r.
solution :
Vérifiez que le service est arrêté
$ sudo systemctl stop fess.service
Vérifiez les dépendances
$ rpm -qa | grep fess $ dpkg -l | grep fess
suppression forcée (dernier recours)
$ sudo rpm -e --nodeps fess $ sudo dpkg -r --force-all fess
Impossible de supprimer le répertoire
symptôme :
Impossible de supprimer le répertoire avec rm -rf.
solution :
Vérifiez les permissions
$ ls -ld /path/to/directory
suppression avec sudo
$ sudo rm -rf /path/to/directory
Vérifiez qu’aucun processus n’utilise le fichier
$ sudo lsof | grep /path/to/directory
Préparation pour la réinstallation
si vous réinstallez après la désinstallation, vérifiez les points suivants :
Tous les processus sont arrêtés
Tous les fichiers et répertoires ont été supprimés
Les ports 8080 et 9200 ne sont pas utilisés
Il ne reste aucun fichier de configuration antérieur
Pour les procédures de réinstallation, consultez Choix de la méthode d’installation.
Étapes suivantes
Après la désinstallation :
Pour installer une nouvelle version, consultez Choix de la méthode d’installation
Pour migrer des données, consultez Procédure de mise à niveau
Pour envisager une solution de recherche alternative, consultez le site officiel de Fess