SHIMODA Piro Hiroshi
null+****@clear*****
Wed Sep 24 01:47:00 JST 2014
SHIMODA "Piro" Hiroshi 2014-09-24 01:47:00 +0900 (Wed, 24 Sep 2014) New Revision: 6304fcbee8d94ff315ac64913558dac90e65bf42 https://github.com/droonga/droonga.org/commit/6304fcbee8d94ff315ac64913558dac90e65bf42 Message: Update translation of the initial tutorial Modified files: _po/ja/tutorial/1.0.6/groonga/index.po ja/tutorial/1.0.6/groonga/index.md tutorial/1.0.6/groonga/index.md Modified: _po/ja/tutorial/1.0.6/groonga/index.po (+321 -114) =================================================================== --- _po/ja/tutorial/1.0.6/groonga/index.po 2014-09-24 00:36:04 +0900 (6789da0) +++ _po/ja/tutorial/1.0.6/groonga/index.po 2014-09-24 01:47:00 +0900 (ee5128b) @@ -76,48 +76,63 @@ msgstr "" msgid "## Set up a Droonga cluster" msgstr "## Droongaクラスタをセットアップする" -msgid "### Prepare an environment for experiments" -msgstr "### 実験用の環境を準備する" +msgid "" +"A database system based on the Droonga is called *Droonga cluster*.\n" +"This section describes how to set up a Droonga cluster from scratch." +msgstr "" +"Droongaベースのデータベースシステムは、*Droongaクラスタ*と呼ばれます。\n" +"この節では、Droongaクラスタを0から構築する方法を解説します。" + +msgid "### Prepare computers for Droonga nodes" +msgstr "### Droongaノード用のコンピュータを用意する" msgid "" -"Prepare a computer at first.\n" -"This tutorial describes steps to set up a Droonga cluster based on existing co" -"mputers.\n" +"A Droonga cluster is constructed from one or more computers, called *Droonga n" +"ode*(s).\n" +"Prepare computers for Droonga nodes at first." +msgstr "" +"Droongaクラスタは、*Droongaノード*と呼ばれる1つ以上のコンピュータによって構成されます。\n" +"まず、Droongaノードにするためのコンピュータを用意しましょう。" + +msgid "" +"This tutorial describes steps to set up Droonga cluster based on existing comp" +"uters.\n" "Following instructions are basically written for a successfully prepared virtu" -"al machine of the `Ubuntu 13.10 x64` or `CentOS 6.5 x64` on the service [Digit" -"alOcean](https://www.digitalocean.com/), with an available console." +"al machine of the `Ubuntu 14.04 x64` or `CentOS 7 x64` on the service [Digital" +"Ocean](https://www.digitalocean.com/), with an available console." msgstr "" -"まず最初にコンピュータを用意します。\n" "このチュートリアルは、既存のコンピュータを使ってDroongaクラスタを構築する手順について解説しています。\n" -"以下の説明は基本的には、[DigitalOcean](https://www.digitalocean.com/)上のサーバで`Ubuntu 13.10 x" -"64`または`CentOS 6.5 x64`の仮想マシンが正しく準備されており、コンソールが利用できる状態になっている、という前提に基づいています。" +"以下の説明は基本的には、[DigitalOcean](https://www.digitalocean.com/)上のサーバで`Ubuntu 14.04 x" +"64`または`CentOS 7 x64`の仮想マシンが正しく準備されており、コンソールが利用できる状態になっている、という前提に基づいています。" + +msgid "NOTE:" +msgstr "注意:" msgid "" -"NOTE: Make sure to use instances with >= 2GB memory equipped, at least during " -"installation of required packages for Droonga.\n" -"Otherwise, you may experience a strange build error." +" * Make sure to use instances with >= 2GB memory equipped, at least during ins" +"tallation of required packages for Droonga.\n" +" Otherwise, you may experience a strange build error.\n" +" * Make sure the hostname reported by `hostname -f` or the IP address reported" +" by `hostname -i` have to be accessible from each other computer in your clust" +"er." msgstr "" -"注意：Droongaの依存パッケージをインストールする前に、仮想マシンのインスタンスが少なくとも2GB以上のメモリを備えていることを確認して下さい。\n" -"メモリが足りないと、ビルド時におかしなエラーに遭遇することになります。" - -msgid "You need to prepare two or more computers for effective replication." -msgstr "また、有効なレプリケーションを実現するためには2台以上のコンピュータを用意する必要もあります。" -msgid "### Steps to install Droonga components" -msgstr "### Droongaの構成コンポーネントをインストールする" +msgid "" +"You need to prepare two or more nodes for effective replication.\n" +"So this tutorial assumes that you have two computers:" +msgstr "" +"有効なレプリケーションを実現するためには2台以上のコンピュータを用意する必要があります。\n" +"ですので、このチュートリアルでは以下のような2台のコンピュータがあると仮定して説明を進めます:" msgid "" -"A database system based on the Droonga is called *Droonga cluster*.\n" -"A Droonga cluster is constructed from multiple computers, called *Droonga node" -"*.\n" -"So you have to set up multiple Droonga nodes for your Droonga cluster." +" * has an IP address `192.168.100.50`, with a host name `node0`.\n" +" * has an IP address `192.168.100.51`, with a host name `node1`." msgstr "" -"Droongaベースのデータベースシステムは、*Droongaクラスタ*と呼ばれます。\n" -"Droongaクラスタは、*Droongaノード*と呼ばれる複数のコンピュータによって構成されます。\n" -"よって、Droongaクラスタを構築するには複数のDroongaノードをセットアップする必要があります。" +" * IPアドレスが`192.168.100.50`で、ホスト名が`node0`であるコンピュータ。\n" +" * IPアドレスが`192.168.100.51`で、ホスト名が`node1`であるコンピュータ。" -msgid "Assume that you have two computers: `192.168.100.50` and `192.168.100.51`." -msgstr "`192.168.100.50`と`192.168.100.51`の2つのコンピュータがあると仮定しましょう。" +msgid "### Set up computers as Droonga nodes" +msgstr "## コンピュータをDroongaノードとしてセットアップする" msgid "" "Groonga provides binary packages and you can install Groonga easily, for some " @@ -127,95 +142,268 @@ msgstr "" "Groongaはバイナリのパッケージを提供しているため、環境によっては簡単にインストールできます。\n" "（[Groongaのインストール手順](http://groonga.org/docs/install.html)を参照）" +msgid "On the other hand, steps to set up a computer as a Droonga node are:" +msgstr "それに対し、コンピュータをDroongaノードとしてセットアップする手順は以下の通りです:" + msgid "" -"On the other hand, there is an installation script to set up a database system" -" based on Droonga.\n" -"If you are using a Ubuntu, Debian, or a CentOS 7 (and later) server, download " -"the script and run it by `bash`, as the root user, like:" +" 1. Install the `droonga-engine`.\n" +" 2. Install the `droonga-http-server`.\n" +" 3. Configure the node to work together with other nodes." msgstr "" +" 1. `droonga-engine`をインストールする。\n" +" 2. `droonga-http-server`をインストールする。\n" +" 3. そのノードを他のノードと協調して動作するように設定する。" + +msgid "" +"Note that you must do all steps on each computer.\n" +"However, they're very simple." +msgstr "" +"上記の手順を各コンピュータに対して実施する必要があることに注意して下さい。\n" +"しかしながら、各手順は非常に簡単です。" + +msgid "" +"Let's log in to the computer `node0` (`192.168.100.50`), and install Droonga c" +"omponents." +msgstr "それでは、`node0` (`192.168.100.50`)にログインしてDroongaの構成コンポーネントをインストールしましょう。" + +msgid "" +"First, install the `droonga-engine`.\n" +"It is the core component provides most features of Droonga system.\n" +"Download the installation script and run it by `bash` as the root user:" +msgstr "" +"まず、`droonga-engine`をインストールします。\n" +"これはDroongaシステムの主要な機能を提供する、核となるコンポーネントです。\n" +"インストールスクリプトをダウンロードし、root権限で`bash`で実行して下さい:" msgid "" "~~~\n" -"(on 192.168.100.50)\n" -"$ curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install" +"# curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install" ".sh | \\\n" -" sudo HOST=192.168.100.50 bash\n" -"$ curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/in" -"stall.sh | \\\n" -" sudo ENGINE_HOST=192.168.100.50 HOST=192.168.100.50 bash" +" bash\n" +"...\n" +"Installing droonga-engine from RubyGems...\n" +"...\n" +"Preparing the user...\n" +"...\n" +"Setting up the configuration directory...\n" +"This node is configured with a hostname XXXXXXXX." msgstr "" msgid "" -"(on 192.168.100.51)\n" -"$ curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install" -".sh | \\\n" -" sudo HOST=192.168.100.51 bash\n" -"$ curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/in" -"stall.sh | \\\n" -" sudo ENGINE_HOST=192.168.100.51 HOST=192.168.100.51 bash\n" +"Registering droonga-engine as a service...\n" +"...\n" +"Successfully installed droonga-engine.\n" "~~~" msgstr "" -msgid "or:" +msgid "" +"Note, The name of the node itself (guessed from the host name of the computer)" +" appears in the message.\n" +"*It is used in various situations*, so *don't forget what is the name of each " +"node*." msgstr "" +"そのノード自身の名前（コンピュータのホスト名から推測されたもの）がメッセージの中に出力されていることに注意して下さい。\n" +"*この名前は様々な場面で使われます*ので、*各ノードの名前が何であるかを忘れないようにして下さい*" + +msgid "" +"Second, install the `droonga-http-server`.\n" +"It is the frontend component required to translate HTTP requests to Droonga's " +"native one.\n" +"Download the installation script and run it by `bash` as the root user:" +msgstr "" +"次に、`droonga-http-server`をインストールします。\n" +"これはHTTPのリクエストをDroongaネイティブのリクエストに変換するために必要な、フロントエンドとなるコンポーネントです。\n" +"インストールスクリプトをダウンロードし、root権限で`bash`で実行して下さい:" msgid "" "~~~\n" -"(on 192.168.100.50)\n" -"$ su\n" -"# curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install" -".sh | \\\n" -" HOST=192.168.100.50 bash\n" "# curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/in" "stall.sh | \\\n" -" ENGINE_HOST=192.168.100.50 HOST=192.168.100.50 bash" +" bash\n" +"...\n" +"Installing droonga-http-server from npmjs.org...\n" +"...\n" +"Preparing the user...\n" +"...\n" +"Setting up the configuration directory...\n" +"The droonga-engine service is detected on this node.\n" +"The droonga-http-server is configured to be connected\n" +"to this node (XXXXXXXX).\n" +"This node is configured with a hostname XXXXXXXX." +msgstr "" + +msgid "" +"Registering droonga-http-server as a service...\n" +"...\n" +"Successfully installed droonga-http-server.\n" +"~~~" +msgstr "" + +msgid "" +"If installation scripts didn't work as expected and you couldn't install them," +" see [the tutorial to install services without installation script](../manual-" +"install/)." +msgstr "" +"インストールスクリプトが期待通りに動作せずインストールできない場合は、[インストールスクリプトを使わない手動インストールの手順](../manual-ins" +"tall/)を参照して下さい。" + +msgid "" +"After that, do same operations on another computer `node1` (`192.168.100.51`) " +"also.\n" +"Then two computers successfully prepared to work as Droonga nodes." +msgstr "" +"ここまでの操作が終わったら、同じ操作をもう1台のコンピュータ `node1` (`192.168.100.51`) に対しても行います。\n" +"これで、無事に2台のコンピュータをDroongaノードとして動作させるための準備が整いました。" + +msgid "" +"### When your computers don't have a host name accessible from other computers" +"... {#accessible-host-name}" +msgstr "### コンピュータが他のコンピュータからアクセスできるホスト名を持っていない場合…… {#accessible-host-name}" + +msgid "" +"Each Droonga node must know the *accessible host name* of the node itself, to " +"communicate with other nodes." +msgstr "各Droongaノードは、他のノードと通信するために、そのノード自身の*アクセス可能な名前*を把握している必要があります。" + +msgid "" +"The installation script guesses accessible host name of the node automatically" +".\n" +"You can confirm what value is detected as the host name of the node itself, by" +" following command:" +msgstr "" +"インストールスクリプトはそのノードのアクセス可能なホスト名を自動的に推測します。\n" +"どのような値がそのノード自身のホストメイトして認識されたかは、以下の手順で確認できます:" + +msgid "" +"~~~\n" +"# cat ~droonga-engine/droonga/droonga-engine.yaml | grep host\n" +"host: XXXXXXXX\n" +"~~~" +msgstr "" + +msgid "" +"However it may be misdetected if the computer is not configured properly.\n" +"For example, even if a node is configured with a host name `node0`, it cannot " +"receive any message from other nodes when others cannot resolve the name `node" +"0` to actual IP address." +msgstr "" +"しかしながら、そのコンピュータが適切に設定されていないと、この自動認識に失敗することがあります。\n" +"例えば、そのノードのホスト名が`node0`であると設定されているにも関わらず、他のノードが`node0`というホスト名から実際のIPアドレスを名前解決でき" +"ないと、そのノードは他のノードから送られてくるメッセージを何も受信することができません。" + +msgid "" +"Then you have to reconfigure your node with raw IP addresse of the node itself" +", like:" +msgstr "そのような場合、以下のようにして、そのノード自身のIPアドレスを使ってノードを再設定する必要があります:" + +msgid "" +"~~~\n" +"(on node0=192.168.100.50)\n" +"# host=192.168.100.50\n" +"# droonga-engine-configure --quiet --reset-config --reset-catalog \\\n" +" --host=$host\n" +"# droonga-http-server-configure --quiet --reset-config \\\n" +" --droonga-engine-host-name=$host \\\n" +" --receive-host-name=$host" msgstr "" msgid "" -"(on 192.168.100.51)\n" -"$ su\n" +"(on node1=192.168.100.51)\n" +"# host=192.168.100.51\n" +"...\n" +"~~~" +msgstr "" + +msgid "" +"Then your computer `node0` is configured as a Droonga node with the host name " +"`192.168.100.50`, and `node1` becomes a node with the name `192.168.100.51`.\n" +"As said before, *the configured name is used in various situations*, so *don't" +" forget what is the name of each node*." +msgstr "" +"この操作により、コンピュータ `node0` は `192.168.100.50` というホスト名のDroongaノード、コンピュータ `node1` は " +"`192.168.100.51` というホスト名のDroongaノードとして設定されます。\n" +"前述した通り、*ここで設定された名前は様々な場面で使われます*ので、*各ノードの名前が何であるかを忘れないようにして下さい*。" + +msgid "" +"This tutorial assumes that all your computers can resolve each other host name" +" `node0` and `node1` correctly.\n" +"Otherwise, read host names `node0` and `node1` in following instructions, as r" +"aw IP addresses like `192.168.100.50` and `192.168.100.51`." +msgstr "" +"このチュートリアルでは、各コンピュータはお互いのホスト名`node0`と`node1`を正しく名前解決できるものと仮定します。\n" +"あなたの環境ではホスト名の解決ができないという場合には、以下の説明の中の`node0`と`node1`は、実際のIPアドレス（例えば`192.168.100" +".50`と`192.168.100.51`）に読み替えて下さい。" + +msgid "" +"By the way, you can specify your favorite value as the host name of the comput" +"er itself via environment variables, for the installation script, like:" +msgstr "ちなみに、インストールスクリプトに対しても、以下のように、環境変数を使って任意の値をホスト名として指定することができます:" + +msgid "" +"~~~\n" +"(on node0=192.168.100.50)\n" +"# host=192.168.100.50\n" "# curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install" ".sh | \\\n" -" HOST=192.168.100.51 bash\n" +" HOST=$host bash\n" "# curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/in" "stall.sh | \\\n" -" ENGINE_HOST=192.168.100.51 HOST=192.168.100.51 bash\n" -"~~~" +" ENGINE_HOST=$host HOST=$host bash" msgstr "" -msgid "And, let's configure these nodes to work together as a cluster:" +msgid "" +"This option will help you, if you already know that your computers are not con" +"figured to resolve each other name." +msgstr "この方法は、使おうとしているコンピュータがお互いのホスト名を名前解決できないことがあらかじめ分かっている場合に便利でしょう。" + +msgid "### Configure nodes to work together as a cluster" +msgstr "### 各ノードをクラスタとして動作するように設定する" + +msgid "" +"Currently, these nodes are still individual nodes.\n" +"Let's configure them to work together as a cluster." msgstr "" +"現時点で、これらのノードはまだ個別に動作する状態になっています。\n" +"それでは、これらを1つのクラスタとして動作するように設定しましょう。" + +msgid "Run commands like this, on each node:" +msgstr "以下のようなコマンドを各ノードで実行して下さい:" msgid "" "~~~\n" -"(on 192.168.100.50, 192.168.100.51)\n" -"$ sudo -u droonga-engine -H \\\n" -" droonga-engine-catalog-generate --hosts=192.168.100.50,192.168.100.51 \\\n" -" --output=~droonga-engine/droonga/catalog.j" -"son\n" +"# droonga-engine-catalog-generate --hosts=node0,node1 \\\n" +" --output=~droonga-engine/droonga/catalog.jso" +"n\n" +"# chown droogna-engine:droonga-engine ~droonga-engine/droonga/catalog.json\n" "~~~" msgstr "" msgid "" +"Of course you must specify correct host name of nodes by the `--hosts` option." +"\n" +"If your nodes are configured with raw IP addresses, the command line is:" +msgstr "" +"当然ながら、`--hosts`オプションには各ノードの正しいホスト名を指定する必要があります。\n" +"もしこれらのノードがIPアドレスをホスト名として設定されている場合には、コマンド列は以下のようになります:" + +msgid "" "~~~\n" -"(on 192.168.100.50, 192.168.100.51)\n" -"$ su\n" "# droonga-engine-catalog-generate --hosts=192.168.100.50,192.168.100.51 \\\n" " --output=~droonga-engine/droonga/catalog.jso" "n\n" -"# chown droogna-engine:droonga-engine ~droonga-engine/droonga/catalog.json\n" +"...\n" "~~~" msgstr "" msgid "" "OK, now your Droonga cluster is correctly prepared.\n" -"Let's continue to [the next step, \"how to use the cluster\"](#use)." +"Two nodes are configured to work together as a Droonga cluster." msgstr "" +"これで、Droongaクラスタの準備が完了しました。\n" +"2つのノードは1つのDroongaクラスタとして動作するための準備が完了しています。" -msgid "" -"If the installation script doesn't work on your platform, see [the tutorial to" -" install services without installation script](../manual-install/)." -msgstr "" +msgid "Let's continue to [the next step, \"how to use the cluster\"](#use)." +msgstr "引き続き、[クラスタの使い方の説明](#use)に進みましょう。" msgid "## Use the Droonga cluster, via HTTP {#use}" msgstr "## DroongaクラスタをHTTP経由で使用する" @@ -223,45 +411,58 @@ msgstr "## DroongaクラスタをHTTP経由で使用する" msgid "### Start and stop services on each Droonga node" msgstr "### 各Droongaノードの上でのサービスの開始と停止" -msgid "You can run Groonga as an HTTP server with the option `-d`, like:" +msgid "You can run Groonga as an HTTP server daemon with the option `-d`, like:" msgstr "GroongaをHTTPサーバとして使う場合は、以下のように `-d` オプションを指定するだけでサーバを起動できます：" -msgid " # groonga -p 10041 -d --protocol http /tmp/databases/db" +msgid "" +"~~~\n" +"# groonga -p 10041 -d --protocol http /tmp/databases/db\n" +"~~~" msgstr "" msgid "" -"On the other hand, you have to run multiple servers for each Droonga node to u" -"se your Droonga cluster via HTTP." -msgstr "一方、DroongaクラスタをHTTP経由で使うためには、各Droongaノードにおいて複数のサービスを起動する必要があります。" +"On the other hand, you have to run multiple server daemons for each Droonga no" +"de to use your Droonga cluster via HTTP." +msgstr "一方、DroongaクラスタをHTTP経由で使うためには、各Droongaノードにおいて複数のサーバ・デーモンを起動する必要があります。" msgid "" -"If services are installed by the installation script, they are already been co" -"nfigured as system services managed via the `service` command.\n" +"If you set up your Droonga nodes by installation scripts, daemons are already " +"been configured as system services managed via the `service` command.\n" "To start them, run commands like following on each Droonga node:" msgstr "" +"Droongaノードをインストールスクリプトを使ってセットアップした場合、デーモンは既に、`service`コマンドによって管理されるシステムのサービスとし" +"て設定されています。\n" +"サービスを起動するには、以下のようなコマンドを各Droongaノードで実行して下さい:" msgid "" -" # service droonga-engine start\n" -" # service droonga-http-server start" +"~~~\n" +"# service droonga-engine start\n" +"# service droonga-http-server start\n" +"~~~" msgstr "" msgid "" -"If you installed services manually, see [the manual installation tutorial](../" -"manual-install/#start-services)." +"If you set up your Droonga nodes manually, see [the manual installation tutori" +"al](../manual-install/#start-services) to know how to start daemons." msgstr "" +"Droongaノードを手動でセットアップした場合のデーモンの起動方法は、[手動インストールの手順の説明](../manual-install/#start-" +"services)を参照して下さい。" msgid "" -"By the command two nodes construct a cluster and they monitor each other.\n" +"By these commands, services start to work.\n" +"Now two nodes construct a cluster and they monitor each other.\n" "If one of nodes dies and there is any still alive node, survivor(s) will work " "as the Droonga cluster.\n" "Then you can recover the dead node and re-join it to the cluster secretly." msgstr "" -"このコマンドにより、2つのノードはクラスタを形成し、互いの生死を監視するようになります。もしクラスタ内のどれか1つのノードが機能を停止し、他のノードがまだ機" -"能し続けていた場合には、残ったノードがDroongaクラスタとして動作し続けます。そのため、そのような事態が起こっても秘密裏に、機能停止したノードを復旧した" -"りクラスタに復帰させたりすることができます。" +"これらのコマンドにより、各サービスが動作し始めます。\n" +"これで、2つのノードは1つのクラスタを形成し、お互いの状態を監視し合う状態になりました。\n" +"もしノードが1つ停止しても、他のノードが生存していれば、それらの生存ノードだけでDroongaクラスタは動作し続けます。\n" +"ですので、秘密裏のうちに機能停止したノードを復旧したりクラスタに復帰させたりすることができます。" msgid "" -"Let's make sure that the cluster works, by the `system.status` command.\n" +"Let's make sure that the cluster works, by a Droonga command, `system.status`." +"\n" "You can see the result via HTTP, like:" msgstr "" "クラスタが動作している事を、`system.status` コマンドを使って確認してみましょう。\n" @@ -269,13 +470,13 @@ msgstr "" msgid "" "~~~\n" -"# curl \"http://192.168.100.50:10041/droonga/system/status\" | jq \".\"\n" +"$ curl \"http://node0:10041/droonga/system/status\" | jq \".\"\n" "{\n" " \"nodes\": {\n" -" \"192.168.100.50:10031/droonga\": {\n" +" \"node0:10031/droonga\": {\n" " \"live\": true\n" " },\n" -" \"192.168.100.51:10031/droonga\": {\n" +" \"node1:10031/droonga\": {\n" " \"live\": true\n" " }\n" " }\n" @@ -292,13 +493,13 @@ msgstr "" msgid "" "~~~\n" -"# curl \"http://192.168.100.51:10041/droonga/system/status\" | jq \".\"\n" +"$ curl \"http://node1:10041/droonga/system/status\" | jq \".\"\n" "{\n" " \"nodes\": {\n" -" \"192.168.100.50:10031/droonga\": {\n" +" \"node0:10031/droonga\": {\n" " \"live\": true\n" " },\n" -" \"192.168.100.51:10031/droonga\": {\n" +" \"node1:10031/droonga\": {\n" " \"live\": true\n" " }\n" " }\n" @@ -310,14 +511,18 @@ msgid "To stop services, run commands like following on each Droonga node:" msgstr "サービスを停止するには、以下のコマンドを各Droongaノード上で実行します：" msgid "" -" # service droonga-engine stop\n" -" # service droonga-http-server stop" +"~~~\n" +"# service droonga-engine stop\n" +"# service droonga-http-server stop\n" +"~~~" msgstr "" msgid "" -"If you installed services manually, see [the manual installation tutorial](../" -"manual-install/#stop-services)." +"If you set up your Droonga nodes manually, see [the manual installation tutori" +"al](../manual-install/#stop-services) to know how to stop daemons." msgstr "" +"Droongaノードを手動でセットアップした場合のデーモンの停止方法は、[手動インストールの手順の説明](../manual-install/#stop-s" +"ervices)を参照して下さい。" msgid "After verification, start services again, on each Droonga node." msgstr "確認が終わったら、再度サービスを起動しておきましょう：" @@ -325,8 +530,10 @@ msgstr "確認が終わったら、再度サービスを起動しておきまし msgid "### Create a table, columns, and indexes" msgstr "### テーブル、カラム、インデックスの作成" -msgid "Now your Droonga cluster actually works as a Groonga's HTTP server." -msgstr "以上の手順で、Groonga HTTPサーバ互換のサービスとして動作するDroongaクラスタができました。" +msgid "" +"Now your Droonga cluster actually works as an HTTP server compatible to Groong" +"a's HTTP server." +msgstr "以上の手順で、Groonga HTTPサーバ互換のHTTPサーバとして動作するDroongaクラスタができました。" msgid "" "Requests are completely same to ones for a Groonga server.\n" @@ -338,8 +545,8 @@ msgstr "" msgid "" "~~~\n" -"# endpoint=\"http://192.168.100.50:10041\"\n" -"# curl \"$endpoint/d/table_create?name=Store&flags=TABLE_PAT_KEY&key_type=Short" +"$ endpoint=\"http://node0:10041\"\n" +"$ curl \"$endpoint/d/table_create?name=Store&flags=TABLE_PAT_KEY&key_type=Short" "Text\" | jq \".\"\n" "[\n" " [\n" @@ -370,7 +577,7 @@ msgstr "次は、`column_create` コマンドを使って `Store` テーブル msgid "" "~~~\n" -"# curl \"$endpoint/d/column_create?table=Store&name=name&flags=COLUMN_SCALAR&ty" +"$ curl \"$endpoint/d/column_create?table=Store&name=name&flags=COLUMN_SCALAR&ty" "pe=ShortText\" | jq \".\"\n" "[\n" " [\n" @@ -380,7 +587,7 @@ msgid "" " ],\n" " true\n" "]\n" -"# curl \"$endpoint/d/column_create?table=Store&name=location&flags=COLUMN_SCALA" +"$ curl \"$endpoint/d/column_create?table=Store&name=location&flags=COLUMN_SCALA" "R&type=WGS84GeoPoint\" | jq \".\"\n" "[\n" " [\n" @@ -398,7 +605,7 @@ msgstr "インデックスも作成しましょう。" msgid "" "~~~\n" -"# curl \"$endpoint/d/table_create?name=Term&flags=TABLE_PAT_KEY&key_type=ShortT" +"$ curl \"$endpoint/d/table_create?name=Term&flags=TABLE_PAT_KEY&key_type=ShortT" "ext&default_tokenizer=TokenBigram&normalizer=NormalizerAuto\" | jq \".\"\n" "[\n" " [\n" @@ -408,7 +615,7 @@ msgid "" " ],\n" " true\n" "]\n" -"# curl \"$endpoint/d/column_create?table=Term&name=store_name&flags=COLUMN_INDE" +"$ curl \"$endpoint/d/column_create?table=Term&name=store_name&flags=COLUMN_INDE" "X|WITH_POSITION&type=Store&source=name\" | jq \".\"\n" "[\n" " [\n" @@ -418,7 +625,7 @@ msgid "" " ],\n" " true\n" "]\n" -"# curl \"$endpoint/d/table_create?name=Location&flags=TABLE_PAT_KEY&key_type=WG" +"$ curl \"$endpoint/d/table_create?name=Location&flags=TABLE_PAT_KEY&key_type=WG" "S84GeoPoint\" | jq \".\"\n" "[\n" " [\n" @@ -428,7 +635,7 @@ msgid "" " ],\n" " true\n" "]\n" -"# curl \"$endpoint/d/column_create?table=Location&name=store&flags=COLUMN_INDEX" +"$ curl \"$endpoint/d/column_create?table=Location&name=store&flags=COLUMN_INDEX" "&type=Store&source=location\" | jq \".\"\n" "[\n" " [\n" @@ -461,7 +668,7 @@ msgstr "" msgid "" "~~~\n" -"# curl \"$endpoint/d/table_list\" | jq \".\"\n" +"$ curl \"$endpoint/d/table_list\" | jq \".\"\n" "[\n" " [\n" " 0,\n" @@ -523,7 +730,7 @@ msgstr "Droongaはクラスタで動作するので、他のエンドポイン msgid "" "~~~\n" -"# curl \"http://192.168.100.51:10041/d/table_list\" | jq \".\"\n" +"$ curl \"http://node1:10041/d/table_list\" | jq \".\"\n" "[\n" " [\n" " 0,\n" @@ -652,7 +859,7 @@ msgstr "データが準備できたら、`load` コマンドのPOSTリクエス msgid "" "~~~\n" -"# curl --data \"@stores.json\" \"$endpoint/d/load?table=Store\" | jq \".\"\n" +"$ curl --data \"@stores.json\" \"$endpoint/d/load?table=Store\" | jq \".\"\n" "[\n" " [\n" " 0,\n" @@ -680,7 +887,7 @@ msgstr "試しに、`select` コマンドを使って最初の10レコードを msgid "" "~~~\n" -"# curl \"$endpoint/d/select?table=Store&output_columns=name&limit=10\" | jq \".\"\n" +"$ curl \"$endpoint/d/select?table=Store&output_columns=name&limit=10\" | jq \".\"\n" "[\n" " [\n" " 0,\n" @@ -739,7 +946,7 @@ msgstr "もちろん、`query` オプションを使って検索条件を指定 msgid "" "~~~\n" -"# curl \"$endpoint/d/select?table=Store&query=Columbus&match_columns=name&outpu" +"$ curl \"$endpoint/d/select?table=Store&query=Columbus&match_columns=name&outpu" "t_columns=name&limit=10\" | jq \".\"\n" "[\n" " [\n" @@ -767,7 +974,7 @@ msgid "" " ]\n" " ]\n" "]\n" -"# curl \"$endpoint/d/select?table=Store&filter=name@'Ave'&output_columns=name&l" +"$ curl \"$endpoint/d/select?table=Store&filter=name@'Ave'&output_columns=name&l" "imit=10\" | jq \".\"\n" "[\n" " [\n" Modified: ja/tutorial/1.0.6/groonga/index.md (+178 -78) =================================================================== --- ja/tutorial/1.0.6/groonga/index.md 2014-09-24 00:36:04 +0900 (cbfa911) +++ ja/tutorial/1.0.6/groonga/index.md 2014-09-24 01:47:00 +0900 (e970fe9) @@ -36,86 +36,177 @@ Droongaは分散アーキテクチャに基づくデータ処理エンジンで ## Droongaクラスタをセットアップする -### 実験用の環境を準備する +Droongaベースのデータベースシステムは、*Droongaクラスタ*と呼ばれます。 +この節では、Droongaクラスタを0から構築する方法を解説します。 + +### Droongaノード用のコンピュータを用意する + +Droongaクラスタは、*Droongaノード*と呼ばれる1つ以上のコンピュータによって構成されます。 +まず、Droongaノードにするためのコンピュータを用意しましょう。 -まず最初にコンピュータを用意します。 このチュートリアルは、既存のコンピュータを使ってDroongaクラスタを構築する手順について解説しています。 -以下の説明は基本的には、[DigitalOcean](https://www.digitalocean.com/)上のサーバで`Ubuntu 13.10 x64`または`CentOS 6.5 x64`の仮想マシンが正しく準備されており、コンソールが利用できる状態になっている、という前提に基づいています。 +以下の説明は基本的には、[DigitalOcean](https://www.digitalocean.com/)上のサーバで`Ubuntu 14.04 x64`または`CentOS 7 x64`の仮想マシンが正しく準備されており、コンソールが利用できる状態になっている、という前提に基づいています。 -注意：Droongaの依存パッケージをインストールする前に、仮想マシンのインスタンスが少なくとも2GB以上のメモリを備えていることを確認して下さい。 -メモリが足りないと、ビルド時におかしなエラーに遭遇することになります。 +注意: -また、有効なレプリケーションを実現するためには2台以上のコンピュータを用意する必要もあります。 + * Make sure to use instances with >= 2GB memory equipped, at least during installation of required packages for Droonga. + Otherwise, you may experience a strange build error. + * Make sure the hostname reported by `hostname -f` or the IP address reported by `hostname -i` have to be accessible from each other computer in your cluster. -### Droongaの構成コンポーネントをインストールする +有効なレプリケーションを実現するためには2台以上のコンピュータを用意する必要があります。 +ですので、このチュートリアルでは以下のような2台のコンピュータがあると仮定して説明を進めます: -Droongaベースのデータベースシステムは、*Droongaクラスタ*と呼ばれます。 -Droongaクラスタは、*Droongaノード*と呼ばれる複数のコンピュータによって構成されます。 -よって、Droongaクラスタを構築するには複数のDroongaノードをセットアップする必要があります。 + * IPアドレスが`192.168.100.50`で、ホスト名が`node0`であるコンピュータ。 + * IPアドレスが`192.168.100.51`で、ホスト名が`node1`であるコンピュータ。 -`192.168.100.50`と`192.168.100.51`の2つのコンピュータがあると仮定しましょう。 +## コンピュータをDroongaノードとしてセットアップする Groongaはバイナリのパッケージを提供しているため、環境によっては簡単にインストールできます。 （[Groongaのインストール手順](http://groonga.org/docs/install.html)を参照） -On the other hand, there is an installation script to set up a database system based on Droonga. -If you are using a Ubuntu, Debian, or a CentOS 7 (and later) server, download the script and run it by `bash`, as the root user, like: +それに対し、コンピュータをDroongaノードとしてセットアップする手順は以下の通りです: -~~~ -(on 192.168.100.50) -$ curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install.sh | \ - sudo HOST=192.168.100.50 bash -$ curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/install.sh | \ - sudo ENGINE_HOST=192.168.100.50 HOST=192.168.100.50 bash + 1. `droonga-engine`をインストールする。 + 2. `droonga-http-server`をインストールする。 + 3. そのノードを他のノードと協調して動作するように設定する。 -(on 192.168.100.51) -$ curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install.sh | \ - sudo HOST=192.168.100.51 bash -$ curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/install.sh | \ - sudo ENGINE_HOST=192.168.100.51 HOST=192.168.100.51 bash -~~~ +上記の手順を各コンピュータに対して実施する必要があることに注意して下さい。 +しかしながら、各手順は非常に簡単です。 -or: +それでは、`node0` (`192.168.100.50`)にログインしてDroongaの構成コンポーネントをインストールしましょう。 + +まず、`droonga-engine`をインストールします。 +これはDroongaシステムの主要な機能を提供する、核となるコンポーネントです。 +インストールスクリプトをダウンロードし、root権限で`bash`で実行して下さい: ~~~ -(on 192.168.100.50) -$ su # curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install.sh | \ - HOST=192.168.100.50 bash + bash +... +Installing droonga-engine from RubyGems... +... +Preparing the user... +... +Setting up the configuration directory... +This node is configured with a hostname XXXXXXXX. + +Registering droonga-engine as a service... +... +Successfully installed droonga-engine. +~~~ + +そのノード自身の名前（コンピュータのホスト名から推測されたもの）がメッセージの中に出力されていることに注意して下さい。 +*この名前は様々な場面で使われます*ので、*各ノードの名前が何であるかを忘れないようにして下さい* + +次に、`droonga-http-server`をインストールします。 +これはHTTPのリクエストをDroongaネイティブのリクエストに変換するために必要な、フロントエンドとなるコンポーネントです。 +インストールスクリプトをダウンロードし、root権限で`bash`で実行して下さい: + +~~~ # curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/install.sh | \ - ENGINE_HOST=192.168.100.50 HOST=192.168.100.50 bash + bash +... +Installing droonga-http-server from npmjs.org... +... +Preparing the user... +... +Setting up the configuration directory... +The droonga-engine service is detected on this node. +The droonga-http-server is configured to be connected +to this node (XXXXXXXX). +This node is configured with a hostname XXXXXXXX. + +Registering droonga-http-server as a service... +... +Successfully installed droonga-http-server. +~~~ + +インストールスクリプトが期待通りに動作せずインストールできない場合は、[インストールスクリプトを使わない手動インストールの手順](../manual-install/)を参照して下さい。 + +ここまでの操作が終わったら、同じ操作をもう1台のコンピュータ `node1` (`192.168.100.51`) に対しても行います。 +これで、無事に2台のコンピュータをDroongaノードとして動作させるための準備が整いました。 + +### コンピュータが他のコンピュータからアクセスできるホスト名を持っていない場合…… {#accessible-host-name} + +各Droongaノードは、他のノードと通信するために、そのノード自身の*アクセス可能な名前*を把握している必要があります。 + +インストールスクリプトはそのノードのアクセス可能なホスト名を自動的に推測します。 +どのような値がそのノード自身のホストメイトして認識されたかは、以下の手順で確認できます: + +~~~ +# cat ~droonga-engine/droonga/droonga-engine.yaml | grep host +host: XXXXXXXX +~~~ + +しかしながら、そのコンピュータが適切に設定されていないと、この自動認識に失敗することがあります。 +例えば、そのノードのホスト名が`node0`であると設定されているにも関わらず、他のノードが`node0`というホスト名から実際のIPアドレスを名前解決できないと、そのノードは他のノードから送られてくるメッセージを何も受信することができません。 -(on 192.168.100.51) -$ su +そのような場合、以下のようにして、そのノード自身のIPアドレスを使ってノードを再設定する必要があります: + +~~~ +(on node0=192.168.100.50) +# host=192.168.100.50 +# droonga-engine-configure --quiet --reset-config --reset-catalog \ + --host=$host +# droonga-http-server-configure --quiet --reset-config \ + --droonga-engine-host-name=$host \ + --receive-host-name=$host + +(on node1=192.168.100.51) +# host=192.168.100.51 +... +~~~ + +この操作により、コンピュータ `node0` は `192.168.100.50` というホスト名のDroongaノード、コンピュータ `node1` は `192.168.100.51` というホスト名のDroongaノードとして設定されます。 +前述した通り、*ここで設定された名前は様々な場面で使われます*ので、*各ノードの名前が何であるかを忘れないようにして下さい*。 + +このチュートリアルでは、各コンピュータはお互いのホスト名`node0`と`node1`を正しく名前解決できるものと仮定します。 +あなたの環境ではホスト名の解決ができないという場合には、以下の説明の中の`node0`と`node1`は、実際のIPアドレス（例えば`192.168.100.50`と`192.168.100.51`）に読み替えて下さい。 + +ちなみに、インストールスクリプトに対しても、以下のように、環境変数を使って任意の値をホスト名として指定することができます: + +~~~ +(on node0=192.168.100.50) +# host=192.168.100.50 # curl https://raw.githubusercontent.com/droonga/droonga-engine/master/install.sh | \ - HOST=192.168.100.51 bash + HOST=$host bash # curl https://raw.githubusercontent.com/droonga/droonga-http-server/master/install.sh | \ - ENGINE_HOST=192.168.100.51 HOST=192.168.100.51 bash + ENGINE_HOST=$host HOST=$host bash + +(on node1=192.168.100.51) +# host=192.168.100.51 +... ~~~ -And, let's configure these nodes to work together as a cluster: +この方法は、使おうとしているコンピュータがお互いのホスト名を名前解決できないことがあらかじめ分かっている場合に便利でしょう。 + +### 各ノードをクラスタとして動作するように設定する + +現時点で、これらのノードはまだ個別に動作する状態になっています。 +それでは、これらを1つのクラスタとして動作するように設定しましょう。 + +以下のようなコマンドを各ノードで実行して下さい: ~~~ -(on 192.168.100.50, 192.168.100.51) -$ sudo -u droonga-engine -H \ - droonga-engine-catalog-generate --hosts=192.168.100.50,192.168.100.51 \ - --output=~droonga-engine/droonga/catalog.json +# droonga-engine-catalog-generate --hosts=node0,node1 \ + --output=~droonga-engine/droonga/catalog.json +# chown droogna-engine:droonga-engine ~droonga-engine/droonga/catalog.json ~~~ -or: +当然ながら、`--hosts`オプションには各ノードの正しいホスト名を指定する必要があります。 +もしこれらのノードがIPアドレスをホスト名として設定されている場合には、コマンド列は以下のようになります: ~~~ -(on 192.168.100.50, 192.168.100.51) -$ su # droonga-engine-catalog-generate --hosts=192.168.100.50,192.168.100.51 \ --output=~droonga-engine/droonga/catalog.json -# chown droogna-engine:droonga-engine ~droonga-engine/droonga/catalog.json +... ~~~ -OK, now your Droonga cluster is correctly prepared. -Let's continue to [the next step, "how to use the cluster"](#use). +これで、Droongaクラスタの準備が完了しました。 +2つのノードは1つのDroongaクラスタとして動作するための準備が完了しています。 + +引き続き、[クラスタの使い方の説明](#use)に進みましょう。 -If the installation script doesn't work on your platform, see [the tutorial to install services without installation script](../manual-install/). ## DroongaクラスタをHTTP経由で使用する @@ -123,31 +214,38 @@ If the installation script doesn't work on your platform, see [the tutorial to i GroongaをHTTPサーバとして使う場合は、以下のように `-d` オプションを指定するだけでサーバを起動できます： - # groonga -p 10041 -d --protocol http /tmp/databases/db +~~~ +# groonga -p 10041 -d --protocol http /tmp/databases/db +~~~ -一方、DroongaクラスタをHTTP経由で使うためには、各Droongaノードにおいて複数のサービスを起動する必要があります。 +一方、DroongaクラスタをHTTP経由で使うためには、各Droongaノードにおいて複数のサーバ・デーモンを起動する必要があります。 -If services are installed by the installation script, they are already been configured as system services managed via the `service` command. -To start them, run commands like following on each Droonga node: +Droongaノードをインストールスクリプトを使ってセットアップした場合、デーモンは既に、`service`コマンドによって管理されるシステムのサービスとして設定されています。 +サービスを起動するには、以下のようなコマンドを各Droongaノードで実行して下さい: - # service droonga-engine start - # service droonga-http-server start +~~~ +# service droonga-engine start +# service droonga-http-server start +~~~ -If you installed services manually, see [the manual installation tutorial](../manual-install/#start-services). +Droongaノードを手動でセットアップした場合のデーモンの起動方法は、[手動インストールの手順の説明](../manual-install/#start-services)を参照して下さい。 -このコマンドにより、2つのノードはクラスタを形成し、互いの生死を監視するようになります。もしクラスタ内のどれか1つのノードが機能を停止し、他のノードがまだ機能し続けていた場合には、残ったノードがDroongaクラスタとして動作し続けます。そのため、そのような事態が起こっても秘密裏に、機能停止したノードを復旧したりクラスタに復帰させたりすることができます。 +これらのコマンドにより、各サービスが動作し始めます。 +これで、2つのノードは1つのクラスタを形成し、お互いの状態を監視し合う状態になりました。 +もしノードが1つ停止しても、他のノードが生存していれば、それらの生存ノードだけでDroongaクラスタは動作し続けます。 +ですので、秘密裏のうちに機能停止したノードを復旧したりクラスタに復帰させたりすることができます。 クラスタが動作している事を、`system.status` コマンドを使って確認してみましょう。 コマンドはHTTP経由で実行できます: ~~~ -# curl "http://192.168.100.50:10041/droonga/system/status" | jq "." +$ curl "http://node0:10041/droonga/system/status" | jq "." { "nodes": { - "192.168.100.50:10031/droonga": { + "node0:10031/droonga": { "live": true }, - "192.168.100.51:10031/droonga": { + "node1:10031/droonga": { "live": true } } @@ -158,13 +256,13 @@ If you installed services manually, see [the manual installation tutorial](../ma Droongaはクラスタで動作するので、他のエンドポイントも同じ結果を返します。 ~~~ -# curl "http://192.168.100.51:10041/droonga/system/status" | jq "." +$ curl "http://node1:10041/droonga/system/status" | jq "." { "nodes": { - "192.168.100.50:10031/droonga": { + "node0:10031/droonga": { "live": true }, - "192.168.100.51:10031/droonga": { + "node1:10031/droonga": { "live": true } } @@ -173,23 +271,25 @@ Droongaはクラスタで動作するので、他のエンドポイントも同 サービスを停止するには、以下のコマンドを各Droongaノード上で実行します： - # service droonga-engine stop - # service droonga-http-server stop +~~~ +# service droonga-engine stop +# service droonga-http-server stop +~~~ -If you installed services manually, see [the manual installation tutorial](../manual-install/#stop-services). +Droongaノードを手動でセットアップした場合のデーモンの停止方法は、[手動インストールの手順の説明](../manual-install/#stop-services)を参照して下さい。 確認が終わったら、再度サービスを起動しておきましょう： ### テーブル、カラム、インデックスの作成 -以上の手順で、Groonga HTTPサーバ互換のサービスとして動作するDroongaクラスタができました。 +以上の手順で、Groonga HTTPサーバ互換のHTTPサーバとして動作するDroongaクラスタができました。 リクエストの送信方法はGroongaサーバの場合と全く同じです。 新しいテーブル `Store` を作るには、`table_create` コマンドにあたるGETリクエストを送信して下さい: ~~~ -# endpoint="http://192.168.100.50:10041" -# curl "$endpoint/d/table_create?name=Store&flags=TABLE_PAT_KEY&key_type=ShortText" | jq "." +$ endpoint="http://node0:10041" +$ curl "$endpoint/d/table_create?name=Store&flags=TABLE_PAT_KEY&key_type=ShortText" | jq "." [ [ 0, @@ -208,7 +308,7 @@ If you installed services manually, see [the manual installation tutorial](../ma 次は、`column_create` コマンドを使って `Store` テーブルに `name` と `location` という新しいカラムを作ります: ~~~ -# curl "$endpoint/d/column_create?table=Store&name=name&flags=COLUMN_SCALAR&type=ShortText" | jq "." +$ curl "$endpoint/d/column_create?table=Store&name=name&flags=COLUMN_SCALAR&type=ShortText" | jq "." [ [ 0, @@ -217,7 +317,7 @@ If you installed services manually, see [the manual installation tutorial](../ma ], true ] -# curl "$endpoint/d/column_create?table=Store&name=location&flags=COLUMN_SCALAR&type=WGS84GeoPoint" | jq "." +$ curl "$endpoint/d/column_create?table=Store&name=location&flags=COLUMN_SCALAR&type=WGS84GeoPoint" | jq "." [ [ 0, @@ -231,7 +331,7 @@ If you installed services manually, see [the manual installation tutorial](../ma インデックスも作成しましょう。 ~~~ -# curl "$endpoint/d/table_create?name=Term&flags=TABLE_PAT_KEY&key_type=ShortText&default_tokenizer=TokenBigram&normalizer=NormalizerAuto" | jq "." +$ curl "$endpoint/d/table_create?name=Term&flags=TABLE_PAT_KEY&key_type=ShortText&default_tokenizer=TokenBigram&normalizer=NormalizerAuto" | jq "." [ [ 0, @@ -240,7 +340,7 @@ If you installed services manually, see [the manual installation tutorial](../ma ], true ] -# curl "$endpoint/d/column_create?table=Term&name=store_name&flags=COLUMN_INDEX|WITH_POSITION&type=Store&source=name" | jq "." +$ curl "$endpoint/d/column_create?table=Term&name=store_name&flags=COLUMN_INDEX|WITH_POSITION&type=Store&source=name" | jq "." [ [ 0, @@ -249,7 +349,7 @@ If you installed services manually, see [the manual installation tutorial](../ma ], true ] -# curl "$endpoint/d/table_create?name=Location&flags=TABLE_PAT_KEY&key_type=WGS84GeoPoint" | jq "." +$ curl "$endpoint/d/table_create?name=Location&flags=TABLE_PAT_KEY&key_type=WGS84GeoPoint" | jq "." [ [ 0, @@ -258,7 +358,7 @@ If you installed services manually, see [the manual installation tutorial](../ma ], true ] -# curl "$endpoint/d/column_create?table=Location&name=store&flags=COLUMN_INDEX&type=Store&source=location" | jq "." +$ curl "$endpoint/d/column_create?table=Location&name=store&flags=COLUMN_INDEX&type=Store&source=location" | jq "." [ [ 0, @@ -275,7 +375,7 @@ If you installed services manually, see [the manual installation tutorial](../ma `table_list` コマンドを使って、作成されたテーブルの情報を見てみましょう: ~~~ -# curl "$endpoint/d/table_list" | jq "." +$ curl "$endpoint/d/table_list" | jq "." [ [ 0, @@ -334,7 +434,7 @@ If you installed services manually, see [the manual installation tutorial](../ma Droongaはクラスタで動作するので、他のエンドポイントも同じ結果を返します。 ~~~ -# curl "http://192.168.100.51:10041/d/table_list" | jq "." +$ curl "http://node1:10041/d/table_list" | jq "." [ [ 0, @@ -446,7 +546,7 @@ stores.json: データが準備できたら、`load` コマンドのPOSTリクエストとして送信します: ~~~ -# curl --data "@stores.json" "$endpoint/d/load?table=Store" | jq "." +$ curl --data "@stores.json" "$endpoint/d/load?table=Store" | jq "." [ [ 0, @@ -468,7 +568,7 @@ stores.json: 試しに、`select` コマンドを使って最初の10レコードを取り出してみましょう: ~~~ -# curl "$endpoint/d/select?table=Store&output_columns=name&limit=10" | jq "." +$ curl "$endpoint/d/select?table=Store&output_columns=name&limit=10" | jq "." [ [ 0, @@ -524,7 +624,7 @@ stores.json: もちろん、`query` オプションを使って検索条件を指定する事もできます: ~~~ -# curl "$endpoint/d/select?table=Store&query=Columbus&match_columns=name&output_columns=name&limit=10" | jq "." +$ curl "$endpoint/d/select?table=Store&query=Columbus&match_columns=name&output_columns=name&limit=10" | jq "." [ [ 0, @@ -551,7 +651,7 @@ stores.json: ] ] ] -# curl "$endpoint/d/select?table=Store&filter=name@'Ave'&output_columns=name&limit=10" | jq "." +$ curl "$endpoint/d/select?table=Store&filter=name@'Ave'&output_columns=name&limit=10" | jq "." [ [ 0, Modified: tutorial/1.0.6/groonga/index.md (+10 -10) Mode: 100644 -> 100755 =================================================================== --- tutorial/1.0.6/groonga/index.md 2014-09-24 00:36:04 +0900 (2a434a1) +++ tutorial/1.0.6/groonga/index.md 2014-09-24 01:47:00 +0900 (1eea4d9) @@ -42,8 +42,7 @@ NOTE: * Make sure to use instances with >= 2GB memory equipped, at least during installation of required packages for Droonga. Otherwise, you may experience a strange build error. - * Make sure the hostname reported by `hostname -f` or the IP address reported by `hostname -i` is correctly accessible from each other computer in your cluster. - For simplicity, + * Make sure the hostname reported by `hostname -f` or the IP address reported by `hostname -i` have to be accessible from each other computer in your cluster. You need to prepare two or more nodes for effective replication. So this tutorial assumes that you have two computers: @@ -56,11 +55,11 @@ So this tutorial assumes that you have two computers: Groonga provides binary packages and you can install Groonga easily, for some environments. (See: [how to install Groonga](http://groonga.org/docs/install.html)) -On the other hand, steps to set up computers as Droonga nodes are: +On the other hand, steps to set up a computer as a Droonga node are: - 1. Install the `droonga-engine` *on each computer*. - 2. Install the `droonga-http-server` *on each computer*. - 3. Configure *each computer* to work together with each other. + 1. Install the `droonga-engine`. + 2. Install the `droonga-http-server`. + 3. Configure the node to work together with other nodes. Note that you must do all steps on each computer. However, they're very simple. @@ -113,10 +112,11 @@ Registering droonga-http-server as a service... Successfully installed droonga-http-server. ~~~ -OK, now two computers successfully prepared to work as Droonga nodes. - If installation scripts didn't work as expected and you couldn't install them, see [the tutorial to install services without installation script](../manual-install/). +After that, do same operations on another computer `node1` (`192.168.100.51`) also. +Then two computers successfully prepared to work as Droonga nodes. + ### When your computers don't have a host name accessible from other computers... {#accessible-host-name} Each Droonga node must know the *accessible host name* of the node itself, to communicate with other nodes. @@ -219,7 +219,7 @@ To start them, run commands like following on each Droonga node: # service droonga-http-server start ~~~ -If you set up your Droonga nodes manually, see [the manual installation tutorial](../manual-install/#start-services). +If you set up your Droonga nodes manually, see [the manual installation tutorial](../manual-install/#start-services) to know how to start daemons. By these commands, services start to work. Now two nodes construct a cluster and they monitor each other. @@ -267,7 +267,7 @@ To stop services, run commands like following on each Droonga node: # service droonga-http-server stop ~~~ -If you set up your Droonga nodes manually, see [the manual installation tutorial](../manual-install/#stop-services). +If you set up your Droonga nodes manually, see [the manual installation tutorial](../manual-install/#stop-services) to know how to stop daemons. After verification, start services again, on each Droonga node. -------------- next part -------------- HTML����������������������������...Download