Repository: drill Updated Branches: refs/heads/gh-pages fa34eb2e3 -> 33194f445
repost of security and odbc doc updates Project: http://git-wip-us.apache.org/repos/asf/drill/repo Commit: http://git-wip-us.apache.org/repos/asf/drill/commit/33194f44 Tree: http://git-wip-us.apache.org/repos/asf/drill/tree/33194f44 Diff: http://git-wip-us.apache.org/repos/asf/drill/diff/33194f44 Branch: refs/heads/gh-pages Commit: 33194f44549ab886cf7477355b44fd7a9dead478 Parents: fa34eb2 Author: Bridget Bevens <[email protected]> Authored: Thu Aug 17 11:54:27 2017 -0700 Committer: Bridget Bevens <[email protected]> Committed: Thu Aug 17 11:54:27 2017 -0700 ---------------------------------------------------------------------- .../020-secure-communication-paths.md | 2 +- .../090-configuring-kerberos-security.md | 2 +- .../010-odbc-configuration-reference.md | 2 +- .../configuring-odbc/011-logging-tracing.md | 358 +++++++++---------- .../020-configuring-odbc-on-linux.md | 2 +- .../025-configuring-odbc-on-mac-os-x.md | 2 +- .../030-configuring-odbc-on-windows.md | 2 +- .../040-testing-the-odbc-connection.md | 2 +- .../010-installing-the-driver-on-linux.md | 2 +- .../020-installing-the-driver-on-mac-os-x.md | 2 +- .../030-installing-the-driver-on-windows.md | 2 +- 11 files changed, 189 insertions(+), 189 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/configure-drill/securing-drill/020-secure-communication-paths.md ---------------------------------------------------------------------- diff --git a/_docs/configure-drill/securing-drill/020-secure-communication-paths.md b/_docs/configure-drill/securing-drill/020-secure-communication-paths.md index f9a3972..dbfd194 100644 --- a/_docs/configure-drill/securing-drill/020-secure-communication-paths.md +++ b/_docs/configure-drill/securing-drill/020-secure-communication-paths.md @@ -1,6 +1,6 @@ --- title: "Secure Communication Paths" -date: 2017-08-17 18:18:45 UTC +date: 2017-08-17 18:54:32 UTC parent: "Securing Drill" --- As illustrated in the following figure, Drill features five secure communication paths. Drill 1.11 introduces encryption between a Drill client and Drillbit. http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/configure-drill/securing-drill/090-configuring-kerberos-security.md ---------------------------------------------------------------------- diff --git a/_docs/configure-drill/securing-drill/090-configuring-kerberos-security.md b/_docs/configure-drill/securing-drill/090-configuring-kerberos-security.md index 1a65d69..6730d40 100644 --- a/_docs/configure-drill/securing-drill/090-configuring-kerberos-security.md +++ b/_docs/configure-drill/securing-drill/090-configuring-kerberos-security.md @@ -1,6 +1,6 @@ --- title: "Configuring Kerberos Security" -date: 2017-08-17 04:11:23 UTC +date: 2017-08-17 18:54:38 UTC parent: "Securing Drill" --- Drill 1.11 supports Kerberos v5 network security authentication and encryption for Kerberos. To use Kerberos with Drill and establish connectivity, use the JDBC driver packaged with Drill. http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/odbc-jdbc-interfaces/configuring-odbc/010-odbc-configuration-reference.md ---------------------------------------------------------------------- diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/010-odbc-configuration-reference.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/010-odbc-configuration-reference.md index 47bab18..86828ea 100644 --- a/_docs/odbc-jdbc-interfaces/configuring-odbc/010-odbc-configuration-reference.md +++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/010-odbc-configuration-reference.md @@ -1,6 +1,6 @@ --- title: "ODBC Configuration Reference" -date: 2017-08-17 04:49:30 UTC +date: 2017-08-17 18:54:52 UTC parent: "Configuring ODBC" --- You can use various configuration options to control the behavior of the Drill ODBC Driver. You can use these options in a connection string or in the `odbc.ini` configuration file for the Mac OS X version or the driver. http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/odbc-jdbc-interfaces/configuring-odbc/011-logging-tracing.md ---------------------------------------------------------------------- diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/011-logging-tracing.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/011-logging-tracing.md index f643c0c..d833a13 100644 --- a/_docs/odbc-jdbc-interfaces/configuring-odbc/011-logging-tracing.md +++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/011-logging-tracing.md @@ -1,179 +1,179 @@ ---- -title: "ODBC Configuration Reference" -date: 2017-06-06 23:26:11 UTC -parent: "Configuring ODBC" ---- - -## Logging Options - -Only enable logging long enough to capture information required to resolve an issue. Logging decreases performance and can consume a large quantity of disk space. - -If logging is enabled, the Drill ODBC driver logs events in the following log files in the log path that you configure: - -* `driver.log` provides a log of driver events. -* `drillclient.log` provides a log of the Drill client events. - -### Logging Levels - -The following log levels are available: - -* (0) OFF: Disables logging. -* (1) FATAL: Logs severe error events that may cause the driver to stop running. -* (2) ERROR: Logs error events that may allow the driver to continue running. -* (3) WARNING: Logs events that might result in an error if action is not taken. -* (4) INFO: Logs general information that describes the progress of the driver. -* (5) DEBUG: Logs detailed events that may help to debug issues. -* (6) TRACE: Logs all driver activity, which includes more fine-grained events than the DEBUG level. - -### Non-Windows Platforms - -On non-Windows platforms, logging is configured through the driver-wide settings in the `mapr.drillodbc.ini` file, which apply to all connections using the driver. - - -#### Enable Logging - -To enable logging: - -1. Open the `.mapr.drillodbc.ini` configuration file in a text editor. (On Mac OS X, the default installation will install a .mapr.drillodbc.ini to $HOME.) - -2. Set the **LogLevel** key to the desired level of information to include in log files. -For example: - - `LogLevel=2` - -3. Set the **LogPath** key to the full path to the folder where you want to save log files. -For example: - - `LogPath=/localhome/employee/logs` - -4. Save the `.mapr.drillodbc.ini` configuration file. The Drill ODBC Driver produces two log files at the location you specify using the **Log Path** field: - * `driver.log` provides a log of driver activities. - * `drillclient.log` provides a log of Drill client activities. - - -6. Restart the applciation to make sure that the new settings take effect. Configuration changes will not be picked up until the application reloads the driver. - -#### Disable Logging - -To disable logging: - -1. Open the `.mapr.drillodbc.ini` configuration file in a text editor. -2. Set the **LogLevel** key to zero (`0`). -3. Save the `.mapr.drillodbc.ini` configuration file. -4. Restart your ODBC application to make sure that the new settings take effect. - -### Windows Platforms - -On Windows, logging is available in the Windows **ODBC Data Source Administrator** where you created the DSN. You must run `C:\Windows\SysWOW64\odbcad32.exe` to access and modify 32-bit DSNs on 64-bit Windows. - -#### Enable Logging - -To enable logging: - -1. Click **Start**, **All Programs**, and then click the program group corresponding to the driver. - -2. Select the DSN for which you want to log activity. - -3. Click **Configure**. - -4. In the **DSN Setup** dialog box, click **Logging Options**. - -6. From the **Log Level** drop-down list, select the logging level corresponding to the amount of information that you want to include in log files. -7. In the **Log Path** (or Log Directory) field, specify the full path to the folder where you want to save log files. - -8. If necessary (for example, if requested by a Support team), type the name of the component for which to log messages in the **Log Namespace** field. Otherwise, do not type a value in the field. -9. Click **OK** to close the Logging Options dialog box. - -7. Click **OK** to save your settings and close the **DSN Configuration** dialog box. Configuration changes will not be saved of picked up by the driver until you have clicked **OK** in the **DSN Configuration **dialog box. Click **Cancel** (or the X button) to discard changes. - -8. Restart the application to make sure that the new settings take effect. Configuration changes will not be picked up by until the application reloads the driver. - - -#### Disable Logging - -To disable logging: - -1. Select the DSN. -2. Click **Configure**. -3. Click **Logging Options**. -4. From the **Log Level** drop-down list, select **LOG_OFF**. -5. Click **OK**. -6. Restart your ODBC application to make sure that the new settings take effect. - -## Driver Manager Tracing - -The driver manager trace facility, is a useful way to troubleshoot ODBC driver issues.You can choose from several driver managers, depending on which platform you use. - -{% include startimportant.html %}Tracing is active only for applications started after tracing has started. Currently-executing applications will not have tracing enabled. You must restart applications to enable tracing. You may need to restart services for applications, or you may have to restart the machine to properly enable tracing.{% include endimportant.html %} - - -### OSX and Other Non-Windows Platforms - -iODBC is the default driver manager on OSX and can sometimes be found on other non-Windows platforms. - - -#### Enable Trace Logging - -To enable trace logging: - -1. Locate your `maprdrill.odbc.ini` file. This often located in your home directory. It might be a hidden file. -2. Open the file and add the following key-value pairs under the section heading **[ODBC]**. If the heading does not exist, add it. For example: - - `[ODBC]` - - `Trace=1` - - `TraceFile=/path/to/file/traceFile.log` - - `[ODBC Data Sources]` - -#### Disable Trace Logging - -When the trace is complete, disable tracing because tracing will consume disk space and significantly impact performance. - -1. Locate your `maprdrill.odbc.ini` file. This often located in your home directory. It might be a hidden file. -2. Open the file and add the following key-value pairs under the section heading **[ODBC]**. For example: - - `[ODBC]` - - `Trace=0` - - `TraceFile=/path/to/file/traceFile.log` - - `[ODBC Data Sources]` - -1. (Again, this action will only impact applications that have just started, not currently-executing applications.) Restart your application. - - -### OSX and Other Non-Windows Platforms - -#### Enable Trace Logging - -To enable tracing on Windows: - -1. Open the **ODBC Data Source Administrator**. -1. Go to the **Tracing** tab. - - - - - -1. Change the **Log File Path** field to be the location and name of the file to which youâd like to write the trace entries. - - -1. (Optional) Check **Machine-wide tracing** for all user identities if you want the tracing to affect all users on the machine. If you are unsure, check this box. - - -1. Press **Start Tracing Now**. - -#### Disable Trace Logging - -When the trace is complete, disable tracing because tracing will consume disk space and significantly impact performance. - -1. Open the **ODBC Data Source Administrator**. -1. Go to the **Tracing** tab. -1. Press Stop **Tracing Now**. (Again, this action will only impact applications that have just started, not currently-executing applications.) -1. Restart your application. - -For more information about generating ODBC traces, see [How To Generate an ODBC Trace with ODBC Data Source Administrator. -](https://support.microsoft.com/en-us/help/274551/how-to-generate-an-odbc-trace-with-odbc-data-source-administrator) +--- +title: "Logging Tracing" +date: 2017-08-17 18:54:56 UTC +parent: "Configuring ODBC" +--- + +## Logging Options + +Only enable logging long enough to capture information required to resolve an issue. Logging decreases performance and can consume a large quantity of disk space. + +If logging is enabled, the Drill ODBC driver logs events in the following log files in the log path that you configure: + +* `driver.log` provides a log of driver events. +* `drillclient.log` provides a log of the Drill client events. + +### Logging Levels + +The following log levels are available: + +* (0) OFF: Disables logging. +* (1) FATAL: Logs severe error events that may cause the driver to stop running. +* (2) ERROR: Logs error events that may allow the driver to continue running. +* (3) WARNING: Logs events that might result in an error if action is not taken. +* (4) INFO: Logs general information that describes the progress of the driver. +* (5) DEBUG: Logs detailed events that may help to debug issues. +* (6) TRACE: Logs all driver activity, which includes more fine-grained events than the DEBUG level. + +### Non-Windows Platforms + +On non-Windows platforms, logging is configured through the driver-wide settings in the `mapr.drillodbc.ini` file, which apply to all connections using the driver. + + +#### Enable Logging + +To enable logging: + +1. Open the `.mapr.drillodbc.ini` configuration file in a text editor. (On Mac OS X, the default installation will install a .mapr.drillodbc.ini to $HOME.) + +2. Set the **LogLevel** key to the desired level of information to include in log files. +For example: + + `LogLevel=2` + +3. Set the **LogPath** key to the full path to the folder where you want to save log files. +For example: + + `LogPath=/localhome/employee/logs` + +4. Save the `.mapr.drillodbc.ini` configuration file. The Drill ODBC Driver produces two log files at the location you specify using the **Log Path** field: + * `driver.log` provides a log of driver activities. + * `drillclient.log` provides a log of Drill client activities. + + +6. Restart the applciation to make sure that the new settings take effect. Configuration changes will not be picked up until the application reloads the driver. + +#### Disable Logging + +To disable logging: + +1. Open the `.mapr.drillodbc.ini` configuration file in a text editor. +2. Set the **LogLevel** key to zero (`0`). +3. Save the `.mapr.drillodbc.ini` configuration file. +4. Restart your ODBC application to make sure that the new settings take effect. + +### Windows Platforms + +On Windows, logging is available in the Windows **ODBC Data Source Administrator** where you created the DSN. You must run `C:\Windows\SysWOW64\odbcad32.exe` to access and modify 32-bit DSNs on 64-bit Windows. + +#### Enable Logging + +To enable logging: + +1. Click **Start**, **All Programs**, and then click the program group corresponding to the driver. + +2. Select the DSN for which you want to log activity. + +3. Click **Configure**. + +4. In the **DSN Setup** dialog box, click **Logging Options**. + +6. From the **Log Level** drop-down list, select the logging level corresponding to the amount of information that you want to include in log files. +7. In the **Log Path** (or Log Directory) field, specify the full path to the folder where you want to save log files. + +8. If necessary (for example, if requested by a Support team), type the name of the component for which to log messages in the **Log Namespace** field. Otherwise, do not type a value in the field. +9. Click **OK** to close the Logging Options dialog box. + +7. Click **OK** to save your settings and close the **DSN Configuration** dialog box. Configuration changes will not be saved of picked up by the driver until you have clicked **OK** in the **DSN Configuration **dialog box. Click **Cancel** (or the X button) to discard changes. + +8. Restart the application to make sure that the new settings take effect. Configuration changes will not be picked up by until the application reloads the driver. + + +#### Disable Logging + +To disable logging: + +1. Select the DSN. +2. Click **Configure**. +3. Click **Logging Options**. +4. From the **Log Level** drop-down list, select **LOG_OFF**. +5. Click **OK**. +6. Restart your ODBC application to make sure that the new settings take effect. + +## Driver Manager Tracing + +The driver manager trace facility, is a useful way to troubleshoot ODBC driver issues.You can choose from several driver managers, depending on which platform you use. + +{% include startimportant.html %}Tracing is active only for applications started after tracing has started. Currently-executing applications will not have tracing enabled. You must restart applications to enable tracing. You may need to restart services for applications, or you may have to restart the machine to properly enable tracing.{% include endimportant.html %} + + +### OSX and Other Non-Windows Platforms + +iODBC is the default driver manager on OSX and can sometimes be found on other non-Windows platforms. + + +#### Enable Trace Logging + +To enable trace logging: + +1. Locate your `maprdrill.odbc.ini` file. This often located in your home directory. It might be a hidden file. +2. Open the file and add the following key-value pairs under the section heading **[ODBC]**. If the heading does not exist, add it. For example: + + `[ODBC]` + + `Trace=1` + + `TraceFile=/path/to/file/traceFile.log` + + `[ODBC Data Sources]` + +#### Disable Trace Logging + +When the trace is complete, disable tracing because tracing will consume disk space and significantly impact performance. + +1. Locate your `maprdrill.odbc.ini` file. This often located in your home directory. It might be a hidden file. +2. Open the file and add the following key-value pairs under the section heading **[ODBC]**. For example: + + `[ODBC]` + + `Trace=0` + + `TraceFile=/path/to/file/traceFile.log` + + `[ODBC Data Sources]` + +1. (Again, this action will only impact applications that have just started, not currently-executing applications.) Restart your application. + + +### OSX and Other Non-Windows Platforms + +#### Enable Trace Logging + +To enable tracing on Windows: + +1. Open the **ODBC Data Source Administrator**. +1. Go to the **Tracing** tab. + + + + + +1. Change the **Log File Path** field to be the location and name of the file to which youâd like to write the trace entries. + + +1. (Optional) Check **Machine-wide tracing** for all user identities if you want the tracing to affect all users on the machine. If you are unsure, check this box. + + +1. Press **Start Tracing Now**. + +#### Disable Trace Logging + +When the trace is complete, disable tracing because tracing will consume disk space and significantly impact performance. + +1. Open the **ODBC Data Source Administrator**. +1. Go to the **Tracing** tab. +1. Press Stop **Tracing Now**. (Again, this action will only impact applications that have just started, not currently-executing applications.) +1. Restart your application. + +For more information about generating ODBC traces, see [How To Generate an ODBC Trace with ODBC Data Source Administrator. +](https://support.microsoft.com/en-us/help/274551/how-to-generate-an-odbc-trace-with-odbc-data-source-administrator) http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_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 eb0be2c..efd9d27 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-08-17 04:11:44 UTC +date: 2017-08-17 18:55:03 UTC parent: "Configuring ODBC" --- http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_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 a607050..78acc3a 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-08-17 04:11:50 UTC +date: 2017-08-17 18:55:07 UTC parent: "Configuring ODBC" --- ODBC driver managers use configuration files to define and configure ODBC data http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_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 cc63e27..96e697c 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-08-17 04:11:54 UTC +date: 2017-08-17 18:55:12 UTC parent: "Configuring ODBC" --- To create an ODBC connection to Drill data sources on Windows, complete the following steps: http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/odbc-jdbc-interfaces/configuring-odbc/040-testing-the-odbc-connection.md ---------------------------------------------------------------------- diff --git a/_docs/odbc-jdbc-interfaces/configuring-odbc/040-testing-the-odbc-connection.md b/_docs/odbc-jdbc-interfaces/configuring-odbc/040-testing-the-odbc-connection.md index 8566f18..2075aca 100644 --- a/_docs/odbc-jdbc-interfaces/configuring-odbc/040-testing-the-odbc-connection.md +++ b/_docs/odbc-jdbc-interfaces/configuring-odbc/040-testing-the-odbc-connection.md @@ -1,6 +1,6 @@ --- title: "Testing the ODBC Connection" -date: 2017-08-17 04:11:59 UTC +date: 2017-08-17 18:55:16 UTC parent: "Configuring ODBC" --- You can use DSN connection strings and DSN-less connection strings for your connections. http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/010-installing-the-driver-on-linux.md ---------------------------------------------------------------------- diff --git a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/010-installing-the-driver-on-linux.md b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/010-installing-the-driver-on-linux.md index 8671cc1..6f7f5ad 100644 --- a/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/010-installing-the-driver-on-linux.md +++ b/_docs/odbc-jdbc-interfaces/installing-the-odbc-driver/010-installing-the-driver-on-linux.md @@ -1,6 +1,6 @@ --- title: "Installing the Driver on Linux" -date: 2017-08-17 04:12:04 UTC +date: 2017-08-17 18:55:21 UTC parent: "Installing the ODBC Driver" --- Install the Drill ODBC Driver on the machine from which you connect to http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_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 c29250f..e7f1850 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-08-17 04:12:08 UTC +date: 2017-08-17 18:55:25 UTC parent: "Installing the ODBC Driver" --- Install the Drill ODBC Driver on the machine from which you connect to http://git-wip-us.apache.org/repos/asf/drill/blob/33194f44/_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 0ce2d5d..8bad61a 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-08-17 04:12:13 UTC +date: 2017-08-17 18:55:29 UTC parent: "Installing the ODBC Driver" --- The Drill ODBC Driver installer is available for 32- and 64-bit
