YUKI Hiroshi
null+****@clear*****
Fri May 8 11:40:32 JST 2015
YUKI Hiroshi 2015-05-08 11:40:32 +0900 (Fri, 08 May 2015) New Revision: 9ad75c915df7f4145a603e075b8134a88ea66eb5 https://github.com/droonga/droonga.org/commit/9ad75c915df7f4145a603e075b8134a88ea66eb5 Message: Complete description of droonga-engine-set-role command Modified files: reference/1.1.1/command-line-tools/droonga-engine-set-role/index.md Modified: reference/1.1.1/command-line-tools/droonga-engine-set-role/index.md (+49 -2) =================================================================== --- reference/1.1.1/command-line-tools/droonga-engine-set-role/index.md 2015-05-08 10:53:52 +0900 (93f8723) +++ reference/1.1.1/command-line-tools/droonga-engine-set-role/index.md 2015-05-08 11:40:32 +0900 (6c74c23) @@ -8,11 +8,58 @@ layout: en ## Abstract {#abstract} -(TBD) +`droonga-engine-set-role` changes the role of a Droonga Engine node to any specified role. + +A Droonga Engine node determines that an incoming message should be processed by self or not, based on [the messaeg's `targetRole` field](../../message/#request-targetRole). +[The `droonga-engine-join` command](../droonga-engine-join/) changes role of operated nodes, so if its operation is unexpectedly aborted, those nodes can stay inactive as a service provider. +Then you can reactivate nodes by changing of their role with this command. + +For example, if there is an existing Droonga Engine node `192.168.100.50` used as a source node for newly joining replica node, and you are logged in to a computer `192.168.100.10` in the same network segment, the command line to reactivate the node `192.168.100.50` is: + +~~~ +(on 192.168.100.10) +$ droonga-engine-set-role --host 192.168.100.50 \ + --role service-provider +Setting role of 192.168.100.50:10031/droonga to service-provider... +Done. +~~~ + +See also [the tutorial about adding new replica to a Droonga cluster](/tutorial/add-replica/). + ## Parameters {#parameters} -(TBD) +`--role=ROLE` +: New role for the engine node. + This is a required parameter. + Possible values: + + * `service-provider`: + The node is activated as a service provider. + * `absorb-source`: + The node is deactivated as a service provider and becomes to a source node to copy data. + * `absorb-destination`: + The node is deactivated as a service provider and becomes to a destination node to copy data. + +`--host=NAME` +: Host name of the engine node to be changed its role. + A guessed host name of the computer you are running the command, by default. + +`--port=PORT` +: Port number to communicate with the engine node. + `10031` by default. + +`--tag=TAG` +: Tag name to communicate with the engine node. + `droonga` 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