You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@drill.apache.org by kr...@apache.org on 2015/12/30 20:34:55 UTC
drill git commit: clarify install docs
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 <kr...@apache.org>
Authored: Wed Dec 30 11:09:53 2015 -0800
Committer: Kris Hahn <kr...@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.