Piro / YUKI Hiroshi
null+****@clear*****
Fri May 8 02:15:04 JST 2015
Piro / YUKI Hiroshi 2015-05-08 02:15:04 +0900 (Fri, 08 May 2015) New Revision: 66763b4407067ea5f919bdb38af4ce3b855e782f https://github.com/droonga/droonga.org/commit/66763b4407067ea5f919bdb38af4ce3b855e782f Message: Write command line tool references for droonga-engine-join and droonga-engine-absorb-data Modified files: reference/1.1.1/command-line-tools/droonga-engine-absorb-data/index.md reference/1.1.1/command-line-tools/droonga-engine-join/index.md Modified: reference/1.1.1/command-line-tools/droonga-engine-absorb-data/index.md (+74 -2) =================================================================== --- reference/1.1.1/command-line-tools/droonga-engine-absorb-data/index.md 2015-05-08 00:23:17 +0900 (73f1d10) +++ reference/1.1.1/command-line-tools/droonga-engine-absorb-data/index.md 2015-05-08 02:15:04 +0900 (630b98d) @@ -8,11 +8,83 @@ layout: en ## Abstract {#abstract} -(TBD) +`droonga-engine-absorb-data` copies all data of the specified source dataset to the destination dataset. + +For example, if there is a Droonga Engine node `192.168.100.50` which is a node in the source cluster and you are logged in to a computer `192.168.200.10` which is another Droonga Engine node in the destination cluster, the command line to copy all data from `192.168.100.50` to `192.168.200.10` is: + +~~~ +(on 192.168.100.10) +$ droonga-engine-absorb-data --host 192.168.200.10 \ + --receiver-host 192.168.200.10 \ + --source-host 192.168.100.50 +Start to absorb data from Defau****@192*****:10031/droonga + to Defau****@192*****:10031/droonga + via 192.168.200.10 (this host) + +Absorbing... +Getting the timestamp of the last processed message in the source node... +The timestamp of the last processed message in the source node: 2015-04-29T10:07:08.230158Z +Setting the destination node to ignore messages older than the timestamp... +100% done (maybe 00:00:00 remaining) +Done. +~~~ + +See also [the tutorial about copying data between multiple Droonga clusters](/tutorial/dump-restore/). + ## Parameters {#parameters} -(TBD) +`--host=NAME` +: Host name of the destination engine node to copy data. + This is a required parameter. + +`--port=PORT` +: Port number to communicate with the destination engine node. + `10031` by default. + +`--tag=TAG` +: Tag name to communicate with the destination engine node. + `droonga` by default. + +`--dataset=NAME` +: Name of the destination dataset for copying data. + `Default` by default. + +`--source-host=NAME` +: Host name of the soruce engine node to copy data. + This is a required parameter. + +`--source-port=PORT` +: Port number to communicate with the soruce engine node. + `10031` by default. + +`--source-tag=TAG` +: Tag name to communicate with the soruce engine node. + `droonga` by default. + +`--source-dataset=NAME` +: Name of the soruce dataset for copying data. + `Default` by default. + +`--receiver-host=NAME` +: Host name of the computer you are running this command. + A guessed host name of the computer, by default. + +`--records-per-second=N` +: Maximum number of records to be copied per one second. + `-1` means "no limit". + `100` by default. + +`--progress-interval-seconds=SECONDS` +: Interval seconds to report progress of data copying. + `3` by default. + +`--[no-]verbose` +: Output details for internal operations or not. + This is mainly for debugging. + +`--help` +: Shows the usage of the command. ## How to install {#install} Modified: reference/1.1.1/command-line-tools/droonga-engine-join/index.md (+78 -2) =================================================================== --- reference/1.1.1/command-line-tools/droonga-engine-join/index.md 2015-05-08 00:23:17 +0900 (ac1be92) +++ reference/1.1.1/command-line-tools/droonga-engine-join/index.md 2015-05-08 02:15:04 +0900 (3fc381b) @@ -8,11 +8,87 @@ layout: en ## Abstract {#abstract} -(TBD) +`droonga-engine-join` puts an orphan Droonga Engine node in an existing Droonga cluster as a new replica node. + +For example, if there is an existing Droonga Engine node `192.168.100.50` which is a replica node in a cluster and you are logged in to a computer `192.168.100.10` which is already prepared orphan Engine node in the same network segment, the command line to put the joining node `192.168.100.10` in the cluster as a new replica node is: + +~~~ +(on 192.168.100.10) +$ droonga-engine-join --host 192.168.100.10 \ + --receiver-host 192.168.100.10 \ + --replica-source-host 192.168.100.50 +Start to join a new node 192.168.100.10 + to the cluster of 192.168.100.50 + via 192.168.100.10 (this host) + port = 10031 + tag = droonga + dataset = Default + +Source Cluster ID: 8951f1b01583c1ffeb12ed5f4093210d28955988 + +Changing role of the joining node... +Configuring the joining node as a new replica for the cluster... +Registering new node to existing nodes... +Changing role of the source node... +Getting the timestamp of the last processed message in the source node... +The timestamp of the last processed message at the source node: 2015-05-07T02:39:50.334377Z +Setting new node to ignore messages older than the timestamp... +Copying data from the source node... +100% done (maybe 00:00:00 remaining) +Restoring role of the source node... +Restoring role of the joining node... +Done. +~~~ + +See also [the tutorial about adding new replica to a Droonga node](/tutorial/add-replica/). + ## Parameters {#parameters} -(TBD) +`--no-copy` +: Don't copy data from the source node. + If you specify this option, the node joins as a replica without synchronizing of data. + +`--host=NAME` +: Host name of the new node to be joined. + This is a required parameter. + +`--replica-source-host=NAME` +: Host name of the soruce node in the cluster to join. + This is a required parameter. + +`--port=PORT` +: Port number to communicate with engine nodes. + `10031` by default. + +`--tag=TAG` +: Tag name to communicate with engine nodes. + `droonga` by default. + +`--dataset=NAME` +: Dataset name the node is going to join as a replica in. + `Default` by default. + +`--receiver-host=NAME` +: Host name of the computer you are running this command. + A guessed host name of the computer, by default. + +`--records-per-second=N` +: Maximum number of records to be copied per one second. + `-1` means "no limit". + `100` by default. + +`--progress-interval-seconds=SECONDS` +: Interval seconds to report progress of data copying. + `3` by default. + +`--verbose` +: Output details for internal operations. + This is mainly for debugging. + +`-h`, `--help` +: Shows the usage of the command. + ## How to install {#install} -------------- next part -------------- HTML����������������������������...Download