Linux へのインストール手順

/usr/sbin/useradd jiro

mkdir /usr/local/jiro
chown jiro /usr/local/jiro

su jiro
cd /usr/local/jiro

保存先を /usr/local/jiro とする。

http://www.crm.co.jp/jirosearch/jirosearch-0.0.*.tar.gz

(* にはバージョン番号に対応する数字が入ります。実際には jirosearch0.0.2.zip のようなファイル名になります。)

/usr/local/jiro/jirosearch0.0.* というディレクトリが作成されるので、 search という名前のシンボリックリンクを作成しておく。

tar xfz jirosearch0.0.*.tar.gz
ln -s jirosearch0.0.* search

既にインストールされている場合は、 それを使うことができる。

• Sun の Jvaa SE Downloads のページ(http://java.sun.com/javase/downloads/index.jspから、JDK 5.0 をダウンロードする
• このとき、Linux Platform - J2SE の Linux self-extracting file を選択する。 現時点(2006-12-4) の最新版は、JDK 5.0 Update 10。(jdk-1_5_0_10-linux-i586.bin)
• ダウンロードした JDK 5.0 を、 /usr/local/jiro の下で展開する。以下のように入力したあと、スペースキーでページを送って内容を読み、最後に「yes」と入力するとインストールされる。

sh jdk-1_5_0_10-linux-i586.bin

ln -s jdk1.5.0_10 jdk1.5

先の手順ではなく既にインストールされている jdk1.5 を使う場合は、 そこを指すようにシンボリックリンクを作成する。

既にインストールされている場合は、次の手順までスキップする。
※使っている ant のバージョンが 1.6.5 の場合は、 1.7.0 にバージョンアップしなくてもそのまま使うことができる。

• http://ant.apache.org/bindownload.cgi からantをダウンロードする。

wget http://people.apache.org/dist/ant/v1.7.0RC1/bin/apache-ant-1.7.0RC1-bin.tar.gz

tar xfz apache-ant-1.7.0RC1-bin.tar.gz

前の手順のディレクトリに ant をインストールしてあれば、 次の手順でシンボリックリンクを生成することができる。

ln -s apache-ant-1.7.ORC1 ant

※ 他のディレクトリに ant をインストールした場合は、シンボリックリンクの先をインストール先のディレクトリに指定する。

※このファイルは、既に /usr/local/jiro/search に含まれている。

JIRO_HOME=/usr/local/jiro
JAVA_HOME=$JIRO_HOME/jdk1.5
ANT_HOME=$JIRO_HOME/ant

CLASSPATH=.
CLASSPATH=$CLASSPATH:$ANT_HOME/lib/ant.jar
PATH=$JAVA_HOME/bin
PATH=$PATH:$ANT_HOME/bin
PATH=$PATH:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin
export JAVA_HOME CLASSPATH PATH

※インストール状況に応じて、内容を適切に修正する必要がある。
端末から source setpath.bash を実行すれば、このファイルを使って、インストール用の環境変数を設定することができる。

ここまでの手順が完了すれば、ant を使って残りの手順の殆どを自動的に実行できる。 ただし、その場合、次のような環境にインストールすることになる。 処理の内容は build.xml に記述されているので、 インストールする環境に応じて修正することもできる。

• tomcat は新たにダウンロードして JiroSearch 専用に起動する。(ダウンロードだけして使わないという選択も可能。)
• Spring Framework をダウンロードすることになる。このファイルはかなり大きく、ダウンロードに時間がかかる。 既にあれば、downloads ディレクトリにコピーしておけば、 ダウンロードしないで済む。(60MB程度)

cd ..
ln -s apache-tomcat-5.5.20 tomcat

cd /usr/local/jiro/tomcat/webapps
ln -s /usr/local/jiro/search/search search

既にインストールされている場合は、それを使うこともできるし、JiroSearch 用に別に tomcat を起動することもできる。既にインストールされている tomact 5.5 を使う場合は、以下の手順をスキップして、次の手順を実行する。

• Tomcat のダウンロードページ( http://tomcat.apache.org/download-55.cgi )を開いて、Quick Navigation の 5.5.** というリンクをクリックする。
• Binary Distributions というページが表示されるので、Core の tar.gz ファイルをダウンロードする。ダウンロード先は/usr/local/jiro/search/downloadsを指定する。
• http://ftp.kddilabs.jp/infosystems/apache/tomcat/tomcat-5/v5.5.20/bin/apache-tomcat-5.5.20.tar.gz
• ダウンロードしたファイルを/usr/local/jiro/search に展開する。

cd /usr/local/jiro
tar xfz search/downloads/apache-tomcat-5.5.20.tar.gz

• これで、/usr/local/jiro/apache-tomcat-5.5.20というディレクトリができていればok。
• tomcat という名前のシンボリックリンクを生成する。
• 前の手順のディレクトリに tomcat をインストールしてあれば、次の手順でシンボリックリンクを生成することができる。

ln -s /usr/local/jiro/apache-tomcat-5.5.* /usr/local/jiro/tomcat

他のディレクトリにインストールした tomcat を使う場合は、 シンボリックリンクの先をインストール先のディレクトリに指定する。

jirosearch.jar に入っているのでダウンロードの必要はないもの

• crmutil.jar

Jakarta Commons - betwixt に含まれるもの

• commons-betwixt-0.7.jar

spring に含まれるもの

• commons-beanutils.jar
• commons-collections-3.2.jar
• commons-digester-1.7.jar
• commons-fileupload-1.1.1.jar
• commons-io-1.2.jar
• commons-lang-2.2.jar
• commons-logging-1.0.4.jar
• log4j-1.2.13.jar
• spring-aspects.jar
• spring-mock.jar
• spring.jar

lucene に含まれるもの

• lucene-analyzers-2.0.0.jar
• lucene-core-2.0.0.jar
• lucene-highlighter-2.0.0.jar

MyFacesに含まれるもの

• myfaces-api-1.1.3.jar
• myfaces-impl-1.1.3.jar

Tomahawk に含まれるもの

• tomahawk-1.1.3.jar

• spring をダウンロードする。 http://www.springframework.org/ から最新版 (2.0.1) を getする。
• ダウンロードしたら、展開する。展開先のディレクトリを$SPRING_HOMEとして、以下のコマンドを実行する。

cd $SPRING_HOME/dist
cp *.jar $JIRO_LIB

cd $SPRING_HOME/lib/jakarta-commons
cp commons-beanutils.jar $JIRO_LIB
cp commons-collections.jar $JIRO_LIB
cp commons-digester.jar $JIRO_LIB
cp commons-fileupload.jar $JIRO_LIB
cp comonns-io.jar $JIRO_LIB
cp commons-lang.jar $JIRO_LIB
cp commons-logging.jar $JIRO_LIB

cd $SPRING_HOME/lib/log4j
cp log4j-1.2.14.jar $JIRO_LIB

• commons-betwixt は、次のサイトからダウンロードする。 http://jakarta.apache.org/commons/betwixt/ ダウンロードページは、 http://jakarta.apache.org/site/downloads/downloads_commons-betwixt.cgi
• Binary というリンクの、0.7.tar.gz をダウンロードする
• 展開すると、 commons-betwixt-0.7.jar というファイルがあるので、これを$JIRO_LIB にコピーする

• lucene は、次のサイトからダウンロードする。http://lucene.apache.org/ http://www.apache.org/dyn/closer.cgi/lucene/java/
• We suggest the following mirror site for your download:というリンクがあるので、クリックするとダウンロードできるデータの一覧が表示される。この中から、 lucene-2.0.0.tag.gz を選択する。
• ダウンロードして展開すると、lucene-2.0.0 というディレクトリができる。これを $LUCENE_HOME とすると、

cp $LUCENE_HOME/lucene-core.2.0.0.jar $JIRO_LIB
cp $LUCENE_HOME/contrib/analyzers/*.jar $JIRO_LIB
cp $LUCENE_HOME/contrib/highlighter/*.jar $JIRO_LIB

• http://myfaces.apache.org/download.htmlから、MyFaces Core 1.1.4 Distributionの、myfaces-core-1.1.4-bin.tar.gz をダウンロードする。
• http://www.apache.org/dyn/closer.cgi/myfaces/binaries/myfaces-core-1.1.4-bin.tar.gz
• ダウンロードしたファイルを展開すると、myfaces-core-1.1.4 というディレクトリができる。これを $MYFACES_HOMEとする。

cp $MYFACES_HOME/lib/myfaces-*.jar $JIRO_LIB

• 同様に、MyFaces Tomahawk 1.1.3 Binary Distributionの、tomahawk-1.1.3-bin.tar.gzをダウンロードする。
• http://www.apache.org/dyn/closer.cgi/myfaces/binaries/tomahawk-1.1.3-bin.tar.gz
• ダウンロードしたファイルを展開すると、tomahakw-1.1.3 というディレクトリができる。これを $TOMAHAWK_HOMEとする。
• jar ファイルを $JIRO_LIB ディレクトリにコピーする。

cp $TOMAHAWK_HOME/lib/tomahawk-*.jar $JIRO_LIB

• ※この作業には root の属性が必要になる場合がある。
• tomcat がインストールされているディレクトリを$TOMCAT_HOME とする。(例えば /usr/local/jiro/search/tomcat)

cd $TOMCAT_HOME/webapps
ln -s /usr/local/jiro/search search

user=jiro の状態で、 次のコマンドを実行する。

cd /usr/local/jiro/search
source setpath.bash
ant filecrawl

成功すれば、 SUCCESS という表示が出る。 このとき、 /usr/local/jiro/search に、 fileInfo.xml というファイルが生成される。

続いて、次のコマンドを実行する。

ant createIndex

成功すれば、 SUCCESS という表示が出る。 このとき、 /usr/local/jiro/search に、 index というディレクトリが生成され、 その中にインデックスファイルが生成されている。

cd /usr/local/jiro/tomcat/bin
bash startup.sh

http://localhost:8080/search/faces/start.jsf を表示する。

検索語のテキストボックスに「検索」と指定して、検索ボタンを押す。
1件ヒットしたページが表示さたらok。