FreyaSX インストール手順

2004年9月18日 Yutaka Sato
http://www.delegate.org/freyasx/

FreyaSX の半自動インストールの手順を説明します。

必要なもの:

インストール手順: 以上で終りです。 所要時間は (1GHz PPC) iMac や (0.8GHz x86 位の) Linux上で 約5分です。

このスクリプトの終了時に、環境変数 FSXHOME と PATH の設定について案内があり ますので、そのように設定して下さい。同時に案内されるように、"fhttpd" と入力 するとHTTPサーバとしてDeleGateが起動され、http://host:8880 でこの FreyaSX のデータが検索できるようになります [関連記事]。 http://host:8880/test/ に幾つかの利用例があります。 例えば、以下のようにしてメールボックスの索引を作ることができます。

作られた索引は、http://host:8880/fsx/search?index=mail で 検索できます。

*1 上記 "freyasx.tar.gz" にはその時点の最新の版のFreyaSXとDeleGateおよび インストーラが含まれています。
*2 どこでmakeしても構いませんが $HOME を推奨します。
*3 root などの特権ユーザでなく、一般ユーザの権限でインストールすることを推奨します。
*4 Windowsでインストールする場合には、 下記の手動インストールの手順で、 適宜 nmake -f Makefile.VC 等をして下さい。いずれ自動化したいと思います。
（以下の情報は最新ではありません。実際に、最新版で sh INSTALL.shを実行して 表示される内容や、同梱されている INSTALL-ja を御覧下さい）
...
インストールの進行状況は以下のように表示されます。 
% sh INSTALL.sh
 ////////////////////////////////////////////////////////////////////
      FreyaSX installer                            
                               FreyaSX ver. 0.99.10 
                               DeleGate ver. 8.9.6
                               September 18, 2004, Yutaka Sato
 ////////////////////////////////////////////////////////////////////

Detailed log is put into "INSTALL.log"

*** extracting FreyaSX-0.99.10 ...
*** making FreyaSX-0.99.10 ...
*** extracting DeleGate/8.9.6 ...
*** making DeleGate/8.9.6 ...

Installing to here: /tmp/test/freyasx
  /tmp/test/freyasx/bin
  /tmp/test/freyasx/etc
  /tmp/test/freyasx/cgi-bin
  /tmp/test/freyasx/bank

0) You can remove following unnecessary files:
---------------------------------------------------------------------
  rm -r /tmp/test/freyasx/delegate8.9.6
  rm -r /tmp/test/freyasx/freyasx-0.99.10
  rm -r /tmp/test/freyasx/INSTALL.log

1) Complete the installation and setup your environmnet as follows:
---------------------------------------------------------------------
  setenv FSXHOME /tmp/test/freyasx
  set path=($FSXHOME/bin $path)
  rehash

2) Then, you can test it as follows:
---------------------------------------------------------------------
  findex sx
  fsearch sx "freya*"
  any2fdif -r $HOME/Mail | findex mail

3) Also you can start HTTP server for this FreyaSX and test it:
---------------------------------------------------------------------
  fhttpd -P8880
  ... then open URL "http://this-host:8880/test" in your WWW browser

See http://www.delegate.org/freyasx/ for more details
 ////////////////////////////////////////////////////////////////////



FreyaSX の手動でのインストール手順と、簡単な使用例を説明します。 基本的には上記半自動インストールの場合の INSTALL.sh を手動で行うものです。

必要なもの:

手順のあらまし: (所要時間は 1GHz iMac 上で約5分です)

ステップ１. FreyaSXの作成とテスト

説明を簡単にするために、以下、ホームディレクトリ直下で作成して、 そのまま使用します。 実際にはどこで展開してmakeして、make後にいつどこへ移動しても構いません。 (インストールや実際の利用にあたってrootユーザになる必要はありません)

1-0 % cd $HOME

1-1 % FreyaSX のソースをダウンロード
ftp://ftp.delegate.org/pub/freyasx/freyasx-0.99.8.tar.gz

1-2 % gzip -d < freyasx-0.99.8.tar.gz | tar xfv -
これによって freyasx-0.99.8/ の下に、次のファイルが得られます。

1-3 % cd freyasx-0.99.8

1-4 % make
これによって以下の実行形式ファイルが作成されます。

1-5 % sh testsx
作成されたプログラムの動作テストを行います。 (このテストでは、"bin/findex" を使用して、索引を "bank/sx" に作成し、 そしてそれを "bin/fsearch" および "cgi-bin/fsearch.cgi" で検索します。 検索の結果３つのドキュメントがヒットすれば成功です (3 documents found のように表示されます)。 このテスト用スクリプトは、FreyaSX の使い方の簡単な実例でもあります。)

1-6 % export FSXHOME=`pwd` または setenv FSXHOME `pwd`
環境変数 FSXHOME が、この(FreyaSXのルートとなる)ディレクトリを指す ように設定します。

1-7 % ln -s $FSXHOME $HOME/freyasx
ホームディレクトリ下の freyasx を、このFreyaSXのルートディレクトリを 指す(シンボリック)リンクにします。FreyaSXの利用時に、FSXHOME環境変数が このディレクトリを指しているなら、このリンクは無くても構いません。

これによってデフォルトの辞書および索引ファイルの置場にアクセスが可能に なります。FreyaSX の索引作成および検索プログラムは、これらの索引置場や、 辞書(索引作成の場合)が、デフォルトで以下の場所にあることを想定しています。

1-8% ln -s $FSXHOME/cgi-bin $WWW/cgi-bin/fsearch
（ここで $WWW は、WWWサーバで公開されているデータのルートディレクトリを 指しているものとします） これによりWWWサーバが、FreyaSXの検索用CGIスクリプトやHTMLテンプレート、 索引ファイルにアクセスできるようになります。(WWWサーバによっては何かの 追加的設定が必要かと思います。WWWサーバがDeleGateの場合には実際にこれ だけでOKです) これで、以下の URL に、WWW サーバからアクセスできるようになるでしょう。

"http://localhost/cgi-bin/fsearch/testsx.html" -- 検索ページへのリンク例
"http://localhost/cgi-bin/fsearch/fsearch.cgi"

ステップ２. DeleGate を用いて "any2fdif" を作成する

このステップでは、以下のファイルをインストールします。