YUKI Hiroshi
null+****@clear*****
Fri May 8 18:52:22 JST 2015
YUKI Hiroshi 2015-05-08 18:52:22 +0900 (Fri, 08 May 2015) New Revision: f487f5ea2b0dcc377bf506a773d201c37a53dca6 https://github.com/droonga/droonga.org/commit/f487f5ea2b0dcc377bf506a773d201c37a53dca6 Message: Translate reference of droonga-engine-catalog-generate Added files: _po/ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.po _po/ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.po ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.md ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.md Added: _po/ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.po (+521 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.po 2015-05-08 18:52:22 +0900 (4b3b95d) @@ -0,0 +1,521 @@ +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-engine-catalog-generate\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: droonga-engine-catalog-generate\n" +"layout: ja\n" +"---" + +msgid "" +"* TOC\n" +"{:toc}" +msgstr "" + +msgid "## Abstract {#abstract}" +msgstr "## 概要 {#abstract}" + +msgid "" +"`droonga-engine-catalog-generate` generates new [`catalog.json` file](../../ca" +"talog/version2/) for a Droonga Engine node." +msgstr "" +"`droonga-engine-catalog-generate`は、Droonga Engineノード用の新しい[`catalog.json`ファイル](" +"../../catalog/version2/)を生成します。" + +msgid "" +"For most usecase you don't need to use this command.\n" +"Instead, use [the `droonga-engine-configure` command](../droonga-engine-config" +"ure/) to initialize an Engine node and change cluster's structure via manageme" +"nt commands like [`droonga-engine-join`](../droonga-engine-join/) or ['droonga" +"-engine-unjoin`](../droonga-engine-unjoin/)." +msgstr "" +"多くの場合において、このコマンドを使う必要はまずありません。代わりに、Engineノードの初期化には[`droonga-engine-configure`コ" +"マンド](../droonga-engine-configure/)を使い、クラスタ構成の変更には[`droonga-engine-join`](../dr" +"oonga-engine-join/)や['droonga-engine-unjoin`](../droonga-engine-unjoin/)のような管理" +"コマンドを使って下さい。" + +msgid "## Examples {#examples}" +msgstr "## 例 {#examples}" + +msgid "### Orphan cluster with single volume" +msgstr "### 1つだけのボリュームを持つ孤立したクラスタ" + +msgid "" +"Most popular usage is generating `catalog.json` for an orphan Engine node as a" +" new replica node managed by [the `droonga-engine-join` command](../droonga-en" +"gine-join/). For example, if you are logged in to an unprepared node `192.168." +"100.50`, the command line is:" +msgstr "" +"最も一般的な使い方は、[`droonga-engine-join`コマンド](../droonga-engine-join/)によって管理される新しいレプリ" +"カノードとして、孤立したEngineノード用の`catalog.json`を生成する場面です。例えば、まだ準備されていないノードである`192.168.10" +"0.50`にログインしている場合のコマンド列は以下の通りです：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate --hosts 192.168.100.50\n" +"~~~" +msgstr "" + +msgid "Full version with omitted options is:" +msgstr "省略されたオプションを含めた完全な指定はこのようになります：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"These options `--n-workers`, `--hosts`, `--port`, `--tag`, `--n-slices` and `-" +"-plugins` are associated to the nearest preceding `--dataset` option.\n" +"All these options preceding to any user defined `--dataset` option are automat" +"ically associated to the default dataset named `Default`." +msgstr "" +"`--n-workers`、`--hosts`、`--port`、`--tag`、`--n-slices`および`--plugins`の各オプションは、最も" +"近くに書かれた先行する`--dataset`オプションに紐付けられています。\n" +"ユーザが指定した`--dataset`オプションよりも前に書かれたこれらのオプションの指定は、自動的に既定のデータセット名`Default`に対して紐付けら" +"れます。" + +msgid "Generated `catalog.json` is:" +msgstr "生成された`catalog.json`の例は以下の通りです：" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" {\n" +" \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" }\n" +" }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "### Cluster with multiple replica nodes" +msgstr "### 複数のreplicaノードを含むクラスタ" + +msgid "" +"To define a dataset with multiple replica nodes, you have to give all host nam" +"es used as replica nodes separated with `,` (comma) via the `--hosts` option, " +"like:" +msgstr "" +"複数のreplicaノードを持つデータセットを定義するには、replicaノードとして使われる全てのノードのホスト名を`,`（カンマ）で区切って`--hos" +"t`オプションに指定します：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "### Cluster with multiple replica nodes and multiple slices for each replica" +msgstr "### 複数のreplicaノードと、それぞれのreplicaについて複数のsliceを含むクラスタ" + +msgid "" +"To define a dataset with sliced replicas, you have to add one more option `--n" +"-slices` for the dataset, like:" +msgstr "" +"sliceに分割されたreplicaを持つデータセットを定義するためには、`--n-slices`オプションをそのデータセットに対して指定する必要があります" +"：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --n-slices 2\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 2 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" } },\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.001\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.000\" } },\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.001\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "" +"`2` or larger number for the `--n-slices` option produces multiple slices on e" +"ach replica node itself.\n" +"For effective slicing we should use one node per one slice, but currently it i" +"s not supported by this command.\n" +"Moreover, we still don't support replicas under a slice yet.\n" +"These limitations will be solved on future versions." +msgstr "" +"`2`またはそれより大きな数を`--n-slices`オプションで指定すると、複数のsliceが各replicaノード自身の上に生成されます。\n" +"有効なslice分けのためには1つのsliceごとに1ノードを割り当てるべきですが、現在のところこのコマンドはそのようなパターンに対応していません。\n" +"また、sliceは以下のreplicaの定義にもまだ対応できていません。\n" +"これらの制限事項は将来のバージョンで解消される予定です。" + +msgid "### Cluster including two or more datasets" +msgstr "### 2つ以上のデータセットを含むクラスタ" + +msgid "" +"To define multiple datasets in a cluster you have to use the `--dataset` optio" +"n, like:" +msgstr "クラスタ内に複数のデータセットを定義するには、`--dataset`オプションを使う必要があります：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 20031 \\\n" +" --dataset Testing \\\n" +" --hosts 192.168.100.60,192.168.100.61 \\\n" +" --port 20032\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 20031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog \\\n" +" --dataset Testing \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.60,192.168.100.61 \\\n" +" --port 20032 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"As above, dataset-associated options affect to the dataset defined by their ne" +"arest preceding `--dataset` option." +msgstr "" +"上記の例の通り、データセットに紐付けられたオプションはそれに先行する最も近くに書かれた`--dataset`オプションで定義されるデータセットに対して影響を" +"及ぼします。" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:20031/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.51:20031/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" },\n" +" \"Testing\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.60:20032/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.61:20032/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "## Parameters {#parameters}" +msgstr "## パラメータ {#parameters}" + +msgid "" +"`--output=PATH`\n" +": The output path of generated `catalog.json` to be saved as.\n" +" `-` means the standard output.\n" +" Any existing file at the specified path will be overwritten without confirma" +"tion.\n" +" It is the path to the `catalog.json` for the `droonga-engine` service on the" +" computer (`/home/droonga-engine/droonga/catalog.json`), by default." +msgstr "" +"`--output=PATH`\n" +": 生成された`catalog.json`の保存先パス。\n" +" `-`を指定した場合は標準出力に対して出力します。\n" +" 指定されたパスの位置にある既存のファイルは、確認無しに上書きされます。\n" +" 既定値は、そのコンピュータ上に設定される`droonga-engine`サービスの`catalog.json`の位置（`/home/droonga-en" +"gine/droonga/catalog.json`）です。" + +msgid "" +"`--dataset=NAME`\n" +": The name of a new dataset.\n" +" This can be specified multiple times to define multiple datasets.\n" +" `Default` by default." +msgstr "" +"`--dataset=NAME`\n" +": 新たに定義するデータセットの名前。\n" +" 複数のデータセットを定義できるように、このオプションは複数回指定できます。\n" +" 既定値は`Default`です。" + +msgid "" +"`--n-workers=N`\n" +": Number of workers for each volume in the dataset specified by the preceding " +"`--dataset` option.\n" +" `4` by default." +msgstr "" +"`--n-workers=N`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、個々のvolumeに対して用意するworkerの数。\n" +" 既定値は`4`です。" + +msgid "" +"`--hosts=NAME1,NAME2,...`\n" +": Host names of engine nodes to be used as replicas in the dataset specified b" +"y the preceding `--dataset` option.\n" +" A single guessed host name of the computer you are running the command, by d" +"efault." +msgstr "" +"`--hosts=NAME1,NAME2,...`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、replicaとして使う1つ以上のEngineノードのホスト名。\n" +" 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。" + +msgid "" +"`--port=PORT`\n" +": Port number to communicate with engine nodes in the dataset specified by the" +" preceding `--dataset` option.\n" +" `10031` by default." +msgstr "" +"`--port=PORT`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うポート番号。\n" +" 既定値は`10031`です。" + +msgid "" +"`--tag=TAG`\n" +": Tag name to communicate with engine nodes in the dataset specified by the pr" +"eceding `--dataset` option.\n" +" `droonga` by default." +msgstr "" +"`--tag=TAG`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うタグ名。\n" +" 既定値は`droonga`です。" + +msgid "" +"`--n-slices=N`\n" +": Number of slices for each replica in the dataset specified by the preceding " +"`--dataset` option.\n" +" `1` by default." +msgstr "" +"`--n-slices=N`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、各レプリカに用意するsliceの数。\n" +" 既定値は`1`です。" + +msgid "" +"`--plugins=PLUGIN1,PLUGIN2,...`\n" +": Plugin names activated for the dataset specified by the preceding `--dataset" +"` option.\n" +" `groonga,search,crud,dump,system,catalog` (the list of all buit-in plugins) " +"by default." +msgstr "" +"`--plugins=PLUGIN1,PLUGIN2,...`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、有効化するプラグインの名前。\n" +" 既定値は`groonga,search,crud,dump,system,catalog`（組み込みのプラグイン全ての一覧）です。" + +msgid "" +"`--schema=PATH`\n" +": The path to a JSON file including schema definition for the dataset specifie" +"d by the preceding `--dataset` option." +msgstr "" +"`--schema=PATH`\n" +": 先行する`--dataset`オプションで定義されたデータセット向けのスキーマ定義を含んだJSONファイルのパス。" + +msgid "" +"`--fact=TABLE`\n" +": Name of the fact table in the dataset specified by the preceding `--dataset`" +" option." +msgstr "" +"`--fact=TABLE`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、fact表として扱うtableの名前。" + +msgid "" +"`--replicas=PATH`\n" +": The path to a JSON file including replicas definition for the dataset specif" +"ied by the preceding `--dataset` option.\n" +" If this option is used, other options to define replicas in the dataset (`--" +"hosts`, `--port`, `--tag` and `--n-slices`) are ignored." +msgstr "" +"`--replicas=PATH`\n" +": 先行する`--dataset`オプションで定義されたデータセット向けのreplica群の定義を含んだJSONファイルのパス。\n" +" このオプションが指定された場合、データセット内にreplica群を定義するための他のオプション（`--hosts`、`--port`、`--tag`、お" +"よび`--n-slices`）は全て無視されます。" + +msgid "## How to install {#install}" +msgstr "## インストール方法 {#install}" + +msgid "This is installed as a part of a rubygems package `droonga-engine`." +msgstr "このコマンドは、Rubygemsのパッケージ`droonga-engine`の一部としてインストールされます。" + +msgid "" +"~~~\n" +"# gem install droonga-engine\n" +"~~~" +msgstr "" Added: _po/ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.po (+521 -0) 100644 =================================================================== --- /dev/null +++ _po/ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.po 2015-05-08 18:52:22 +0900 (4b3b95d) @@ -0,0 +1,521 @@ +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-engine-catalog-generate\n" +"layout: en\n" +"---" +msgstr "" +"---\n" +"title: droonga-engine-catalog-generate\n" +"layout: ja\n" +"---" + +msgid "" +"* TOC\n" +"{:toc}" +msgstr "" + +msgid "## Abstract {#abstract}" +msgstr "## 概要 {#abstract}" + +msgid "" +"`droonga-engine-catalog-generate` generates new [`catalog.json` file](../../ca" +"talog/version2/) for a Droonga Engine node." +msgstr "" +"`droonga-engine-catalog-generate`は、Droonga Engineノード用の新しい[`catalog.json`ファイル](" +"../../catalog/version2/)を生成します。" + +msgid "" +"For most usecase you don't need to use this command.\n" +"Instead, use [the `droonga-engine-configure` command](../droonga-engine-config" +"ure/) to initialize an Engine node and change cluster's structure via manageme" +"nt commands like [`droonga-engine-join`](../droonga-engine-join/) or ['droonga" +"-engine-unjoin`](../droonga-engine-unjoin/)." +msgstr "" +"多くの場合において、このコマンドを使う必要はまずありません。代わりに、Engineノードの初期化には[`droonga-engine-configure`コ" +"マンド](../droonga-engine-configure/)を使い、クラスタ構成の変更には[`droonga-engine-join`](../dr" +"oonga-engine-join/)や['droonga-engine-unjoin`](../droonga-engine-unjoin/)のような管理" +"コマンドを使って下さい。" + +msgid "## Examples {#examples}" +msgstr "## 例 {#examples}" + +msgid "### Orphan cluster with single volume" +msgstr "### 1つだけのボリュームを持つ孤立したクラスタ" + +msgid "" +"Most popular usage is generating `catalog.json` for an orphan Engine node as a" +" new replica node managed by [the `droonga-engine-join` command](../droonga-en" +"gine-join/). For example, if you are logged in to an unprepared node `192.168." +"100.50`, the command line is:" +msgstr "" +"最も一般的な使い方は、[`droonga-engine-join`コマンド](../droonga-engine-join/)によって管理される新しいレプリ" +"カノードとして、孤立したEngineノード用の`catalog.json`を生成する場面です。例えば、まだ準備されていないノードである`192.168.10" +"0.50`にログインしている場合のコマンド列は以下の通りです：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate --hosts 192.168.100.50\n" +"~~~" +msgstr "" + +msgid "Full version with omitted options is:" +msgstr "省略されたオプションを含めた完全な指定はこのようになります：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"These options `--n-workers`, `--hosts`, `--port`, `--tag`, `--n-slices` and `-" +"-plugins` are associated to the nearest preceding `--dataset` option.\n" +"All these options preceding to any user defined `--dataset` option are automat" +"ically associated to the default dataset named `Default`." +msgstr "" +"`--n-workers`、`--hosts`、`--port`、`--tag`、`--n-slices`および`--plugins`の各オプションは、最も" +"近くに書かれた先行する`--dataset`オプションに紐付けられています。\n" +"ユーザが指定した`--dataset`オプションよりも前に書かれたこれらのオプションの指定は、自動的に既定のデータセット名`Default`に対して紐付けら" +"れます。" + +msgid "Generated `catalog.json` is:" +msgstr "生成された`catalog.json`の例は以下の通りです：" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" {\n" +" \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" }\n" +" }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "### Cluster with multiple replica nodes" +msgstr "### 複数のreplicaノードを含むクラスタ" + +msgid "" +"To define a dataset with multiple replica nodes, you have to give all host nam" +"es used as replica nodes separated with `,` (comma) via the `--hosts` option, " +"like:" +msgstr "" +"複数のreplicaノードを持つデータセットを定義するには、replicaノードとして使われる全てのノードのホスト名を`,`（カンマ）で区切って`--hos" +"t`オプションに指定します：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "### Cluster with multiple replica nodes and multiple slices for each replica" +msgstr "### 複数のreplicaノードと、それぞれのreplicaについて複数のsliceを含むクラスタ" + +msgid "" +"To define a dataset with sliced replicas, you have to add one more option `--n" +"-slices` for the dataset, like:" +msgstr "" +"sliceに分割されたreplicaを持つデータセットを定義するためには、`--n-slices`オプションをそのデータセットに対して指定する必要があります" +"：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --n-slices 2\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 10031 \\\n" +" --tag droonga \\\n" +" --n-slices 2 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.000\" } },\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.50:10031/droonga.001\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.000\" } },\n" +" { \"weight\": 50,\n" +" \"volume\": { \"address\": \"192.168.100.51:10031/droonga.001\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "" +"`2` or larger number for the `--n-slices` option produces multiple slices on e" +"ach replica node itself.\n" +"For effective slicing we should use one node per one slice, but currently it i" +"s not supported by this command.\n" +"Moreover, we still don't support replicas under a slice yet.\n" +"These limitations will be solved on future versions." +msgstr "" +"`2`またはそれより大きな数を`--n-slices`オプションで指定すると、複数のsliceが各replicaノード自身の上に生成されます。\n" +"有効なslice分けのためには1つのsliceごとに1ノードを割り当てるべきですが、現在のところこのコマンドはそのようなパターンに対応していません。\n" +"また、sliceは以下のreplicaの定義にもまだ対応できていません。\n" +"これらの制限事項は将来のバージョンで解消される予定です。" + +msgid "### Cluster including two or more datasets" +msgstr "### 2つ以上のデータセットを含むクラスタ" + +msgid "" +"To define multiple datasets in a cluster you have to use the `--dataset` optio" +"n, like:" +msgstr "クラスタ内に複数のデータセットを定義するには、`--dataset`オプションを使う必要があります：" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 20031 \\\n" +" --dataset Testing \\\n" +" --hosts 192.168.100.60,192.168.100.61 \\\n" +" --port 20032\n" +"~~~" +msgstr "" + +msgid "" +"~~~\n" +"(on 192.168.100.50)\n" +"# droonga-engine-catalog-generate \\\n" +" --output /home/droonga-engine/droonga/catalog.json \\\n" +" --dataset Default \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.50,192.168.100.51 \\\n" +" --port 20031 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog \\\n" +" --dataset Testing \\\n" +" --n-workers 4 \\\n" +" --hosts 192.168.100.60,192.168.100.61 \\\n" +" --port 20032 \\\n" +" --tag droonga \\\n" +" --n-slices 1 \\\n" +" --plugins groonga,search,crud,dump,system,catalog\n" +"~~~" +msgstr "" + +msgid "" +"As above, dataset-associated options affect to the dataset defined by their ne" +"arest preceding `--dataset` option." +msgstr "" +"上記の例の通り、データセットに紐付けられたオプションはそれに先行する最も近くに書かれた`--dataset`オプションで定義されるデータセットに対して影響を" +"及ぼします。" + +msgid "" +"~~~\n" +"{\n" +" \"version\": 2,\n" +" \"effectiveDate\": \"2015-05-08T09:02:12+00:00\",\n" +" \"datasets\": {\n" +" \"Default\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.50:20031/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.51:20031/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" },\n" +" \"Testing\": {\n" +" \"nWorkers\": 4,\n" +" \"plugins\": [\"groonga\", \"search\", \"crud\", \"dump\", \"system\", \"catalog\"],\n" +" \"schema\": {},\n" +" \"replicas\": [\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.60:20032/droonga.000\" } }\n" +" ]\n" +" },\n" +" {\n" +" \"dimension\": \"_key\",\n" +" \"slicer\": \"hash\",\n" +" \"slices\": [\n" +" { \"weight\": 100,\n" +" \"volume\": { \"address\": \"192.168.100.61:20032/droonga.000\" } }\n" +" ]\n" +" }\n" +" ]\n" +" }\n" +" }\n" +"}\n" +"~~~" +msgstr "" + +msgid "## Parameters {#parameters}" +msgstr "## パラメータ {#parameters}" + +msgid "" +"`--output=PATH`\n" +": The output path of generated `catalog.json` to be saved as.\n" +" `-` means the standard output.\n" +" Any existing file at the specified path will be overwritten without confirma" +"tion.\n" +" It is the path to the `catalog.json` for the `droonga-engine` service on the" +" computer (`/home/droonga-engine/droonga/catalog.json`), by default." +msgstr "" +"`--output=PATH`\n" +": 生成された`catalog.json`の保存先パス。\n" +" `-`を指定した場合は標準出力に対して出力します。\n" +" 指定されたパスの位置にある既存のファイルは、確認無しに上書きされます。\n" +" 既定値は、そのコンピュータ上に設定される`droonga-engine`サービスの`catalog.json`の位置（`/home/droonga-en" +"gine/droonga/catalog.json`）です。" + +msgid "" +"`--dataset=NAME`\n" +": The name of a new dataset.\n" +" This can be specified multiple times to define multiple datasets.\n" +" `Default` by default." +msgstr "" +"`--dataset=NAME`\n" +": 新たに定義するデータセットの名前。\n" +" 複数のデータセットを定義できるように、このオプションは複数回指定できます。\n" +" 既定値は`Default`です。" + +msgid "" +"`--n-workers=N`\n" +": Number of workers for each volume in the dataset specified by the preceding " +"`--dataset` option.\n" +" `4` by default." +msgstr "" +"`--n-workers=N`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、個々のvolumeに対して用意するworkerの数。\n" +" 既定値は`4`です。" + +msgid "" +"`--hosts=NAME1,NAME2,...`\n" +": Host names of engine nodes to be used as replicas in the dataset specified b" +"y the preceding `--dataset` option.\n" +" A single guessed host name of the computer you are running the command, by d" +"efault." +msgstr "" +"`--hosts=NAME1,NAME2,...`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、replicaとして使う1つ以上のEngineノードのホスト名。\n" +" 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。" + +msgid "" +"`--port=PORT`\n" +": Port number to communicate with engine nodes in the dataset specified by the" +" preceding `--dataset` option.\n" +" `10031` by default." +msgstr "" +"`--port=PORT`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うポート番号。\n" +" 既定値は`10031`です。" + +msgid "" +"`--tag=TAG`\n" +": Tag name to communicate with engine nodes in the dataset specified by the pr" +"eceding `--dataset` option.\n" +" `droonga` by default." +msgstr "" +"`--tag=TAG`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うタグ名。\n" +" 既定値は`droonga`です。" + +msgid "" +"`--n-slices=N`\n" +": Number of slices for each replica in the dataset specified by the preceding " +"`--dataset` option.\n" +" `1` by default." +msgstr "" +"`--n-slices=N`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、各レプリカに用意するsliceの数。\n" +" 既定値は`1`です。" + +msgid "" +"`--plugins=PLUGIN1,PLUGIN2,...`\n" +": Plugin names activated for the dataset specified by the preceding `--dataset" +"` option.\n" +" `groonga,search,crud,dump,system,catalog` (the list of all buit-in plugins) " +"by default." +msgstr "" +"`--plugins=PLUGIN1,PLUGIN2,...`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、有効化するプラグインの名前。\n" +" 既定値は`groonga,search,crud,dump,system,catalog`（組み込みのプラグイン全ての一覧）です。" + +msgid "" +"`--schema=PATH`\n" +": The path to a JSON file including schema definition for the dataset specifie" +"d by the preceding `--dataset` option." +msgstr "" +"`--schema=PATH`\n" +": 先行する`--dataset`オプションで定義されたデータセット向けのスキーマ定義を含んだJSONファイルのパス。" + +msgid "" +"`--fact=TABLE`\n" +": Name of the fact table in the dataset specified by the preceding `--dataset`" +" option." +msgstr "" +"`--fact=TABLE`\n" +": 先行する`--dataset`オプションで定義されたデータセットにおいて、fact表として扱うtableの名前。" + +msgid "" +"`--replicas=PATH`\n" +": The path to a JSON file including replicas definition for the dataset specif" +"ied by the preceding `--dataset` option.\n" +" If this option is used, other options to define replicas in the dataset (`--" +"hosts`, `--port`, `--tag` and `--n-slices`) are ignored." +msgstr "" +"`--replicas=PATH`\n" +": 先行する`--dataset`オプションで定義されたデータセット向けのreplica群の定義を含んだJSONファイルのパス。\n" +" このオプションが指定された場合、データセット内にreplica群を定義するための他のオプション（`--hosts`、`--port`、`--tag`、お" +"よび`--n-slices`）は全て無視されます。" + +msgid "## How to install {#install}" +msgstr "## インストール方法 {#install}" + +msgid "This is installed as a part of a rubygems package `droonga-engine`." +msgstr "このコマンドは、Rubygemsのパッケージ`droonga-engine`の一部としてインストールされます。" + +msgid "" +"~~~\n" +"# gem install droonga-engine\n" +"~~~" +msgstr "" Added: ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.md (+362 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.md 2015-05-08 18:52:22 +0900 (2f43910) @@ -0,0 +1,362 @@ +--- +title: droonga-engine-catalog-generate +layout: ja +--- + +{% comment %} +############################################## + THIS FILE IS AUTOMATICALLY GENERATED FROM + "_po/ja/reference/1.1.0/command-line-tools/droonga-engine-catalog-generate/index.po" + DO NOT EDIT THIS FILE MANUALLY! +############################################## +{% endcomment %} + + +* TOC +{:toc} + +## 概要 {#abstract} + +`droonga-engine-catalog-generate`は、Droonga Engineノード用の新しい[`catalog.json`ファイル](../../catalog/version2/)を生成します。 + +多くの場合において、このコマンドを使う必要はまずありません。代わりに、Engineノードの初期化には[`droonga-engine-configure`コマンド](../droonga-engine-configure/)を使い、クラスタ構成の変更には[`droonga-engine-join`](../droonga-engine-join/)や['droonga-engine-unjoin`](../droonga-engine-unjoin/)のような管理コマンドを使って下さい。 + +## 例 {#examples} + +### 1つだけのボリュームを持つ孤立したクラスタ + +最も一般的な使い方は、[`droonga-engine-join`コマンド](../droonga-engine-join/)によって管理される新しいレプリカノードとして、孤立したEngineノード用の`catalog.json`を生成する場面です。例えば、まだ準備されていないノードである`192.168.100.50`にログインしている場合のコマンド列は以下の通りです： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate --hosts 192.168.100.50 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50 \ + --port 10031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +`--n-workers`、`--hosts`、`--port`、`--tag`、`--n-slices`および`--plugins`の各オプションは、最も近くに書かれた先行する`--dataset`オプションに紐付けられています。 +ユーザが指定した`--dataset`オプションよりも前に書かれたこれらのオプションの指定は、自動的に既定のデータセット名`Default`に対して紐付けられます。 + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { + "weight": 100, + "volume": { "address": "192.168.100.50:10031/droonga.000" } + } + ] + } + ] + } + } +} +~~~ + + +### 複数のreplicaノードを含むクラスタ + +複数のreplicaノードを持つデータセットを定義するには、replicaノードとして使われる全てのノードのホスト名を`,`（カンマ）で区切って`--host`オプションに指定します： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 10031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.50:10031/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.51:10031/droonga.000" } } + ] + } + ] + } + } +} +~~~ + + +### 複数のreplicaノードと、それぞれのreplicaについて複数のsliceを含むクラスタ + +sliceに分割されたreplicaを持つデータセットを定義するためには、`--n-slices`オプションをそのデータセットに対して指定する必要があります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 \ + --n-slices 2 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 10031 \ + --tag droonga \ + --n-slices 2 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 50, + "volume": { "address": "192.168.100.50:10031/droonga.000" } }, + { "weight": 50, + "volume": { "address": "192.168.100.50:10031/droonga.001" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 50, + "volume": { "address": "192.168.100.51:10031/droonga.000" } }, + { "weight": 50, + "volume": { "address": "192.168.100.51:10031/droonga.001" } } + ] + } + ] + } + } +} +~~~ + +`2`またはそれより大きな数を`--n-slices`オプションで指定すると、複数のsliceが各replicaノード自身の上に生成されます。 +有効なslice分けのためには1つのsliceごとに1ノードを割り当てるべきですが、現在のところこのコマンドはそのようなパターンに対応していません。 +また、sliceは以下のreplicaの定義にもまだ対応できていません。 +これらの制限事項は将来のバージョンで解消される予定です。 + +### 2つ以上のデータセットを含むクラスタ + +クラスタ内に複数のデータセットを定義するには、`--dataset`オプションを使う必要があります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 20031 \ + --dataset Testing \ + --hosts 192.168.100.60,192.168.100.61 \ + --port 20032 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 20031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog \ + --dataset Testing \ + --n-workers 4 \ + --hosts 192.168.100.60,192.168.100.61 \ + --port 20032 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +上記の例の通り、データセットに紐付けられたオプションはそれに先行する最も近くに書かれた`--dataset`オプションで定義されるデータセットに対して影響を及ぼします。 + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.50:20031/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.51:20031/droonga.000" } } + ] + } + ] + }, + "Testing": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.60:20032/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.61:20032/droonga.000" } } + ] + } + ] + } + } +} +~~~ + + +## パラメータ {#parameters} + +`--output=PATH` +: 生成された`catalog.json`の保存先パス。 + `-`を指定した場合は標準出力に対して出力します。 + 指定されたパスの位置にある既存のファイルは、確認無しに上書きされます。 + 既定値は、そのコンピュータ上に設定される`droonga-engine`サービスの`catalog.json`の位置（`/home/droonga-engine/droonga/catalog.json`）です。 + +`--dataset=NAME` +: 新たに定義するデータセットの名前。 + 複数のデータセットを定義できるように、このオプションは複数回指定できます。 + 既定値は`Default`です。 + +`--n-workers=N` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、個々のvolumeに対して用意するworkerの数。 + 既定値は`4`です。 + +`--hosts=NAME1,NAME2,...` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、replicaとして使う1つ以上のEngineノードのホスト名。 + 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。 + +`--port=PORT` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うポート番号。 + 既定値は`10031`です。 + +`--tag=TAG` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うタグ名。 + 既定値は`droonga`です。 + +`--n-slices=N` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、各レプリカに用意するsliceの数。 + 既定値は`1`です。 + +`--plugins=PLUGIN1,PLUGIN2,...` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、有効化するプラグインの名前。 + 既定値は`groonga,search,crud,dump,system,catalog`（組み込みのプラグイン全ての一覧）です。 + +`--schema=PATH` +: 先行する`--dataset`オプションで定義されたデータセット向けのスキーマ定義を含んだJSONファイルのパス。 + +`--fact=TABLE` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、fact表として扱うtableの名前。 + +`--replicas=PATH` +: 先行する`--dataset`オプションで定義されたデータセット向けのreplica群の定義を含んだJSONファイルのパス。 + このオプションが指定された場合、データセット内にreplica群を定義するための他のオプション（`--hosts`、`--port`、`--tag`、および`--n-slices`）は全て無視されます。 + +## インストール方法 {#install} + +このコマンドは、Rubygemsのパッケージ`droonga-engine`の一部としてインストールされます。 + + +~~~ +# gem install droonga-engine +~~~ + Added: ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.md (+362 -0) 100644 =================================================================== --- /dev/null +++ ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.md 2015-05-08 18:52:22 +0900 (8616f5e) @@ -0,0 +1,362 @@ +--- +title: droonga-engine-catalog-generate +layout: ja +--- + +{% comment %} +############################################## + THIS FILE IS AUTOMATICALLY GENERATED FROM + "_po/ja/reference/1.1.1/command-line-tools/droonga-engine-catalog-generate/index.po" + DO NOT EDIT THIS FILE MANUALLY! +############################################## +{% endcomment %} + + +* TOC +{:toc} + +## 概要 {#abstract} + +`droonga-engine-catalog-generate`は、Droonga Engineノード用の新しい[`catalog.json`ファイル](../../catalog/version2/)を生成します。 + +多くの場合において、このコマンドを使う必要はまずありません。代わりに、Engineノードの初期化には[`droonga-engine-configure`コマンド](../droonga-engine-configure/)を使い、クラスタ構成の変更には[`droonga-engine-join`](../droonga-engine-join/)や['droonga-engine-unjoin`](../droonga-engine-unjoin/)のような管理コマンドを使って下さい。 + +## 例 {#examples} + +### 1つだけのボリュームを持つ孤立したクラスタ + +最も一般的な使い方は、[`droonga-engine-join`コマンド](../droonga-engine-join/)によって管理される新しいレプリカノードとして、孤立したEngineノード用の`catalog.json`を生成する場面です。例えば、まだ準備されていないノードである`192.168.100.50`にログインしている場合のコマンド列は以下の通りです： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate --hosts 192.168.100.50 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50 \ + --port 10031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +`--n-workers`、`--hosts`、`--port`、`--tag`、`--n-slices`および`--plugins`の各オプションは、最も近くに書かれた先行する`--dataset`オプションに紐付けられています。 +ユーザが指定した`--dataset`オプションよりも前に書かれたこれらのオプションの指定は、自動的に既定のデータセット名`Default`に対して紐付けられます。 + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { + "weight": 100, + "volume": { "address": "192.168.100.50:10031/droonga.000" } + } + ] + } + ] + } + } +} +~~~ + + +### 複数のreplicaノードを含むクラスタ + +複数のreplicaノードを持つデータセットを定義するには、replicaノードとして使われる全てのノードのホスト名を`,`（カンマ）で区切って`--host`オプションに指定します： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 10031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.50:10031/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.51:10031/droonga.000" } } + ] + } + ] + } + } +} +~~~ + + +### 複数のreplicaノードと、それぞれのreplicaについて複数のsliceを含むクラスタ + +sliceに分割されたreplicaを持つデータセットを定義するためには、`--n-slices`オプションをそのデータセットに対して指定する必要があります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 \ + --n-slices 2 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 10031 \ + --tag droonga \ + --n-slices 2 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 50, + "volume": { "address": "192.168.100.50:10031/droonga.000" } }, + { "weight": 50, + "volume": { "address": "192.168.100.50:10031/droonga.001" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 50, + "volume": { "address": "192.168.100.51:10031/droonga.000" } }, + { "weight": 50, + "volume": { "address": "192.168.100.51:10031/droonga.001" } } + ] + } + ] + } + } +} +~~~ + +`2`またはそれより大きな数を`--n-slices`オプションで指定すると、複数のsliceが各replicaノード自身の上に生成されます。 +有効なslice分けのためには1つのsliceごとに1ノードを割り当てるべきですが、現在のところこのコマンドはそのようなパターンに対応していません。 +また、sliceは以下のreplicaの定義にもまだ対応できていません。 +これらの制限事項は将来のバージョンで解消される予定です。 + +### 2つ以上のデータセットを含むクラスタ + +クラスタ内に複数のデータセットを定義するには、`--dataset`オプションを使う必要があります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 20031 \ + --dataset Testing \ + --hosts 192.168.100.60,192.168.100.61 \ + --port 20032 +~~~ + +省略されたオプションを含めた完全な指定はこのようになります： + +~~~ +(on 192.168.100.50) +# droonga-engine-catalog-generate \ + --output /home/droonga-engine/droonga/catalog.json \ + --dataset Default \ + --n-workers 4 \ + --hosts 192.168.100.50,192.168.100.51 \ + --port 20031 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog \ + --dataset Testing \ + --n-workers 4 \ + --hosts 192.168.100.60,192.168.100.61 \ + --port 20032 \ + --tag droonga \ + --n-slices 1 \ + --plugins groonga,search,crud,dump,system,catalog +~~~ + +上記の例の通り、データセットに紐付けられたオプションはそれに先行する最も近くに書かれた`--dataset`オプションで定義されるデータセットに対して影響を及ぼします。 + +生成された`catalog.json`の例は以下の通りです： + +~~~ +{ + "version": 2, + "effectiveDate": "2015-05-08T09:02:12+00:00", + "datasets": { + "Default": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.50:20031/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.51:20031/droonga.000" } } + ] + } + ] + }, + "Testing": { + "nWorkers": 4, + "plugins": ["groonga", "search", "crud", "dump", "system", "catalog"], + "schema": {}, + "replicas": [ + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.60:20032/droonga.000" } } + ] + }, + { + "dimension": "_key", + "slicer": "hash", + "slices": [ + { "weight": 100, + "volume": { "address": "192.168.100.61:20032/droonga.000" } } + ] + } + ] + } + } +} +~~~ + + +## パラメータ {#parameters} + +`--output=PATH` +: 生成された`catalog.json`の保存先パス。 + `-`を指定した場合は標準出力に対して出力します。 + 指定されたパスの位置にある既存のファイルは、確認無しに上書きされます。 + 既定値は、そのコンピュータ上に設定される`droonga-engine`サービスの`catalog.json`の位置（`/home/droonga-engine/droonga/catalog.json`）です。 + +`--dataset=NAME` +: 新たに定義するデータセットの名前。 + 複数のデータセットを定義できるように、このオプションは複数回指定できます。 + 既定値は`Default`です。 + +`--n-workers=N` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、個々のvolumeに対して用意するworkerの数。 + 既定値は`4`です。 + +`--hosts=NAME1,NAME2,...` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、replicaとして使う1つ以上のEngineノードのホスト名。 + 既定値は、コマンドを実行しているコンピュータ自身の推測されたホスト名です。 + +`--port=PORT` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うポート番号。 + 既定値は`10031`です。 + +`--tag=TAG` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、Engineノードとの通信に使うタグ名。 + 既定値は`droonga`です。 + +`--n-slices=N` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、各レプリカに用意するsliceの数。 + 既定値は`1`です。 + +`--plugins=PLUGIN1,PLUGIN2,...` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、有効化するプラグインの名前。 + 既定値は`groonga,search,crud,dump,system,catalog`（組み込みのプラグイン全ての一覧）です。 + +`--schema=PATH` +: 先行する`--dataset`オプションで定義されたデータセット向けのスキーマ定義を含んだJSONファイルのパス。 + +`--fact=TABLE` +: 先行する`--dataset`オプションで定義されたデータセットにおいて、fact表として扱うtableの名前。 + +`--replicas=PATH` +: 先行する`--dataset`オプションで定義されたデータセット向けのreplica群の定義を含んだJSONファイルのパス。 + このオプションが指定された場合、データセット内にreplica群を定義するための他のオプション（`--hosts`、`--port`、`--tag`、および`--n-slices`）は全て無視されます。 + +## インストール方法 {#install} + +このコマンドは、Rubygemsのパッケージ`droonga-engine`の一部としてインストールされます。 + + +~~~ +# gem install droonga-engine +~~~ + -------------- next part -------------- HTML����������������������������...Download