You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by ec...@apache.org on 2013/12/11 15:16:18 UTC
[03/11] git commit: ACCUMULO-1956 expand docs,
addition/decommision of cluster nodes
ACCUMULO-1956 expand docs, addition/decommision of cluster nodes
Signed-off-by: Eric Newton <er...@gmail.com>
Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo
Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/ff29f08a
Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/ff29f08a
Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/ff29f08a
Branch: refs/heads/1.6.0-SNAPSHOT
Commit: ff29f08a7d79be3baecb356a05444f342b74b620
Parents: 19a48da
Author: Alex Moundalexis <al...@clouderagovt.com>
Authored: Mon Dec 9 16:33:57 2013 -0500
Committer: Eric Newton <er...@gmail.com>
Committed: Wed Dec 11 09:15:04 2013 -0500
----------------------------------------------------------------------
docs/administration.html | 23 ++++++++++++++
.../src/user_manual/chapters/administration.tex | 32 ++++++++++++++++++++
2 files changed, 55 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/accumulo/blob/ff29f08a/docs/administration.html
----------------------------------------------------------------------
diff --git a/docs/administration.html b/docs/administration.html
index b0c8e88..b8712dc 100644
--- a/docs/administration.html
+++ b/docs/administration.html
@@ -53,6 +53,29 @@ ask the master to shut down the tablet servers gracefully. If the tablet servers
at the password prompt, and waiting 15 seconds for the script to force a shutdown. Normally, once the shutdown happens gracefully, unresponsive tablet servers are
forcibly shut down after 5 seconds.
+<h3>Adding a Node</h3>
+
+<p>Update your <code>$ACCUMULO_HOME/conf/slaves</code> (or <code>$ACCUMULO_CONF_DIR/slaves</code>) file to account for the addition; at a minimum this needs to be on the host(s) being added, but in practice it's good to ensure consistent configuration across all nodes.</p>
+
+<pre>
+$ACCUMULO_HOME/bin/accumulo admin start >host(s)> {<host> ...}
+</pre>
+
+<p>Alternatively, you can ssh to each of the hosts you want to add and run <code>$ACCUMULO_HOME/bin/start-here.sh</code>.</p>
+
+<p>Make sure the host in question has the new configuration, or else the tablet server won't start.</p>
+
+<h3>Decomissioning a Node</h3>
+
+<p>If you need to take a node out of operation, you can trigger a graceful shutdown of a tablet server. Accumulo will automatically rebalance the tablets across the available tablet servers.</p>
+
+<pre>
+$ACCUMULO_HOME/bin/accumulo admin stop >host(s)> {<host> ...}
+</pre>
+
+<p>Alternatively, you can ssh to each of the hosts you want to remove and run <code>$ACCUMULO_HOME/bin/stop-here.sh</code>.</p>
+
+<p>Be sure to update your <code>$ACCUMULO_HOME/conf/slaves</code> (or <code>$ACCUMULO_CONF_DIR/slaves</code>) file to account for the removal of these hosts. Bear in mind that the monitor will not re-read the slaves file automatically, so it will report the decomissioned servers as down; it's recommended that you restart the monitor so that the node list is up to date.</p>
<h3>Configuration</h3>
<p>Accumulo configuration information is stored in a xml file and ZooKeeper. System wide
http://git-wip-us.apache.org/repos/asf/accumulo/blob/ff29f08a/docs/src/user_manual/chapters/administration.tex
----------------------------------------------------------------------
diff --git a/docs/src/user_manual/chapters/administration.tex b/docs/src/user_manual/chapters/administration.tex
index f3feca5..d0533d9 100644
--- a/docs/src/user_manual/chapters/administration.tex
+++ b/docs/src/user_manual/chapters/administration.tex
@@ -184,6 +184,38 @@ To shutdown cleanly, run \texttt{bin/stop-all.sh} and the master will orchestrat
shutdown of all the tablet servers. Shutdown waits for all minor compactions to finish, so it may
take some time for particular configurations.
+\subsection{Adding a Node}
+
+Update your \texttt{\$ACCUMULO_HOME/conf/slaves} (or \texttt{\$ACCUMULO_CONF_DIR/slaves}) file to account for the addition.
+
+\begin{verbatim}
+$ACCUMULO_HOME/bin/accumulo admin start <host(s)> {<host> ...}
+\end{verbatim}
+
+Alternatively, you can ssh to each of the hosts you want to add and run
+\texttt{\$ACCUMULO_HOME/bin/start-here.sh}.
+
+Make sure the host in question has the new configuration, or else the tablet
+server won't start; at a minimum this needs to be on the host(s) being added,
+but in practice it's good to ensure consistent configuration across all nodes.
+
+\subsection{Decomissioning a Node}
+
+If you need to take a node out of operation, you can trigger a graceful shutdown of a tablet
+server. Accumulo will automatically rebalance the tablets across the available tablet servers.
+
+\begin{verbatim}
+$ACCUMULO_HOME/bin/accumulo admin stop <host(s)> {<host> ...}
+\end{verbatim}
+
+Alternatively, you can ssh to each of the hosts you want to remove and run
+\texttt{\$ACCUMULO_HOME/bin/stop-here.sh}.
+
+Be sure to update your \texttt{\$ACCUMULO_HOME/conf/slaves} (or \texttt{\$ACCUMULO_CONF_DIR/slaves}) file to
+account for the removal of these hosts. Bear in mind that the monitor will not re-read the
+slaves file automatically, so it will report the decomissioned servers as down; it's
+recommended that you restart the monitor so that the node list is up to date.
+
\section{Monitoring}
The Accumulo Master provides an interface for monitoring the status and health of