accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [3/6] accumulo git commit: ACCUMULO-4072 Document how to run multiple tservers on one host in user manual
Date Mon, 28 Dec 2015 18:43:36 GMT
ACCUMULO-4072 Document how to run multiple tservers on one host in user manual


Branch: refs/heads/master
Commit: 97a92a0917fa9e55fb8b033846705c24f870e764
Parents: da7aaea
Author: Josh Elser <>
Authored: Mon Dec 28 13:28:56 2015 -0500
Committer: Josh Elser <>
Committed: Mon Dec 28 13:28:56 2015 -0500

 .../chapters/administration.tex                 | 48 +++++++++++++++++++-
 1 file changed, 46 insertions(+), 2 deletions(-)
diff --git a/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex b/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex
index 120e88b..73044c1 100644
--- a/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex
+++ b/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex
@@ -342,7 +342,7 @@ $ACCUMULO_HOME/bin/accumulo admin start <host(s)> {<host>
 Alternatively, you can ssh to each of the hosts you want to add and run:
 Make sure the host in question has the new configuration, or else the tablet 
@@ -361,7 +361,7 @@ $ACCUMULO_HOME/bin/accumulo admin stop <host[:port]> {<host[:port]>
 Alternatively, you can ssh to each of the hosts you want to remove and run:
 Be sure to update your \texttt{\$ACCUMULO\_HOME/conf/slaves} (or \texttt{\$ACCUMULO\_CONF\_DIR/slaves})
file to 
@@ -389,6 +389,50 @@ from the \texttt{\$ACCUMULO\_HOME/conf/slaves} file) to gracefully stop
a node.
 ensure that the tabletserver is cleanly stopped and recovery will not need to be performed
 when the tablets are re-hosted.
+\subsection{Running multiple TabletServers on a single node}
+With very powerful nodes, it may be beneficial to run more than one TabletServer on a given
+node. This decision should be made carefully and with much deliberation as Accumulo is designed
+to be able to scale to using 10's of GB of RAM and 10's of CPU cores.
+To run multiple TabletServers on a single host, it is necessary to create multiple Accumulo
+directories. Ensuring that these properties are appropriately set (and remain consistent)
are an exercise
+for the user.
+Accumulo TabletServers bind certain ports on the host to accommodate remote procedure calls
+other nodes. This requires additional configuration values in \texttt{accumulo-site.xml}:
+  \item tserver.port.client
+Normally, setting a value of \texttt{0} for these configuration properties is sufficient.
In some
+environment, the ports used by Accumulo must be well-known for security reasons and require
+separate copy of the configuration files to use a static port for each TabletServer instance.
+It is also necessary to update the following exported variables in \texttt{}.
+The values for these properties are left up to the user to define; there are no constraints
+other than ensuring that the directory exists and the user running Accumulo has the permission
+to read/write into that directory.
+Accumulo's provided scripts for stopping a cluster operate under the assumption that one
+is running per host. As such, starting and stopping multiple TabletServers on one host requires
+more effort on the user. It is important to ensure that \texttt{ACCUMULO\_CONF\_DIR} is correctly
+set for the instance of the TabletServer being started.
+$ACCUMULO_CONF_DIR=$ACCUMULO_HOME/conf $ACCUMULO_HOME/bin/accumulo tserver --address <your_server_ip>
+To stop TabletServers, the normal \texttt{} will stop all instances of TabletServers
across all nodes.
+Using the provided \texttt{kill} command by your operation system is an option to stop a
single instance on
+a single node. \texttt{} can be used to stop all TabletServers on a single
 The Accumulo Master provides an interface for monitoring the status and health of

View raw message