設定オプション

• --with-tokyo-tyrant[=DIR] DIR は Tokyo Tyrant のインストール先のプレフィックス
• --with-tokyo-cabinet-dir[=DIR] DIR は Tokyo Cabinet のインストール先のプレフィックス
• --disable-tokyo-tyrant-session Tokyo Tyrant セッションハンドラのサポートを無効にする

この拡張モジュールの有効化

この拡張モジュールを使うには、INI 設定に extension=tokyo_tyrant.so を追加します。

Tokyo Tyrant セッションハンドラの実行

ttserver -port 2000 -ext /path/to/expire.lua -extpc expire 30.0 '/tmp/sessions.tct#idx=ts:dec'

注意: expire.lua は、tokyo_tyrant 拡張モジュールのソースに含まれています。

セッションハンドラの設定

• tokyo_tyrant.session_salt="randomlongstring"
• session.save_handler=tokyo_tyrant
• session.save_path="tcp://hostname1:2000,tcp://hostname2:2000"

注意: tokyo_tyrant.session_salt はすべてのサーバー上でマッチしなければなりません。

動作原理

このセッションハンドラは、次のようなセッション ID を作成します。 8b0e27a823fa4a6cf7246945b82c1d51-a5eadbbed1f2075952900628456bfd6830541629-0-5460

各パートは、左から順に次のような意味となります。

• セッション ID - 生成されたセッション ID
• チェックサム - セッションの salt、セッション ID、ノード ID そして主キーのチェックサム
• ノード ID - セッションが対応付けられるノードの ID
• 主キー - セッションが格納される行の主キー

チェックサムは、ノード ID、主キー、セッション ID そして salt の SHA1 サムとなります。 これを使うことで、セッション ID からノードや主キーへのマッピングが高速に行えるようになります。 わざわざ検索する必要がないからです。セッション ID を再生成すると最初のふたつの部分が変わりますが、 ノードと主キーのマッピングはそのままとなります。

一部のノードがダウンしたときのフェイルオーバー処理は、INI 設定 tokyo_tyrant.allow_failover、 tokyo_tyrant.fail_threshold および tokyo_tyrant.health_check_divisor で制御します。フェイルオーバーが許可されると、 セッションハンドラは正常なノードにセッションをマップして新たに空のセッションを作成します。