drill-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From krish...@apache.org
Subject drill git commit: clarify install docs
Date Wed, 30 Dec 2015 19:34:55 GMT
Repository: drill
Updated Branches:
  refs/heads/gh-pages 2a99c0d57 -> 175cfed09


clarify install docs

minor edit


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

Branch: refs/heads/gh-pages
Commit: 175cfed09a6e34272535ca6e1697393fd6c4b48e
Parents: 2a99c0d
Author: Kris Hahn <krishahn@apache.org>
Authored: Wed Dec 30 11:09:53 2015 -0800
Committer: Kris Hahn <krishahn@apache.org>
Committed: Wed Dec 30 11:33:41 2015 -0800

----------------------------------------------------------------------
 _docs/install/010-install-drill-introduction.md        | 11 ++++++-----
 _docs/install/045-distributed-mode-prerequisites.md    | 10 +++++-----
 _docs/install/047-installing-drill-on-the-cluster.md   |  8 ++++----
 .../install/050-starting-drill-in-distributed-mode.md  |  4 ++--
 .../010-embedded-mode-prerequisites.md                 | 13 +++++--------
 5 files changed, 22 insertions(+), 24 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/drill/blob/175cfed0/_docs/install/010-install-drill-introduction.md
----------------------------------------------------------------------
diff --git a/_docs/install/010-install-drill-introduction.md b/_docs/install/010-install-drill-introduction.md
index 21022d5..7d948eb 100644
--- a/_docs/install/010-install-drill-introduction.md
+++ b/_docs/install/010-install-drill-introduction.md
@@ -1,11 +1,12 @@
 ---
 title: "Install Drill Introduction"
-date:  
+date: 2015-12-30 19:09:53 UTC
 parent: "Install Drill"
 ---
 
-If you installed Drill 1.2 or earlier and generated Parquet files, you need to [migrate the
files]({{site.baseurl}}/docs/migrating-parquet-data) for use in later releases as explained
in the next section.
+You can install Drill for use in either embedded mode or distributed mode. [Choose embedded
mode]({{site.baseurl}}/docs/installing-drill-in-distributed-mode/) to use Drill only on a
single node. Installing Drill for use in embedded mode does not require installation of ZooKeeper.
Using Drill in embedded mode requires no configuration.
+
+[Choose distributed mode]({{site.baseurl}}/docs/installing-drill-in-distributed-mode/) to
use Drill in a clustered Hadoop environment. A clustered (multi-server) installation of ZooKeeper
is one of the [prerequisites]({{site.baseurl}}/docs/distributed-mode-prerequisites/). You
also need to configure Drill for use in distributed mode. After you complete these tasks,
connect Drill to your Hive, HBase, or distributed file system data sources, and run queries
on them.
 
-You can install Drill in either embedded mode or distributed mode. Installing
-Drill in embedded mode does not require any configuration. To use Drill in a
-clustered Hadoop environment, install Drill in distributed mode. You need to perform some
configuration after installing Drill in distributed mode. After you complete these tasks,
connect Drill to your Hive, HBase, or distributed file system data sources, and run queries
on them.
+## Using Parquet Files from a Previous Installation
+If you installed Drill 1.2 or earlier and generated Parquet files, you need to [migrate the
files]({{site.baseurl}}/docs/migrating-parquet-data) for use in later releases as explained
in the next section.

http://git-wip-us.apache.org/repos/asf/drill/blob/175cfed0/_docs/install/045-distributed-mode-prerequisites.md
----------------------------------------------------------------------
diff --git a/_docs/install/045-distributed-mode-prerequisites.md b/_docs/install/045-distributed-mode-prerequisites.md
index 5373a9e..17d3218 100644
--- a/_docs/install/045-distributed-mode-prerequisites.md
+++ b/_docs/install/045-distributed-mode-prerequisites.md
@@ -1,6 +1,6 @@
 ---
 title: "Distributed Mode Prerequisites"
-date:  
+date: 2015-12-30 19:31:38 UTC
 parent: "Installing Drill in Distributed Mode"
 ---
 You can install Apache Drill on one or more nodes to
@@ -8,9 +8,9 @@ run it in a clustered environment.
 
 ## Prerequisites
 
-Before you install Apache Drill on nodes in your cluster, your cluster must meet the following
prerequisites:
+Before you install Drill on nodes in a cluster, ensure that the cluster meets the following
prerequisites:
 
-  * Running [Oracle JDK version 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html)
(Required)
-  * Running a ZooKeeper quorum (Required)
-  * Running a Hadoop cluster (Recommended)
+  * Running [Oracle JDK version 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html)
(Required)  
+  * Running a [ZooKeeper quorum](https://zookeeper.apache.org/doc/r3.1.2/zookeeperStarted.html#sc_RunningReplicatedZooKeeper)
(Required)  
+  * Running a Hadoop cluster (Recommended)  
   * Using DNS (Recommended)

http://git-wip-us.apache.org/repos/asf/drill/blob/175cfed0/_docs/install/047-installing-drill-on-the-cluster.md
----------------------------------------------------------------------
diff --git a/_docs/install/047-installing-drill-on-the-cluster.md b/_docs/install/047-installing-drill-on-the-cluster.md
index c1e82cd..bfcd59c 100644
--- a/_docs/install/047-installing-drill-on-the-cluster.md
+++ b/_docs/install/047-installing-drill-on-the-cluster.md
@@ -1,9 +1,9 @@
 ---
 title: "Installing Drill on the Cluster"
-date:  
+date: 2015-12-30 19:09:53 UTC
 parent: "Installing Drill in Distributed Mode"
 ---
-You install Drill on nodes in the cluster, and then configure a cluster ID and add Zookeeper
information, as described in the following steps:
+You install Drill on nodes in the cluster, configure a cluster ID, and add Zookeeper information,
as described in the following steps:
 
   1. Download the Drill tarball. For example, enter the curl command using the latest version
number for Drill:
   
@@ -11,9 +11,9 @@ You install Drill on nodes in the cluster, and then configure a cluster
ID and a
   2. Extract the tarball to the directory of your choice, such as `/opt`:
   
       `tar -xzvf apache-drill-<version>.tar.gz`
-  3. In `drill-override.conf,` use the Drill `cluster ID`, and provide Zookeeper host names
and port numbers to configure a connection to your Zookeeper quorum.
+  3. In `drill-override.conf,` use the Drill `cluster ID`, and provide ZooKeeper host names
and port numbers to configure a connection to your ZooKeeper quorum.
      1. Edit `drill-override.conf` located in the `conf` directory.
-     2. Provide a unique `cluster-id` and the Zookeeper host names and port numbers in `zk.connect`.
If you install Drill on multiple nodes, assign the same `cluster ID` to each Drill node so
that all Drill nodes share the same ID. The default Zookeeper port on the open source version
of Apache Drill is 2181.
+     2. Provide a unique `cluster-id` and the ZooKeeper host names and port numbers in `zk.connect`.
If you install Drill on multiple nodes, assign the same `cluster ID` to each Drill node so
that all Drill nodes share the same ID. The default ZooKeeper port on the open source version
of Apache Drill is 2181.
 
        **Example**
        

http://git-wip-us.apache.org/repos/asf/drill/blob/175cfed0/_docs/install/050-starting-drill-in-distributed-mode.md
----------------------------------------------------------------------
diff --git a/_docs/install/050-starting-drill-in-distributed-mode.md b/_docs/install/050-starting-drill-in-distributed-mode.md
index 8d15348..e93f866 100644
--- a/_docs/install/050-starting-drill-in-distributed-mode.md
+++ b/_docs/install/050-starting-drill-in-distributed-mode.md
@@ -1,6 +1,6 @@
 ---
 title: Starting Drill in Distributed Mode
-date:  
+date: 2015-12-30 19:09:53 UTC
 parent: "Installing Drill in Distributed Mode"
 ---
 
@@ -64,7 +64,7 @@ Specifying the storage plugin configuration name when you start up eliminates
th
 
 The following command starts the Drill shell in a cluster configured to run ZooKeeper on
three nodes:
 
-`bin/sqlline –u jdbc:drill:zk=cento23,zk=centos24,zk=centos26:5181`
+`bin/sqlline –u jdbc:drill:zk=cento23,centos24,centos26:5181`
 
 ## Making a Direct Drillbit Connection
 

http://git-wip-us.apache.org/repos/asf/drill/blob/175cfed0/_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md
----------------------------------------------------------------------
diff --git a/_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md
b/_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md
index a80b287..42b742f 100644
--- a/_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md
+++ b/_docs/install/installing-drill-in-embedded-mode/010-embedded-mode-prerequisites.md
@@ -1,22 +1,19 @@
 ---
 title: "Embedded Mode Prerequisites"
-date:  
+date: 2015-12-30 19:31:38 UTC
 parent: "Installing Drill in Embedded Mode"
 ---
-Installing Drill in embedded mode installs Drill locally on your machine.
-Embedded mode is a quick way to install and try Drill without having to
-perform any configuration tasks. Installing Drill in embedded mode configures the
+To use Drill only on a single node, install Drill in embedded mode. Installing Drill in embedded
mode installs Drill locally on your machine. Embedded mode is a quick way to install and try
Drill without having to
+perform any configuration tasks. A ZooKeeper installation is not required. Installing Drill
in embedded mode configures the
 local Drillbit service to start automatically when you launch the Drill shell. You can install
Drill in embedded mode on a machine
 running Linux, Mac OS X, or Windows.
 
-**Prerequisite:**
-
 You need to meet the following prerequisites to run Drill:
 
 * Linux, Mac OS X, and Windows: [Oracle Java SE Development (JDK) Kit 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html)
installation  
 * Windows only:  
-  * A JAVA_HOME environment variable set up that points to the JDK installation  
+  * A JAVA_HOME environment variable that points to the JDK installation  
   * A PATH environment variable that includes a pointer to the JDK installation  
-  * A third-party utility for unzipping a tar.gz file 
+  * A utility for unzipping a tar.gz file 
 
 Follow installation instructions in this documentation for your particular operating system.


Mime
View raw message