Index > Quick Start

クイックスタート

• クイックスタート
• インストール
• Rubyのインストール
• Ruby/EventMachineのインストール
• ROMAのインストール
• 一つのホスト上でROMAを制御する
• ルーティングファイルの作成
• ROMAの開始
• ROMAのシャットダウン
• ROMAの設定の変更
• telnetでROMAに接続する

インストール

Rubyのインストール

ROMAはRubyで書かれているため、Rubyが必要です。

前もってRuby 1.9.1 (not 1.8) をインストールする必要があります。以下のwebページを見て、Ruby 1.9.1の最新バージョンをダウンロードしてください。

ftp://core.ring.gr.jp/pub/lang/ruby/1.9/

以下のようにインストールします。

$ wget ftp://core.ring.gr.jp/pub/lang/ruby/1.9/ruby-1.9.1-pXXX.tar.gz
$ tar zxvf ruby-1.9.1-pXXX.tar.gz
$ cd ruby-1.9.1-pXXX
$ ./configure
$ make
$ sudo make install

"v" オプションを使うことで、以下のようにプラットフォームにインストールされているRubyのバージョン番号をチェックすることができます。

$ ruby -v
1.9.1-pXXX

Ruby/EventMachineのインストール

event-driven I/O を提供するRubyのライブラリのRuby/EventMachineをインストールする。ROMAを実行するには、それが必要です。

以下のようにRubyの"gems"コマンドを使って、Ruby/EventMachine を簡単にインストールすることができます。

$ sudo gem install eventmachine 

ROMAのインストール

ROMAのインストールには、二つの選択可能な方法があります。

• ROMA はhttps://github.com/roma/roma/tagsからダウンロードすることができます
  tarballからソースを解凍します。
• 以下のように"gems" コマンドを使うことができます。

$ sudo gem install roma

一つのホスト上でROMAを制御する

以下では、一つのホストで二つのプロセスからなるROMAを実行する方法を示します。

ルーティングファイルの作成

ROMAは開始する前にルーティングファイルを作る必要があります。
ルーティングファイルはそえｒぞれのプロセスのルーティング情報を保存しています。

$ cd ./ruby/server
$ bin/mkroute localhost_11211 localhost_11212 --enabled_repeathost

成功した場合、localhost_11211.route と localhost_11212.route という名前の新しい二つのファイルが現在のディレクトリに作成されます。

• 注意:
  ROMAの輪がいくつかのサーバからできている場合、mkrouteコマンドは一度だけ実行する必要があります。そして、mkrouteコマンドで作成されたルーティングファイルはそれぞれのサーバに配布される必要があります。

• 注意:
  ROMAが一つのホスト上でいくつかのプロセスから成る場合は、 mkroute と romadコマンドの--enabled_repeathostオプションが必要です。

起動コマンドの詳細な情報については、コマンド を参照してください。

ROMAの開始

以下のように、romad.rbプログラムを使って二つのプロセスを実行します:

$ bin/romad localhost -p 11211 -d --enabled_repeathost
$ bin/romad localhost -p 11212 -d --enabled_repeathost

• 注意:
  ROMAが一つのホスト上でいくつかのプロセスから成る場合は、 mkroute と romadコマンドの--enabled_repeathostオプションが必要です。

起動コマンドの詳細な情報については、コマンド を参照してください。

ROMAのシャットダウン

ROMAの全てのプロセスをシャットダウンする必要がある場合は、以下のようにbalse コマンドを実行します。
これは、ROMAによって提供されているシャットダウンコマンドです。

$ telnet localhost 11211 
balse<return>
Are you sure?(yes/no)
yes<return>
{"localhost_11211"=>"BYE", "localhost_11212"=>"BYE"} 

ROMAの設定の変更

ROMA は設定ファイルとして ./ruby/server/lib/roma/config.rbファイルを利用します。
ROMAの設定が変更される時は、設定ファイルを編集します。

更に詳しい情報は 設定 を参照してください。

telnetでROMAに接続する

memcachedのように、telnetを使ってROMAに接続することができます。上で実行したROMAプロセスに接続します。

$ telnet localhost 11211 

memcachedコマンドと同じ方法でROMAとやり取りすることができます。

set foo 0 0 3<return>
bar <return>
STORED

get foo<return>
VALUE foo 0 3
bar
END