Mailing-List: contact commits-help@accumulo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@accumulo.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: ecn@apache.org
To: commits@accumulo.apache.org
Date: Wed, 11 Dec 2013 14:16:19 -0000
Message-Id: <7d7ea2d1f7954bdea19b47f243038137@git.apache.org>
In-Reply-To: <75a4a28e634e4de09bbcb1af5e354d6a@git.apache.org>
References: <75a4a28e634e4de09bbcb1af5e354d6a@git.apache.org>
Subject: [04/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 <eric.newton@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/master
Commit: ff29f08a7d79be3baecb356a05444f342b74b620
Parents: 19a48da
Author: Alex Moundalexis <alexm@clouderagovt.com>
Authored: Mon Dec 9 16:33:57 2013 -0500
Committer: Eric Newton <eric.newton@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 &gt;host(s)&gt; {&lt;host&gt; ...}
+</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 &gt;host(s)&gt; {&lt;host&gt; ...}
+</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