FESS（全文検索）のインストールで上手くいかないとき

対象とする読者
インストールの準備
インストール方法
トラブル解決

対象とする読者

こんな方へ

linuxへインストール
docker(docker compose)でインストール

インストールの準備

下記を実施
$ sudo dnf update
$ sudo dnf config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo
$ sudo dnf install -y docker-ce docker-ce-cli containerd.io
$ docker -v
$ sudo systemctl start docker
$ sudo systemctl enable docker
$ sudo dnf install git

参考

CentOS8にDockerをインストールする方法 - Qiita

CentOS8にDockerをインストールしたので、その手順を紹介します。1. 環境OS：CentOS Linux release 8.5.2111# cat …

インストール方法

下記公式のDockerでのインストール方法
具体的には、下記コマンド

$ git clone https://github.com/codelibs/docker-fess.git
$ cd docker-fess/compose/
$ docker compose -f compose.yaml -f compose-opensearch2.yaml up -d

インストール

Fess は以下の環境で利用することができます。 OS: JavaまたはDockerが実行可能なOS環境 (WindowsやLinuxなど) Java 17 (TAR.GZ/ZIP/RPM/DEB版をインストールする場合) Docker (...

トラブル解決

確認方法1

opensearchで作る前にelasticsearchでの不要なvloumeが残っている
$ docker logs es01
[2023-04-27T13:28:58,889][ERROR][o.o.b.OpenSearchUncaughtExceptionHandler] [es01] uncaught exception in thread [main]
org.opensearch.bootstrap.StartupException: OpenSearchException[failed to bind service]; nested: FileSystemException[/usr/share/opensearch/data/nodes/0: Not a directory];

対処方法1

$ docker compose --env-file .env.elasticsearch -f compose.yaml -f compose-elasticsearch8.yaml down
$ docker volume rm compose_esdata01 compose_esdictionary01 compose_esdata02 compose_esdictionary02

確認方法2

linux kernelパラメータが低い。
ERROR: [1] bootstrap checks failed [1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144] ERROR: OpenSearch did not exit normally - check the logs at /usr/share/opensearch/logs/fess-es.log

対処方法2

linux kernelパラメータを変更する。
/etc/sysctl.d/配下に新規にファイルを作成する。（具合的には↓を参照）
$ ls /etc/sysctl.d/ 99-sysctl.conf vm_max_map_count.conf $ cat /etc/sysctl.d/vm_max_map_count.conf vm.max_map_count=262144