インストール取扱説明書

(1)

Kabayaki for Linux

インストール手順説明書

(2)

(3)

Kabayaki 更新履歴

最終更新日

: 2003-09-01

(4)

(5)

2003-8-04: Kabayaki Version 1.2.0 released. コンテンツ設定で特定のパターンのURL を登録すると表示が崩れる不具合の修正記号のみをキーとした検索への対応 WebSpider で特定のパターンの URL を取得する際の不具合を修正 (製品版) 1 _要インデックス再構築 WebSpider のキャッシング時の階層処理の不具合を修正 (製品版) 文書中の半角カナを対象とした検索に対応

2003-6-30: Kabayaki Version 1.1.5 released.

WebSpider の robots.txt 処理の不具合の修正および robots.txt パーサの変更 (製品版) WebSpider の、アドレスに # が含まれている場合の処理を修正 (製品版) WebSpider が mhonarc で作成した HTML のリンクをたどれないことがある不具合を修正 (製品版) 1 _{要インデックス再構築} WebSpider のキャッシング時の階層処理の不具合を修正 (製品版) 自動インデキシング実行時刻をより柔軟に設定できるよう変更 mhonarc の出力したファイルをインデクシングしない不具合を修正ローカルパスの検索対象外パスが動作していない不具合を修正検索キーワードのわかち書き機能を強化

2003-5-16: Kabayaki Version 1.1.4 released. WebSpider のフィルタ設定の強化 (製品版) WebSpider のキャッシングの向上と高速化 (製品版) 1 _{要インデックス再構築} 辞書のエクスポート機能の追加 (製品版) 辞書登録を意図的に空にした場合に、インデキシング時に警告を出す不具合を修正 (製品版) コンテンツ未設定インデックスが存在する場合に、検索画面で最終更新日付が表示されないことのある不具合を修正非常に大きな Excel のファイルに対してインデキシングを実行した際に core dump する不具合を修正 (製品版) セキュリティパスワードつきPDF の検索に対応 (製品版) 全角数字の検索に対応 (製品版) Apache が生成するインデックスファイルのスコアを下げるように変更 (製品版) 特定の組み合せの設定時に WebSpider がリンクをたどれないことがある不具合を 1 _{チューニング画面の再構築をチェックした後、手動実行ボタンを押し、インデックスの再構築を行う必要があります} 5

(6)

修正 (製品版) ライセンスに問題のある場合場合、より詳細な情報を出力するよう変更全てのインデックスを検索するパラメータ ALL を追加検索時のエラーメッセージを検索結果の上部に表示するように変更 WebSpider が HTTP プロキシを経由できる機能を追加 (製品版) WebSpider の検索除外パスを設定機能を追加 (製品版) '*'を検索した場合に、画面がくずれる不具合を修正マッチした文書数が非常に多い場合の検索速度を向上 2003-2-28: Kabayaki Version 1.1.3 released.

RedHat8.0 に対応 RTF に対応(製品版) 2 _{要インデックス再構築} 日本語を含むファイル名に対応半角数字の検索に対応 3 _{要インデックス再作成} WebSpider の検索除外パス設定機能を実装(製品版) WebSpider が特定の条件下でリンクを辿らない不具合を修正(製品版) mail/news ファイルを検索できなかった不具合を修正

META タグの name=keywords と name=description の検索に対応 ※2 要インデックス再作成 HTML の TITLE タグ等、一部のタグ内が全文検索出来ない不具合を修正 ※1 要インデックス再構築 Word/Excel 等の文書が検索検索結果一覧に表示された場合、タイトル部分に文書プロパティのサブタイトルが表示される不具合を修正(製品版) ※1 要インデックス再構築 *を使った部分一致検索で、検索結果画面の表示が崩れる不具合を修正 2002-12-27: Kabayaki Version 1.1.2 released.

WebSpider 機能を追加(製品版)

「Kabayaki について」の画面が文字化けする場合がある不具合を修正チューニング画面の表示を修正

「テキストの上限値」から「テキストサイズ」の上限値に変更 HTTP サーバのログに、テンプレートの警告が出る不具合を修正

表示するSubject の最大サイズを 42byte から 50byte に変更

2byte コードの途中で Subject と URI が切り捨てられる不具合を修正インデックスに関連するデータのファイルサイズを大幅に縮小検索結果一覧のタイトル項目がファイル名の場合、日本語が正しく表示されなかっ 2 チューニング画面の再構築をチェックした後、手動実行ボタンを押し、インデックスの再構築を行う必要があります 3 インデックスの追加で再度インデックスを作成し、コンテンツ設定等をやり直す必要があります 6

(7)

た点を修正

一太郎Ver8 ファイルで、テキスト抽出できない不具合(製品版)

Excel ファイルでマクロ指定がされていた場合に core dump する不具合を修正(製品版)

Netscape でキーワードがハイライト表示されなかった点を修正 4 _{要テンプレート再設}

定

etc/apache.conf を httpd.conf で Include するように修正

chasen-config を使って chasen の設定をするように修正（ソースインストール）インデクシングの自動実行をした際に、Perl の警告が出る点を修正 Namazu ライクなテンプレートを用意検索テンプレートの追加機能を追加チューニングとログ一覧のヘルプを修正ファイル先頭のPerl のパスがハードコーディングされていた点を修正（ソースインストール）

フィルタ設定画面で表示する拡張子の項目を追加インデックスの内部名、表示名の文字数を制限するように変更クリアボタンを消去ヘルプを作成インデックスの削除の前に、確認画面を表示するように変更インデックスの再構築機能を追加ディレクトリ構成の変更とそれに伴う修正 HTML を修正してブラウザの負荷を大幅に軽減 2002-09-20: Kabayaki Version 1.0.1 released. クロスサイトスクリプティング脆弱性の問題を修正 2002-08-12: Kabayaki Version 1.0.1 released.

自動インデクシングで、word や excel 等の文書フィルタが正常に動作しない不具合を修正スコアバーの塗りつぶされた部分の幅が0 だった場合に表示が崩れる不具合を修正インデックス削除ボタンの二度押しの不具合を修正フィルタ設定の「検索対象外パス追加」部分の注意文言を修正コンテンツ一覧の「削除フラグ」の幅を縮小コンテンツ一覧に「削除フラグ」の文言を追加 4 サーバ環境情報ページを開き、保存ボタンを押す必要があります 7

(8)

Netscape で管理画面を閲覧した場合、表示がくずれる場合があった不具合を修正チューニング画面の表示を修正

「テキスト上限値」を「単語長の上限値」に変更

検索トップページ(enterprise)の検索方法ボタンのリンクミスを修正 2002-06-24: Kabayaki Version 1.0.0 released.

(9)

はじめに 11

動作環境... 13

インストール (Red Hat Linux) 15 Kabayaki の入手... 17 Kabayaki の動作に必要な,他のソフトウェアのインストール ... 17 Kabayaki のインストール... 18 Kabayaki を新規にインストールする場合 ...18 オプションパック Sansyo のインストール ... 19 Sansyo を新規にインストールする場合...19 ファイルの所有者の変更 ... 19 httpd.conf の修正 ... 20 動作確認... 21 インストール (Debian GNU/Linux) 23 Kabayaki の入手 ... 25 オプションパック sansyo のインストール... 25 ファイルの所有者の変更 ... 25 httpd.conf の修正 ... 26

動作確認

... 28

アンインストール (Ret Hat Linux) 31 sansyo がインストールされている場合... 33 Kabayaki だけがインストールされている場合 ... 33 アンインストール (Debian GNU/Linux) 35 付録 A 38 その他の諸設定 38 アクセスコントールについて ... 40 htaccess の作成 ...40 AuthUserFile の作成 ...40 9

(10)

(11)

はじめに

動作環境

(12)

(13)

動作環境

Kabayaki をインストールするにあたり，Kabayaki を動作させるサーバ側の動作環境と， Kabayaki で検索した結果を表示させるクライアント側の動作環境は以下のとおりです．

サーバ側 OS:

Red Hat Linux 7.2 / 7.3 / 8.0 Debian GNU/Linux 3.0(woody) WWW server: Apache 1.3.x Apache 2.0.x クライアント側 WWW ブラウザ Netscape Navigator 4.7 Netscape Navigator 7

Microsoft Internet Explorer 5.5 Microsoft Internet Explorer 6

(14)

(15)

インストール

(Red Hat Linux)

Kabayaki と

その他のパッケージの導入

(16)

(17)

Kabayaki の入手

Kabayaki 一式は以下の URL からダウンロードしていただけます． http://www.kabayaki.jp/portal/dw/ Kabayaki 関連のパッケージは，作業ディレクトリへ移動して伸長されることをお勧めします．

Kabayaki の動作に必要な,他のソフトウェアのインストー

ル

Kabayaki を動作させるためには，以下のパッケージが必要です．これらのパッケージのインストールは，Kabayaki をインストールする前に済ませておく必要があります． expat 1.95.1 以上 perl-CGI 5 _{OS に依ります} perl-File-MMagic 1.12 以上 perl-Jcode 0.80 以上 perl-XML-Parser 2.30 以上 perl-XML-Writer 0.4 以上 perl-CGI-FastTemplate 1.09 以上 perl-NKF 1.71 以上 chasen 2.2.9 以上 ipadic 2.5.1 以上 kakasi 2.3.0 以上 perl-Text-Kakasi 1.0.0 以上 namazu 2.0.10 以降の作業は,スーパーユーザの権限で行ってください. まず,各パッケージがインストールされているかどうか調べます． # rpm –qa | grep パッケージ名 インストールされている場合は，各パッケージ名とバージョンが表示されます． 5 _{RedHat 7.2J には必要ありません} 17

(18)

まだインストールされていないパッケージがあれば，バージョンと対応する OS に注意してインストールを済ませておきます．パッケージのバージョンが間違っていたり，異なるOS 用の rpm をインストールしてしまうとKabayaki が正しく動作しないので注意してください． # rpm -ivh パッケージファイル名 インストールされているパッケージのバージョンが必須のものでない場合は，アップデートします． # rpm -Uvh パッケージファイル名

Kabayaki のインストール

Kabayaki のインストールには,インストールするものによって手順が異なります.Kabayaki のインストールも,スーパーユーザの権限で行ってください．

Kabayaki を新規にインストールする場合

# rpm -ivh kabayaki-xxx.i386.rpm 以前のバージョンからKabayaki をアップデートする場合 # rpm -Uvh kabayaki-xxx.i386.rpm 18

(19)

オプションパック Sansyo のインストール

オプションパック Sansyo は高性能のフィルタや追加機能を含めた Kabayaki の追加パッケージです．Sansyo をインストールしない場合はこの項目をスキップしてください． Sansyo のインストールも,スーパーユーザの権限で行ってください．

Sansyo を新規にインストールする場合

# rpm -ivh sansyo-xxx.i386.rpm

Sansyo をアップデートする場合

# rpm -Uvh sansyo-xxx.i386.rpm 以上で,Kabayaki とその他のソフトウエアのインストールは完了しました.続いて,Kabayaki を動作させるための設定について解説します．

ファイルの所有者の変更

HTTP サービスを，ユーザー apache，グループ apache 以外の権限で動作させている場合は, 以下の設定を行ってください．そうでない場合は,この設定を行なう必要はありません.以降の作業はスーパーユーザの権限で行ってください. ここでは例として，ユーザ kabayaki，グループ search とします．ユーザとグループを変更するには Kabayaki 付属の kabachown コマンドを用います． # /usr/sbin/kabachown kabayaki search

kabachown コマンドを使わず手動で変更する場合は以下のようにします．

# chown -R kabayaki /usr/share/kabayaki # chgrp -R search /usr/share/kabayaki # chown -R kabayaki /usr/libexec/kabayaki # chgrp -R search /usr/libexec/kabayaki # chown -R kabayaki /var/kabayaki # chgrp -R search /var/kabayaki

(20)

httpd.conf の修正

/var/kabayaki/etc/apache.conf を，Apache の設定ファイルである 6_{httpd.conf の適当な場}

所にインクルードします． Apache をインストールした直後であれば，httpd.conf の末尾へ追加すればよいでしょう． httpd.conf に，以下の一行を追加します． Include “/var/kabayaki/etc/apache.conf” httpd.conf の編集は,スーパーユーザーの権限で行います．以上の設定が完了したら，Apache を再起動してください． Apache HTTP Server 2.x と組み合わせてお使いいただく場合，以下の変更も必要になります．この変更を行ないませんと，Kabayaki 管理画面を含むすべての日本語が正しく表示されず，いわゆる，文字化けを起してしまいます．これは，Kabayaki の問題ではなく，Apache HTTP Server 2.x が，標準で日本語を正しく表示するよう設定されていないためです．

Apache HTTP Server 2.x の httpd.conf にて， AddDefaultCharset ディレクティブ (directive) の部分を，削除するか以下のように変更して無効にしてください．変更前: AddDefaultCharset ISO-8859-1 変更後 #AddDefaultCharset ISO-8859-1

6 _{rpm を使って Apache をインストールした場合， httpd.conf は /etc/httpd/conf/httpd.conf にあります．}

ソースからApache をインストールした場合，httpd.conf はデフォルトで /usr/local/apache/conf/httpd.conf にあります．

(21)

動作確認

ウェブブラウザで Kabayaki 管理画面へアクセスして，動作確認をします．Kabayaki 管理画面は，

http://<インストールを行ったホスト名>/kabayaki/cgi-bin/admin/rc.cgi

というURL になります．例えばホスト名が kabayaki.exsample.com の場合，URL は下記のよう

になります． http://kabayaki.exsample.com/kabayaki/cgi-bin/admin/rc.cgi Apache が 80 番以外のポートで動作している場合は，URL の FQDN ホスト名の後に ":<ポート番号>" という記述を追加してください．例えば，ホスト名が kabayaki.exsample.com, ポート番号が8080 の場合の URL は下記のようになります． http://kabayaki.exsample.com:8080/kabayaki/cgi-bin/admin/rc.cgi 21

(22)

ウェブブラウザにて，次のようなページが表示されれば，正常に動作しています．

(23)

インストール

(Debian GNU/Linux)

Kabayaki と

その他のパッケージの導入

(24)

(25)

Kabayaki の入手

Debian GNU/Linux で Kabayaki をインストールするには，/etc/apt/sources.list に以下の記

述を追加します．

deb http://www.kabayaki.jp/debian kabayaki/

deb-src http://www.kabayaki.jp/debian kabayaki-src/

次に，以下のコマンドを発行し，パッケージ情報を更新します． # apt-get update

最後に，以下のコマンドで Kabayaki をインストールします． # apt-get install kabayaki

Kabayaki の依存パッケージは apt が自動的に解決してくれますので，依存パッケージをひとつひとつ手動で導入する必要はありません．

オプションパック sansyo のインストール

オプションパックsansyo をインストールするには，以下のコマンドを発行します．

# apt-get install sansyo

ファイルの所有者の変更

HTTP サービスを，ユーザー www-data，グループ www-data 以外の権限で動作させている場合は,以下の設定を行ってください．そうでない場合は,この設定を行なう必要はありません.以降の作業はスーパーユーザの権限で行ってください. ここでは例として，ユーザ kabayaki，グループ search とします．ユーザとグループを変更するには Kabayaki 付属の kabachown コマンドを用います． # /usr/sbin/kabachown kabayaki search

(26)

httpd.conf の修正

httpd.conf の編集は,スーパーユーザーの権限で行います．

/var/lib/kabayaki/etc/apache.conf を，Apache の設定ファイルである 7_{httpd.conf の適当な}

場所にインクルードします． Apache をインストールした直後であれば，httpd.conf の末尾へ追加すればよいでしょう．

httpd.conf に，以下の一行を追加します． Include “/var/lib/kabayaki/etc/apache.conf”

一般にdeb パッケージで配布されている apache の場合は，mod_env モジュールがコメントアウト

されているので，これを有効にします．

#LoadModule env_module /usr/lib/apache/1.3/mod_env.so とコメントアウトで記述された行がありますので，先頭の#を除去し有効にします．

変更前:

#LoadModule env_module /usr/lib/apache/1.3/mod_env.so 変更後:

LoadModule env_module /usr/lib/apache/1.3/mod_env.so

Apache HTTP Server 2.x と組み合わせてお使いいただく場合，以下の変更も必要になります．この変更を行ないませんと，Kabayaki 管理画面を含むすべての日本語が正しく表示されず，いわゆる，文字化けを起してしまいます．これは，Kabayaki の問題ではなく，Apache HTTP Server 2.x が，標準で日本語を正しく表示するよう設定されていないためです．

7 _{deb パッケージを使って Apache をインストールした場合， httpd.conf は /etc/apache/conf/httpd.conf にあります．}

ソースからApache をインストールした場合，httpd.conf はデフォルトで /usr/local/apache/conf/httpd.conf にあります．

(27)

Apache HTTP Server 2.x の httpd.conf にて， AddDefaultCharset ディレクティブ (directive) の部分を，削除するか以下のように変更して無効にしてください．変更前: AddDefaultCharset ISO-8859-1 変更後 #AddDefaultCharset ISO-8859-1 以上の設定が完了したら，Apache を再起動してください． 27

(28)

動作確認

ウェブブラウザで Kabayaki 管理画面へアクセスして，動作確認をします．Kabayaki 管理画面は，

http://<インストールを行ったホスト名>/kabayaki/cgi-bin/admin/rc.cgi

というURL になります．例えばホスト名が kabayaki.exsample.com の場合，URL は下記のよう

になります． http://kabayaki.exsample.com/kabayaki/cgi-bin/admin/rc.cgi Apache が 80 番以外のポートで動作している場合は，URL の FQDN ホスト名の後に ":<ポート番号>" という記述を追加してください．例えば，ホスト名が kabayaki.exsample.com, ポート番号が8080 の場合の URL は下記のようになります． http://kabayaki.exsample.com:8080/kabayaki/cgi-bin/admin/rc.cgi 28

(29)

ウェブブラウザにて，次のようなページが表示されれば，正常に動作しています．

(30)

(31)

アンインストール

(Ret Hat Linux)

Kabayaki と関連パッケージの削除

(32)

(33)

サーバーから Kabayaki をアンインストールするには,インストールされているものによって手順が異なります.Kabayaki のアンインストールも,スーパーユーザの権限で行ってください．

sansyo がインストールされている場合

まず，sansyo をアンインストールします． # rpm -ev sansyo

Kabayaki だけがインストールされている場合

次に Kabayaki をアンインストールします．Kabayaki だけをインストールしている場合は,手順はここからとなります． # rpm -ev kabayaki 上記のコマンドを実行しても，/usr/libexec/kabayaki, /var/kabayaki 以下には削除されないファイルがありますので，これらを手動で削除します．また，httpd の実行ユーザの crontab が設定されていますので，これも手動で削除します．さらに,必要であれば，Kabayaki が依存しているソフトウェアもアンインストールします．ただし， Kabayaki 以外のパッケージが依存していることもありますので，アンインストールしないことをお勧めします．アンインストールする場合は，依存関係に注意してアンインストールしてください． # rpm -ev <パッケージ名> 33

(34)

(35)

アンインストール

(Debian GNU/Linux)

Kabayaki と関連パッケージの削除

(36)

(37)

Kabayaki および sansyo をアンインストールは，以下のように行います．

Sansyo パッケージのアンインストール # apt-get remove sansyo

Kabayaki のアンインストール # apt-get remove kabayaki

上記のコマンドを実行しても，/usr/lib/kabayaki, /var/lib/kabayaki 以下には削除されないファイルがありますので，これらを手動で削除します．また，httpd の実行ユーザの crontab が設定されていますので，これも手動で削除します．さらに,必要であれば，Kabayaki が依存しているソフトウェアもアンインストールします．ただし， Kabayaki 以外のパッケージが依存していることもありますので，アンインストールしないことをお勧めします．アンインストールする場合は，依存関係に注意してアンインストールしてください． # apt-get remove <パッケージ名> 37

(38)

付録 A

その他の諸設定

安全に運用するために

(39)

(40)

アクセスコントールについて

Kabayaki をインターネットへ公開する場合等，Kabayaki へのアクセスの権限を制限したいことがあるでしょう.アクセスを制限したい機能に対応するディレクトリを，Apache の制御ファイルである .htaccess を利用して制御します． Kabayaki では提供している機能とディレクトリとの対応は次の通りです．管理機能 /usr/libexec/kabayaki/admin 管理機能のヘルプ` /var/kabayaki/public_html/admin/help 検索機能 /usr/libexec/kabayaki/search 検索トップページ /var/kabayaki/public_html/search 以下は，管理機能にパスワード認証されたユーザのみアクセスできるようにする例です．

htaccess の作成

まず，アクセス制限したいディレクトリ/usr/libexec/kabayaki/admin に，.htaccess というファイルを作成します．.htaccess の内容は以下の通りです． AuthUserFile /var/kabayaki/etc/htpasswd AuthGroupFile /dev/null AuthType Basic AuthName kabayaki <Limit POST GET PUT> require valid-user

order allow,deny allow from all </limit>

AuthUserFile の作成

AuthUserFile ( /var/kabayaki/etc/htpasswd ) を新規作成し，admin というユーザを追加して，パスワードを設定します．

$ htpasswd -c /var/kabayaki/etc/htpasswd admin New password:

Re-type new password:

Adding password for user admin

(41)

41 ※ htpasswd コマンドがコマンドサーチパスにない場合は絶対パスで指定してください．

以上で，Kabayaki の管理機能画面を表示する際に,にパスワードによるユーザ認証を行なえるようになります．

なお，.htaccess や htpasswd コマンドの詳細については，Apache のドキュメントを参照してください．