YUKI Hiroshi
null+****@clear*****
Fri Aug 29 17:09:37 JST 2014
YUKI Hiroshi 2014-08-29 17:09:37 +0900 (Fri, 29 Aug 2014) New Revision: 0b2d704b44f55aeac76c611f953daa1cb3fd2886 https://github.com/droonga/droonga.org/commit/0b2d704b44f55aeac76c611f953daa1cb3fd2886 Message: Update translations Modified files: _po/ja/tutorial/1.0.6/add-replica/index.po _po/ja/tutorial/1.0.6/basic/index.po _po/ja/tutorial/1.0.6/groonga/index.po ja/tutorial/1.0.6/add-replica/index.md ja/tutorial/1.0.6/basic/index.md ja/tutorial/1.0.6/groonga/index.md Modified: _po/ja/tutorial/1.0.6/add-replica/index.po (+10 -20) =================================================================== --- _po/ja/tutorial/1.0.6/add-replica/index.po 2014-08-29 16:56:50 +0900 (9cc6945) +++ _po/ja/tutorial/1.0.6/add-replica/index.po 2014-08-29 17:09:37 +0900 (2649abb) @@ -143,7 +143,9 @@ msgid "" " # gem install droonga-engine\n" " # npm install -g droonga-http-server\n" " # mkdir ~/droonga\n" -" # echo \"host: 192.168.100.52\" > ~/droonga/droonga-engine.yaml" +" # echo \"host: 192.168.100.52\" > ~/droonga/droonga-engine.yaml\n" +" # echo \"port: 10041\" > ~/droonga/droonga-http-server.yaml\n" +" # echo \"environment: production\" >> ~/droonga/droonga-http-server.yaml" msgstr "" msgid "Then generate the `catalog.json` with only one replica, the new node itself:" @@ -177,16 +179,9 @@ msgstr "では、サーバを起動しましょう。" msgid "" " (on 192.168.100.52)\n" -" # host=192.168.100.52\n" " # export DROONGA_BASE_DIR=$HOME/droonga\n" " # droonga-engine\n" -" # droonga-http-server --port=10041 \\\n" -" --receive-host-name=$host \\\n" -" --droonga-engine-host-name=$host \\\n" -" --environment=production \\\n" -" --cache-size=-1 \\\n" -" --daemon \\\n" -" --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid" +" # droonga-http-server --cache-size=-1" msgstr "" msgid "" @@ -300,7 +295,6 @@ msgstr "" msgid "" " (on 192.168.100.52)\n" -" # cd ~/droonga\n" " # droonga-engine-join --host=192.168.100.52 \\\n" " --replica-source-host=192.168.100.50\n" " Joining new replica to the cluster...\n" @@ -490,19 +484,16 @@ msgstr "" msgid "" " (on 192.168.100.52)\n" -" # host=192.168.100.52\n" " # export DROONGA_BASE_DIR=$HOME/droonga\n" -" # echo \"host: $host\" > $DROONGA_BASE_DIR/droonga-engine.yaml\n" +" # echo \"host: 192.168.100.52\" > $DROONGA_BASE_DIR/droonga-engine.yaml\n" +" # echo \"port: 10041\" > $DROONGA_BASE_DIR/droonga-http-server." +"yaml\n" +" # echo \"environment: production\" >> $DROONGA_BASE_DIR/droonga-http-server." +"yaml\n" " # droonga-engine-catalog-generate --hosts=$host \\\n" " --output=$DROONGA_BASE_DIR/catalog.json\n" " # droonga-engine\n" -" # droonga-http-server --port=10041 \\\n" -" --receive-host-name=$host \\\n" -" --droonga-engine-host-name=$host \\\n" -" --environment=production \\\n" -" --cache-size=-1 \\\n" -" --daemon \\\n" -" --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid" +" # droonga-http-server --cache-size=-1" msgstr "" msgid "Then, join the node to the cluster." @@ -510,7 +501,6 @@ msgstr "そうしたら、そのノードをクラスタに参加させましょ msgid "" " (on 192.168.100.52)\n" -" # cd ~/droonga\n" " # droonga-engine-join --host=192.168.100.52 \\\n" " --replica-source-host=192.168.100.50" msgstr "" Modified: _po/ja/tutorial/1.0.6/basic/index.po (+49 -12) =================================================================== --- _po/ja/tutorial/1.0.6/basic/index.po 2014-08-29 16:56:50 +0900 (fed413f) +++ _po/ja/tutorial/1.0.6/basic/index.po 2014-08-29 17:09:37 +0900 (80bcfe3) @@ -1128,27 +1128,64 @@ msgstr "" msgid "## Setup an HTTP Protocol Adapter" msgstr "## HTTP Protocol Adapter を用意する" -msgid "" -"Let's use the `droonga-http-server` as an HTTP protocol adapter. It is an npm " -"package for the Node.js." -msgstr "" -"HTTP Protocol Adapterとして`droonga-http-server`を使用します。`droonga-http-server`は、Nod" -"e.js のパッケージです。" +msgid "Let's use the `droonga-http-server` as an HTTP protocol adapter." +msgstr "HTTP Protocol Adapterとして`droonga-http-server`を使用しましょう。" msgid "### Install the droonga-http-server" msgstr "### droonga-http-serverをインストールする" +msgid "" +"It is an npm package for the Node.js so you can install it by `npm` command ea" +"sily:" +msgstr "`droonga-http-server`は、Node.js のパッケージなので、`npm`コマンドで簡単にインストールすることができます：" + msgid " # npm install -g droonga-http-server" msgstr "" -msgid "Then, run it." -msgstr "次に、サーバを起動します。" +msgid "" +"Next, put a configuration file `droonga-http-server.yaml` into the configurati" +"on directory specified by the environment variable `DROONGA_BASE_DIR`." +msgstr "" +"次に、環境変数 `DROONGA_BASE_DIR` で示されているディレクトリに設定ファイル `droonga-http-server.yaml` を置き" +"ます。" + +msgid "droonga-http-server.yaml:" +msgstr "" msgid "" -" # droonga-http-server --receive-host-name=192.168.100.50 \\\n" -" --droonga-engine-host-name=192.168.100.50 \\\n" -" --daemon \\\n" -" --pid-file $DROONGA_BASE_DIR/droonga-http-server.pid" +" port: 10041\n" +" environment: production" +msgstr "" + +msgid "" +"Because there is `droogna-engine.yaml` and droonga-http-server automatically l" +"oads some information from `droogna-engine.yaml`, you only have to put very fe" +"w information to the `droonga-http-server.yaml`.\n" +"If no droonga-engine is working on the computer, you have to specify required " +"information completely, to communicate with a droonga-engine server.\n" +"For example, if the computer is `192.168.100.51` and there is a droonga-engine" +" server `192.168.100.50`, then `droonga-http-server.yaml` on `192.168.100.51` " +"should be:" +msgstr "" +"`droogna-engine.yaml`が存在する場合、droonga-http-serverは自動的にそのファイルの内容を参照するため、`droonga" +"-http-server.yaml`にはごく一部の情報だけを置けば十分です。\n" +"そのコンピュータ上でdroonga-engineが動作していない場合には、droonga-engineサーバと通信するために、必要な情報尾すべて書く必要があ" +"ります。\n" +"例えば、そのコンピュータが `192.168.100.51` で、droogna-engineサーバである別のコンピュータ `192.168.100.50`" +" が存在している場合では、`droonga-http-server.yaml`の内容は以下の要領となります：" + +msgid "" +" port: 10041\n" +" environment: production\n" +" engine:\n" +" host: 192.168.100.50\n" +" receiver_host: 192.168.100.51" +msgstr "" + +msgid "OK, let's run it." +msgstr "では、サーバを起動しましょう。" + +msgid " # droonga-http-server" msgstr "" msgid "### Search request via HTTP" Modified: _po/ja/tutorial/1.0.6/groonga/index.po (+21 -22) =================================================================== --- _po/ja/tutorial/1.0.6/groonga/index.po 2014-08-29 16:56:50 +0900 (94c3cca) +++ _po/ja/tutorial/1.0.6/groonga/index.po 2014-08-29 17:09:37 +0900 (f22831a) @@ -256,6 +256,19 @@ msgid "" msgstr " （もしくは、できあがったファイルをコピーする代わりに、各コンピュータ上で同じ設定の`catalog.json`を作成しても結構です。）" msgid "" +" 7. Create a `droonga-http-server.yaml` in the directory, *on each computer*.\n" +" It includes information to work droonga-http-server well." +msgstr "" +" 7. *それぞれのコンピュータで*、ディレクトリ内に`droonga-http-server.yaml`を作成します。\n" +" このファイルはdroonga-http-serverを上手く動作させるために必要な情報を含みます。\n" + +msgid "" +" # echo \"port: 10041\" > ~/droonga/droonga-http-server.yaml" +"\n" +" # echo \"environment: production\" >> ~/droonga/droonga-http-server.yaml" +msgstr "" + +msgid "" "All Droonga nodes for your Droonga cluster are prepared by steps described abo" "ve.\n" "Let's continue to the next step." @@ -284,34 +297,20 @@ msgid "To start them, run commands like following on each Droonga node:" msgstr "サービスを起動するには、各Droongaノードで以下のようにコマンドを実行します：" msgid "" -" # host=192.168.100.50\n" " # export DROONGA_BASE_DIR=$HOME/droonga\n" " # droonga-engine\n" -" # droonga-http-server --port=10041 \\\n" -" --receive-host-name=$host \\\n" -" --droonga-engine-host-name=$host \\\n" -" --environment=production \\\n" -" --cache-size=-1 \\\n" -" --daemon \\\n" -" --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid" -msgstr "" - -msgid "" -"Note that you have to specify the host name of the Droonga node itself via som" -"e options.\n" -"It will be used to communicate with other Droonga nodes in the cluster.\n" -"So you have to specify different host name on another Droonga node, like:" +" # droonga-http-server --cache-size=-1" msgstr "" -"いくつかのオプションにおいて、そのDroongaノード自身のホスト名を指定する必要がある事に注意して下さい。\n" -"この情報は、クラスタ内の他のDroongaノードとの通信のために使われます。\n" -"よって、別のDroongaノード上では以下のように別のホスト名を指定する事になります：" msgid "" -" # host=192.168.100.51\n" -" # export DROONGA_BASE_DIR=$HOME/droonga\n" -" # droonga-engine\n" -" ..." +"The option `--cache-size=-1` for `droonga-http-server` is just for avoiding th" +"at you see cached result unexpectedly, after you modify some data in the clust" +"er.\n" +"On an actual production environment, you should not specify it." msgstr "" +"`droonga-http-server`の`--cache-size=-1`というオプションは、クラスタ内の情報を変更した後の検証で、キャッシュされた結果" +"が意図せず返されてしまうことを防ぐための物です。\n" +"実際のプロダクション環境では、この指定は行わないで下さい。" msgid "" "By the command two nodes construct a cluster and they monitor each other.\n" Modified: ja/tutorial/1.0.6/add-replica/index.md (+8 -20) =================================================================== --- ja/tutorial/1.0.6/add-replica/index.md 2014-08-29 16:56:50 +0900 (87b73c9) +++ ja/tutorial/1.0.6/add-replica/index.md 2014-08-29 17:09:37 +0900 (28f42ed) @@ -69,7 +69,9 @@ Droongaのノードの集合には、「replica」と「slice」という2つの # gem install droonga-engine # npm install -g droonga-http-server # mkdir ~/droonga - # echo "host: 192.168.100.52" > ~/droonga/droonga-engine.yaml + # echo "host: 192.168.100.52" > ~/droonga/droonga-engine.yaml + # echo "port: 10041" > ~/droonga/droonga-http-server.yaml + # echo "environment: production" >> ~/droonga/droonga-http-server.yaml 新しく追加しようとしているノードのみをreplicaとして含む内容で、`catalog.json`を生成します： @@ -90,16 +92,9 @@ Droongaのノードの集合には、「replica」と「slice」という2つの では、サーバを起動しましょう。 (on 192.168.100.52) - # host=192.168.100.52 # export DROONGA_BASE_DIR=$HOME/droonga # droonga-engine - # droonga-http-server --port=10041 \ - --receive-host-name=$host \ - --droonga-engine-host-name=$host \ - --environment=production \ - --cache-size=-1 \ - --daemon \ - --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid + # droonga-http-server --cache-size=-1 この時点では、ノードの情報が `catalog.json` に含まれていないため、この新しいノードはクラスタのノードとしては動作していません。 新しいノードにリクエストを送っても、それらはすべてクラスタ内の既存のノードに転送されます。 @@ -168,7 +163,6 @@ cronjobとして実行されるバッチスクリプトによって `load` コ 新しいreplicaノードを既存のクラスタに追加するには、いずれかの既存のノードもしくは新しいreplicaノードのいずれかにおいて、`catalog.json` が置かれているディレクトリで、`droonga-engine-join` コマンドを実行します: (on 192.168.100.52) - # cd ~/droonga # droonga-engine-join --host=192.168.100.52 \ --replica-source-host=192.168.100.50 Joining new replica to the cluster... @@ -310,24 +304,18 @@ Droongaクラスタ内のノードは互いに監視しあっており、動作 必要なパッケージをインストールし、`catalog.json`を生成して、サービスを起動します。 (on 192.168.100.52) - # host=192.168.100.52 # export DROONGA_BASE_DIR=$HOME/droonga - # echo "host: $host" > $DROONGA_BASE_DIR/droonga-engine.yaml + # echo "host: 192.168.100.52" > $DROONGA_BASE_DIR/droonga-engine.yaml + # echo "port: 10041" > $DROONGA_BASE_DIR/droonga-http-server.yaml + # echo "environment: production" >> $DROONGA_BASE_DIR/droonga-http-server.yaml # droonga-engine-catalog-generate --hosts=$host \ --output=$DROONGA_BASE_DIR/catalog.json # droonga-engine - # droonga-http-server --port=10041 \ - --receive-host-name=$host \ - --droonga-engine-host-name=$host \ - --environment=production \ - --cache-size=-1 \ - --daemon \ - --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid + # droonga-http-server --cache-size=-1 そうしたら、そのノードをクラスタに参加させましょう。 (on 192.168.100.52) - # cd ~/droonga # droonga-engine-join --host=192.168.100.52 \ --replica-source-host=192.168.100.50 Modified: ja/tutorial/1.0.6/basic/index.md (+24 -6) =================================================================== --- ja/tutorial/1.0.6/basic/index.md 2014-08-29 16:56:50 +0900 (6c92cdf) +++ ja/tutorial/1.0.6/basic/index.md 2014-08-29 17:09:37 +0900 (7a64813) @@ -923,18 +923,36 @@ Elapsed time: 0.008286785 ## HTTP Protocol Adapter を用意する -HTTP Protocol Adapterとして`droonga-http-server`を使用します。`droonga-http-server`は、Node.js のパッケージです。 +HTTP Protocol Adapterとして`droonga-http-server`を使用しましょう。 ### droonga-http-serverをインストールする +`droonga-http-server`は、Node.js のパッケージなので、`npm`コマンドで簡単にインストールすることができます： + # npm install -g droonga-http-server -次に、サーバを起動します。 +次に、環境変数 `DROONGA_BASE_DIR` で示されているディレクトリに設定ファイル `droonga-http-server.yaml` を置きます。 + +droonga-http-server.yaml: + + port: 10041 + environment: production + +`droogna-engine.yaml`が存在する場合、droonga-http-serverは自動的にそのファイルの内容を参照するため、`droonga-http-server.yaml`にはごく一部の情報だけを置けば十分です。 +そのコンピュータ上でdroonga-engineが動作していない場合には、droonga-engineサーバと通信するために、必要な情報尾すべて書く必要があります。 +例えば、そのコンピュータが `192.168.100.51` で、droogna-engineサーバである別のコンピュータ `192.168.100.50` が存在している場合では、`droonga-http-server.yaml`の内容は以下の要領となります： + +droonga-http-server.yaml: + + port: 10041 + environment: production + engine: + host: 192.168.100.50 + receiver_host: 192.168.100.51 + +では、サーバを起動しましょう。 - # droonga-http-server --receive-host-name=192.168.100.50 \ - --droonga-engine-host-name=192.168.100.50 \ - --daemon \ - --pid-file $DROONGA_BASE_DIR/droonga-http-server.pid + # droonga-http-server ### HTTPでの検索リクエスト Modified: ja/tutorial/1.0.6/groonga/index.md (+11 -17) =================================================================== --- ja/tutorial/1.0.6/groonga/index.md 2014-08-29 16:56:50 +0900 (981724b) +++ ja/tutorial/1.0.6/groonga/index.md 2014-08-29 17:09:37 +0900 (537a1f9) @@ -122,6 +122,13 @@ Droongaクラスタは、*Droongaノード*と呼ばれる複数のコンピュ # scp ~/droonga/catalog.json 192.168.100.51:~/droonga/ （もしくは、できあがったファイルをコピーする代わりに、各コンピュータ上で同じ設定の`catalog.json`を作成しても結構です。） + + 7. *それぞれのコンピュータで*、ディレクトリ内に`droonga-http-server.yaml`を作成します。 + このファイルはdroonga-http-serverを上手く動作させるために必要な情報を含みます。 + + + # echo "port: 10041" > ~/droonga/droonga-http-server.yaml + # echo "environment: production" >> ~/droonga/droonga-http-server.yaml 上記の手順により、DroongaクラスタのためのすべてのDroongaノードの準備が完了しました。 次の段階に進みましょう。 @@ -138,25 +145,12 @@ GroongaをHTTPサーバとして使う場合は、以下のように `-d` オプ サービスを起動するには、各Droongaノードで以下のようにコマンドを実行します： - # host=192.168.100.50 # export DROONGA_BASE_DIR=$HOME/droonga # droonga-engine - # droonga-http-server --port=10041 \ - --receive-host-name=$host \ - --droonga-engine-host-name=$host \ - --environment=production \ - --cache-size=-1 \ - --daemon \ - --pid-file=$DROONGA_BASE_DIR/droonga-http-server.pid - -いくつかのオプションにおいて、そのDroongaノード自身のホスト名を指定する必要がある事に注意して下さい。 -この情報は、クラスタ内の他のDroongaノードとの通信のために使われます。 -よって、別のDroongaノード上では以下のように別のホスト名を指定する事になります： - - # host=192.168.100.51 - # export DROONGA_BASE_DIR=$HOME/droonga - # droonga-engine - ... + # droonga-http-server --cache-size=-1 + +`droonga-http-server`の`--cache-size=-1`というオプションは、クラスタ内の情報を変更した後の検証で、キャッシュされた結果が意図せず返されてしまうことを防ぐための物です。 +実際のプロダクション環境では、この指定は行わないで下さい。 このコマンドにより、2つのノードはクラスタを形成し、互いの生死を監視するようになります。もしクラスタ内のどれか1つのノードが機能を停止し、他のノードがまだ機能し続けていた場合には、残ったノードがDroongaクラスタとして動作し続けます。そのため、そのような事態が起こっても秘密裏に、機能停止したノードを復旧したりクラスタに復帰させたりすることができます。 -------------- next part -------------- HTML����������������������������...Download