ABSTRACT Install and configure the ODBC Client Connector and setup connection with Tableau, Power Bi, Excel March 7, 2019 ODBC CONNECTOR CONFIGURATION Installing and Configuring ODBC Client Connector Version 1.0 Installing and Configuring ODBC Client Connector This document provides instructions on how to install the ODBC client driver on your Linux server or Windows desktop. Included are examples of how to connect to the BlackLynx server using the ODBC connector with Tableau, Power Bi, Microsoft Excel, and ISQL. Table of Contents Install the ODBC Driver on Windows Desktop ...........................................................................................................2 Upgrade Windows Client ........................................................................................................................................7 Sample Server Connections with Windows Clients ................................................................................................8 Example 1: Connect Using Tableau ....................................................................................................................8 Example 2: Connect Using Power BI ................................................................................................................ 10 Example 3: Connect Using Microsoft Excel ..................................................................................................... 12 Install and Run the ODBC Driver on Ubuntu Linux .................................................................................................. 15 README File ........................................................................................................................................................ 16 Run the Installation File ....................................................................................................................................... 16 Example ODBC connections with Linux clients ................................................................................................... 18 Sample Connect with ISQL ............................................................................................................................... 18 Sample Connect with LibreOffice .................................................................................................................... 19 Install and Run the ODBC Driver on Mac OS ........................................................................................................... 23 Install the ODBC Driver on Mac OS Desktop ....................................................................................................... 24 Example Mac OS installation ............................................................................................................................... 26 Sample SQL queries ................................................................................................................................................. 27 Raw pcap data set 16GB ...................................................................................................................................... 27 Other datasets ..................................................................................................................................................... 27 XML Dataset .................................................................................................................................................... 27 Fuzzy search ..................................................................................................................................................... 27 Log files 21GB .................................................................................................................................................. 27 Unstructured text with regular expression 22GB ............................................................................................ 27 Leading wildcard search on 65GB ................................................................................................................... 27 BlackLynx, Inc. ©2019 Page | 1 Installing and Configuring ODBC Client Connector Install the ODBC Driver on Windows Desktop 1. Download the installer from: https://s3.amazonaws.com/ryft-public-sample- data/ODBC/blacklynx_odbc_client_win_64-2.1.20.0.msi 2. The Setup wizard displays to guide you through installing the BlackLynx ODBC Driver (64-bit). Click Next. 3. The End User License Agreement window displays. Ensure you read the agreement. BlackLynx, Inc. ©2019 Page | 2 Installing and Configuring ODBC Client Connector 4. Select the I accept the terms in the License Agreement checkbox and click Next. 5. Specify or accept the default destination folder. Click Next. 6. Click Install and the installation starts. 7. Allow the program to update your system. BlackLynx, Inc. ©2019 Page | 3 Installing and Configuring ODBC Client Connector 8. Once installation is complete, click Finish. 9. On your desktop, click Programs. You can now see the BlackLynx ODBC Driver X.X (64-bit) folder and its files. Select 64-bit ODBC Administrator. **In Windows 10 environment it is located under Windows Administrative Tools -> ODBC Data Source Administrator (64-bit). BlackLynx, Inc. ©2019 Page | 4 Installing and Configuring ODBC Client Connector 10. The ODBC Data Source Administrator pop-up window displays. On the User DSN tab, click Add to create a new data source. 11. On the Create New Data Source window ensure BlackLynx ODBC Driver is selected. Click Finish. BlackLynx, Inc. ©2019 Page | 5 Installing and Configuring ODBC Client Connector 12. The Configure Ryft window displays. Enter a Name and Description for data source. Enter the User name and Password for the server, and specify the IP address of the server. By default, the Port is 7409, but should be changed to match your environment. 13. Click Test Connection to verify connectivity to the Ryft ONE server. If the test is successful, this message displays. If the IP address or the Port is bad, this message displays. BlackLynx, Inc. ©2019 Page | 6 Installing and Configuring ODBC Client Connector 14. After a successful test, click OK to close the Connection Test pop-up. Click OK to close the Configure Ryft pop-up. 15. You’re back on the ODBC Data Source Administrator window. Notice that the data source named has been added. In our example capture it is BlackLynx – 0310. 16. Click OK to close this window. Upgrade Windows Client When a new release of the Windows client is released, you need to run the new windows installer on your desktop and set up the connections to your BlackLynx servers. You can install the new version without uninstalling/deleting the old version, but the SDK does not allow BlackLynx to automatically recreate existing connections to the BlackLynx server. You must manually re-establish these connections. Follow the same steps for installation, as covered in the beginning of this chapter. Ensure you complete the Configure window for each BlackLynx server connection. BlackLynx, Inc. ©2019 Page | 7 Installing and Configuring ODBC Client Connector Sample Server Connections with Windows Clients Example 1: Connect Using Tableau You can connect a business intelligence tool, like Tableau, to the BlackLynx server to view datasets stored on the server. From using pre-defined views to creating custom views using SQL, you can easily connect to your datasets from a BI tool, like Tableau, by using the BlackLynx Connector. 1. Open Tableau. From the left-hand menu, click More Servers… and then select Other Databases (ODBC) 2. The Server Connection window displays. Select your named datasource from the DSN drop-down list, and click Connect. BlackLynx, Inc. ©2019 Page | 8 Installing and Configuring ODBC Client Connector 3. After successfully connecting to the BlackLynx server, then click Sign-in at the bottom of the window. 4. Tableau displays and shows that you are now connected to the BlackLynx server (ODBC). 5. Click on the New Custom SQL to execute a search. BlackLynx, Inc. ©2019 Page | 9 Installing and Configuring ODBC Client Connector Example 2: Connect Using Power BI Power BI can connect to the to the BlackLynx server using the connector. 1. Open the Power BI and select Get data. 2. Select Other -> ODBC and then hit the Connect button. BlackLynx, Inc. ©2019 Page | 10 Installing and Configuring ODBC Client Connector 3. Select the immuta-blacklynx DSN and expand Advance options to enter a custom SQL statement: 4. Hit OK and the query will preview. Then you can Load. BlackLynx, Inc. ©2019 Page | 11 Installing and Configuring ODBC Client Connector Example 3: Connect Using Microsoft Excel Microsoft Excel can connect to the BlackLynx server using the connector. Please note that only the 64-bit version of Excel works with the Connector. Open Microsoft Excel and follow these steps: 1. From the Data ribbon, select From Other Sources and then From ODBC. BlackLynx, Inc. ©2019 Page | 12 Installing and Configuring ODBC Client Connector 2. The window displays. Select ODBC DSN and then click Next. 3. Select Ryft ONE as your ODBC data source and click Next. BlackLynx, Inc. ©2019 Page | 13 Installing and Configuring ODBC Client Connector 4. The Connect to BlackLynx dialog box displays. Enter the information for the server and click Connect. 5. The Navigator will allow you to enter the custom SQL command. BlackLynx, Inc. ©2019 Page | 14 Installing and Configuring ODBC Client Connector 6. Execute the Load button. Install and Run the ODBC Driver on Ubuntu Linux