YUKI Hiroshi
null+****@clear*****
Thu Apr 30 19:50:43 JST 2015
YUKI Hiroshi 2015-04-30 19:50:43 +0900 (Thu, 30 Apr 2015) New Revision: dc9a28d9f9d75cc11809bf43c330400aac58b5ed https://github.com/droonga/droonga.org/commit/dc9a28d9f9d75cc11809bf43c330400aac58b5ed Message: Feedback command line tools reference for 1.1.1 to 1.1.0 Added files: _po/ja/reference/1.1.0/command-line-tools/droonga-add/index.po _po/ja/reference/1.1.0/command-line-tools/droonga-system-status/index.po _po/ja/reference/1.1.0/command-line-tools/index.po ja/reference/1.1.0/command-line-tools/droonga-add/index.md ja/reference/1.1.0/command-line-tools/droonga-system-status/index.md ja/reference/1.1.0/command-line-tools/index.md reference/1.1.0/command-line-tools/droonga-add/index.md reference/1.1.0/command-line-tools/droonga-system-status/index.md reference/1.1.0/command-line-tools/index.md Modified files: _po/ja/reference/1.1.0/index.po ja/reference/1.1.0/index.md reference/1.1.0/index.md Added: _po/ja/reference/1.1.0/command-line-tools/droonga-add/index.po (+211 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/1.1.0/command-line-tools/droonga-add/index.po 2015-04-30 19:50:43 +0900 (22287db) @@ -0,0 +1,211 @@ +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"PO-Revision-Date: 2014-11-30 23:19+0900\n" +"Language: ja\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +msgid "" +"---\n" +"title: droonga-add\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: droonga-add\n" +"layout: ja\n" +"---" + +msgid "" +"* TOC\n" +"{:toc}" +msgstr "" + +msgid "## Abstract {#abstract}" +msgstr "## 概要 {#abstract}" + +msgid "" +"`droonga-add` adds a new record or updates an existing record, to the specifie" +"d table in a Droonga cluster." +msgstr "`droonga-add`は、Droongaクラスタ内の指定されたテーブルについて、新しいレコードの追加および既存レコードの更新を行います。" + +msgid "" +"For example, if there is a Droonga node `192.168.100.50` and you are logged in" +" to a computer `192.168.100.10` in the same network segment, the command line " +"to add a new record to the table `User` in the cluster is:" +msgstr "" +"例えば、`192.168.100.50`というDroongaノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログイ" +"ンしている場合、クラスタ内の`User`テーブルにレコードを1つ追加するコマンド列は以下のようになります：" + +msgid "" +"~~~\n" +"(on 192.168.100.10)\n" +"$ droonga-add --host 192.168.100.50 --receiver-host 192.168.100.10 \\\n" +" --table User --key id1 --name Adam --age 20\n" +"~~~" +msgstr "" + +msgid "" +"This command is just a shorthand of [`droonga-request`](../droonga-request/) w" +"ith a message with the type [`add`](../../commands/add/).\n" +"The result produced by the following command line completely equals to the one" +" of above:" +msgstr "" +"このコマンドは、typeが[`add`](../../commands/add/)であるメッセージを[`droonga-request`](../droon" +"ga-request/)を用いて送信する操作を簡単に行う物です。\n" +"上記コマンド列によってもたらされる結果は、以下のコマンド列の結果と完全に同一です:" + +msgid "" +"~~~\n" +"(on 192.168.100.10)\n" +"$ echo '{\"type\":\"key\",\"key\":\"id1\",\"values\":{\"name\":\"Adam\",\"age\":20}}' |\n" +" droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10\n" +"~~~" +msgstr "" + +msgid "See also [the reference of the `add` command](../../commands/add/)." +msgstr "[`add`コマンドのリファレンス](../../commands/add/)も併せて参照して下さい。" + +msgid "## Parameters {#parameters}" +msgstr "## パラメータ {#parameters}" + +msgid "" +"`--table=TABLE` *(required)*\n" +": Name of the target table." +msgstr "" +"`--table=TABLE` *(必須)*\n" +": レコードを追加するテーブルの名前。" + +msgid "" +"`--key=KEY`\n" +": A unique key of the adding or updating record." +msgstr "" +"`--key=KEY`\n" +": 追加または更新するレコードの一意なキー。" + +msgid "" +"`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)`\n" +": Value of the column for the record.\n" +" Columns with names same to other existing parameter like `host` must be spec" +"ified with the prefix `--value:`." +msgstr "" +"`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)`\n" +": レコードのカラムの値。\n" +" `host`のように既存の他のパラメータと同じ名前のカラムの値を指定する場合は、`--value:`という接頭辞を付ける必要があります。" + +msgid "" +"`--host=NAME`\n" +": Host name of the engine node.\n" +" A guessed host name of the computer you are running the command, by default." +msgstr "" +"`--host=NAME`\n" +": メッセージの送信先となるEngineノードのホスト名。\n" +" 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。" + +msgid "" +"`--port=PORT`\n" +": Port number to communicate with the engine.\n" +" `10031` by default." +msgstr "" +"`--port=PORT`\n" +": Engineノードとの通信に使うポート番号。\n" +" 既定値は`10031`です。" + +msgid "" +"`--tag=TAG`\n" +": Tag name to communicate with the engine.\n" +" `droonga` by default." +msgstr "" +"`--tag=TAG`\n" +": Engineノードとの通信に使うタグ名。\n" +" 既定値は`droonga`です。" + +msgid "" +"`--dataset=NAME`\n" +": Dataset name for the sending message.\n" +" `Default` by default." +msgstr "" +"`--dataset=NAME`\n" +": メッセージの送信先データセット名。\n" +" 既定値は`Default`です。" + +msgid "" +"`--receiver-host=NAME`\n" +": Host name of the computer you are running the command.\n" +" A guessed host name of the computer, by default." +msgstr "" +"`--receiver-host=NAME`\n" +": コマンドを実行しているコンピュータのホスト名。\n" +" 既定値は、そのコンピュータのホスト名として推測される名前です。" + +msgid "" +"`--target-role=ROLE`\n" +": Role of engine nodes which should process the message.\n" +" Possible values:" +msgstr "" +"`--target-role=ROLE`\n" +": メッセージを処理できるEngineノードのロール。\n" +" 以下のいずれかを指定します:" + +msgid "" +" * `service-provider`:\n" +" The message is processed by service provider nodes in the cluster.\n" +" For absorb-source nodes and absrob-destination nodes, the message will be " +"dispatched later.\n" +" * `absorb-source`:\n" +" The message is processed by absorb-source nodes in the cluster.\n" +" For service provider nodes and absrob-destination nodes, the message is ne" +"ver dispatched.\n" +" * `absorb-destination`:\n" +" The message is processed by absorb-destination nodes in the cluster.\n" +" For service provider nodes and absrob-source nodes, the message is never d" +"ispatched.\n" +" * `any`:\n" +" The message is always processed by the node specified via the option `--ho" +"st`." +msgstr "" +" * `service-provider`:\n" +" メッセージは、クラスタ内でサービスを提供中のノードで処理されます。\n" +" データ抽出操作に関わるノードには、後から遅れてメッセージが伝搬します。\n" +" * `absorb-source`:\n" +" メッセージは、クラスタへのノード追加操作におけるデータコピー元となっているノードで処理されます。\n" +" サービスを提供中のノード、並びにデータコピー先となっているノードへは、メッセージは伝搬しません。\n" +" * `absorb-destination`:\n" +" メッセージは、クラスタへのノード追加操作におけるデータコピー先となっているノードで処理されます。\n" +" サービスを提供中のノード、並びにデータコピー元となっているノードへは、メッセージは伝搬しません。\n" +" * `any`:\n" +" メッセージは、`--host`で指定されたノードで処理されます。" + +msgid " `any` by default." +msgstr " 既定値は`any`です。" + +msgid "" +"`--timeout=SECONDS`\n" +": Time to terminate unresponsive connections, in seconds.\n" +" `3` by default." +msgstr "" +"`--timeout=SECONDS`\n" +": 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。\n" +" 既定値は`3`です。" + +msgid "" +"`-h`, `--help`\n" +": Shows the usage of the command." +msgstr "" +"`-h`, `--help`\n" +": コマンドの使い方の説明を表示します。" + +msgid "## How to install {#install}" +msgstr "## インストール方法 {#install}" + +msgid "This is installed as a part of a rubygems package `droonga-client`." +msgstr "このコマンドは、Rubygemsのパッケージ`droonga-client`の一部としてインストールされます。" + +msgid "" +"~~~\n" +"# gem install droonga-client\n" +"~~~" +msgstr "" Added: _po/ja/reference/1.1.0/command-line-tools/droonga-system-status/index.po (+193 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/1.1.0/command-line-tools/droonga-system-status/index.po 2015-04-30 19:50:43 +0900 (f9c1dcd) @@ -0,0 +1,193 @@ +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"PO-Revision-Date: 2014-11-30 23:19+0900\n" +"Language: ja\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +msgid "" +"---\n" +"title: droonga-system-status\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: droonga-system-status\n" +"layout: ja\n" +"---" + +msgid "" +"* TOC\n" +"{:toc}" +msgstr "" + +msgid "## Abstract {#abstract}" +msgstr "## 概要 {#abstract}" + +msgid "`droonga-system-status` reports current status of a Droonga cluster." +msgstr "`droonga-system-status`は、Droongaクラスタの現在の状態を報告します。" + +msgid "" +"For example, if there is a Droonga node `192.168.100.50` and you are logged in" +" to a computer `192.168.100.10` in the same network segment, the command line " +"to report status of the cluster is:" +msgstr "" +"例えば、`192.168.100.50`というDroongaノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログイ" +"ンしている場合、クラスタの状態を報告するコマンド列は以下のようになります：" + +msgid "" +"~~~\n" +"(on 192.168.100.10)\n" +"$ droonga-system-status --host 192.168.100.50 --receiver-host 192.168.100.10\n" +"~~~" +msgstr "" + +msgid "" +"This command is just a shorthand of [`droonga-request`](../droonga-request/) w" +"ith a message with the type [`system.status`](../../commands/system/status/).\n" +"The result produced by the following command line completely equals to the one" +" of above:" +msgstr "" +"このコマンドは、typeが[`system.status`](../../commands/system/status/)であるメッセージを[`droong" +"a-request`](../droonga-request/)を用いて送信する操作を簡単に行う物です。\n" +"上記コマンド列によってもたらされる結果は、以下のコマンド列の結果と完全に同一です:" + +msgid "" +"~~~\n" +"(on 192.168.100.10)\n" +"$ echo '{\"type\":\"system.status\"}' |\n" +" droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10\n" +"~~~" +msgstr "" + +msgid "" +"See also [the reference of the `system.status` command](../../commands/system/" +"status/)." +msgstr "[`system.status`コマンドのリファレンス](../../commands/system/status/)も併せて参照して下さい。" + +msgid "## Parameters {#parameters}" +msgstr "## パラメータ {#parameters}" + +msgid "" +"`--pretty`\n" +": Output result as a pretty print JSON." +msgstr "" +"`--pretty`\n" +": 結果をpretty print形式のJSONで出力します。" + +msgid "" +"`--host=NAME`\n" +": Host name of the engine node.\n" +" A guessed host name of the computer you are running the command, by default." +msgstr "" +"`--host=NAME`\n" +": メッセージの送信先となるEngineノードのホスト名。\n" +" 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。" + +msgid "" +"`--port=PORT`\n" +": Port number to communicate with the engine.\n" +" `10031` by default." +msgstr "" +"`--port=PORT`\n" +": Engineノードとの通信に使うポート番号。\n" +" 既定値は`10031`です。" + +msgid "" +"`--tag=TAG`\n" +": Tag name to communicate with the engine.\n" +" `droonga` by default." +msgstr "" +"`--tag=TAG`\n" +": Engineノードとの通信に使うタグ名。\n" +" 既定値は`droonga`です。" + +msgid "" +"`--dataset=NAME`\n" +": Dataset name for the sending message.\n" +" `Default` by default." +msgstr "" +"`--dataset=NAME`\n" +": メッセージの送信先データセット名。\n" +" 既定値は`Default`です。" + +msgid "" +"`--receiver-host=NAME`\n" +": Host name of the computer you are running the command.\n" +" A guessed host name of the computer, by default." +msgstr "" +"`--receiver-host=NAME`\n" +": コマンドを実行しているコンピュータのホスト名。\n" +" 既定値は、そのコンピュータのホスト名として推測される名前です。" + +msgid "" +"`--target-role=ROLE`\n" +": Role of engine nodes which should process the message.\n" +" Possible values:" +msgstr "" +"`--target-role=ROLE`\n" +": メッセージを処理できるEngineノードのロール。\n" +" 以下のいずれかを指定します:" + +msgid "" +" * `service-provider`:\n" +" The message is processed by service provider nodes in the cluster.\n" +" For absorb-source nodes and absrob-destination nodes, the message will be " +"dispatched later.\n" +" * `absorb-source`:\n" +" The message is processed by absorb-source nodes in the cluster.\n" +" For service provider nodes and absrob-destination nodes, the message is ne" +"ver dispatched.\n" +" * `absorb-destination`:\n" +" The message is processed by absorb-destination nodes in the cluster.\n" +" For service provider nodes and absrob-source nodes, the message is never d" +"ispatched.\n" +" * `any`:\n" +" The message is always processed by the node specified via the option `--ho" +"st`." +msgstr "" +" * `service-provider`:\n" +" メッセージは、クラスタ内でサービスを提供中のノードで処理されます。\n" +" データ抽出操作に関わるノードには、後から遅れてメッセージが伝搬します。\n" +" * `absorb-source`:\n" +" メッセージは、クラスタへのノード追加操作におけるデータコピー元となっているノードで処理されます。\n" +" サービスを提供中のノード、並びにデータコピー先となっているノードへは、メッセージは伝搬しません。\n" +" * `absorb-destination`:\n" +" メッセージは、クラスタへのノード追加操作におけるデータコピー先となっているノードで処理されます。\n" +" サービスを提供中のノード、並びにデータコピー元となっているノードへは、メッセージは伝搬しません。\n" +" * `any`:\n" +" メッセージは、`--host`で指定されたノードで処理されます。" + +msgid " `any` by default." +msgstr " 既定値は`any`です。" + +msgid "" +"`--timeout=SECONDS`\n" +": Time to terminate unresponsive connections, in seconds.\n" +" `3` by default." +msgstr "" +"`--timeout=SECONDS`\n" +": 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。\n" +" 既定値は`3`です。" + +msgid "" +"`-h`, `--help`\n" +": Shows the usage of the command." +msgstr "" +"`-h`, `--help`\n" +": コマンドの使い方の説明を表示します。" + +msgid "## How to install {#install}" +msgstr "## インストール方法 {#install}" + +msgid "This is installed as a part of a rubygems package `droonga-client`." +msgstr "このコマンドは、Rubygemsのパッケージ`droonga-client`の一部としてインストールされます。" + +msgid "" +"~~~\n" +"# gem install droonga-client\n" +"~~~" +msgstr "" Added: _po/ja/reference/1.1.0/command-line-tools/index.po (+89 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/1.1.0/command-line-tools/index.po 2015-04-30 19:50:43 +0900 (3328693) @@ -0,0 +1,89 @@ +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"PO-Revision-Date: 2014-11-30 23:19+0900\n" +"Language: ja\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +msgid "" +"---\n" +"title: Command line tools\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: コマンドラインツール\n" +"layout: ja\n" +"---" + +msgid "" +"Droonga provides some command line tools.\n" +"This section describes usage of them." +msgstr "" +"Droongaはいくつかのコマンドラインツールを提供しています。\n" +"このセクションでは、それらの使い方を説明しています。" + +msgid "## Communicating with Droonga cluster" +msgstr "## Droongaクラスタとの通信" + +msgid "" +" * [droonga-add](droonga-add/): Adds a new record to a cluster.\n" +" * [droonga-groonga](droonga-groonga/): Sends Groonga commands to a cluster.\n" +" * [droonga-system-status](droonga-system-status/): Reports status of members " +"in a cluster.\n" +" * [droonga-request](droonga-request/): Sends any message to a cluster and rep" +"orts the response.\n" +" * [droonga-send](droonga-send/): Sends any message to a cluster.\n" +" * [drndump](drndump/): Extracts all schema definitions and records from a clu" +"ster." +msgstr "" +" * [droonga-add](droonga-add/): クラスタに新しいレコードを追加します。\n" +" * [droonga-groonga](droonga-groonga/): クラスタにGroongaコマンドを送信します。\n" +" * [droonga-system-status](droonga-system-status/): クラスタ内のメンバーの状態を出力します。\n" +" * [droonga-request](droonga-request/): 任意のメッセージをクラスタに送信し、レスポンスを出力します。\n" +" * [droonga-send](droonga-send/): 任意のメッセージをクラスタに送信します。\n" +" * [drndump](drndump/): クラスタから全てのスキーマ定義およびレコードの情報を抽出します。" + +msgid "## Cluster management" +msgstr "## クラスタの管理" + +msgid "" +" * [droonga-engine-join](droonga-engine-join/): Adds a new replica node to a c" +"luster.\n" +" * [droonga-engine-unjoin](droonga-engine-unjoin/): Removes an existing replic" +"a node from a cluster.\n" +" * [droonga-engine-absorb-data](droonga-engine-absorb-data/): Copy all schema " +"definitions and records from a cluster to another.\n" +" * [droonga-engine-set-role](droonga-engine-set-role/): Sets the role of a nod" +"e in a cluster." +msgstr "" +" * [droonga-engine-join](droonga-engine-join/): クラスタに新しいreplicaを追加します。\n" +" * [droonga-engine-unjoin](droonga-engine-unjoin/): クラスタから既存のreplicaを削除します。\n" +" * [droonga-engine-absorb-data](droonga-engine-absorb-data/): クラスタ間で全てのスキーマ定義お" +"よびレコードの情報をコピーします。\n" +" * [droonga-engine-set-role](droonga-engine-set-role/): クラスタ内のノードのroleを設定します。" + +msgid "## Low level system administration" +msgstr "## 低レイヤのシステム管理" + +msgid "" +" * [droonga-engine-configure](droonga-engine-configure/): Configures the `droo" +"nga-engine` service on a computer.\n" +" * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): Genera" +"tes a new cluster definition file.\n" +" * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): Modifies a" +"n existing cluster definition file.\n" +" * [droonga-http-server-configure](droonga-http-server-configure/): Configures" +" the `droonga-http-server` service on a computer." +msgstr "" +" * [droonga-engine-configure](droonga-engine-configure/): コンピュータ上の`droonga-eng" +"ine`サービスを設定します。\n" +" * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): クラスタ定義" +"ファイルを新たに生成します。\n" +" * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): 既存のクラスタ定義フ" +"ァイルを更新します。\n" +" * [droonga-http-server-configure](droonga-http-server-configure/): コンピュータ上の`d" +"roonga-http-server`サービスを設定します。" Modified: _po/ja/reference/1.1.0/index.po (+21 -0) =================================================================== --- _po/ja/reference/1.1.0/index.po 2015-04-30 19:47:15 +0900 (dc9f747) +++ _po/ja/reference/1.1.0/index.po 2015-04-30 19:50:43 +0900 (48acbaa) @@ -14,31 +14,52 @@ msgid "" "layout: en\n" "---" msgstr "" +"---\n" +"title: リファレンスマニュアル\n" +"layout: ja\n" +"---" msgid "" "[Catalog](catalog/)\n" ": Describes details of `catalog.json` which defines behavior of the Droonga En" "gine." msgstr "" +"[カタログの仕様](catalog/)\n" +": Droonga Engineの振る舞いを定義する`catalog.json`の詳細。" msgid "" "[Message format](message/)\n" ": Describes details of message format flowing in the Droonga Engines." msgstr "" +"[メッセージの形式](message/)\n" +": Droonga Engine内を流れるメッセージの形式の詳細。" msgid "" "[Commands](commands/)\n" ": Describes details of built-in commands available on the Droonga Engines." msgstr "" +"[コマンドリファレンス](commands/)\n" +": Droonga Engineで利用可能な組み込みのコマンドの詳細。" + +msgid "" +"[Command line tools](command-line-tools/)\n" +": Describes usage of command line tools provided by Droonga." +msgstr "" +"[コマンドラインツール](command-line-tools/)\n" +": Droongaが提供するコマンドラインツールの使い方の説明。" msgid "" "[HTTP Server](http-server/)\n" ": Describes usage of the [droonga-http-server](https://github.com/droonga/droo" "nga-http-server)." msgstr "" +"[HTTPサーバ](http-server/)\n" +": [droonga-http-server](https://github.com/droonga/droonga-http-server)の使用方法。" msgid "" "[Plugin development](plugin/)\n" ": Describes details of public APIs to develop custom plugins for the Droonga E" "ngine." msgstr "" +"[プラグイン開発](plugin/)\n" +": Droonga Engine用の独自のプラグインを開発するための公開APIの詳細。" Added: ja/reference/1.1.0/command-line-tools/droonga-add/index.md (+106 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/1.1.0/command-line-tools/droonga-add/index.md 2015-04-30 19:50:43 +0900 (0e1bfff) @@ -0,0 +1,106 @@ +--- +title: droonga-add +layout: ja +--- + +{% comment %} +############################################## + THIS FILE IS AUTOMATICALLY GENERATED FROM + "_po/ja/reference/1.1.0/command-line-tools/droonga-add/index.po" + DO NOT EDIT THIS FILE MANUALLY! +############################################## +{% endcomment %} + + +* TOC +{:toc} + +## 概要 {#abstract} + +`droonga-add`は、Droongaクラスタ内の指定されたテーブルについて、新しいレコードの追加および既存レコードの更新を行います。 + +例えば、`192.168.100.50`というDroongaノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログインしている場合、クラスタ内の`User`テーブルにレコードを1つ追加するコマンド列は以下のようになります： + +~~~ +(on 192.168.100.10) +$ droonga-add --host 192.168.100.50 --receiver-host 192.168.100.10 \ + --table User --key id1 --name Adam --age 20 +~~~ + +このコマンドは、typeが[`add`](../../commands/add/)であるメッセージを[`droonga-request`](../droonga-request/)を用いて送信する操作を簡単に行う物です。 +上記コマンド列によってもたらされる結果は、以下のコマンド列の結果と完全に同一です: + +~~~ +(on 192.168.100.10) +$ echo '{"type":"key","key":"id1","values":{"name":"Adam","age":20}}' | + droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +[`add`コマンドのリファレンス](../../commands/add/)も併せて参照して下さい。 + +## パラメータ {#parameters} + +`--table=TABLE` *(必須)* +: レコードを追加するテーブルの名前。 + +`--key=KEY` +: 追加または更新するレコードの一意なキー。 + +`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)` +: レコードのカラムの値。 + `host`のように既存の他のパラメータと同じ名前のカラムの値を指定する場合は、`--value:`という接頭辞を付ける必要があります。 + +`--host=NAME` +: メッセージの送信先となるEngineノードのホスト名。 + 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。 + +`--port=PORT` +: Engineノードとの通信に使うポート番号。 + 既定値は`10031`です。 + +`--tag=TAG` +: Engineノードとの通信に使うタグ名。 + 既定値は`droonga`です。 + +`--dataset=NAME` +: メッセージの送信先データセット名。 + 既定値は`Default`です。 + +`--receiver-host=NAME` +: コマンドを実行しているコンピュータのホスト名。 + 既定値は、そのコンピュータのホスト名として推測される名前です。 + +`--target-role=ROLE` +: メッセージを処理できるEngineノードのロール。 + 以下のいずれかを指定します: + + * `service-provider`: + メッセージは、クラスタ内でサービスを提供中のノードで処理されます。 + データ抽出操作に関わるノードには、後から遅れてメッセージが伝搬します。 + * `absorb-source`: + メッセージは、クラスタへのノード追加操作におけるデータコピー元となっているノードで処理されます。 + サービスを提供中のノード、並びにデータコピー先となっているノードへは、メッセージは伝搬しません。 + * `absorb-destination`: + メッセージは、クラスタへのノード追加操作におけるデータコピー先となっているノードで処理されます。 + サービスを提供中のノード、並びにデータコピー元となっているノードへは、メッセージは伝搬しません。 + * `any`: + メッセージは、`--host`で指定されたノードで処理されます。 + + 既定値は`any`です。 + +`--timeout=SECONDS` +: 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。 + 既定値は`3`です。 + +`-h`, `--help` +: コマンドの使い方の説明を表示します。 + + +## インストール方法 {#install} + +このコマンドは、Rubygemsのパッケージ`droonga-client`の一部としてインストールされます。 + +~~~ +# gem install droonga-client +~~~ + Added: ja/reference/1.1.0/command-line-tools/droonga-system-status/index.md (+98 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/1.1.0/command-line-tools/droonga-system-status/index.md 2015-04-30 19:50:43 +0900 (61f57e6) @@ -0,0 +1,98 @@ +--- +title: droonga-system-status +layout: ja +--- + +{% comment %} +############################################## + THIS FILE IS AUTOMATICALLY GENERATED FROM + "_po/ja/reference/1.1.0/command-line-tools/droonga-system-status/index.po" + DO NOT EDIT THIS FILE MANUALLY! +############################################## +{% endcomment %} + + +* TOC +{:toc} + +## 概要 {#abstract} + +`droonga-system-status`は、Droongaクラスタの現在の状態を報告します。 + +例えば、`192.168.100.50`というDroongaノードがあり、同一ネットワークセグメント内のコンピュータ`192.168.100.10`にログインしている場合、クラスタの状態を報告するコマンド列は以下のようになります： + +~~~ +(on 192.168.100.10) +$ droonga-system-status --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +このコマンドは、typeが[`system.status`](../../commands/system/status/)であるメッセージを[`droonga-request`](../droonga-request/)を用いて送信する操作を簡単に行う物です。 +上記コマンド列によってもたらされる結果は、以下のコマンド列の結果と完全に同一です: + +~~~ +(on 192.168.100.10) +$ echo '{"type":"system.status"}' | + droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +[`system.status`コマンドのリファレンス](../../commands/system/status/)も併せて参照して下さい。 + +## パラメータ {#parameters} + +`--pretty` +: 結果をpretty print形式のJSONで出力します。 + +`--host=NAME` +: メッセージの送信先となるEngineノードのホスト名。 + 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。 + +`--port=PORT` +: Engineノードとの通信に使うポート番号。 + 既定値は`10031`です。 + +`--tag=TAG` +: Engineノードとの通信に使うタグ名。 + 既定値は`droonga`です。 + +`--dataset=NAME` +: メッセージの送信先データセット名。 + 既定値は`Default`です。 + +`--receiver-host=NAME` +: コマンドを実行しているコンピュータのホスト名。 + 既定値は、そのコンピュータのホスト名として推測される名前です。 + +`--target-role=ROLE` +: メッセージを処理できるEngineノードのロール。 + 以下のいずれかを指定します: + + * `service-provider`: + メッセージは、クラスタ内でサービスを提供中のノードで処理されます。 + データ抽出操作に関わるノードには、後から遅れてメッセージが伝搬します。 + * `absorb-source`: + メッセージは、クラスタへのノード追加操作におけるデータコピー元となっているノードで処理されます。 + サービスを提供中のノード、並びにデータコピー先となっているノードへは、メッセージは伝搬しません。 + * `absorb-destination`: + メッセージは、クラスタへのノード追加操作におけるデータコピー先となっているノードで処理されます。 + サービスを提供中のノード、並びにデータコピー元となっているノードへは、メッセージは伝搬しません。 + * `any`: + メッセージは、`--host`で指定されたノードで処理されます。 + + 既定値は`any`です。 + +`--timeout=SECONDS` +: 応答がない接続を打ち切るまでの待ち時間（単位：秒）です。 + 既定値は`3`です。 + +`-h`, `--help` +: コマンドの使い方の説明を表示します。 + + +## インストール方法 {#install} + +このコマンドは、Rubygemsのパッケージ`droonga-client`の一部としてインストールされます。 + +~~~ +# gem install droonga-client +~~~ + Added: ja/reference/1.1.0/command-line-tools/index.md (+40 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/1.1.0/command-line-tools/index.md 2015-04-30 19:50:43 +0900 (09ebaae) @@ -0,0 +1,40 @@ +--- +title: コマンドラインツール +layout: ja +--- + +{% comment %} +############################################## + THIS FILE IS AUTOMATICALLY GENERATED FROM + "_po/ja/reference/1.1.0/command-line-tools/index.po" + DO NOT EDIT THIS FILE MANUALLY! +############################################## +{% endcomment %} + + +Droongaはいくつかのコマンドラインツールを提供しています。 +このセクションでは、それらの使い方を説明しています。 + +## Droongaクラスタとの通信 + + * [droonga-add](droonga-add/): クラスタに新しいレコードを追加します。 + * [droonga-groonga](droonga-groonga/): クラスタにGroongaコマンドを送信します。 + * [droonga-system-status](droonga-system-status/): クラスタ内のメンバーの状態を出力します。 + * [droonga-request](droonga-request/): 任意のメッセージをクラスタに送信し、レスポンスを出力します。 + * [droonga-send](droonga-send/): 任意のメッセージをクラスタに送信します。 + * [drndump](drndump/): クラスタから全てのスキーマ定義およびレコードの情報を抽出します。 + +## クラスタの管理 + + * [droonga-engine-join](droonga-engine-join/): クラスタに新しいreplicaを追加します。 + * [droonga-engine-unjoin](droonga-engine-unjoin/): クラスタから既存のreplicaを削除します。 + * [droonga-engine-absorb-data](droonga-engine-absorb-data/): クラスタ間で全てのスキーマ定義およびレコードの情報をコピーします。 + * [droonga-engine-set-role](droonga-engine-set-role/): クラスタ内のノードのroleを設定します。 + +## 低レイヤのシステム管理 + + * [droonga-engine-configure](droonga-engine-configure/): コンピュータ上の`droonga-engine`サービスを設定します。 + * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): クラスタ定義ファイルを新たに生成します。 + * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): 既存のクラスタ定義ファイルを更新します。 + * [droonga-http-server-configure](droonga-http-server-configure/): コンピュータ上の`droonga-http-server`サービスを設定します。 + Modified: ja/reference/1.1.0/index.md (+3 -0) =================================================================== --- ja/reference/1.1.0/index.md 2015-04-30 19:47:15 +0900 (ee684f2) +++ ja/reference/1.1.0/index.md 2015-04-30 19:50:43 +0900 (2790b45) @@ -21,6 +21,9 @@ layout: ja [コマンドリファレンス](commands/) : Droonga Engineで利用可能な組み込みのコマンドの詳細。 +[コマンドラインツール](command-line-tools/) +: Droongaが提供するコマンドラインツールの使い方の説明。 + [HTTPサーバ](http-server/) : [droonga-http-server](https://github.com/droonga/droonga-http-server)の使用方法。 Added: reference/1.1.0/command-line-tools/droonga-add/index.md (+97 -0) 100644 =================================================================== --- /dev/null +++ reference/1.1.0/command-line-tools/droonga-add/index.md 2015-04-30 19:50:43 +0900 (2a933d9) @@ -0,0 +1,97 @@ +--- +title: droonga-add +layout: en +--- + +* TOC +{:toc} + +## Abstract {#abstract} + +`droonga-add` adds a new record or updates an existing record, to the specified table in a Droonga cluster. + +For example, if there is a Droonga node `192.168.100.50` and you are logged in to a computer `192.168.100.10` in the same network segment, the command line to add a new record to the table `User` in the cluster is: + +~~~ +(on 192.168.100.10) +$ droonga-add --host 192.168.100.50 --receiver-host 192.168.100.10 \ + --table User --key id1 --name Adam --age 20 +~~~ + +This command is just a shorthand of [`droonga-request`](../droonga-request/) with a message with the type [`add`](../../commands/add/). +The result produced by the following command line completely equals to the one of above: + +~~~ +(on 192.168.100.10) +$ echo '{"type":"key","key":"id1","values":{"name":"Adam","age":20}}' | + droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +See also [the reference of the `add` command](../../commands/add/). + +## Parameters {#parameters} + +`--table=TABLE` *(required)* +: Name of the target table. + +`--key=KEY` +: A unique key of the adding or updating record. + +`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)` +: Value of the column for the record. + Columns with names same to other existing parameter like `host` must be specified with the prefix `--value:`. + +`--host=NAME` +: Host name of the engine node. + A guessed host name of the computer you are running the command, by default. + +`--port=PORT` +: Port number to communicate with the engine. + `10031` by default. + +`--tag=TAG` +: Tag name to communicate with the engine. + `droonga` by default. + +`--dataset=NAME` +: Dataset name for the sending message. + `Default` by default. + +`--receiver-host=NAME` +: Host name of the computer you are running the command. + A guessed host name of the computer, by default. + +`--target-role=ROLE` +: Role of engine nodes which should process the message. + Possible values: + + * `service-provider`: + The message is processed by service provider nodes in the cluster. + For absorb-source nodes and absrob-destination nodes, the message will be dispatched later. + * `absorb-source`: + The message is processed by absorb-source nodes in the cluster. + For service provider nodes and absrob-destination nodes, the message is never dispatched. + * `absorb-destination`: + The message is processed by absorb-destination nodes in the cluster. + For service provider nodes and absrob-source nodes, the message is never dispatched. + * `any`: + The message is always processed by the node specified via the option `--host`. + + `any` by default. + +`--timeout=SECONDS` +: Time to terminate unresponsive connections, in seconds. + `3` by default. + +`-h`, `--help` +: Shows the usage of the command. + + +## How to install {#install} + +This is installed as a part of a rubygems package `droonga-client`. + +~~~ +# gem install droonga-client +~~~ + Added: reference/1.1.0/command-line-tools/droonga-system-status/index.md (+89 -0) 100644 =================================================================== --- /dev/null +++ reference/1.1.0/command-line-tools/droonga-system-status/index.md 2015-04-30 19:50:43 +0900 (076db8f) @@ -0,0 +1,89 @@ +--- +title: droonga-system-status +layout: en +--- + +* TOC +{:toc} + +## Abstract {#abstract} + +`droonga-system-status` reports current status of a Droonga cluster. + +For example, if there is a Droonga node `192.168.100.50` and you are logged in to a computer `192.168.100.10` in the same network segment, the command line to report status of the cluster is: + +~~~ +(on 192.168.100.10) +$ droonga-system-status --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +This command is just a shorthand of [`droonga-request`](../droonga-request/) with a message with the type [`system.status`](../../commands/system/status/). +The result produced by the following command line completely equals to the one of above: + +~~~ +(on 192.168.100.10) +$ echo '{"type":"system.status"}' | + droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10 +~~~ + +See also [the reference of the `system.status` command](../../commands/system/status/). + +## Parameters {#parameters} + +`--pretty` +: Output result as a pretty print JSON. + +`--host=NAME` +: Host name of the engine node. + A guessed host name of the computer you are running the command, by default. + +`--port=PORT` +: Port number to communicate with the engine. + `10031` by default. + +`--tag=TAG` +: Tag name to communicate with the engine. + `droonga` by default. + +`--dataset=NAME` +: Dataset name for the sending message. + `Default` by default. + +`--receiver-host=NAME` +: Host name of the computer you are running the command. + A guessed host name of the computer, by default. + +`--target-role=ROLE` +: Role of engine nodes which should process the message. + Possible values: + + * `service-provider`: + The message is processed by service provider nodes in the cluster. + For absorb-source nodes and absrob-destination nodes, the message will be dispatched later. + * `absorb-source`: + The message is processed by absorb-source nodes in the cluster. + For service provider nodes and absrob-destination nodes, the message is never dispatched. + * `absorb-destination`: + The message is processed by absorb-destination nodes in the cluster. + For service provider nodes and absrob-source nodes, the message is never dispatched. + * `any`: + The message is always processed by the node specified via the option `--host`. + + `any` by default. + +`--timeout=SECONDS` +: Time to terminate unresponsive connections, in seconds. + `3` by default. + +`-h`, `--help` +: Shows the usage of the command. + + +## How to install {#install} + +This is installed as a part of a rubygems package `droonga-client`. + +~~~ +# gem install droonga-client +~~~ + Added: reference/1.1.0/command-line-tools/index.md (+31 -0) 100644 =================================================================== --- /dev/null +++ reference/1.1.0/command-line-tools/index.md 2015-04-30 19:50:43 +0900 (b9a020e) @@ -0,0 +1,31 @@ +--- +title: Command line tools +layout: en +--- + +Droonga provides some command line tools. +This section describes usage of them. + +## Communicating with Droonga cluster + + * [droonga-add](droonga-add/): Adds a new record to a cluster. + * [droonga-groonga](droonga-groonga/): Sends Groonga commands to a cluster. + * [droonga-system-status](droonga-system-status/): Reports status of members in a cluster. + * [droonga-request](droonga-request/): Sends any message to a cluster and reports the response. + * [droonga-send](droonga-send/): Sends any message to a cluster. + * [drndump](drndump/): Extracts all schema definitions and records from a cluster. + +## Cluster management + + * [droonga-engine-join](droonga-engine-join/): Adds a new replica node to a cluster. + * [droonga-engine-unjoin](droonga-engine-unjoin/): Removes an existing replica node from a cluster. + * [droonga-engine-absorb-data](droonga-engine-absorb-data/): Copy all schema definitions and records from a cluster to another. + * [droonga-engine-set-role](droonga-engine-set-role/): Sets the role of a node in a cluster. + +## Low level system administration + + * [droonga-engine-configure](droonga-engine-configure/): Configures the `droonga-engine` service on a computer. + * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): Generates a new cluster definition file. + * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): Modifies an existing cluster definition file. + * [droonga-http-server-configure](droonga-http-server-configure/): Configures the `droonga-http-server` service on a computer. + Modified: reference/1.1.0/index.md (+3 -0) =================================================================== --- reference/1.1.0/index.md 2015-04-30 19:47:15 +0900 (0a37859) +++ reference/1.1.0/index.md 2015-04-30 19:50:43 +0900 (fcc77e4) @@ -12,6 +12,9 @@ layout: en [Commands](commands/) : Describes details of built-in commands available on the Droonga Engines. +[Command line tools](command-line-tools/) +: Describes usage of command line tools provided by Droonga. + [HTTP Server](http-server/) : Describes usage of the [droonga-http-server](https://github.com/droonga/droonga-http-server). -------------- next part -------------- HTML����������������������������...Download