|Fess| は以下の環境で利用することができます。
- OS: Windows や Unix など Java が実行できる OS 環境
- Java: Java 8u20 以上のバージョン
- (RPMまたはDEB) Elasticsearch: 5.2.X
|Fess| を利用したい環境に Java がインストールされていない場合は、Oracle のサイト より JDK をインストールしてください。 本番環境での利用では、組み込みElasticsearchでの稼働は推奨しません。
https://github.com/codelibs/fess/releases から最新の |Fess| パッケージをダウンロードします。
ダウンロードした fess-<version>.zip を展開します。 UNIX 環境では、 以下のコマンドを実行します。
$ unzip fess-<version>.zip $ cd fess-<version>
|Fess| をインストールする前に elasticsearch の RPM パッケージをインストールする必要があります。 https://www.elastic.co/downloads/elasticsearch からダウンロードし、インストールします。
$ sudo rpm -ivh elasticsearch-<version>.rpm
|Fess| にアクセスするために、/etc/elasticsearch/elasticsearch.yml に下記の設定を加えます。
configsync.config_path: /var/lib/elasticsearch/config
次に、|Fess| の RPM パッケージをインストールします。
$ sudo rpm -ivh fess-<version>.rpm
|Fess| には elasticsearch の機能を拡張するためのプラグインがあります。 プラグインを elasticsearch の plugins ディレクトリにインストールします。
$ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-analysis-fess:5.2.0 $ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-analysis-ja:5.2.0 $ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-analysis-synonym:5.2.0 $ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-configsync:5.2.0 $ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-dataformat:5.2.0 $ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-langfield:5.2.0
日本語形態素解析において、標準の Kuromoji 辞書の代わりに Neologd を利用するためには以下のプラグインをインストールします。
$ /usr/share/elasticsearch/bin/elasticsearch-plugin install org.codelibs:elasticsearch-analysis-kuromoji-neologd:5.2.0
これらのプラグインはelasticsearchのバージョンに依存するので注意してください。
サービスとして登録するには次のコマンドを入力します。 chkconfig を使う場合は
$ sudo /sbin/chkconfig --add elasticsearch $ sudo /sbin/chkconfig --add fess
systemd を使う場合は
$ sudo /bin/systemctl daemon-reload $ sudo /bin/systemctl enable elasticsearch.service $ sudo /bin/systemctl enable fess.service
|Fess| では RPM パッケージでは外部のElasticsearchを標準で利用しますが、ZIPパッケージでのインストールにおいてElasticsearchクラスタを構築しておき、そのElasticsearchクラスタへ接続して利用することができます。 Elasticsearchの設定方法についてはRPMでの設定方法を参照してください。
|Fess| でElasticsearchクラスタへ接続するためには、起動オプションで指定します。 Windows環境では fess-<version>\bin\fess.in.batを変更します。 fess.dictionary.pathにはelasticsearch.ymlに設定したconfigsync.config_pathの値を設定してください。
set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.es.http_address=http://localhost:9200 set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.es.transport_addresses=localhost:9300 set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path="c:/<elasticsearch-<version>/data/"
ElasticsearchのRPM/DEBパッケージでは fess-<version>/bin/fess.in.shを変更します。
ES_HTTP_URL=http://localhost:9200 ES_TRANSPORT_URL=localhost:9300 FESS_DICTIONARY_PATH=/var/lib/elasticsearch/config/