YUKI Hiroshi
null+****@clear*****
Wed Aug 27 17:41:42 JST 2014
YUKI Hiroshi 2014-08-27 17:41:42 +0900 (Wed, 27 Aug 2014) New Revision: e3b254cd1cabba9646d13433227e2307c8b73cc2 https://github.com/droonga/droonga.org/commit/e3b254cd1cabba9646d13433227e2307c8b73cc2 Message: Update steps to join a node for the latest implementation Modified files: _po/ja/tutorial/1.0.6/add-replica/index.po ja/tutorial/1.0.6/add-replica/index.md tutorial/1.0.6/add-replica/index.md Modified: _po/ja/tutorial/1.0.6/add-replica/index.po (+17 -27) =================================================================== --- _po/ja/tutorial/1.0.6/add-replica/index.po 2014-08-22 14:26:44 +0900 (f315048) +++ _po/ja/tutorial/1.0.6/add-replica/index.po 2014-08-27 17:41:42 +0900 (c21bfea) @@ -43,19 +43,20 @@ msgid "" "* You must know how to duplicate data between multiple clusters.\n" " Please complete the [\"How to backup and restore the database?\" tutorial](../" "dump-restore/) before this.\n" -"* Your `catalog.json` must have the plugin `system` in the list of plugins.\n" -" Otherwise, you must add it, like:" +"* Your `catalog.json` must have `system` and `catalog` plugins in the list of " +"plugins.\n" +" Otherwise, you must add them, like:" msgstr "" "* 何らかのデータが格納されている状態の[Droonga][]クラスタがあること。\n" " このチュートリアルを始める前に、[「使ってみる」のチュートリアル](../groonga/)を完了している事が望ましいです\n" "* 複数のクラスタの間でのデータの複製方法を把握していること。\n" " このチュートリアルを始める前に、[バックアップと復元のチュートリアル](../dump-restore/)を完了しておいてください。\n" -"* `catalog.json`に`system`プラグインが登録済みであること。\n" -" 未登録の場合は、以下のようにして`plugins`の一覧に`system`を追加しておいて下さい：" +"* `catalog.json`に`system`と`catalog`プラグインが登録済みであること。\n" +" 未登録の場合は、以下のようにして`plugins`の一覧に`system`と`catalog`を追加しておいて下さい：" msgid "" " - \"plugins\": [\"groonga\", \"crud\", \"search\", \"dump\"],\n" -" + \"plugins\": [\"groonga\", \"crud\", \"search\", \"dump\", \"system\"]," +" + \"plugins\": [\"groonga\", \"crud\", \"search\", \"dump\", \"system\", \"catalog\"]," msgstr "" msgid "## What's \"replica\"?" @@ -140,18 +141,10 @@ msgid "" " # apt-get install -y ruby ruby-dev build-essential nodejs nodejs-legacy np" "m\n" " # gem install droonga-engine\n" -" # npm install -g droonga-http-server" -msgstr "" - -msgid "" -"For the new node, you have to copy the `catalog.json` from existing node of th" -"e cluster." -msgstr "新しいノードには、クラスタの既存のノードから `catalog.json` をコピーする必要があります。" - -msgid "" -" (on 192.168.100.52)\n" +" # npm install -g droonga-http-server\n" " # mkdir ~/droonga\n" -" # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/" +" # droonga-engine-catalog-generate --hosts=192.168.100.52 \\\n" +" --output=~/droonga/catalog.json" msgstr "" msgid "" @@ -167,7 +160,8 @@ msgid "" " # kill $(cat ~/droonga/droonga-engine.pid)\n" " # rm -rf ~/droonga\n" " # mkdir ~/droonga\n" -" # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/" +" # droonga-engine-catalog-generate --hosts=192.168.100.52 \\\n" +" --output=~/droonga/catalog.json" msgstr "" msgid "Let's start the server." @@ -315,14 +309,10 @@ msgid "" " * You must specify the host name or the IP address of the new replica node, v" "ia the `--host` option.\n" " * You must specify the host name or the IP address of an existing node of the" -" cluster, via the `--replica-source-host` option.\n" -" * You must run the command in the directory `catalog.json` is located, or spe" -"cify path to the directory via the `--base-dir` option." +" cluster, via the `--replica-source-host` option." msgstr "" " * `--host` オプションで、その新しいreplicaノードのホスト名またはIPアドレスを指定して下さい。\n" -" * `--replica-source-host` オプションで、クラスタ中の既存のノードの1つのホスト名またはIPアドレスを指定して下さい。\n" -" * コマンドは `catalog.json` が置かれたディレクトリで実行するか、もしくはそのディレクトリのパスを `--base-dir` オプションで" -"指定して下さい。" +" * `--replica-source-host` オプションで、クラスタ中の既存のノードの1つのホスト名またはIPアドレスを指定して下さい。" msgid "" "Then the command automatically starts to synchronize all data of the cluster t" @@ -488,17 +478,17 @@ msgstr "### 新しいreplicaを追加する" msgid "" "Next, setup the new replica.\n" -"Install required packages and starts the server with the `catalog.json` copied" -" from an existing node of the cluster." +"Install required packages, generate the `catalog.json`, and start services." msgstr "" "次に、新しいreplicaを用意します。\n" -"必要なパッケージをインストールし、クラスタの既存のノードから `catalog.json` をコピーして、サーバを起動します。" +"必要なパッケージをインストールし、`catalog.json`を生成して、サービスを起動します。" msgid "" " (on 192.168.100.52)\n" -" # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/\n" " # host=192.168.100.52\n" " # export DROONGA_BASE_DIR=$HOME/droonga\n" +" # droonga-engine-catalog-generate --hosts=192.168.100.52 \\\n" +" --output=$DROONGA_BASE_DIR/catalog.json\n" " # droonga-engine --host=$host \\\n" " --log-file=$DROONGA_BASE_DIR/droonga-engine.log \\\n" " --daemon \\\n" Modified: ja/tutorial/1.0.6/add-replica/index.md (+10 -12) =================================================================== --- ja/tutorial/1.0.6/add-replica/index.md 2014-08-22 14:26:44 +0900 (2946850) +++ ja/tutorial/1.0.6/add-replica/index.md 2014-08-27 17:41:42 +0900 (a10a4eb) @@ -25,11 +25,11 @@ layout: ja このチュートリアルを始める前に、[「使ってみる」のチュートリアル](../groonga/)を完了している事が望ましいです * 複数のクラスタの間でのデータの複製方法を把握していること。 このチュートリアルを始める前に、[バックアップと復元のチュートリアル](../dump-restore/)を完了しておいてください。 -* `catalog.json`に`system`プラグインが登録済みであること。 - 未登録の場合は、以下のようにして`plugins`の一覧に`system`を追加しておいて下さい： +* `catalog.json`に`system`と`catalog`プラグインが登録済みであること。 + 未登録の場合は、以下のようにして`plugins`の一覧に`system`と`catalog`を追加しておいて下さい： - "plugins": ["groonga", "crud", "search", "dump"], - + "plugins": ["groonga", "crud", "search", "dump", "system"], + + "plugins": ["groonga", "crud", "search", "dump", "system", "catalog"], ## 「replica」とは？ @@ -68,12 +68,9 @@ Droongaのノードの集合には、「replica」と「slice」という2つの # apt-get install -y ruby ruby-dev build-essential nodejs nodejs-legacy npm # gem install droonga-engine # npm install -g droonga-http-server - -新しいノードには、クラスタの既存のノードから `catalog.json` をコピーする必要があります。 - - (on 192.168.100.52) # mkdir ~/droonga - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=~/droonga/catalog.json 注意点として、空でないノードを既存のクラスタに追加することはできません。 もしそのコンピュータがかつてDroongaノードとして使われていた事があった場合には、最初に古いデータを消去する必要があります。 @@ -82,7 +79,8 @@ Droongaのノードの集合には、「replica」と「slice」という2つの # kill $(cat ~/droonga/droonga-engine.pid) # rm -rf ~/droonga # mkdir ~/droonga - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=~/droonga/catalog.json では、サーバを起動しましょう。 @@ -179,7 +177,6 @@ cronjobとして実行されるバッチスクリプトによって `load` コ * `--host` オプションで、その新しいreplicaノードのホスト名またはIPアドレスを指定して下さい。 * `--replica-source-host` オプションで、クラスタ中の既存のノードの1つのホスト名またはIPアドレスを指定して下さい。 - * コマンドは `catalog.json` が置かれたディレクトリで実行するか、もしくはそのディレクトリのパスを `--base-dir` オプションで指定して下さい。 コマンドを実行すると、自動的に、クラスタのデータが新しいreplicaノードへと同期され始めます。 データの同期が完了すると、ノードが自動的に再起動してクラスタに参加します。 @@ -308,12 +305,13 @@ Droongaクラスタ内のノードは互いに監視しあっており、動作 ### 新しいreplicaを追加する 次に、新しいreplicaを用意します。 -必要なパッケージをインストールし、クラスタの既存のノードから `catalog.json` をコピーして、サーバを起動します。 +必要なパッケージをインストールし、`catalog.json`を生成して、サービスを起動します。 (on 192.168.100.52) - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ # host=192.168.100.52 # export DROONGA_BASE_DIR=$HOME/droonga + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=$DROONGA_BASE_DIR/catalog.json # droonga-engine --host=$host \ --log-file=$DROONGA_BASE_DIR/droonga-engine.log \ --daemon \ Modified: tutorial/1.0.6/add-replica/index.md (+10 -12) =================================================================== --- tutorial/1.0.6/add-replica/index.md 2014-08-22 14:26:44 +0900 (6426a1d) +++ tutorial/1.0.6/add-replica/index.md 2014-08-27 17:41:42 +0900 (b500600) @@ -16,11 +16,11 @@ Learning steps to add a new replica node, remove an existing replica, and replac Please complete the ["getting started" tutorial](../groonga/) before this. * You must know how to duplicate data between multiple clusters. Please complete the ["How to backup and restore the database?" tutorial](../dump-restore/) before this. -* Your `catalog.json` must have the plugin `system` in the list of plugins. - Otherwise, you must add it, like: +* Your `catalog.json` must have `system` and `catalog` plugins in the list of plugins. + Otherwise, you must add them, like: - "plugins": ["groonga", "crud", "search", "dump"], - + "plugins": ["groonga", "crud", "search", "dump", "system"], + + "plugins": ["groonga", "crud", "search", "dump", "system", "catalog"], ## What's "replica"? @@ -59,12 +59,9 @@ First, prepare a new computer, install required softwares and configure them. # apt-get install -y ruby ruby-dev build-essential nodejs nodejs-legacy npm # gem install droonga-engine # npm install -g droonga-http-server - -For the new node, you have to copy the `catalog.json` from existing node of the cluster. - - (on 192.168.100.52) # mkdir ~/droonga - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=~/droonga/catalog.json Note, you cannot add a non-empty node to an existing cluster. If the computer was used as a Droonga node in old days, then you must clear old data at first. @@ -73,7 +70,8 @@ If the computer was used as a Droonga node in old days, then you must clear old # kill $(cat ~/droonga/droonga-engine.pid) # rm -rf ~/droonga # mkdir ~/droonga - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=~/droonga/catalog.json Let's start the server. @@ -171,7 +169,6 @@ To add a new replica node to an existing cluster, you just run a command `droong * You must specify the host name or the IP address of the new replica node, via the `--host` option. * You must specify the host name or the IP address of an existing node of the cluster, via the `--replica-source-host` option. - * You must run the command in the directory `catalog.json` is located, or specify path to the directory via the `--base-dir` option. Then the command automatically starts to synchronize all data of the cluster to the new replica node. After data is successfully synchronized, the node restarts and joins to the cluster automatically. @@ -302,12 +299,13 @@ You can confirm that via the `system.status` command: ### Add a new replica Next, setup the new replica. -Install required packages and starts the server with the `catalog.json` copied from an existing node of the cluster. +Install required packages, generate the `catalog.json`, and start services. (on 192.168.100.52) - # scp 192.168.100.50:~/droonga/catalog.json ~/droonga/ # host=192.168.100.52 # export DROONGA_BASE_DIR=$HOME/droonga + # droonga-engine-catalog-generate --hosts=192.168.100.52 \ + --output=$DROONGA_BASE_DIR/catalog.json # droonga-engine --host=$host \ --log-file=$DROONGA_BASE_DIR/droonga-engine.log \ --daemon \ -------------- next part -------------- HTML����������������������������...Télécharger
