Cassandra 初心者メモ - ジン@ ウィキ

工事中

ダウンロード

下記の場所からダウンロードしてください。
http://cassandra.apache.org/

本章では、Cassandra 0.7.2 をベースに記載しています。

とにかく動かしてみる

環境は、Windows 7で動作確認しました。。Unix系OSの場合、適当に読み替えてください。でも、説明の中の記述方法は、Unixのシェルっぽかったりします（＾＾；

1. Java6 を入手して、インストール。手順省略。
2. Cassandraをダウンロードして、適当なフォルダに展開。展開した（インストールした）ディレクトリを、以降、CASSANDRA_HOME と略す。
3. コマンドプロンプトを開く。
4. JAVA_HOMEをJava6をインストールした場所に指定して、設定。(set JAVA_HOME=<Javaインストールした場所>)
5. CASSANDRA_HOME の環境変数を設定。（例：CASSANDRA_HOME=C:\Applications\apache-cassandra）
5. $CASSANDRA_HOME/bin の配下にある、cassandra.bat を実行する。

上手くいけば、こんな感じで起動するはずです。

C:\Applications\apache-cassandra\bin>cassandra
Starting Cassandra Server
 INFO 14:27:54,295 Heap size: 1065025536/1065025536
 INFO 14:27:54,342 JNA not found. Native methods will be disabled.
 INFO 14:27:54,413 Loading settings from file:/C:/Applications/apache-cassandra/conf/cassandra.yaml
 INFO 14:27:54,812 DiskAccessMode 'auto' determined to be mmap, indexAccessMode is mmap
 INFO 14:27:55,270 Creating new commitlog segment /var/lib/cassandra/commitlog\CommitLog-1298352475270.log

※データファイルなどは、デフォルトで、C:\var 配下に作成する模様

カスタマイズしてみる

個人的にカスタマイズした内容のメモです。意図的に手間がかかるような方法でやっているところもあるので、ここに書いてあることをそのまま実行する必要はありません。

設定ファイルについて

cassandra.yaml

Cassandraのメインとなる設定ファイルが

$CASSSANDRA_HOME/conf/cassandra.yaml

となります。
※以前のバージョンまでは、storage-conf.xml だったようです。

オリジナルを取っておきたいので、cassandra-utsugi.yaml のように、別名でファイルを作成するようにしました。

その場合、新たに作成したファイル名を読み込むようにしますが、以下のように起動パラメタに指定することで可能になります。

-Dcassandra.config=＜ファイル名>

$CASSANDRA_HOME/bin/cassandra.bat を 同じように cassandra-utsugi.bat のように別名で作成した後、そのファイルを編集してます。

:okClasspath
REM Include the build\classes directory so it works in development
set CASSANDRA_CLASSPATH=%CLASSPATH%;"%CASSANDRA_HOME%\build\classes"
set CASSANDRA_PARAMS=-Dcassandra -Dcassandra-foreground=yes

REM Customize by jin
set CASSANDRA_PARAMS=%CASSANDRA_PARAMS% -Dcassandra.config=cassandra-utsugi.yaml
REM ------------

goto runDaemon

REM で囲まれた部分に追加してます。

• Dcassandra.config=<値> に記載する内容は、Javaのクラスパスを通している場所であれば、ファイル名で記述できます。逆に、クラスパスが通っていない場所は、file:///..... の形式で記述します。C:\cassandra\conf\cassandra-utsugi.yaml のような記述はできません。

log4jプロパティ

Cassandraは、log4j を使ってロギングしています。conf ディレクトリ配下に、サーバ用として、log4j-server.properties があります。こちらもlog4j-server-utsugi.properties のようにファイルを別名で保存しています。

Cassndraの実行ファイル（cassandra-utsugi.bat）に、

set JAVA_OPTS=^
 ....
 -Dlog4j.configuration=log4j-server.properties

とあるので、log4j-server-utsugi.properties を参照するように変更しました。

データファイルなどの場所変更

デフォルトの C:\var にデータファイルやライブラリファイルを置きたくなかったため、C:\Applications\apache-cassandra\work\test1 の配下に一式カサンドラのファイル群が作成されるように、以下のように変更しました。

設定ファイル(cassandra-utsugi.yaml)

data_file_directories:
    - C:\Applications\apache-cassandra\work\test1/lib/cassandra/data

# commit log
commitlog_directory: C:\Applications\apache-cassandra\work\test1/lib/cassandra/commitlog

# saved caches
saved_caches_directory: C:\Applications\apache-cassandra\work\test1/lib/cassandra/saved_caches

log4jログ

# Edit the next line to point to your logs directory
log4j.appender.R.File=C:\\Applications\\apache-cassandra\\work\\test1/log/cassandra/system.log

ログレベル

log4ログ

デバッグレベルにする場合、以下のように変更しました。

log4j.rootLogger=DEBUG,stdout,R