OnDO SIP Server チュートリアル
 --- サードパーティーのデータベースとの接続方法

(C) 2002-2004, Brekeke Software, Inc. All rights reserved.

Date: December 07, 2004

1. はじめに
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
このドキュメントはOnDO SIP Serverに組み込まれているデータベースの代わりに、サードパーティーのデータベースを
使用するためのステップを説明します。お使いのデーターベース管理ツールなどからデータベースにアクセスしてデータを修正したり
追加したりすることができます。ここでは、MySQLを使った例を紹介します。他のデータベースも同じような方法で使用いただけます。

2. OnDO SIP Server で MySQL を使用するためのステップ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1) SQLのコマンドウィンドウを開き、データベースを作成します (例： "ossdb")。

mysql> create database ossdb;

2) 以下のコマンドにより、テーブル "t_registered" とインデックスを作成します。
このテーブルはレジスタされたユーザー・エージェント情報を格納します。

CREATE TABLE t_registered
(
   		skey 		BIGINT,
   		namealias 	VARCHAR(50),
   		nameoriginal 	VARCHAR(50),
   		urlalias     	VARCHAR(100),
  		urloriginal  	VARCHAR(100),
   		acceptpattern 	VARCHAR(100),
   		requester     	VARCHAR(100),
   		expires 	BIGINT,
   		priority     	INT,
   		timeupdate   	BIGINT,
   		expirestime  	BIGINT,
   		mappedport 	VARCHAR(100),
   		awake		INT
);

CREATE INDEX idx_registered_skey ON t_registered( skey );
CREATE INDEX idx_registered_urlalias ON t_registered( urlalias );
CREATE INDEX idx_registered_urloriginal ON t_registered( urloriginal );
CREATE INDEX idx_registered_expirestime ON t_registered( expirestime );


3) 以下のコマンドにより、テーブル "t_userdir" とインデックスを作成します。
このテーブルはユーザーの認証データを格納します。

CREATE TABLE t_userdir
(
		uid 		BIGINT,
		username 	VARCHAR(100),
		longname 	VARCHAR(200),
		password 	VARCHAR(100),
		email 		VARCHAR(100),
		description 	VARCHAR(200),
		gid 		BIGINT,
		timeexpire 	BIGINT,
		timemake 	BIGINT
);

CREATE UNIQUE INDEX idx_userdir_uid ON t_userdir( uid );
CREATE INDEX idx_userdir_username ON t_userdir( username );
CREATE INDEX idx_userdir_timeexpire ON t_userdir( timeexpire );

4) 最新のMySQL用のJDBCドライバー "MySQL Connector/J" を 
http://www.mysql.com/products/connector/j/ から入手し、
ファイル"mysql-connector-java-3.0.XX-ga-bin.jar" を
ディレクトリ oss_インストールディレクトリ\webapps\oss\WEB-INF\lib 
にコピーします。

5)ファイル oss_インストールディレクトリ\WEB-INF\work\sv\sv.properties を開き、以下の行を追加し保存してください。

registered.url=jdbc\:mysql\://localhost/ossdir
               ("ossdir" の部分は、あなたのデータベース名に変更してください)
registered.driver=com.mysql.jdbc.Driver
registered.user = (データベースのユーザー名)
registered.password=(パスワード)

userdir.url=jdbc\:mysql\://localhost/ossdir  
                   ("ossdir" の部分は、あなたのデータベース名に変更してください)
userdir.driver=com.mysql.jdbc.Driver
userdir.user=(データベースのユーザー名)
userdir.password=(パスワード)

6) OnDO SIP Serverのマシンをリスタートしてください。


3. トラブルシューティング
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
もし、OnDO SIP Server アドミンツールで "Can not open a database" のエラーメッセージが出てしまった場合は、
通常の場合、ログファイル oss_インストールディレクトリ\webapps\oss\WEB-INF\work\logs\log.log に
データベース接続に関連する詳細なエラーメッセージを確認できます。