Namazu のインストール

注意: このページは、レンタルサーバー SPEEDEX VPS v1 の技術サポートです。
SPEEDEX VPS v1 には FreeBSD サーバーA、FreeBSD サーバーB、FreeBSD サーバーC、Solaris Standard、Solaris Pro の 5 タイプがあります。
2009年6月現在、5 タイプとも新規オーダーはお受けしておりません。
現在提供中のサービスについては SPEEDEX のメニューページを参照ください。
なお、Solaris Standard、Solaris Pro につきましては 2010年5月を持ってサービスを停止する予定です。
SPEEDEX VPS v2 サーバーご利用の場合は v2 サーバーサポートページを参照ください。
SPEEDEX VPS v3 サーバーご利用の場合は v3 サーバーサポートページを参照ください。
SPEEDEX OneDom サーバーご利用の場合は OneDom サーバーサポートページを参照ください。

●必要なソースファイル

以下のファイルを ~/usr/src フォルダにアップロードしてください。

namazu-2.0.5.tar.gz　 (Namazu本体)
http://www.namazu.org/#stable
nkf171.shar (Netaork Kanji Filter 漢字コード変換系)
http://www.jazzdisco.org/bsdi/software/nkf/
kakasi-2.3.3.tar.gz　　（日本語・ローマ字変換系）
http://kakasi.namazu.org/
chasen-sys2.02-ipadic2.1.tar.gz ((茶筌) 日本語形態素解析器）
http://chasen.aist-nara.ac.jp/chasen/distribution.html.ja

注:Kakasi、ChaSenは、どちらか一つがインストールされていることが必要です。これらは、インデックス作成時において日本語を分解･分析する際に、どちらか一方を使用します。2つともインストールし、必要に応じて使い分けることも可能です。

Namazu を動作させるために最低でも以下のソフトウェアが必要です。

    Perl（5.004以降)
    File::MMagic

   Namazu の配布には File::MMagic (1.09) が同梱されています。

日本語の文書を処理する場合には以下のソフトウェアが必要になります。

nkf (1.71を推奨)
KAKASI (2.3.0以降)もしくは ChaSen

Perl 拡張モジュールを利用することもできます。

NKF (1.71を推奨)
Text::Kakasi もしくは Text::ChaSen

これらのソフトウェアは Namazu のインストール前にあらかじめインストールされている必要があります。インストールの手順は各々のソフトウェアに含まれるドキュメントに従ってください。

注:NKFは、nkfに同梱されており、nkfインストール時に自動的にインストールされます。

以上のものをインストールすることによりtxt、html両形式について、インデックスを作成し、検索することが可能になります。各種モジュールを別途インストールすることにより、pdfをはじめさまざまなファイル形式に対応することが可能になります。
詳細についてはNamazuHP
http://www.namazu.org/#stable
を参照してください。

●インストール方法

以下の説明は上記で取得したソースファイルが ~/usr/src に保存されている事を前提としています。
別のディレクトリーに保存した場合は、 ~/usr/src を保存したディレクトリーに読み替えてください。
　Namazu本体をインストールする前に、nkf、KAKASIもしくはChaSenをあらかじめインストールしておく必要があります。

nkfのインストール

	telnetでサーバに接続し、以下のコマンドを実行します。
	% cd usr/src
	(nkf171.sharのあるディレクトリに移動)
	% sh nkf171.shar
	(nkf171.sharが解凍されます。カレントディレクトリにNKFフォルダができます。)
	% cd NKF
	% perl Makefile.PL LIB=/usr/home/****/lib INSTALLMAN3DIR=/usr/home/****/man
	(******には、ご自分のユーザ名（ログインID）を入力してください。)
	% make
	% make install
	NKFディレクトリに、実行ファイルが生成されるので、これをパスの通ったディレクトリ(/usr/local/bin等)にコピーします。
	% cp NKF.* ~/usr/local/bin

KAKASIのインストール

	telnetでサーバに接続し、以下のコマンドを実行します。
	% cd usr/src
	(kakasi-2.3.3.tar.gzのあるディレクトリに移動)
	% tar -xvzf kakasi-2.3.3.tar.gz
	(ファイルを解凍)
	% cd kakasi-2.3.3
	% ./configure --prefix /usr/home/******/usr/local
	(******には、ご自分のユーザ名（ログインID）を入力してください。)
	% make
	% make install

ChaSenのインストール

	telnetでサーバに接続し、以下のコマンドを実行します。
	% cd usr/src
	% tar -xvzf chasen-sys2.02-ipadic2.1.tar.gz
	% cd chasen-2.02
	ChaSenは、Makefileを直接編集して、インストールするディレクトリを指定します。
	chasen-2.02フォルダ中のMakefile　22,23行目
	BINDIR = /usr/local/bin
	LIBDIR = /usr/local/lib/chasen
	を、
	BINDIR = /usr/home/******/usr/local/bin
	LIBDIR = /usr/home/******/usr/local/lib/chasen
	と変更します。
	(******には、ご自分のユーザ名（ログインID）を入力してください。)
	% make
	% make dic
	(システム辞書の作成)
	% make install

Namazuのインストール

	telnetでサーバに接続し、以下のコマンドを実行します。
	% tar -xvzf namazu-2.0.5.tar.gz
	% cd namazu-2.0.5
	mamazuのインストールに先立ち、File-MMagicをインストールします。
	% cd File-MMagic
	% perl Makefile.PL LIB=/usr/home/****/lib INSTALLMAN3DIR=/usr/home/****/man
	(******には、ご自分のユーザ名（ログインID）を入力してください。)
	% make
	% make install
	次に、Namazuをインストールします。
	% cd ..
	(一つ上の階層のディレクトリに移動)
	% ./configure --with-pmdir=/usr/home/****/lib --prefix=/usr/home/****/usr/local
	(******には、ご自分のユーザ名（ログインID）を入力してください。)
	% make
	% make install

●cgi用のセットアップ

Namazuはコマンドラインで実行可能ですが、一般的なウェブブラウザ上で操作するために、telnet上で以下のコマンドを実行します。


 % cp /usr/home/******/usr/local/libexec/namazu.cgi /usr/home/******/usr/local/etc/httpd/cgi-bin

 (******には、ご自分のユーザ名（ログインID）を入力してください。)

namazu.cgiファイルを、CGI用のディレクトリにコピーするということです。コマンドラインでの操作ではなく、ftpクライアントソフトでコピーしても差し支えありません。
設定ファイルのサンプルnamazurc-sampleを、.namazurcという名前で、namazu.cgiをコピーしたディレクトリへコピーします。
設定ファイルは、usr/local/etc/namazuにインストールされています。操作例を以下に示します。


 % cp /usr/home/******/usr/local/etc/namazu/namazurc-sample /usr/home/******/usr/local/etc/httpd/cgi-bin/.namazurc

この設定ファイルのパラメータを操作することにより、日本語表示や検索結果のパスを置き換えることが可能となりますが、次節で詳述します。

●Namazuの設定ファイル(.namazurc)

.namazurcでは、基本インデックスや、HTMLで検索結果や使い方を表示するときに使用するテンプレートファイル(NMZ.resultなど)のディレクトリを指定します。namazu-sampleをコピーした状態では、パラメータはすべてコメントアウトされており、有効ではありません。下の表を参考にし、各パラメータ先頭の#を削除し、設定を有効にしてください。

.namazurcでの主な設定項目

Index 基本インデックス

Template テンプレートファイルのディレクトリ

Replace URI置き換え

Logging 検索キーワードのログをとる(on)/とらない(off)
このログファイルは、MNZ.slogの出力されます。

Lang 使用する言語および文字コード(ロケールコード)

Emphasis Tags 検索結果中のキーワード表示用タグ
スタイルシートを使って、赤字で表示するようになっています。

CGIで利用する際にポイントとなるのは"Index"と"Replace"です。また、検索結果を日本語で表示するには、"Lang"についても設定する必要があります。以下にこれらの設定方法を解説します。

Index、Templateの設定

インデックスファイル(NMZ.*)を置くディレクトリを指定します。これからインデックスを作成する場合でも、あらかじめディレクトリを作成し、指定しておきます。


 設定例 (.namazurc)

 Index         /usr/home/******/usr/local/var/namazu/index/JFdocs

すでにインデックスを作成していて、基本インデックス用のディレクトリ下にディレクトリを作っている、という場合でも、ひとまずここではNMZ.*ファイルのディレクトリを指定してください。

つまり、 /usr/home/******/usr/local/var/namazu/indexという基本ディレクトリを用意して、こちらはディレクトリのみでインデックスを作成しないようにし、その下のJFdocsというディレクトリ中に、対応する文書のインデックスを作成するという構造にするほうが良いということです。ディレクトリの名前、場所は任意に設定できます。このような構造をとるのは、複数のインデックスを扱う際に有効な方法であるためです。なお、複数のインデックスを扱う方法についてはNamazuHP
http://www.namazu.org/doc/manual.html#cgi
を参照してください。

Templateディレクトリは、このindexディレクトリ下に作成するのが良いでしょう。このディレクトリには、NMZ.*ファイルの雛型を入れておきます。
これらは、usr/local/share/namazu/templateにあるので、すべてコピーします。


 設定例 (.namazurc)

 Template       /usr/home/******/usr/local/var/namazu/index/template

Replaceの設定

ここでは、検索の対象となる文章ファイルのディレクトリ(インデックスを作成したときに指定したディレクトリ)のパスを、wwwブラウザからのアクセス用のURIに置き換えます。これは、インデックスを作成した後に設定すべき項目なのですが、あらかじめ解説しておきます。


 設定例(.namazurc)

 Replace  /usr/home/******/usr/local/etc/httpd/htdocs/doc/ http://(ホスト名等).ne.jp/doc

Langの設定

検索結果を日本語で表示するためには、以下の設定を行います。


 設定例(.manazurc)

 Lang ja

ja にしても日本語表示されない場合は、 /usr/local/share/locale または /usr/share/locale の下に設定してある文字列を参考にし、ja_JP.SJIS あるいはja_JP.EUC などと指定します。また、漢字コードを揃えておくことも必要です。ちなみに、mknmz/namazuは内部ではeuc-japanを使用しています。
.namazurcで設定したテンプレートファイルとは、manazu.cgiにて使用される書式のことであり、これらを変更することにより、検索情報入力画面及び、検索結果表示画面をカスタマイズすることができます。その際、日本語のテンプレートファイルのコードをeuc-japanにしておきます。

テンプレートファイルの内容

ファイル 内容

NMZ.result.normal.ja 検索結果の書式

NMZ.result.short.ja 検索結果の書式（短い書式）

NMZ.head.ja 検索結果のヘッダ部分

NMZ.foot.ja 検索結果のフッダ部分

NMZ.body.ja 検索式の説明（キーワードを指定しなかったときに表示される）

NMZ.tips.ja 検索のコツ（一件もヒットしなかったときに表示される）

Namazuの概要 インデックスの作成 NamazuをCGIで使用する
SPEEDEX サポートポリシー