accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From e..@apache.org
Subject [01/11] git commit: ACCUMULO-1956 expand docs, addition/decommision of cluster nodes
Date Wed, 11 Dec 2013 14:16:16 GMT
Updated Branches:
  refs/heads/1.4.5-SNAPSHOT 19a48da09 -> ff29f08a7
  refs/heads/1.5.1-SNAPSHOT 7655de68f -> e9423ae35
  refs/heads/1.6.0-SNAPSHOT 8f9258500 -> 0d874d05a
  refs/heads/master 71dc0527f -> f84e9a1f3


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/1.4.5-SNAPSHOT
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


Mime
View raw message