This is an automated email from the ASF dual-hosted git repository.
mmiller pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/master by this push:
new 8e9a703 Add instructions for multiple TServers in 2.1.0 (#225)
8e9a703 is described below
commit 8e9a70310d79dbddc30a877b98aa7fdb912873e8
Author: Arvind Shyamsundar <arvin...@microsoft.com>
AuthorDate: Mon Apr 6 09:06:07 2020 -0700
Add instructions for multiple TServers in 2.1.0 (#225)
* Explains the usage of accumulo-cluster and NUM_TSERVERS
* Adds details of filenames when running more than 1 TServer / node
---
_docs-2/administration/in-depth-install.md | 31 ++++++++++++++++++++++++++++--
1 file changed, 29 insertions(+), 2 deletions(-)
diff --git a/_docs-2/administration/in-depth-install.md
b/_docs-2/administration/in-depth-install.md
index 623ae51..09a53d6 100644
--- a/_docs-2/administration/in-depth-install.md
+++ b/_docs-2/administration/in-depth-install.md
@@ -459,14 +459,41 @@ started. Also, set the these properties in
[accumulo.properties]:
* {% plink tserver.port.search %} = `true`
* {% plink replication.receipt.service.port %} = `0`
-Multiple TabletServers cannot be started using the `accumulo-cluster` or
`accumulo-service` commands
-at this time. The `accumulo` command must be used:
+In order to start multiple TabletServers on a node, the `accumulo` command
must be used:
```
ACCUMULO_SERVICE_INSTANCE=1 ./bin/accumulo tserver &> ./logs/tserver1.out &
ACCUMULO_SERVICE_INSTANCE=2 ./bin/accumulo tserver &> ./logs/tserver2.out &
```
+#### Running multiple TabletServers per node in Accumulo 2.1.0 and later
+Starting with Accumulo 2.1.0, the `accumulo-cluster` script can be used along
with environment
+variable `NUM_TSERVERS` as a convenient alternative to the `accumulo` command
to start / stop
+multiple TabletServers per node. For example, the following commands can be
used to start / stop
+2 TabletServers on the current node:
+
+```
+NUM_TSERVERS=2 ./bin/accumulo-cluster start-here
+NUM_TSERVERS=2 ./bin/accumulo-cluster stop-here
+```
+
+To start / stop the entire Accumulo cluster with 2 TabletServers per worker
node, use:
+
+```
+NUM_TSERVERS=2 ./bin/accumulo-cluster start
+NUM_TSERVERS=2 ./bin/accumulo-cluster stop
+```
+
+Other commands like `accumulo-cluster start-tservers` and `accumulo-cluster
stop-tservers` support
+the use of `NUM_TSERVERS` to specify the number of TabletServers per worker
node.
+
+When `accumulo-cluster` is used along with `NUM_TSERVERS` greater than 1, the
resultant log files
+and redirected stdout / stderr files for each TabletServer running on the node
have the instance
+number as part of their respective filenames.
+
+Lastly, starting with Accumulo 2.1.0 the `accumulo-env.sh` script ensures that
Accumulo metrics
+are correctly associated with the respective instance number for each
TabletServer on a node.
+
## Logging
Accumulo processes each write to a set of log files. By default, these logs
are found at directory
