Usage_jpn
CHMPXの利用するコンフィグレーションのサンプルを示します。
- INI形式 test_server.ini
- YAML形式 test_server.yaml
- JSON形式 test_server.json
- JSON文字列 test_json_string.data ファイルの中の "SERVER=" の以降の文字列
- INI形式 test_slave.ini
- YAML形式 test_slave.yaml
- JSON形式 test_slave.json
- JSON文字列 test_json_string.data ファイルの中の "SLAVE=" の以降の文字列
CHMPXをビルドした後で、動作確認をしてみます。
-
ビルド成功
-
CHMPXサーバーノードを起動
$ chmpx -conf test_server.ini
- サーバープログラムを起動
$ chmpxbench -s -conf test_server.ini -l 0 -proccnt 1 -threadcnt 1 -ta -dl 128 -pr -g err -dummykey TEST
- CHMPXスレーブノード起動
$ chmpx -conf test_slave.ini
- クライアントプログラムを起動
$ chmpxbench -c -conf test_slave.ini -l 1 -proccnt 1 -threadcnt 1 -ta -dl 128 -pr -g err -dummykey TEST
以上の動作でエラーが出なければ問題ありません。
chmpx、chmpxbenchともにシグナルHUPを送ります。
自動的に終了します。
CHMPXは、CHMPXプロセス自身およびRING上のCHMPXサーバーノード群を制御するためのポートを指定して起動されます。
この制御ポートに対して、制御コマンドを送ることでCHMPXプロセス、RING上のCHMPXサーバーノード群の制御、状態管理、確認ができます。
制御コマンドは、そのコマンドを受け取るCHMPXプロセス自身を制御するコマンドと、RING上のCHMPXサーバーノード群（RING）を制御するコマンドに大別できます。
この制御コマンドを使い、RING上のCHMPXサーバーノード群の状態確認、変更ができます。
また、CHMPXプロセス自身の状態確認、変更もできます。
この制御ポート経由の制御コマンドを直接利用せず、簡単に利用できるchmpxlinetoolを利用することを推奨します。
CHMPXプログラム起動時に指定するコンフィグレーション（ファイル、JSON文字列）に、CTLPORTの項目があります。
このCTLPORTは、制御ポートを示しています。
この制御ポートに接続し、制御コマンドを文字列でCHMPXプロセスに渡すことができます。
CHMPXプロセスは制御コマンドを受け、そのコマンドに応じた処理、返答を行います。
なお、現在制御ポートとの接続と通信は暗号化をサポートしていません。（今後サポートされます）
制御ポートへのアクセスは、コンフィグレーション（ファイル、JSON文字列）で指定されているサーバーノード、スレーブノードのみが可能です。
CHMPXプロセスのバージョンを返します。
接続したCHMPXプロセスのみの状態を返します。 このコマンドはCHMPXプロセスの基本的な状態を返し、それはDUMPコマンドよりも荒い情報です。
接続したCHMPXプロセスが持っている全CHMPXサーバーノード、スレーブノードの状態を返します。 このコマンドは接続したCHMPXプロセスが持つ自分自身を含む他CHMPXプロセスの必要最小限な状態を返し、CHMPXプロセス同士のRINGに関する状態を得ることができます。
接続したCHMPXプロセスの状態を、このCHMPXプロセスが接続している他CHMPXプロセスに送り、状態を強制的にアップデートします。
もし、特定のCHMPXプロセスの状態が間違った状態で他CHMPXプロセスに伝播している場合、正しいCHMPXプロセスの状態に合わせるために利用するコマンドです。
通常発生しないケースでありますが、CHMPXプロセスの状態を一致させるための復旧コマンドです。
接続したCHMPXプロセスのもつ内部情報をすべて返します。 本コマンドにより、その時点のCHMPXプロセスの詳細な状態を確認することができます。
接続したCHMPXサーバーノードに対して、サービスを提供するように指示します。 サーバーノードのCHMPXプロセスが、起動し、RINGに参加しているが、サービスを提供していない状態（SERVICE OUT状態）である場合、サービスを提供するように指示します。 このコマンドにより、CHMPXプロセスはサービス提供開始準備状態（SERVICE IN、かつADD、PENDING状態）になります。 コンフィグレーションにて、AUTOMERGE設定がONの場合には、CHMPXプロセスは自動的にSERVICE IN状態になるように初期動作しますので、本コマンドを利用する必要はありません。
任意のCHMPXサーバーノードに対して、サービスを提供しないように指示します。 サーバーノードのCHMPXプロセスが、RINGに参加し、サービスを提供している状態（SERVICE IN状態）である場合、サービスを提供しないように指示します。 このコマンドにより、CHMPXプロセスはサービス提供停止準備状態（SERVICE IN、かつ、DELETE、PENDING状態）になります。 指定するホスト名と制御ポート番号は、このコマンドを送付するCHMPXプロセス以外のCHMPXプロセス（ホスト）を指定することができます。 これは、CHMPXプロセスが起動していない（DOWN状態）サーバーノードを、他CHMPXサーバーノードからサービスアウトできるようにするためです。 コンフィグレーションのAUTOMERGE設定がONに設定されており、CHMPXプロセスが停止（終了）した場合、自動的にSERVICE OUT状態になるように動作しますので、本コマンドを利用する必要はありません。
SERVICEIN、SERVICEOUTコマンドなどにより、CHMPXサーバーノードの状態が準備状態（PENDING状態）となっている場合、本コマンドによりデーターマージを開始させます。 CHMPXサーバーノードプロセスと接続するクライアントプロセス（サーバーサイドプロセス）がデータを持つ場合、サービス提供を開始・停止するときに必要となる/必要とされるデータを他CHMPXサーバーノードプロセスとマージしなくてはなりません。 このデータをマージ開始させるための制御コマンドです。 このコマンドが正常に受け付けられた場合、CHMPXプロセスはマージ実行中状態（DOING）となります。 CHMPXサーバーノードプロセスは、データのマージが完了すると自動的にマージ完了状態（DONE）に移行します。 コンフィグレーションのAUTOMERGE設定がONに設定されている場合には、PENDING状態のCHMPXサーバーノードプロセスは、準備が整い次第自動的にDOING、DONE状態に移行します。
すべてのCHMPXサーバーノードプロセスが、データのマージ完了状態（DONE）となっているとき、本コマンドを受け取ることによって、サービス提供・サービス停止状態（SERVICE IN/SERVICE OUT）となります。 もし、ひとつでもCHMPXサーバーノードプロセスが、データのマージ完了状態（DONE）となっていない場合には、本コマンドは失敗します。 コンフィグレーションのAUTOMERGE設定がONに設定されている場合には、すべてのCHMPXサーバーノードプロセスが、データのマージ完了状態（DONE）となった時点で、自動的にサービス提供・サービス停止状態（SERVICE IN/SERVICE OUT）となります。
CHMPXサーバーノードプロセスが、サービス提供・停止準備状態（PENDING）やデータのマージ中（DOING）、データのマージ完了（DONE）の状態のときに、その処理をキャンセルし、元の状態に戻します。 データのマージ処理が完了できない場合や、時間のかかる場合などにおいて、その処理をキャンセルために使用するコマンドです。
CHMPXは起動時にコンフィグレーションからAUTOMERGEの設定を読み取り、自動的なマージ処理を実行するか決定します。 このAUTOMERGEのコンフィグレーションを無視（SUSPEND）するか、有効と判断（NOSUSPEND）するかを制御コマンドで指定することができます。 本コマンドは、AUTOMERGEの設定を無視（SUSPEND）するように、RING上の全CHMPXサーバーノードに指示します。 このコマンドにより、RING上の全CHMPXサーバーノードだけではなく、後からRINGに参加するCHMPXサーバーノードに対しても、この設定状態が反映されます。 本コマンドは、多数のCHMPXサーバーノードを一度にRINGに投入する場合に、一時的にAUTOMERGEの設定を無効化し、投入後SERVICEIN/MERGE/COMPMERGEコマンドによってサービス提供を開始させるなどで利用します。 この手法により多数のCHMPXサーバーノードを一度に追加するときに、追加毎にAUTOMERGEが自動的に実行されないようにし、効率よくマージ処理を行えるようにします。
本コマンドは、AUTOMERGEの設定を有効（NOSUSPEND）するように、RING上の全CHMPXサーバーノードに指示します。 AUTOMERGEの設定が無効（SUSPEND）となっている状態を解除します。 このコマンドにより、RING上の全CHMPXサーバーノードだけではなく、後からRINGに参加するCHMPXサーバーノードに対しても、この設定状態が反映されます。