卸载步骤
本页面说明完全卸载 Fess 的步骤。
卸载前的准备
获取备份
请备份必要的数据：
配置数据
从管理页面的「系统」→「备份」下载
爬取配置
根据需要导出爬取配置
定制的配置文件
TAR.GZ/ZIP 版:
$ cp -r /path/to/fess/app/WEB-INF/conf /backup/ $ cp -r /path/to/fess/app/WEB-INF/classes /backup/
RPM/DEB 版:
$ sudo cp -r /etc/fess /backup/
停止服务
卸载前，停止所有服务。
TAR.GZ/ZIP 版:
$ ps aux | grep fess
$ kill <fess_pid>
$ kill <opensearch_pid>
RPM/DEB 版:
$ sudo systemctl stop fess.service
$ sudo systemctl stop opensearch.service
Docker 版:
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down
TAR.GZ/ZIP 版的卸载
步骤 1: 删除 Fess
删除安装目录:
$ rm -rf /path/to/fess-15.3.2
步骤 2: 删除 OpenSearch
删除 OpenSearch 的安装目录:
$ rm -rf /path/to/opensearch-3.3.2
步骤 3: 删除数据目录（可选）
默认情况下，数据目录在 Fess 的安装目录内， 但如果指定了其他位置，也请删除该目录:
$ rm -rf /path/to/data
步骤 4: 删除日志目录（可选）
删除日志文件:
$ rm -rf /path/to/fess/logs
$ rm -rf /path/to/opensearch/logs
RPM 版的卸载
步骤 1: 卸载 Fess
卸载 RPM 包:
$ sudo rpm -e fess
步骤 2: 卸载 OpenSearch
$ sudo rpm -e opensearch
步骤 3: 禁用和删除服务
chkconfig 的情况:
$ sudo /sbin/chkconfig --del fess
$ sudo /sbin/chkconfig --del opensearch
systemd 的情况:
$ sudo systemctl disable fess.service
$ sudo systemctl disable opensearch.service
$ sudo systemctl daemon-reload
步骤 4: 删除数据目录
Warning
执行此操作会完全删除所有索引数据和配置。
$ sudo rm -rf /var/lib/fess
$ sudo rm -rf /var/lib/opensearch
步骤 5: 删除配置文件
$ sudo rm -rf /etc/fess
$ sudo rm -rf /etc/opensearch
步骤 6: 删除日志文件
$ sudo rm -rf /var/log/fess
$ sudo rm -rf /var/log/opensearch
步骤 7: 删除用户和组（可选）
删除系统用户和组:
$ sudo userdel fess
$ sudo groupdel fess
$ sudo userdel opensearch
$ sudo groupdel opensearch
DEB 版的卸载
步骤 1: 卸载 Fess
卸载 DEB 包:
$ sudo dpkg -r fess
包括配置文件完全删除:
$ sudo dpkg -P fess
步骤 2: 卸载 OpenSearch
$ sudo dpkg -r opensearch
或包括配置文件删除:
$ sudo dpkg -P opensearch
步骤 3: 禁用服务
$ sudo systemctl disable fess.service
$ sudo systemctl disable opensearch.service
$ sudo systemctl daemon-reload
步骤 4: 删除数据目录
Warning
执行此操作会完全删除所有索引数据和配置。
$ sudo rm -rf /var/lib/fess
$ sudo rm -rf /var/lib/opensearch
步骤 5: 删除配置文件（如未使用 dpkg -P）
$ sudo rm -rf /etc/fess
$ sudo rm -rf /etc/opensearch
步骤 6: 删除日志文件
$ sudo rm -rf /var/log/fess
$ sudo rm -rf /var/log/opensearch
步骤 7: 删除用户和组（可选）
删除系统用户和组:
$ sudo userdel fess
$ sudo groupdel fess
$ sudo userdel opensearch
$ sudo groupdel opensearch
Docker 版的卸载
步骤 1: 删除容器和网络
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down
步骤 2: 删除卷
Warning
执行此操作会完全删除所有数据。
确认卷列表:
$ docker volume ls
删除 Fess 相关的卷:
$ docker volume rm fess-es-data
$ docker volume rm fess-data
或批量删除所有卷:
$ docker compose -f compose.yaml -f compose-opensearch3.yaml down -v
步骤 3: 删除镜像（可选）
删除 Docker 镜像以释放磁盘空间:
$ docker images | grep fess
$ docker rmi codelibs/fess:15.3.2
$ docker images | grep opensearch
$ docker rmi opensearchproject/opensearch:3.3.2
步骤 4: 删除网络（可选）
删除 Docker Compose 创建的网络:
$ docker network ls
$ docker network rm <network_name>
步骤 5: 删除 Compose 文件
$ rm compose.yaml compose-opensearch3.yaml
确认卸载
确认所有组件已删除。
确认进程
$ ps aux | grep fess
$ ps aux | grep opensearch
如果没有显示任何内容，则进程已停止。
确认端口
$ sudo netstat -tuln | grep 8080
$ sudo netstat -tuln | grep 9200
确认端口未被使用。
确认文件
TAR.GZ/ZIP 版:
$ ls /path/to/fess-15.3.2 # 确认目录不存在
RPM/DEB 版:
$ ls /var/lib/fess # 确认目录不存在
$ ls /etc/fess # 确认目录不存在
Docker 版:
$ docker ps -a | grep fess # 确认容器不存在
$ docker volume ls | grep fess # 确认卷不存在
确认包
RPM 版:
$ rpm -qa | grep fess
$ rpm -qa | grep opensearch
DEB 版:
$ dpkg -l | grep fess
$ dpkg -l | grep opensearch
如果没有显示任何内容，则包已删除。
部分卸载
仅删除 Fess 保留 OpenSearch
如果 OpenSearch 被其他应用程序使用，可以仅删除 Fess。
停止 Fess
删除 Fess 的包或目录
删除 Fess 的数据目录（
/var/lib/fess等）不删除 OpenSearch
仅删除 OpenSearch 保留 Fess
Warning
删除 OpenSearch 会导致 Fess 无法工作。 请更改配置以连接到其他 OpenSearch 集群。
停止 OpenSearch
删除 OpenSearch 的包或目录
删除 OpenSearch 的数据目录（
/var/lib/opensearch等）更新 Fess 的配置以指定其他 OpenSearch 集群
故障排除
无法删除包
症状:
rpm -e 或 dpkg -r 出现错误。
解决方法:
确认服务已停止:
$ sudo systemctl stop fess.service
确认依赖关系:
$ rpm -qa | grep fess $ dpkg -l | grep fess
强制删除（最后手段）:
$ sudo rpm -e --nodeps fess $ sudo dpkg -r --force-all fess
无法删除目录
症状:
rm -rf 无法删除目录。
解决方法:
确认权限:
$ ls -ld /path/to/directory
使用 sudo 删除:
$ sudo rm -rf /path/to/directory
确认进程是否在使用文件:
$ sudo lsof | grep /path/to/directory
重新安装的准备
如果卸载后要重新安装，请确认以下内容：
所有进程已停止
所有文件和目录已删除
端口 8080 和 9200 未被使用
没有残留以前的配置文件
关于重新安装步骤，请参阅 选择安装方法。
下一步
卸载完成后：