drill-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bridg...@apache.org
Subject drill-site git commit: DRILL-4286 doc for graceful shutdown feature
Date Mon, 19 Mar 2018 22:15:38 GMT
Repository: drill-site
Updated Branches:
  refs/heads/asf-site 42204ec51 -> 3c2376415

DRILL-4286 doc for graceful shutdown feature

Project: http://git-wip-us.apache.org/repos/asf/drill-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/drill-site/commit/3c237641
Tree: http://git-wip-us.apache.org/repos/asf/drill-site/tree/3c237641
Diff: http://git-wip-us.apache.org/repos/asf/drill-site/diff/3c237641

Branch: refs/heads/asf-site
Commit: 3c23764151889f83c192634a6f1b4fd1b8ff70c4
Parents: 42204ec
Author: Bridget Bevens <bbevens@maprtech.com>
Authored: Mon Mar 19 15:15:21 2018 -0700
Committer: Bridget Bevens <bbevens@maprtech.com>
Committed: Mon Mar 19 15:15:21 2018 -0700

 .../index.html                                  | 47 +++++++++++++++++---
 feed.xml                                        |  4 +-
 2 files changed, 44 insertions(+), 7 deletions(-)

diff --git a/docs/starting-drill-in-distributed-mode/index.html b/docs/starting-drill-in-distributed-mode/index.html
index 9586594..8bb7c36 100644
--- a/docs/starting-drill-in-distributed-mode/index.html
+++ b/docs/starting-drill-in-distributed-mode/index.html
@@ -1214,7 +1214,7 @@
-     Feb 8, 2018
+     Mar 19, 2018
     <link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1237,11 +1237,11 @@
 <li>Configure a Drillbit to restart by default</li>
-<p>You can use a configuration file to start Drillbits. Using such a file is handy
for controlling Drillbits on multiple nodes.</p>
+<p>You can use a configuration file to start Drillbits. A configuration file is useful
for controlling Drillbits on multiple nodes.</p>
 <h3 id="drillbit.sh-command-syntax">drillbit.sh Command Syntax</h3>
-<p><code>drillbit.sh [--config &lt;conf-dir&gt;] (start|stop|status|restart|autorestart)</code></p>
+<p><code>drillbit.sh [--config &lt;conf-dir&gt;] (start|stop|graceful_stop|status|restart|autorestart)</code></p>
 <p>For example, to restart a Drillbit on a tarball installation, navigate to the Drill
installation directory, and issue the following command from the installation directory:</p>
@@ -1311,9 +1311,46 @@ Drill lists information about the Drillbits that are running, such
as the host n
 <h2 id="stopping-drill">Stopping Drill</h2>
-<p>Navigate to the Drill installation directory, and issue the following command to
stop a Drillbit:</p>
+<p>You can abruptly stop the Drill process on a node, or you can have the Drill process
on the node shutdown gracefully. When you stop the Drill process on a node, active queries
cannot complete if they require additional time to complete beyond the default five second
wait period. In Drill 1.12 and later, you can use the Graceful Shutdown option, which transitions
a Drillbit into a quiescent state in which the Drill process can complete in-progress queries
before shutting down.  </p>
-<p><code>bin/drillbit.sh stop</code></p>
+<h3 id="stopping-drill">Stopping Drill</h3>
+<p>To stop the Drill process on the node, issue the <code>drillbit.sh stop</code>
command, as shown:  </p>
+<div class="highlight"><pre><code class="language-text" data-lang="text">
  bin/drillbit.sh stop   
+<h3 id="graceful-shutdown">Graceful Shutdown</h3>
+<p>Graceful shutdown is enabled by default. You can gracefully shutdown a Drillbit
from the command line or the Drill Web Console. When you initiate a graceful shutdown from
the Drill Web Console, the console posts an alert stating that a graceful shutdown was triggered.
You can see the progress of the shutdown as the Drillbit completes queries and transitions
through the quiescent state.  </p>
+<p><strong>How A Drillbit Shuts Down Gracefully</strong>  </p>
+<p>When a Drillbit shuts down gracefully, it transitions through a quiescent state
to complete in-progress queries. </p>
+<p>The following list describes the various states that a Drillbit transitions through,
including the quiescent state and phases within that state:  </p>
+<li><strong>Start</strong>: The Drillbit is initializing. For example,
when you issue the <code>drillbit.sh start</code> or <code>drillbit.sh restart</code>
+<li><strong>Online</strong>: The Drillbit has started and registered with
the cluster coordinator, such as ZooKeeper. ZooKeeper then shares the state of the Drillbit
with other Drillbits in the cluster. Drillbits in the online state can all accept and process
+<li><strong>Quiescent</strong>: When a Drillbit receives a graceful shutdown
request, the Drillbit transitions into the quiescent state and shares its status change with
the ZooKeeper. The ZooKeeper notifies the other Drillbits in the cluster of the Drillbit’s
status change. Once the other Drillbits get the status update, they do not assign work to
the Drillbit. However, if the Foreman assigns work to the Drillbit as the status update occurs,
the Drillbit waits to complete work before shutting down. The quiescent state has three phases:
grace, draining, and offline.<br>
+<li><strong>Grace</strong>: A period in which a Drillbit can accept new
queries from the Foreman. You can configure (at the system level) the amount of time a Drillbit
can remain in this phase using the <code>drill.exe.grace_period_ms</code> option.
Set this value in milliseconds. The default value is 0. There is no maximum limit. Ideally,
you should give as little time as possible or no longer than twice the default heartbeat time
of the ZooKeeper. For example, if the heartbeat is 5 seconds, set the value to the equivalent
of 10 seconds in milliseconds (10000).<br></li>
+<li><strong>Draining</strong>:  When the grace period ends, the Drillbit
enters the draining phase of the quiescent state. In this phase, the Drillbit cannot accept
new queries, but waits for the running queries to complete. You can view the draining queries
in the Drill Web Console. The Index page in the Web Console shows the queries and fragments
currently running on the node.<br></li>
+<li><strong>Offline</strong>: The phase the Drillbit enters after completing
all queries.<br></li>
+<li><strong>Shutdown</strong>: The final state in which a Drillbit removes
itself from the ZooKeeper registry.<br></li>
+<p><strong>Shutting Down a Drillbit Gracefully</strong><br>
+You can gracefully shutdown a node from the command line or the Drill Web Console. </p>
+<p>From the command line, run the following command on the node you want to shut down:
+<div class="highlight"><pre><code class="language-text" data-lang="text">
  drillbit.sh graceful_stop
+<p>From the Drill Web Console, enter the following URL in your browser’s address
+<div class="highlight"><pre><code class="language-text" data-lang="text">
  http://&lt;IP address or host name&gt;:8047 or https://&lt;IP address or host
+<p>In the Drill Web Console, open the Index page, and click Shutdown next to the Drillbit
you want to shut down.</p>

diff --git a/feed.xml b/feed.xml
index de1aa65..94308f5 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
     <atom:link href="/feed.xml" rel="self" type="application/rss+xml"/>
-    <pubDate>Sun, 18 Mar 2018 13:13:40 -0700</pubDate>
-    <lastBuildDate>Sun, 18 Mar 2018 13:13:40 -0700</lastBuildDate>
+    <pubDate>Mon, 19 Mar 2018 14:59:21 -0700</pubDate>
+    <lastBuildDate>Mon, 19 Mar 2018 14:59:21 -0700</lastBuildDate>
     <generator>Jekyll v2.5.2</generator>

View raw message