You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@drill.apache.org by br...@apache.org on 2017/06/03 01:17:55 UTC
drill-site git commit: odbc driver doc edits from c.skrbina
Repository: drill-site
Updated Branches:
refs/heads/asf-site d5caafc46 -> 1cbd033b6
odbc driver doc edits from c.skrbina
Project: http://git-wip-us.apache.org/repos/asf/drill-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/drill-site/commit/1cbd033b
Tree: http://git-wip-us.apache.org/repos/asf/drill-site/tree/1cbd033b
Diff: http://git-wip-us.apache.org/repos/asf/drill-site/diff/1cbd033b
Branch: refs/heads/asf-site
Commit: 1cbd033b661e6a213b032360381fb7af84e484c6
Parents: d5caafc
Author: Bridget Bevens <bb...@maprtech.com>
Authored: Fri Jun 2 18:17:42 2017 -0700
Committer: Bridget Bevens <bb...@maprtech.com>
Committed: Fri Jun 2 18:17:42 2017 -0700
----------------------------------------------------------------------
docs/configuring-odbc-on-mac-os-x/index.html | 2 +-
docs/configuring-odbc-on-windows/index.html | 4 +-
docs/img/explorer-connect.png | Bin 29945 -> 37761 bytes
docs/img/explorer-schemas.png | Bin 14332 -> 229615 bytes
docs/img/odbc-explorer-win-connect.png | Bin 0 -> 34764 bytes
docs/img/winstart.png | Bin 84587 -> 37279 bytes
docs/installing-the-driver-on-linux/index.html | 6 +-
.../index.html | 21 +++---
.../installing-the-driver-on-windows/index.html | 6 +-
docs/testing-the-odbc-connection/index.html | 66 +++++++++----------
feed.xml | 4 +-
11 files changed, 60 insertions(+), 49 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/configuring-odbc-on-mac-os-x/index.html
----------------------------------------------------------------------
diff --git a/docs/configuring-odbc-on-mac-os-x/index.html b/docs/configuring-odbc-on-mac-os-x/index.html
index f83e5c5..eaa19c0 100644
--- a/docs/configuring-odbc-on-mac-os-x/index.html
+++ b/docs/configuring-odbc-on-mac-os-x/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/configuring-odbc-on-windows/index.html
----------------------------------------------------------------------
diff --git a/docs/configuring-odbc-on-windows/index.html b/docs/configuring-odbc-on-windows/index.html
index bddc35b..1637b41 100644
--- a/docs/configuring-odbc-on-windows/index.html
+++ b/docs/configuring-odbc-on-windows/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1155,7 +1155,7 @@ version of the ODBC Data Source Administrator to create the DSN.</p>
<p><img src="http://i.imgur.com/f9Avhcz.png" alt=""> </p>
-<p>To access <strong>Drill Explorer</strong>, click <strong>Drill Explorer...</strong>.</p>
+<p>To access Drill Explorer, click <strong>Drill Explorer...</strong>.</p>
<h3 id="authentication-options">Authentication Options</h3>
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/img/explorer-connect.png
----------------------------------------------------------------------
diff --git a/docs/img/explorer-connect.png b/docs/img/explorer-connect.png
index 752bce9..12521c3 100644
Binary files a/docs/img/explorer-connect.png and b/docs/img/explorer-connect.png differ
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/img/explorer-schemas.png
----------------------------------------------------------------------
diff --git a/docs/img/explorer-schemas.png b/docs/img/explorer-schemas.png
index 3a9a53a..40830ce 100644
Binary files a/docs/img/explorer-schemas.png and b/docs/img/explorer-schemas.png differ
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/img/odbc-explorer-win-connect.png
----------------------------------------------------------------------
diff --git a/docs/img/odbc-explorer-win-connect.png b/docs/img/odbc-explorer-win-connect.png
new file mode 100644
index 0000000..c4f7a64
Binary files /dev/null and b/docs/img/odbc-explorer-win-connect.png differ
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/img/winstart.png
----------------------------------------------------------------------
diff --git a/docs/img/winstart.png b/docs/img/winstart.png
index cca1a31..9a327a6 100644
Binary files a/docs/img/winstart.png and b/docs/img/winstart.png differ
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/installing-the-driver-on-linux/index.html
----------------------------------------------------------------------
diff --git a/docs/installing-the-driver-on-linux/index.html b/docs/installing-the-driver-on-linux/index.html
index dd3e48c..e5964df 100644
--- a/docs/installing-the-driver-on-linux/index.html
+++ b/docs/installing-the-driver-on-linux/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1144,6 +1144,10 @@ application that you use to access Drill. The 64-bit editions of Linux support
<p>Verify that your system meets the system requirements before you start.</p>
+<h2 id="known-issue">Known Issue</h2>
+
+<p>MapR SASL support for Kerberos and MapR tickets is only available on 64-bit machines. </p>
+
<h2 id="system-requirements">System Requirements</h2>
<ul>
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/installing-the-driver-on-mac-os-x/index.html
----------------------------------------------------------------------
diff --git a/docs/installing-the-driver-on-mac-os-x/index.html b/docs/installing-the-driver-on-mac-os-x/index.html
index f6a6e00..7acf449 100644
--- a/docs/installing-the-driver-on-mac-os-x/index.html
+++ b/docs/installing-the-driver-on-mac-os-x/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1139,6 +1139,13 @@ the Drill service.</p>
<li><a href="/docs/installing-the-driver-on-mac-os-x/#step-3:-check-the-mapr-drill-odbc-driver-version">Step 3: Check the MapR Drill ODBC Driver Version</a></li>
</ul>
+<h2 id="known-issues">Known Issues</h2>
+
+<ul>
+<li>The 32- and 64-bit MapR Drill ODBC drivers are supported on 64-bit machines. </li>
+<li>MapR SASL support for Kerberos and MapR tickets is only available on 64-bit machines. </li>
+</ul>
+
<h2 id="system-requirements">System Requirements</h2>
<p>To install the driver, you need Administrator privileges on the computer.</p>
@@ -1159,12 +1166,11 @@ The iodbc-config file in the <code>/usr/local/iODBC/bin</code> includes the vers
<div class="admonition note">
<p class="first admonition-title">Note</p>
- <p class="last">The most current (version 1.3.8) MapR Drill ODBC driver for Mac might not be available yet. </p>
+ <p class="last">The most current (version 1.3.8) MapR Drill ODBC driver for Mac might not be available yet. </p>
</div>
-<p>Click the following link to download available drivers that support both 32- and 64-bit client applications: </p>
-
-<p><a href="http://package.mapr.com/tools/MapR-ODBC/MapR_Drill/">MapR Drill ODBC Driver for Mac</a></p>
+<p>To download available drivers that support both 32- and 64-bit client applications, click
+<a href="http://package.mapr.com/tools/MapR-ODBC/MapR_Drill/">MapR Drill ODBC Driver for Mac</a>.</p>
<hr>
@@ -1179,10 +1185,7 @@ The iodbc-config file in the <code>/usr/local/iODBC/bin</code> includes the vers
<li>When the installation completes, click <strong>Close.</strong></li>
</ol>
-<div class="admonition note">
- <p class="first admonition-title">Note</p>
- <p class="last">MapR Drill ODBC Driver files install in the following locations: </p>
-</div>
+<p>MapR Drill ODBC Driver files install in the following locations:</p>
<ul>
<li><code>/Library/mapr/drill/ErrorMessages</code> – Error messages files directory</li>
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/installing-the-driver-on-windows/index.html
----------------------------------------------------------------------
diff --git a/docs/installing-the-driver-on-windows/index.html b/docs/installing-the-driver-on-windows/index.html
index 248d81c..b944cf5 100644
--- a/docs/installing-the-driver-on-windows/index.html
+++ b/docs/installing-the-driver-on-windows/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1138,6 +1138,10 @@ applications on Windows®. On 64-bit Windows operating systems, you can execute
<p>Install the MapR Drill ODBC Driver on a system that meets the system requirements. </p>
+<h2 id="known-issue">Known Issue</h2>
+
+<p>Drill does not support running drillbits on 32-bit Windows machines.</p>
+
<h2 id="system-requirements">System Requirements</h2>
<p>Each computer where you install the driver must meet the following system
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/docs/testing-the-odbc-connection/index.html
----------------------------------------------------------------------
diff --git a/docs/testing-the-odbc-connection/index.html b/docs/testing-the-odbc-connection/index.html
index 0bcc31d..b0a49a0 100644
--- a/docs/testing-the-odbc-connection/index.html
+++ b/docs/testing-the-odbc-connection/index.html
@@ -1122,7 +1122,7 @@
</div>
- May 31, 2017
+ Jun 3, 2017
<link href="/css/docpage.css" rel="stylesheet" type="text/css">
@@ -1131,8 +1131,8 @@
<p>You can use DSN connection strings and DSN-less connection strings for your connections.</p>
<ul>
-<li><a href="/docs/testing-the-odbc-connection/#example-connection-string-with-DSN">Example Connection String with DSN</a></li>
-<li><a href="/docs/testing-the-odbc-connection/#example-connection-strings-without-DSN">Example Connection Strings without DSN</a></li>
+<li><a href="/docs/testing-the-odbc-connection/#example-connection-string-with-dsn">Example Connection String with DSN</a></li>
+<li><a href="/docs/testing-the-odbc-connection/#example-connection-strings-without-dsn">Example Connection Strings without DSN</a></li>
</ul>
<h2 id="example-connection-string-with-dsn">Example Connection String with DSN</h2>
@@ -1164,19 +1164,18 @@ The placeholders in the examples are defined as follows, in alphabetical order:<
<p>The following is the format of a DSN-less connection string for a Drillbit that does not require authentication:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;ConnectionType=Direct; Host=[*Server*];Port=[*PortNumber*]
</code></pre></div>
-<p>For example:</p>
+<p>Example:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;ConnectionType=Direct; Host=192.168.222.160;Port=31010
</code></pre></div>
<h3 id="zookeeper-connections">ZooKeeper Connections</h3>
<p>The following is the format of a DSN-less connection string for a ZooKeeper cluster that does not require authentication:</p>
-
-<p>Driver=MapR Drill ODBC Driver;
+<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;
ConnectionType=ZooKeeper;
-ZKQuorum=[<em>Server1</em>]:[<em>PortNumber*1], [*Server2</em>]:[<em>PortNumber2</em>], [<em>Server3</em>]:[<em>PortNumber3</em>];
-ZKClusterID=[<em>ClusterName</em>]</p>
-
-<p>For example:</p>
+ZKQuorum=[*Server1*]:[*PortNumber*1], [*Server2*]:[*PortNumber2*], [*Server3*]:[*PortNumber3*];
+ZKClusterID=[*ClusterName*]
+</code></pre></div>
+<p>Example:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;
ConnectionType=ZooKeeper;
ZKQuorum=192.168.222.160:31010, 192.168.222.165:31010, 192.168.222.231:31010;
@@ -1185,14 +1184,13 @@ ZKClusterID=drill;
<h3 id="kerberos-authentication-connections">Kerberos Authentication Connections</h3>
<p>The following is the format of a DSN-less connection string for a Drillbit that requires Kerberos authentication:</p>
-
-<p>Driver=MapR Drill ODBC Driver;
+<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;
ConnectionType=Direct;
-Host=[<em>Server</em>];Port=[<em>PortNumber</em>];
+Host=[*Server*];Port=[*PortNumber*];
AuthenticationType=Kerberos;
-KrbServiceHost=[<em>DomainName</em>];KrbServiceName=[<em>ServiceName</em>]</p>
-
-<p>For example:</p>
+KrbServiceHost=[*DomainName*];KrbServiceName=[*ServiceName*]
+</code></pre></div>
+<p>Example:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;
ConnectionType=Direct;
Host=192.168.222.160;Port=31010;
@@ -1205,7 +1203,7 @@ KrbServiceHost=maprdriverdemo.example.com; KrbServiceName=drill
<p>Driver=MapR Drill ODBC Driver;ConnectionType=Direct; Host=[<em>Server</em>];Port=[<em>PortNumber</em>];AuthenticationType=MapRSASL</p>
-<p>For example:</p>
+<p>Example:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;
ConnectionType=Direct;
Host=192.168.227.169;
@@ -1220,7 +1218,7 @@ Host=[*Server*];Port=[*PortNumber*];
AuthenticationType=Plain;
UID=[*YourUserName*];PWD=[*YourPassword*]
</code></pre></div>
-<p>For example:</p>
+<p>Example:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">Driver=MapR Drill ODBC Driver;ConnectionType=Direct;
Host=192.168.227.169;Port=31010;
AuthenticationType=Plain;
@@ -1269,7 +1267,7 @@ Driver Manager: 03.52.0709.0909
<li><p>Type <code>?</code> to see the DSN name. The output is:</p>
<div class="highlight"><pre><code class="language-text" data-lang="text">DSN | Driver
------------------------------------------------------------------------------
-Sample MapR Drill (64-bit) | MapR Drill ODBC Driver 64-bit
+MapR Drill (64-bit) | MapR Drill ODBC Driver 64-bit
Enter ODBC connect string (? shows list):
</code></pre></div></li>
<li><p>To test the connection if the DSN was previously configured in the <code>.odbc.ini</code>, type the following connection string: </p>
@@ -1297,32 +1295,34 @@ ZKClusterID=<Cluster Name>
Go to the Drill shell to run commands. Do not attempt to run SQL commands from this prompt.</p></li>
</ol>
-<p>This example shows a connection string for a direct connection:</p>
-<div class="highlight"><pre><code class="language-text" data-lang="text"> DSN=Sample MapR Drill 64-bit;
+<p>Example: Connection String for a Direct Connection</p>
+<div class="highlight"><pre><code class="language-text" data-lang="text"> DSN=MapR Drill 64-bit;
ConnectionType=Direct;
Host=localhost;Port=31010
</code></pre></div>
-<p>This example shows a connection string for a ZooKeeper cluster connection:</p>
-<div class="highlight"><pre><code class="language-text" data-lang="text"> DSN=Sample MapR Drill 64-bit 64;
+<p>Example: Connection String for a ZooKeeper Cluster Connection</p>
+<div class="highlight"><pre><code class="language-text" data-lang="text"> DSN=MapR Drill 64-bit 64;
ConnectionType=ZooKeeper;
ZKQuorum=centos23.lab:5181;
ZKClusterID=docs60cluster-drillbits
</code></pre></div>
<h2 id="testing-the-odbc-connection-on-mac-os-x">Testing the ODBC Connection on Mac OS X</h2>
-<p>To test the ODBC connection on Mac OS X, follow these steps.</p>
+<p>To test the ODBC connection on Mac OS X: </p>
<ol>
<li><p><a href="/docs/starting-drill-on-linux-and-mac-os-x/">Start Drill</a>. </p></li>
-<li><p>Start the iODBC Administrator.app in <code>/Applications</code>.<br>
-The iODBC Data Source Administrator dialog appears. </p></li>
-<li><p>On the User DSN tab, select <strong>MapR Drill</strong>.<br>
-<img src="/docs/img/odbc_data_source_names.png" alt=""> </p></li>
-<li><p>Click <strong>Test</strong>.<br>
-The Login for the MapR Drill dialog appears.<br>
-<img src="/docs/img/odbc_login.png" alt=""> </p></li>
-<li><p>If you configured Plain (or Basic) authentication in the <code>.odbc.ini</code>, enter the user name and password you also configured; otherwise, click <strong>OK</strong>. The success message displays.<br>
-<img src="/docs/img/success.png" alt=""></p></li>
+<li><p>Start the iODBC Data Source Administrator app in <code>/Applications</code>. The <strong>iODBC Data Source Administrator</strong> dialog appears. </p></li>
+<li><p>On the <strong>ODBC DSN</strong> tab, select <strong>MapR Drill</strong>. </p>
+
+<p><img src="http://i.imgur.com/Wcm99OI.png" alt=""></p></li>
+<li><p>Click <strong>Test</strong>. The <strong>MapR Drill</strong> login dialog appears. </p>
+
+<p><img src="http://i.imgur.com/T914QZk.png" alt=""> </p></li>
+<li><p>If you configured Plain (or Basic Authentication) in the <code>.odbc.ini</code> file, enter the user name and password you also configured.
+Otherwise, click <strong>OK</strong>. The success message displays. </p>
+
+<p><img src="http://i.imgur.com/G4YZY7n.png" alt=""></p></li>
</ol>
<h2 id="testing-the-odbc-connection-on-windows">Testing the ODBC Connection on Windows</h2>
http://git-wip-us.apache.org/repos/asf/drill-site/blob/1cbd033b/feed.xml
----------------------------------------------------------------------
diff --git a/feed.xml b/feed.xml
index 2b84b58..fc1f3c9 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>/</link>
<atom:link href="/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Wed, 31 May 2017 16:20:39 -0700</pubDate>
- <lastBuildDate>Wed, 31 May 2017 16:20:39 -0700</lastBuildDate>
+ <pubDate>Fri, 02 Jun 2017 18:13:00 -0700</pubDate>
+ <lastBuildDate>Fri, 02 Jun 2017 18:13:00 -0700</lastBuildDate>
<generator>Jekyll v2.5.2</generator>
<item>