This is an automated email from the ASF dual-hosted git repository. ishan pushed a commit to branch jira/SOLR15694 in repository https://gitbox.apache.org/repos/asf/solr.git
commit a501b777c64d126aaeac92c22d858a6f281ed9be Author: Ishan Chattopadhyaya <[email protected]> AuthorDate: Sat Dec 18 15:40:38 2021 +0530 Ref guide fixes --- solr/solr-ref-guide/src/node-roles.adoc | 29 ++++++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) diff --git a/solr/solr-ref-guide/src/node-roles.adoc b/solr/solr-ref-guide/src/node-roles.adoc index ed2c07a..19c5beb 100644 --- a/solr/solr-ref-guide/src/node-roles.adoc +++ b/solr/solr-ref-guide/src/node-roles.adoc @@ -37,10 +37,10 @@ In order to specify role(s) for a node, one needs to start a Solr node with the |Parameter |Value |Required? | Default |solr.node.roles -|Comma separated list of roles (in the format: <role>:<mode>) for this node. -Examples: "data:on,overseer:allowed" or "overseer:preferred" +|Comma separated list of roles (in the format: `<role>:<mode>`) for this node. +Examples: `-Dsolr.node.roles=data:on,overseer:allowed` or `-Dsolr.node.roles=overseer:preferred` |No -|data:on,overseer:allowed +|`data:on,overseer:allowed` |=== [TIP] @@ -48,6 +48,17 @@ Examples: "data:on,overseer:allowed" or "overseer:preferred" If a node has been started with no `solr.node.roles` parameter, it will be assumed to have the data role turned on and overseer role allowed on it. If you've never needed roles before, you likely won't need to change anything in your startup parameters to accomodate the functionality associated with these roles. ==== +.Supported roles +[cols="1,1"] +|=== +|Role |Modes + +|`data` +|on, off + +|`overseer` +|allowed, preferred, disallowed +|=== === `data` role A node with this role (in mode "on") can host shards and replicas for collections. @@ -55,9 +66,9 @@ A node with this role (in mode "on") can host shards and replicas for collection === `overseer` role A node with this role can perform duties of an overseer node (unless mode is `disallowed`). When one or more nodes have the overseer role in `preferred` mode, the overseer leader will be elected from one of these nodes. In case no node is designated as a preferred overseer or no such node is live, the overseer leader will be elected from one of the nodes that have the overseer role in `allowed` mode. If all nodes that are designated with overseer role (allowed or preferred) are down, the [...] -== A typical scenario of roles usage +== Example usage -A common situation arises when the nodes in a cluster is under heavy querying or indexing load, and under such circumstances the overseer leader node is unable to perform collection management duties efficiently. It might be reasonable to have dedicated nodes to act as the overseer. Such an effect can be achieved as follows: +Sometimes, when the nodes in a cluster is under heavy querying or indexing load, the overseer leader node is unable to perform collection management duties efficiently. It might be reasonable to have dedicated nodes to act as the overseer. Such an effect can be achieved as follows: * Most nodes, say 10 of them, in the cluster start with `-Dsolr.node.roles=data:on,overseer:allowed` (or with no parameter, since the default value for `solr.node.roles` is the same). * One or more nodes can start with `-Dsolr.node.roles=overseer:preferred` (or `-Dsolr.node.roles=overseer:preferred,data:off`) @@ -68,6 +79,8 @@ In this arrangement, such dedicated nodes can have lesser resources than other d === GET /api/cluster/node-roles/supported +Fetches the list of supported roles and their supported modes for this cluster. + *Input* [source,text] ---- @@ -96,6 +109,8 @@ curl http://localhost:8983/api/cluster/node-roles/supported === GET /api/cluster/node-roles +Fetches the current node roles assignment for all the nodes in the cluster. + *Input* [source,text] ---- @@ -122,6 +137,8 @@ curl http://localhost:8983/api/cluster/node-roles === GET /api/cluster/node-roles/{role} +Fetches the current node roles assignment for a specified role. + *Input* [source,text] ---- @@ -144,6 +161,8 @@ http://localhost:8983/api/node-roles/data === GET /api/cluster/node-roles/nodes/{node} +Fetches the current node roles assignment for the specified node. + *Input* [source,text] ----
