[prev in list] [next in list] [prev in thread] [next in thread]
List: drill-commits
Subject: git commit: Update READMEs
From: jacques () apache ! org
Date: 2014-08-31 19:18:09
Message-ID: 346977e3223e4fa88987b22984d0b305 () git ! apache ! org
[Download RAW message or body]
Repository: incubator-drill
Updated Branches:
refs/heads/master b094c4438 -> b7df73062
Update READMEs
Project: http://git-wip-us.apache.org/repos/asf/incubator-drill/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-drill/commit/b7df7306
Tree: http://git-wip-us.apache.org/repos/asf/incubator-drill/tree/b7df7306
Diff: http://git-wip-us.apache.org/repos/asf/incubator-drill/diff/b7df7306
Branch: refs/heads/master
Commit: b7df73062643be71d5e5a6885dbf7da162690ca8
Parents: b094c44
Author: Jacques Nadeau <jacques.drill@gmail.com>
Authored: Sun Aug 31 10:54:08 2014 -0700
Committer: Jacques Nadeau <jacques@apache.org>
Committed: Sun Aug 31 11:20:52 2014 -0700
----------------------------------------------------------------------
README.md | 8 ++----
distribution/pom.xml | 1 +
distribution/src/assemble/bin.xml | 4 +++
distribution/src/resources/README.md | 44 +++++++++++++++++++++++++++++++
4 files changed, 51 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 1e489e1..9bb9a68 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,7 @@
-# Apache Drill Milestone 1 - (Drill Alpha)
+# Apache Drill
Apache Drill is a distributed mpp query layer that supports SQL and alternative \
query languages against NoSQL and Hadoop data storage systems. It was inspired in \
part by the [Google's Dremel](http://research.google.com/pubs/pub36632.html). It is \
currently incubating under the Apache Foundation.
-
-## Milestone 1
-Milestone 1 is focused on providing a technology preview for developers. It offers \
the ability to query JSON and Parquet columnar data storage formats using ANSI \
compliant SQL. It also provides the ability to run queries in distributed execution \
mode utilizing Apache Zookeeper as a cluster coordination service.
-
## Quickstart
Please read INSTALL.md for setting up and running Apache Drill.
@@ -23,4 +19,4 @@ Please see the [Apache Drill \
Website](http://incubator.apache.org/drill/) or the Apache Drill is an Apache \
Foundation project and is seeking all types of contributions. Please say hello on \
the Apache Drill mailing list or join our weekly Google Hangouts for more \
information. (More information can be found at the Apache Drill website).
## Disclaimer
-Apache Drill is an effort undergoing incubation at The Apache Software Foundation \
(ASF), sponsored by the Apache Incubator. Incubation is required of all newly \
accepted projects until a further review indicates that the infrastructure, \
communications, and decision making process have stabilized in a manner consistent \
with other successful ASF projects. While incubation status is not necessarily a \
reflection of the completeness or stability of the code, it does indicate that the \
project has yet to be fully endorsed by the ASF. \ No newline at end of file
+Apache Drill is an effort undergoing incubation at The Apache Software Foundation \
(ASF), sponsored by the Apache Incubator. Incubation is required of all newly \
accepted projects until a further review indicates that the infrastructure, \
communications, and decision making process have stabilized in a manner consistent \
with other successful ASF projects. While incubation status is not necessarily a \
reflection of the completeness or stability of the code, it does indicate that the \
project has yet to be fully endorsed by the ASF.
http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/pom.xml
----------------------------------------------------------------------
diff --git a/distribution/pom.xml b/distribution/pom.xml
index a0abada..a8a28e0 100644
--- a/distribution/pom.xml
+++ b/distribution/pom.xml
@@ -112,6 +112,7 @@
<exclude>**/control</exclude>
<exclude>**/*.checkstyle</exclude>
<exclude>**/*.json</exclude>
+ <exclude>**/README.md</exclude>
<exclude>**/hadoop-excludes.txt</exclude>
</excludes>
</configuration>
http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/src/assemble/bin.xml
----------------------------------------------------------------------
diff --git a/distribution/src/assemble/bin.xml b/distribution/src/assemble/bin.xml
index 1c07e2f..455f9bd 100644
--- a/distribution/src/assemble/bin.xml
+++ b/distribution/src/assemble/bin.xml
@@ -114,6 +114,10 @@
<outputDirectory/>
</file>
<file>
+ <source>src/resources/README.md</source>
+ <outputDirectory/>
+ </file>
+ <file>
<source>../NOTICE</source>
<outputDirectory/>
</file>
http://git-wip-us.apache.org/repos/asf/incubator-drill/blob/b7df7306/distribution/src/resources/README.md
----------------------------------------------------------------------
diff --git a/distribution/src/resources/README.md \
b/distribution/src/resources/README.md new file mode 100644
index 0000000..f333b38
--- /dev/null
+++ b/distribution/src/resources/README.md
@@ -0,0 +1,44 @@
+# Running Apache Drill
+
+## Prerequisites
+
+ * Linux, Windows or OSX
+ * Oracle JDK 7 (JDK, not JRE)
+
+Additional requirements when running in clustered mode:
+ * Hadoop 2.3+ distribution of Hadoop (such as Apache or MapR)
+ * Zookeeper is required for a clustered installation
+
+## Installing the Tarball
+
+ 1. mkdir /opt/drill
+ 2. tar xvzf [tarball] --strip=1 -C /opt/drill
+
+## Running in embedded mode
+
+ 1. cd /opt/drill
+ 2. bin/sqlline -u jdbc:drill:zk=local
+ 3. Run a query (below).
+
+## Running in clustered mode
+
+ 1. Edit drill-override.conf to provide zookeeper location
+ 2. Start the drillbit using bin/drillbit.sh start
+ 3. Repeat on other nodes
+ 4. Connect with sqlline by using bin/sqlline -u "jdbc:drill:zk=[zk_host:port]"
+ 5. Run a query (below).
+
+## Run a query
+
+Drill comes preinstalled with a number of example data files including a small copy \
of the TPCH data in self describing Parquet files as well as the foodmart database in \
JSON. You can query these files using the cp schema. For example: +
+ USE cp;
+
+ SELECT
+ employee_id,
+ first_name
+ FROM `employee.json`;
+
+## More information
+
+For more information including how to run a Apache Drill cluster, visit the [Apache \
Drill Wiki](https://cwiki.apache.org/confluence/display/DRILL/Apache+Drill+Wiki)
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic