Repository: accumulo Updated Branches: refs/heads/1.6 da7aaeae9 -> 97a92a091 refs/heads/1.7 5efa0bd9b -> 14e88e4ba refs/heads/master 7b1e26ae2 -> 7f4cb62b0
ACCUMULO-4072 Document how to run multiple tservers on one host in user manual Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/97a92a09 Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/97a92a09 Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/97a92a09 Branch: refs/heads/1.6 Commit: 97a92a0917fa9e55fb8b033846705c24f870e764 Parents: da7aaea Author: Josh Elser <els...@apache.org> Authored: Mon Dec 28 13:28:56 2015 -0500 Committer: Josh Elser <els...@apache.org> Committed: Mon Dec 28 13:28:56 2015 -0500 ---------------------------------------------------------------------- .../chapters/administration.tex | 48 +++++++++++++++++++- 1 file changed, 46 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo/blob/97a92a09/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex ---------------------------------------------------------------------- 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: \begingroup\fontsize{8pt}{8pt}\selectfont\begin{verbatim} -$ACCUMULO\_HOME/bin/start-here.sh +$ACCUMULO_HOME/bin/start-here.sh \end{verbatim}\endgroup 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: \begingroup\fontsize{8pt}{8pt}\selectfont\begin{verbatim} -$ACCUMULO\_HOME/bin/stop-here.sh +$ACCUMULO_HOME/bin/stop-here.sh \end{verbatim}\endgroup 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 configuration +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 to/from +other nodes. This requires additional configuration values in \texttt{accumulo-site.xml}: + +\begin{itemize} + \item tserver.port.client +\end{itemize} + +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 a +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{accumulo-env.sh}. + +\begin{itemize} + \item ACCUMULO\_LOG\_DIR +\end{itemize} + +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 process +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. + +\begingroup\fontsize{8pt}{8pt}\selectfont\begin{verbatim} +$ACCUMULO_CONF_DIR=$ACCUMULO_HOME/conf $ACCUMULO_HOME/bin/accumulo tserver --address <your_server_ip> & +\end{verbatim}\endgroup + +To stop TabletServers, the normal \texttt{stop-all.sh} 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{stop-server.sh} can be used to stop all TabletServers on a single node. + \section{Monitoring} The Accumulo Master provides an interface for monitoring the status and health of
