SumibiServerSetup

このドキュメントについて

このドキュメントはSumibi.orgで提供しているような変換サービスをご自分のサイトにセットアップする方法を解説します。

Sumibi Serverは 0.5.5以上のソースディストリビューションに含まれています。

Sumibi Serverとは？

• Sumibi Serverは、Sumibiの漢字変換サービスを提供するサーバです。
• SOAP 1.1に準拠したAPIで変換サービスを提供します。
• SOAPに対応したあらゆる言語から利用することができます。

ソフトウェア構成

システム構成図

Sumibiシステムは沢山のソフトウェアコンポーネントから構成されています。

Sumibi Serverのセットアップに必要なソフトウェア

下記は Sumibi.orgサイト上で動作が確認されているバージョンです。(Debian sarge上で確認)

※下記のバージョン以外の組合せでも動作するかも知れません

入手方法

Sumibi Serverのダウンロード方法

リリースパッケージを以下のサイトからダウンロードしてください。(0.5.5以上)

セットアップ

MySQLに辞書DBをリストアする

1. sumibiエンジンからアクセスするためのアカウントを作成する

   ※ 読みだし専用アカウントで構いません

2. 辞書DBを作成する

   例)

   echo 'create database sumi_bincho_1 DEFAULT CHARACTER SET utf8;' | mysql -u \
       アドミンユーザー
   

3. 辞書DBをリストアする

   例)

   mysql -u アドミンユーザー  sumi_bincho_1 < 辞書DBイメージ
   

SumibiServerのデプロイ(設置)

以下の手順でSumibiWebAPI(SOAPプロトコル)でアクセス可能なSumibiサーバーを設置可能です。

1. Sumibiのディストリビューションを展開し、make deployします

   例)

   tar zxf sumibi-0.5.5.tar.gz
   cd sumibi-0.5.5
   make deploy
   cd ..
   ls -al
   

2. その結果、次のファイルが生成されます。

   ファイル名	役割
   sumibi	sumibiエンジン本体
   sumibi.cgi	sumibiエンジンの入出力をSOAP 1.1プロトコルに変換するブリッジ
   sumibi-0.5.5/lib	sumibiエンジンが使用するライブラリ

sumibi エンジンの設定ファイル .sumibi を用意する

1. Sumibiのディストリビューションに含まれるdot.sumibi.sampleをdeployしたsumibi本体と同じディレクトリに.sumibiという名前で保存します。
2. .sumibiのDB接続の為のパラメータを正しい値に変更します。

   ;; sumiyaki db
   (define sumibi-sumiyakidb-host       "myhostname")
   (define sumibi-sumiyakidb-name       "sumi_bincho_1")
   (define sumibi-sumiyakidb-user       "username")
   (define sumibi-sumiyakidb-password   "password")
   
   ;; sumibi db
   (define sumibi-sumibidb-host         "myhostname")
   (define sumibi-sumibidb-name         "sumi_bincho_1")
   (define sumibi-sumibidb-user         "username")
   (define sumibi-sumibidb-password     "password")
   
   ;; debug flag
   (set! sumibi-debug #f)