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/05/31 00:04:21 UTC

drill git commit: edits to odbc docs per cathering skrbina

Repository: drill
Updated Branches:
  refs/heads/gh-pages ee71b646e -> b8647ddc7


edits to odbc docs per cathering skrbina


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

Branch: refs/heads/gh-pages
Commit: b8647ddc7765ef66c9c314da0a5e0d0a3d386907
Parents: ee71b64
Author: Bridget Bevens <bb...@maprtech.com>
Authored: Tue May 30 17:03:39 2017 -0700
Committer: Bridget Bevens <bb...@maprtech.com>
Committed: Tue May 30 17:03:39 2017 -0700

----------------------------------------------------------------------
 .../020-configuring-odbc-on-linux.md            | 13 +++++-----
 .../025-configuring-odbc-on-mac-os-x.md         |  6 ++---
 .../030-configuring-odbc-on-windows.md          | 25 ++++++++++++--------
 .../020-installing-the-driver-on-mac-os-x.md    | 11 ++++-----
 .../030-installing-the-driver-on-windows.md     | 14 ++++++-----
 .../020-connecting-drill-explorer-to-data.md    | 22 ++++++++---------
 6 files changed, 48 insertions(+), 43 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/configuring-odbc/020-configuring-odbc-on-linux.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/020-configuring-odbc-on-linux.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/020-configuring-odbc-on-linux.md
index 440bb70..c5ad206 100644
--- a/_docs/odbc-jdbc-interfaces/configuring-odbc/020-configuring-odbc-on-linux.md
+++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/020-configuring-odbc-on-linux.md
@@ -1,6 +1,6 @@
 ---
 title: "Configuring ODBC on Linux"
-date: 2017-05-30 23:11:52 UTC
+date: 2017-05-31 00:03:40 UTC
 parent: "Configuring ODBC"
 ---
 
@@ -143,14 +143,15 @@ If the Drillbit requires authentication, uncomment the AuthenticationType, add a
 	* The MapR login utility must be used to obtain a MapR ticket for MapR SASL authentication. 
 	* You must install and configure the MapR login utility before you can use the MapR SASL authentication mechanism. See <a href="http://maprdocs.mapr.com/home/SecurityGuide/SecurityArchitecture-AuthenticationArchitecture.html" title="MapR Login Utilty">Authentication Architecture: The maprlogin Utility</a> and <a href="http://maprdocs.mapr.com/home/SecurityGuide/Tickets.html/">Tickets</a>.
 
-	**Kerberos** 
-	*  See the <a href="http://web.mit.edu/kerberos/" title="MIT Kerberos">MIT Kerberos</a> documentation for installing and configuring a Kerberos environment, which is beyond the scope of the information provided here.
-	* To specify the Kerberos mechanism:
+* **Kerberos** 
+	*  See the <a href="http://web.mit.edu/kerberos/" title="MIT Kerberos">MIT Kerberos</a> documentation for installing and configuring a Kerberos environment, which is beyond the scope of the information provided here.  
+	*  To specify the Kerberos mechanism:
 		* Set the AuthenticationType to Kerberos.
 		* Set the KrbServiceHost property to the FQDN of the Drill server host.
-		* Set the KrbServiceName property to the Kerberos service principal name of the Drill server.
+		* Set the KrbServiceName property to the Kerberos service principal name of the Drill server.  
+		
 
-	**Plain (or Basic Authentication)**
+* **Plain (or Basic Authentication)**
 	* Configure the UID to an appropriate name for accessing the Drill server. 
 	* Set the PWD property to the password corresponding to the UID. 
 

http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/configuring-odbc/025-configuring-odbc-on-mac-os-x.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/025-configuring-odbc-on-mac-os-x.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/025-configuring-odbc-on-mac-os-x.md
index d83ff36..956afa1 100644
--- a/_docs/odbc-jdbc-interfaces/configuring-odbc/025-configuring-odbc-on-mac-os-x.md
+++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/025-configuring-odbc-on-mac-os-x.md
@@ -1,6 +1,6 @@
 ---
 title: "Configuring ODBC on Mac OS X"
-date: 2017-05-30 23:11:52 UTC
+date: 2017-05-31 00:03:40 UTC
 parent: "Configuring ODBC"
 ---
 ODBC driver managers use configuration files to define and configure ODBC data
@@ -78,14 +78,14 @@ If the Drillbit requires authentication, uncomment the AuthenticationType, add a
 	* The MapR login utility must be used to obtain a MapR ticket for MapR SASL authentication. 
 	* You must install and configure the MapR login utility before you can use the MapR SASL authentication mechanism. See <a href="http://maprdocs.mapr.com/home/SecurityGuide/SecurityArchitecture-AuthenticationArchitecture.html" title="MapR Login Utilty">Authentication Architecture: The maprlogin Utility</a> and <a href="http://maprdocs.mapr.com/home/SecurityGuide/Tickets.html/">Tickets</a>.
 
-	**Kerberos** 
+* **Kerberos** 
 	*  See the <a href="http://web.mit.edu/kerberos/" title="MIT Kerberos">MIT Kerberos</a> documentation for installing and configuring a Kerberos environment, which is beyond the scope of the information provided here.
 	* To specify the Kerberos mechanism:
 		* Set the AuthenticationType to Kerberos.
 		* Set the KrbServiceHost property to the FQDN of the Drill server host.
 		* Set the KrbServiceName property to the Kerberos service principal name of the Drill server.
 
-	**Plain (or Basic Authentication)**
+* **Plain (or Basic Authentication)**
 	* Configure the UID to an appropriate name for accessing the Drill server. 
 	* Set the PWD property to the password corresponding to the UID. 
 

http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/configuring-odbc/030-configuring-odbc-on-windows.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/030-configuring-odbc-on-windows.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/030-configuring-odbc-on-windows.md
index 1509e86..1f5d134 100644
--- a/_docs/odbc-jdbc-interfaces/configuring-odbc/030-configuring-odbc-on-windows.md
+++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/030-configuring-odbc-on-windows.md
@@ -1,6 +1,6 @@
 ---
 title: "Configuring ODBC on Windows"
-date: 2017-05-30 23:11:53 UTC
+date: 2017-05-31 00:03:41 UTC
 parent: "Configuring ODBC"
 ---
 Complete one of the following steps to create an ODBC connection on Windows to Drill data
@@ -14,16 +14,21 @@ sources:
 You can see how to create a DSN to connect to Drill data sources by taking a look at the preconfigured sample that the installer sets up. If you want to create a DSN for a 32-bit application, you must use the 32-bit
 version of the ODBC Administrator to create the DSN.
 
-1. Click **Start** and locate the ODBC Administrator app that you installed. Then click ODBC Administrator to start the app.
-   The ODBC Data Source Administrator dialog appears.
-   ![]({{ site.baseurl }}/docs/img/odbc-user-dsn.png)
+1\. Click **Start** and locate the ODBC Administrator app that you installed. Then click ODBC Administrator to start the app. The ODBC Data Source Administrator dialog appears.  
 
-2. On the **System DSN** tab in System Data Sources, select the sample MapR Drill.
-   ![]({{ site.baseurl }}/docs/img/odbc-configure1.png)
-   The system DSN is available for all users who log in to the machine. You can set up a user DSN is available only to the user who creates the DSN on the **User DSN** tab.  
-3. Click **Configure**.  
-   The MapR Drill setup dialog appears with a preconfigured sample DSN. The following screenshot shows a possible DSN configuration for using Drill in embedded mode.
-   ![]({{ site.baseurl }}/docs/img/odbc-configure2.png)
+![odbcuser]({{ site.baseurl }}/docs/img/odbc-user-dsn.png)
+
+2\. On the **System DSN** tab in System Data Sources, select the sample MapR Drill.  
+
+![odbcconfig]({{ site.baseurl }}/docs/img/odbc-configure1.png)  
+
+   The system DSN is available for all users who log in to the machine. You can set up a user DSN is available only to the user who creates the DSN on the **User DSN** tab. 
+ 
+3\. Click **Configure**.  
+  
+   The MapR Drill setup dialog appears with a preconfigured sample DSN. The following screenshot shows a possible DSN configuration for using Drill in embedded mode.  
+
+![odbcconfig2]({{ site.baseurl }}/docs/img/odbc-configure2.png)
    
 ### Authentication Options
 To password protect the DSN, select the appropriate AuthenticationType in the dropdown.  If the Drillbit does not require authentication (or to configure no password protection), you can use the No Authentication option; you do not need to configure additional settings.

http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/020-installing-the-driver-on-mac-os-x.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/020-installing-the-driver-on-mac-os-x.md b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/020-installing-the-driver-on-mac-os-x.md
index a1af4cd..5a179b3 100644
--- a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/020-installing-the-driver-on-mac-os-x.md
+++ b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/020-installing-the-driver-on-mac-os-x.md
@@ -1,6 +1,6 @@
 ---
 title: "Installing the Driver on Mac OS X"
-date: 2017-05-30 23:11:54 UTC
+date: 2017-05-31 00:03:41 UTC
 parent: "Installing the ODBC Driver"
 ---
 Install the MapR Drill ODBC Driver on the machine from which you connect to
@@ -27,13 +27,10 @@ If not, create an entry in `/etc/hosts` for each node in the following format:
 
 ----------
 
-## Step 1: Download the MapR Drill ODBC Driver
-
-
-----------
-Note: The most current (version 1.3.8)  MapR Drill ODBC driver for Mac might not be available yet. 
-----------
+## Step 1: Download the MapR Drill ODBC Driver  
+ 
 
+{% include startnote.html %}The most current (version 1.3.8)  MapR Drill ODBC driver for Mac might not be available yet.{% include endnote.html %}  
 
 Click the following link to download the latest version (1.3.8) of the driver, which supports both 32- and 64-bit client applications:  
 

http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/030-installing-the-driver-on-windows.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/030-installing-the-driver-on-windows.md b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/030-installing-the-driver-on-windows.md
index dfeeb65..768cbf7 100644
--- a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/030-installing-the-driver-on-windows.md
+++ b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/030-installing-the-driver-on-windows.md
@@ -1,6 +1,6 @@
 ---
 title: "Installing the Driver on Windows"
-date: 2017-05-30 23:11:55 UTC
+date: 2017-05-31 00:03:41 UTC
 parent: "Installing the ODBC Driver"
 ---
 The MapR Drill ODBC Driver installer is available for 32- and 64-bit
@@ -63,13 +63,15 @@ To verify the installation on Windows 10, perform the following steps:
 1. Go to **Settings** and enter **odbc**. Select ***Setup ODBC data sources <version>***.
 
 2. The ODBC Data Source Administrator <version> dialog appears. Click the **System DSN** to view 
-   the MapR Drill data source. 
-   ![]({{ site.baseurl }}/docs/img/odbc-user-dsn.png)
+   the MapR Drill data source.  
 
-3. Click the **Drivers** tab and verify that the MapR Drill ODBC Driver appears in the list of drivers that are installed on the computer.
-   ![]({{ site.baseurl }}/docs/img/odbc-drivers.png)
+   ![odbcuser]({{site.baseurl}}/docs/img/odbc-user-dsn.png)    
 
-You need to configure and start Drill before [testing]({{site.baseurl}}/docs/testing-the-odbc-connection/) the ODBC Data Source Administrator.
+3. Click the **Drivers** tab and verify that the MapR Drill ODBC Driver appears in the list of drivers that are installed on the computer.  
+
+   ![odbcdriver]({{site.baseurl}}/docs/img/odbc-drivers.png)
+
+Configure and start Drill before [testing]({{site.baseurl}}/docs/testing-the-odbc-connection/) the ODBC Data Source Administrator.
 
 ### Next Step 
 [Configuring ODBC on Windows]({{ site.baseurl }}/docs/configuring-odbc-on-windows).

http://git-wip-us.apache.org/repos/asf/drill/blob/b8647ddc/_docs/odbc-jdbc-interfaces/using-drill-explorer/020-connecting-drill-explorer-to-data.md
----------------------------------------------------------------------
diff --git a/_docs/odbc-jdbc-interfaces/using-drill-explorer/020-connecting-drill-explorer-to-data.md b/_docs/odbc-jdbc-interfaces/using-drill-explorer/020-connecting-drill-explorer-to-data.md
index 93a35c6..65e15bc 100644
--- a/_docs/odbc-jdbc-interfaces/using-drill-explorer/020-connecting-drill-explorer-to-data.md
+++ b/_docs/odbc-jdbc-interfaces/using-drill-explorer/020-connecting-drill-explorer-to-data.md
@@ -1,6 +1,6 @@
 ---
 title: "Connecting Drill Explorer to Data"
-date: 2017-05-30 23:11:55 UTC
+date: 2017-05-31 00:03:42 UTC
 parent: "Using Drill Explorer"
 ---
 The way you start Drill Explorer differs depending on your platform, but regardless of the platform, Drill must be running. 
@@ -32,28 +32,28 @@ In Windows 10, you can start Drill Explorer from the Start menu or from the ODBC
 
 To start Drill Explorer from the Start menu:
 
-1. Click **Start**, and locate MaprR Drill ODBC Driver <*version*>. 
+1\. Click **Start**, and locate MaprR Drill ODBC Driver <*version*>. 
    
-   ![]({{ site.baseurl }}/docs/img/winstart.png)
+   ![winstart]({{ site.baseurl }}/docs/img/winstart.png)
 
-2. Click **Drill Explorer**.
+2\. Click **Drill Explorer**.
    
-   ![]({{ site.baseurl }}/docs/img/odbc-explorer-win.png)
+   ![odbcexplore]({{ site.baseurl }}/docs/img/odbc-explorer-win.png)
 
-3. Select the DSN that you want to explore. For example, select MapR Drill and click Connect.
+3\. Select the DSN that you want to explore. For example, select MapR Drill and click Connect.
    
 To start Drill Explorer from the ODBC Administrator in Windows 10:
 
-1. In the Settings field, enter **odbc**. Select a version and the ODBC Data Source Administrator <version> appears. 
+1\. In the Settings field, enter **odbc**. Select a version and the ODBC Data Source Administrator <version> appears. 
    
-   ![]({{ site.baseurl }}/docs/img/odbc-configure1.png)
+   ![obdcconfig]({{ site.baseurl }}/docs/img/odbc-configure1.png)
    
-3. Click **System DSN**. Select MapR Drill and click Connect. 
+3\. Click **System DSN**. Select MapR Drill and click Connect. 
    The DSN Setup dialog appears showing the properties.  
    
-   ![]({{ site.baseurl }}/docs/img/odbc-configure2.png)
+   ![odbcconfig2]({{ site.baseurl }}/docs/img/odbc-configure2.png)
 
-4. Click **Drill Explorer** at the bottom of the dialog.
+. Click **Drill Explorer** at the bottom of the dialog.
    Drill Explorer appears.