インストール要件
Fess は以下の環境で利用することができます。
OS: Windows や Unix など Java が実行できる OS 環境
Java: Java 7 以上
Fess を利用したい環境に Java がインストールされていない場合は、http://java.sun.com/ より Java 7 以上の JDK を取得してインストールしてください。
ダウンロード
http://sourceforge.jp/projects/fess/releases/ から最新の Fess パッケージをダウンロードします。
インストール
ダウンロードした fess-server-x.y.zip を展開します。Unix 環境にインストールした場合、bin 以下にあるスクリプトに実行権を付加します。
$ unzip fess-server-x.y.zip
$ cd fess-server-x.y
$ chmod +x bin/*.sh # (Unix環境のみ)
管理者パスワードの変更
管理者アカウントはアプリケーションサーバーにより管理されています。標準の Fess サーバーは Tomcat を利用しているので、Tomcat のユーザー変更方法と同様になります。変更する場合は、conf/tomcat-user.xml の admin アカウントのパスワードを修正してください。
<user username="admin" password="admin" roles="fess"/>
tomcat-user.xml のファイルによる管理方法以外を利用する場合は、Tomcat のドキュメントや JAAS 認証の仕様を参照してください。
Solr サーバーのパスワード変更
Fess サーバーには Solr が組み込まれていますが、アクセスするためにはパスワードが必要になります。実運用などにおいては、デフォルトのパスワードを変更してください。
パスワードの変更方法は、まず、conf/tomcat-user.xml の solradmin のパスワード属性を変更します。
<user username="solradmin" password="solradmin" roles="solr"/>
次に webapps/fess/WEB-INF/classes/solrlib.dicon、fess_suggest.dicon および solr/core1/conf/solrconfig.xml の3ファイルを変更します。以下のパスワードの箇所へ tomcat-user.xml で指定したものを記述します。
solrlib.dicon の対象箇所を以下のように修正します。
<component class="org.apache.commons.httpclient.UsernamePasswordCredentials">
<arg>"solradmin"</arg> <!-- ユーザー名 -->
<arg>"solradmin"</arg> <!-- パスワード -->
</component>
fess_suggest.dicon は以下の箇所です。
<component name="suggestCredentials" class="org.apache.http.auth.UsernamePasswordCredentials">
<arg>"solradmin"</arg> <!-- ユーザー名 -->
<arg>"solradmin"</arg> <!-- パスワード -->
</component>
solrconfig.xml は以下の箇所です。
<!-- SuggestTranslogUpdateHandler settings -->
<suggest>
<solrServer class="org.codelibs.solr.lib.server.SolrLibHttpSolrServer">
<arg>http://localhost:8080/solr/core1-suggest</arg>
<credentials>
<username>solradmin</username> <!-- ユーザー名 -->
<password>solradmin</password> <!-- パスワード -->
</credentials>
Tomcat コンソールのパスワード変更
Fess サーバーから Tomcat に配置した Solr のコンテキストを管理することができますが、管理するためにはパスワードが必要になります。実運用などにおいては、デフォルトのパスワードを変更してください。
パスワードの変更方法は、conf/tomcat-user.xml の manager のパスワード属性を変更します。
<user username="manager" password="manager" roles="manager-script"/>
次に webapps/fess/WEB-INF/classes/app.dicon の以下のパスワードの箇所を tomcat-user.xml で指定したものを記述します。
<component class="jp.sf.fess.helper.impl.TomcatManagementHelperImpl$SolrInstance">
<property name="name">"solrServer1"</property>
<property name="managerUrl">"http://localhost:8080/manager/text/"</property>
<property name="contextPath">"/solr"</property>
<property name="username">"manager"</property>
<property name="password">"manager"</property> <!-- パスワード -->
</component>
暗号化キーの変更
ログイン時の戻りパスの設定などで暗号化/復号化が利用されています。実運用などにおいてはデフォルトのパスワードを変更してください。
変更方法は、webapps/fess/WEB-INF/classes/app.dicon で key の値を変更します。16 文字の半角英数字を設定してください。
<!-- CHANGE THE FOLLOWING KEY -->
<property name="key">"1234567890123456"</property>