起動、停止、初期設定

このページでは、 Fess サーバーの起動、停止、および初回セットアップの手順について説明します。

重要

Fess を起動する前に、必ず OpenSearch を起動してください。 OpenSearch が起動していない場合、 Fess は正しく動作しません。

起動方法

インストール方法により、起動手順が異なります。

TAR.GZ 版の場合

OpenSearch の起動

$ cd /path/to/opensearch-3.7.0
$ ./bin/opensearch

バックグラウンドで起動する場合:

$ ./bin/opensearch -d

Fess の起動

$ cd /path/to/fess-15.7.0
$ ./bin/fess

バックグラウンドで起動する場合:

$ ./bin/fess -d

注釈

起動には数分かかる場合があります。 ログファイル（logs/fess.log）で起動状況を確認できます。

ZIP 版の場合（Windows）

OpenSearch の起動

1. OpenSearch のインストールディレクトリを開きます

2. bin フォルダー内の opensearch.bat をダブルクリックします

または、コマンドプロンプトから:

C:\> cd C:\opensearch-3.7.0
C:\opensearch-3.7.0> bin\opensearch.bat

Fess の起動

1. Fess のインストールディレクトリを開きます

2. bin フォルダー内の fess.bat をダブルクリックします

または、コマンドプロンプトから:

C:\> cd C:\fess-15.7.0
C:\fess-15.7.0> bin\fess.bat

RPM/DEB 版の場合 (chkconfig)

OpenSearch の起動:

$ sudo service opensearch start

Fess の起動:

$ sudo service fess start

起動状態の確認:

$ sudo service fess status

RPM/DEB 版の場合 (systemd)

OpenSearch の起動:

$ sudo systemctl start opensearch.service

Fess の起動:

$ sudo systemctl start fess.service

起動状態の確認:

$ sudo systemctl status fess.service

サービスの自動起動を有効化:

$ sudo systemctl enable opensearch.service
$ sudo systemctl enable fess.service

Docker 版の場合

注釈

compose.yaml および compose-opensearch3.yaml は、Fess 本体には 含まれていません。これらは docker-fess プロジェクト （https://github.com/codelibs/docker-fess）で提供されており、リポジトリを 取得した上で compose ディレクトリ内で以下のコマンドを実行します。

Docker Compose を使用して起動:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml up -d

起動状態の確認:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml ps

ログの確認:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml logs -f fess01

起動の確認

Fess が正常に起動したことを確認します。

ヘルスチェック

ブラウザーまたは curl コマンドで以下の URL にアクセスします:

http://localhost:8080/

正常に起動している場合、Fess の検索画面が表示されます。

コマンドラインでの確認:

$ curl -I http://localhost:8080/

HTTP/1.1 200 OK が返ってくれば、正常に起動しています。

ログの確認

起動ログを確認して、エラーがないことを確認します。

TAR.GZ/ZIP 版:

$ tail -f /path/to/fess-15.7.0/logs/fess.log

RPM/DEB 版:

$ sudo tail -f /var/log/fess/fess.log

または journalctl を使用:

$ sudo journalctl -u fess.service -f

Docker 版:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml logs -f fess01

Tip

正常に起動した場合、コンソールおよびログに以下のような起動完了メッセージが表示されます:

...Booting the Tomcat: port=8080 contextPath=/
...
Boot successful: url -> http://localhost:8080

ブラウザーでのアクセス

以下の URL にアクセスして、Web インターフェースを確認します。

検索画面

URL: http://localhost:8080/

Fess の検索画面が表示されます。初期状態では、クロール設定が行われていないため、検索結果は表示されません。

管理画面

URL: http://localhost:8080/admin

デフォルトの管理者アカウント：

• ユーザー名: admin

• パスワード: admin

警告

セキュリティに関する重要な注意

デフォルトのパスワードは必ず変更してください。 特に本番環境では、初回ログイン後すぐにパスワードを変更することを強く推奨します。

初回セットアップ

管理画面にログインしたら、以下の初期設定を行います。

ステップ 1: 管理者パスワードの変更

1. 管理画面にログイン（http://localhost:8080/admin）

2. 左メニューから「システム」→「ユーザー」をクリック

3. admin ユーザーをクリック

4. 「パスワード」フィールドに新しいパスワードを入力

5. 「パスワード(確認)」フィールドに同じパスワードを再入力

6. 「更新」ボタンをクリック

重要

パスワードは以下の条件を満たすことを推奨します：

• 8文字以上（password.min.length で設定される必須の最小文字数）

• 英大文字、英小文字、数字、記号を組み合わせる

• 推測されにくいもの

デフォルトで必須となるのは最小文字数（8文字）のみで、文字種の組み合わせは 強制されません。文字種の要件は password.require.uppercase などの設定で 有効化できます。

ステップ 2: クロール設定の作成

検索対象のサイトや ファイルシステムをクロールする設定を作成します。

1. 左メニューから「クローラー」→「ウェブ」をクリック

2. 「新規作成」ボタンをクリック

3. 必要な情報を入力：

   • 名前: クロール設定の名前（例：会社のWebサイト）

   • URL: クロール対象の URL（例：https://www.example.com/）。複数指定する場合は 1 行に 1 URL を記述します

   • 最大アクセス数: クロールするドキュメント数の上限（省略可能）

   • 間隔: 各アクセス間の待機時間（ミリ秒。デフォルト：10000）

   注釈

   上記以外の項目（ユーザーエージェント、スレッド数、深さなど）は、 未入力の場合はデフォルト値が使用されます。

4. 「作成」ボタンをクリック

ステップ 3: クロールの実行

1. 左メニューから「システム」→「スケジューラ」をクリック

2. 「Default Crawler」ジョブを開き、「今すぐ開始」ボタンをクリック

3. クロールが完了するまで待ちます（進行状況はダッシュボードで確認可能）

ステップ 4: 検索の確認

1. 検索画面（http://localhost:8080/）にアクセス

2. 検索キーワードを入力

3. 検索結果が表示されることを確認

注釈

クロールには時間がかかる場合があります。 大規模なサイトの場合、数時間から数日かかることもあります。

その他の推奨設定

本番環境で運用する場合、以下の設定も検討してください。

主な環境変数による設定

ポート番号、JVM ヒープサイズ、接続先の OpenSearch などは、環境変数で変更できます。 TAR.GZ 版は bin/fess.in.sh、RPM 版は /etc/sysconfig/fess、DEB 版は /etc/default/fess を編集します。変更後は Fess の再起動が必要です。

環境変数	デフォルト	説明
FESS_PORT	8080	Fess が待ち受けする HTTP ポート番号。
FESS_HEAP_SIZE	（未設定）	JVM ヒープサイズ。最小・最大に同じ値を設定します。未設定時は最小 256m・最大 2g``（ZIP 版（Windows）は最大 ``1g）、RPM/DEB 版では 512m が使用されます。
SEARCH_ENGINE_HTTP_URL	（未設定）	接続先 OpenSearch の URL。未設定の場合は内部既定値 http://localhost:9201 が使用されます。OpenSearch を別ポートや別ホストで稼働させる場合に変更します（Linux へのインストール (詳細手順) の手順では OpenSearch の待ち受けポートに合わせて http://localhost:9200 を設定します）。RPM/DEB 版ではパッケージの環境設定ファイルにより、既定で http://localhost:9200 が設定されます。
FESS_LOG_LEVEL	warn	Fess のログレベル。

注釈

ZIP 版（Windows）の bin\fess.in.bat は、これらの環境変数を参照しません （プロキシ関連を除く）。値がファイル内に直接記述されているため、変更する場合は bin\fess.in.bat を直接編集してください。

メールサーバーの設定

障害通知などをメールで受信するには、SMTP サーバーと通知先メールアドレスを設定します。

1. 設定ファイル app/WEB-INF/classes/fess_env.properties の mail.smtp.server.main.host.and.port に SMTP サーバーのホストとポートを 指定します（デフォルト：localhost:25）。変更後は Fess の再起動が必要です。

2. 管理画面の左メニューから「システム」→「全般」をクリックします。

3. 「通知メール」フィールドに通知先のメールアドレスを入力します。

4. 「更新」ボタンをクリックします。

5. 「テストメールの送信」ボタンで、メールが正しく送信されるか確認できます。

タイムゾーンの設定

Fess のタイムゾーンには、サーバー（OS / JVM）のタイムゾーンが使用されます。 管理画面にタイムゾーンを変更する設定項目はありません。変更する場合は、OS の タイムゾーン設定を変更するか、bin/fess.in.sh``（Windows は ``bin\fess.in.bat）の FESS_JAVA_OPTS に JVM オプション -Duser.timezone=Asia/Tokyo を追加します。

ログレベルの調整

本番環境では、ログレベルを調整してディスク使用量を抑えることができます。

Fess 全体のログレベルは、環境変数 FESS_LOG_LEVEL``（デフォルト：``warn）で 変更できます。個別のロガーを細かく制御する場合は、設定ファイル app/WEB-INF/classes/log4j2.xml を編集します。クロール、サジェスト、サムネイル 生成は別プロセスで動作するため、これらのログレベルは app/WEB-INF/env/{crawler,suggest,thumbnail}/resources/log4j2.xml で個別に 設定します。

詳細は Fess 管理者ガイド を参照してください。

停止方法

TAR.GZ/ZIP 版の場合

Fess の停止

プロセスを kill します:

$ ps aux | grep fess
$ kill <PID>

または、Ctrl+C でコンソールから停止できます（フォアグラウンドで実行している場合）。

OpenSearch の停止:

$ ps aux | grep opensearch
$ kill <PID>

RPM/DEB 版の場合 (chkconfig)

Fess の停止:

$ sudo service fess stop

OpenSearch の停止:

$ sudo service opensearch stop

RPM/DEB 版の場合 (systemd)

Fess の停止:

$ sudo systemctl stop fess.service

OpenSearch の停止:

$ sudo systemctl stop opensearch.service

Docker 版の場合

コンテナの停止:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml stop

コンテナの停止と削除:

$ docker compose -f compose.yaml -f compose-opensearch3.yaml down

警告

down コマンドでボリュームも削除する場合は -v オプションを追加します。 この場合、すべてのデータが削除されるため注意してください。

再起動方法

TAR.GZ/ZIP 版の場合

停止してから起動します。

RPM/DEB 版の場合

chkconfig:

$ sudo service fess restart

systemd:

$ sudo systemctl restart fess.service

Docker 版の場合

$ docker compose -f compose.yaml -f compose-opensearch3.yaml restart

トラブルシューティング

起動しない場合

1. OpenSearch が起動しているか確認

   $ curl http://localhost:9200/
   

   OpenSearch が起動していない場合、まず OpenSearch を起動してください。

2. ポート番号の競合を確認

   $ sudo netstat -tuln | grep 8080
   

   ポート 8080 が既に使用されている場合、ポート番号を変更します。

   • TAR.GZ 版：bin/fess.in.sh の FESS_PORT を変更

   • ZIP 版（Windows）：bin\fess.in.bat の -Dfess.port=8080 を直接編集

   • RPM 版：/etc/sysconfig/fess の FESS_PORT を変更

   • DEB 版：/etc/default/fess の FESS_PORT を変更

3. ログを確認

   エラーメッセージを確認して、問題を特定します。

4. Java のバージョンを確認

   $ java -version
   

   Java 21 以降がインストールされていることを確認してください。

詳細なトラブルシューティングについては、トラブルシューティング を参照してください。

次のステップ

Fess が正常に起動したら、以下のドキュメントを参照して運用を開始してください：

• Fess 管理者ガイド - クロール設定、検索設定、システム設定の詳細

• セキュリティ設定 - 本番環境でのセキュリティ設定

• トラブルシューティング - よくある問題と解決方法

• アップグレード手順 - バージョンアップ手順

• アンインストール手順 - アンインストール手順