Voldemort設定ファイル

Voldemortの設定のメモ。

設定ファイルの場所

Voldemortをインストールした場所の下にconfigというディレクトリーがあり、その下にsingle_node_clusterという単独ノードクラスターの設定ファイルがある。
Voldemortの起動時にこの設定ディレクトリーの場所を指定して起動する。

Voldemortを起動すると、データディレクトリーが自動的に作られる。

環境変数VOLDEMORT_HOMEにこのディレクトリーを指定しておくと、起動時にディレクトリーを指定しない場合はVOLDEMORT_HOMEの設定が使われる。

cluster.xml

<cluster>
	<name>mycluster</name>
	<server>
		<id>0</id>
		<host>localhost</host>
		<http-port>8081</http-port>
		<socket-port>6666</socket-port>
		<partitions>0, 1</partitions>
	</server>
</cluster>

とりあえず、クライアントからの通信を受け付けるポート（6666）が記されているようだ。

stores.xml

stores.xmlは、ストア（RDBのテーブルに相当）の定義を記述する。

<stores>
  <store>
    <name>test</name>
    <persistence>bdb</persistence>
    <routing>client</routing>
    <replication-factor>1</replication-factor>
    <required-reads>1</required-reads>
    <required-writes>1</required-writes>
    <key-serializer>
      <type>string</type>
    </key-serializer>
    <value-serializer>
      <type>string</type>
    </value-serializer>
  </store>
  <view>
    <name>test-view</name>
    <view-of>test</view-of>
    <view-class>
      voldemort.store.views.UpperCaseView
    </view-class>
    <value-serializer>
      <type>string</type>
    </value-serializer>
  </view>
</stores>

single_node_clusterでは、デフォルトで「test」という名前のストアが定義されている。

また、「test-view」という名前のビューが定義されている。[2010-06-05]
test-viewに接続すると、testに保存していた値は大文字に変換されてgetされる。
test-viewへのputは出来ない。（UpperCaseViewクラスがそういう作りになっている。）

新しいストアを定義したい場合は、store要素をコピペしてnameの値を変えればとりあえず作れる。（viewは不要）[/2010-06-05]

VoldemortのDBを再起動すると、新しいストアが反映される。

stores/store要素

store要素でストア（RDBのテーブルに相当）を定義する。[2010-06-05]

persistence要素

store/persistence要素でストアのデータを保存するバックエンドシステムを指定する。[2010-06-05]

バックエンドシステムを使うには、server.propertiesのstorage.configsでそのバックエンドシステムを扱うクラスを指定する必要がある。
併せて、server.properties内にそのシステムを使う為の設定も記述する。

persistenceに指定する値は、storage.configsに指定するStorageConfigurationクラスのgetType()によって取得される値。

stores/view要素

stores.xmlには、store以外にviewという要素が指定できる。[2010-06-05]
これは、RDBのビューに相当する。
ストアに格納されている内容（値）を変換して表示・格納したり、表示専用扱い（書き込みを禁止する）にしたりするのに使う。

view-class要素

view/view-class要素でビューのクラスを指定する。[2010-06-05]
voldemort.store.views.Viewを実装する必要があるが、AbstractViewTransformationを継承するのが良さそう。

package jp.hishidama.sample.voldemort;

import org.apache.log4j.Logger;

import voldemort.store.Store;
import voldemort.store.views.AbstractViewTransformation;

public class UpperCaseWritableView extends AbstractViewTransformation<String, String, String> {

	private static final Logger logger = Logger.getLogger(UpperCaseWritableView.class);

	@Override
	public String storeToView(Store<String, String> store, String k, String s) {
		String v = s.toUpperCase();
		logger.info("storeToView: " + s + " -> " + v);
		return v;
	}

	@Override
	public String viewToStore(Store<String, String> store, String k, String v) {
		String s = v.toLowerCase();
		logger.info("viewToStore: " + v + " -> " + s);
		return s;
	}
}

クライアントからgetを実行するとサーバー側でstoreToView()が呼ばれる。
クライアントからputを実行するとサーバー側でviewToStore()が呼ばれる。
AbstractViewTransformationではUnsupportedViewOperationExceptionの例外が常に発生するようになっているので、読み込み専用のビューにしたい場合は、viewToStore()はオーバーライドしないようにすればいい。

AbstractViewTransformationの型引数は、<K, V, S>。ちと紛らわしいが(苦笑)、
K…キーの型（store/key-serializerに合わせる）
V…ビュー側の値の型（view/value-serializerに合わせる）
S…ストア側の値の型（store/value-serializerに合わせる）

サーバー起動時のクラスパスには、この独自ビュークラスも含まれるようにしないといけない。
また、クライアント側（クライアントシェル）も同様にクラスパスを指定する必要がある ようだ。（何に使ってるんだか分からないけど）

> put "hello" "World"
> get "hello"
version(0:3): "World"

> get "hello"
version(0:3): "WORLD"

> put "hello" "Abc"
> get "hello"
version(0:4): "Abc"

> get "hello"
version(0:4): "abc"

server.properties

server.propertiesには、個別の設定（プロパティー）を記述する。[2010-06-05]

「#」で始まる行はコメント。
長い設定を書きたい場合は、行末に「\」を付けて次の行に続ける。
バイト数を表す場合、単位を示す接尾辞が使える。「k」「kB」「M」「MB」「G」「GB」。当然1024の倍数。
真偽値を表す場合、「true」（大文字小文字は問わない）なら真、それ以外は全て偽。

どういったプロパティーが存在するのかは、VoldemortConfigのソースを見れば分かる。