29
RYFT SYSTEMS, INC. Ryft JDBC Connector Installation and User Guide Ryft Document Number: 1193 Document Version: 1.2.1 Revision Date: May 2017 © 2017 – Ryft Systems, Inc. All Rights in this documentation are reserved.

Ryft JDBC Connector JDBC Connector . ... Example: Connect to Ryft ONE Using Pentaho ... Connect to Ryft Using Pentaho User Console 16 3: Troubleshooting

Embed Size (px)

Citation preview

RYFT SYSTEMS, INC.

Ryft JDBC Connector Installation and User Guide

Ryft Document Number: 1193

Document Version: 1.2.1

Revision Date: May 2017

© 2017 – Ryft Systems, Inc. All Rights in this documentation are reserved.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page ii

Copyright (c) 2017, Ryft Systems, Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

All advertising materials mentioning features or use of this software must display the following acknowledgement:

This product includes software developed by Ryft Systems, Inc.

Neither the name of Ryft Systems, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY RYFT SYSTEMS, INC. ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL RYFT SYSTEMS, INC. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page iii

Revision History

Date Reason for Change Version

May 2017 Update location of JDBC client zip file 1.2.1

February 2017 Updated Simba information 1.2.0

November 2016 Initial Release 1.1.0

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page iv

Contents Using This Guide ....................................................................................................................................... 5 Ryft Technical Support ............................................................................................................................. 5 About Ryft Systems Inc. ........................................................................................................................... 5 1: Overview .............................................................................................................................................. 7 2: Install Ryft JDBC Connector .................................................................................................................. 9

Summary of Steps ................................................................................................................................. 9

Step 1: Create Directory on Java Classpath ........................................................................................ 10

Step 2: Download/Unzip the file and Review the README file .......................................................... 10

Step 3: Modify ryftone.server.ini File (Optional) ................................................................................ 11

Step 4: Test the JDBC Client/Server Connection ................................................................................. 12

Connection String Parameters 12

Example: Connect to Ryft ONE Using Pentaho ................................................................................... 15

Install Ryft JDBC Driver 15

Connect to Ryft Using Pentaho User Console 16

3: Troubleshooting ................................................................................................................................. 25 Appendix A: Commonly Used Acronyms and Terms ............................................................................. 26 Appendix B: Open Source ...................................................................................................................... 28

3rd Parties Used in Deployment: Open Source .................................................................................... 28

3rd Parties Used in Deployment: 3rd Party Purchased ......................................................................... 28

Ryft-Developed Code .......................................................................................................................... 28

Optional Ryft-Developed Open Source ............................................................................................... 29

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 5

Using This Guide This guide is for the System Administrator responsible for installing the Ryft Connector on your Ryft ONE server and/or clients, and making Ryft ONE accessible to your end users. It’s also for the end user who will ultimately use their business intelligence and data visualization (BI/DV) tool to access the datasets on the Ryft ONE, taking advantage of all of the benefits of the Ryft ONE server.

There are step-by-step instructions on installing the Ryft Connector and installing the sample datasets, and how to connect the BI/BA applications to the Ryft ONE.

Additional resources: Ryft Open API Library User Guide and the Ryft ONE: User Guide.

Ryft Technical Support You may access our first-tier support directly from our public website by using the Chat Widget and starting a chat with our support agents. All chat conversations are tracked and become help desk tickets in our support system. In addition, you can access our support system through the Ryft Support site: https://support.ryft.com. Log in with your credentials to see your past tickets, create new tickets, and to access limited-access content.

For technical support, contact us:

Email: [email protected]

Web: https://support.ryft.com

Phone: 1-855-793-8663 (RYFT ONE)

About Ryft Systems Inc. Ryft makes data analytics fast and simple with the world’s top cloud and physical heterogeneous compute accelerators. With more than a decade of experience, Ryft helps deliver instant insights into any data by eliminating the latency associated with data indexing and transformation/curating. Today, industry leaders rely on Ryft to quickly and simply unlock the value hidden in their data for real-time actionable insight.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 6

This page intentionally left blank.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 7

1 1: Overview Connect your business analytics/intelligence/visualization applications such as Tableau, Birst, Excel, or Pentaho to the Ryft ONE server using Ryft Connectors for ODBC, JDBC or Apache Spark. This is done without the need for indexing or ETL and without the need to put the data into an SQL or noSQL database inside the Ryft ONE. Instead, the Ryft ONE can work with structured files like XML and JSON, with future support for flat files, key values and CSV files, to make it look like the data is coming from an SQL database while being transparent to your business applications.

The Ryft Connector:

• Supports the SQL-92 standard, which is supported by most major database vendors.

• Enables key features for analysis including:

o Database tables and views o Column meta data o SQL commands (=, !=, LIKE, NOT LIKE) o Auto discovery of tables, views and metadata

• Client runs natively on Windows, Mac, and Linux-based infrastructures The Ryft Connector was built with the SimbaEngine SDK from Simba Technologies, which provides flexibility, convenience and connectivity to multiple BI tools, comprehensive support and excellent SQL-query coverage.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 8

This guide focuses on the Ryft JDBC Connector.

See Also:

• Ryft ODBC Connector: Installation and User Guide

• Ryft ODBC/JDBC Connector: SQL Reference Guide

• Ryft ONE Spark Integration and User Guide

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 9

2 2: Install Ryft JDBC Connector The Ryft JDBC Connector enables Java programs to execute the Ryft primitives and SQL statements, and to interact with the Ryft ONE server and datasets. The Ryft JDBC Connector (“Ryft Connector”) supports LDAP, and is easy to download and install.

NOTE: The Ryft JDBC Client requires Java 1.8 or higher.

The Ryft Connector for JDBC driver file, ryft1_jdbc_client_x.x.x.x.zip (where “x.x.x.x” is the version number) is in the “~/install” directory on the Ryft ONE.

Create a directory on the Java Classpath and unzip the file in the new directory.

ryftuser@ryftone-313:~/install$ ls -al total 697272 drwxr-xr-- 4 ryftuser ryftuser 4096 Feb 7 11:05 . drwxr-xr-x 47 ryftuser ryftuser 12288 May 30 11:24 .. drwxrwxrwx 2 ryftuser ryftuser 4096 Dec 20 10:13 Documents -rw-rw-r-- 1 ryftuser ryftuser 45056 Jan 13 14:19 installation-fpga.log-2017-0113 -rw-rw-r-- 1 ryftuser ryftuser 176128 Jan 13 14:11 installation.log-2017-0113 -rw-r--r-- 1 root root 21990 Jan 13 14:19 repoServer.log -rwxrwxr-x 1 ryftuser ryftuser 710306 Jan 13 14:09 ryft1_jdbc_client_1.1.9.0.zip -rwxrwxr-x 1 ryftuser ryftuser 34516194 Jan 13 14:09 ryft1_odbc_client_linux_64-1.1-12.3.tar.gz -rwxrwxr-x 1 ryftuser ryftuser 10649600 Jan 13 14:10 ryft1_odbc_client_win_64_1.0.6.1.msi -rwxrwxr-x 1 ryftuser ryftuser 38144074 Jan 13 14:10 ryft1_odbc_server_linux_64-2.0-16.2.tar.gz drwxrwxrwx 6 ryftuser ryftuser 4096 Jan 6 17:17 ryft-cluster -rwxrwxr-x 1 ryftuser ryftuser 15541582 Jan 13 14:09 ryft-demo-0.3.0-bin.tar.gz -rwxrwxr-x 1 ryftuser ryftuser 849466 Jan 13 14:09 ryft-python-client-0.2.1.tar.gz -rw-r--r-- 1 ryftuser ryftuser 125286474 Jan 13 14:09 SampleDatabases.tar.gz -rwxr-xr-x 1 ryftuser ryftuser 4781 Jan 23 11:56 starbucks.sjson

The ryft1_jdbc_client_x.x.x.x zip file contains 2 files:

• README

• RyftJDBCClient42.jar – an executable Jar file.

Summary of Steps Follow these steps to unzip and install the driver:

1. Create directory on Java Classpath

2. Download/unzip file and review README file

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 10

3. Modify ryftone.server.ini file (Optional)

4. Test JDBC Client/Server Connection

Step 1: Create Directory on Java Classpath

The Ryft JDBC Client requires Java 1.8 or higher. You can find a JDK at the Java website: http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Copy the “RyftJDBCClient42.jar” file to the target machine and make sure that it is on the java classpath. More information about setting the java classpath can be found here: http://docs.oracle.com/javase/7/docs/technotes/tools/windows/classpath.html.

Step 2: Download/Unzip the file and Review the README file

Unzip the client installation file. Open the README file using your preferred viewer and review the contents. Here is a snippet:

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 11

NOTE: The information provided in the “Testing the JDBC Client/Server connection” will be needed when integrating a BI tool, such as Pentaho, with the Ryft Server. You will need the IP address of the Ryft ONE server and the listening port number on the server.

Step 3: Modify ryftone.server.ini File (Optional) Next, you may choose to modify the ~/.ryftone.server.ini file to match your installation. This is optional.

ryftuser@ryftone-310:~$ cat .ryftone.server.ini [Server] LogLevel=6 LogNamespace= LogPath=./ DriverLocale=en-US DriverManagerEncoding=UTF-16 ErrorMessagesPath=../../../ryft1_files/errormessages ListenPort=12345 ListenAddress=0.0.0.0 UseSsl=0 [REST] RESTServer=http://localhost:8765 #RESTUser=odbcuser #RESTPass=odbcpass [Auth] Type=none LDAPServer=ldap://ldap.forumsys.com:389 LDAPUser=read-only-admin LDAPPassword=password LDAPBaseDN=dc=example,dc=com

You may want to update the following values in the file:

Section Field Description/Notes

[Server] LogLevel Logging Level. Default is 0, off. Available values are: • 0 = Off

• 1 = Fatal; only fatal issues are logged

• 2 = Error; error conditions and fatal issues

• 3 = Warning; warnings, errors and fatal issues

• 4 = Informational; informational messages, warnings, etc.

• 5 = Debug; all debugging information, information messages, etc.

• 6 = Trace; function level entry points, debugging info, etc.

LogPath Path to directory that will contain the log files.

[REST] RESTServer URL and port for Ryft REST server

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 12

Section Field Description/Notes

RESTUser Administrative user account name. Un-comment if authentication is enabled.

RESTPass Password for the administrative account. Un-comment if authentication is enabled.

[Auth] Type Authorization type. Available values are: • ldap – if specified, set the next 4 values

• system

• none

LADPServer URL for LDAP server (i.e. ldap://ldap.forumsys.com:389)

LDAPUser Administrative user account name (i.e. read-only-admin)

LDAPPassword Password for the administrative user account listed above.

LDAPBaseDN Base domain name used for account searches (i.e. dc=example,dc=com)

Modify the file, as needed, and then save and close the file.

If your JDBC application runs on your desktop, such as Pentaho, then install the JDBC driver on your desktop.

If you will use a JDBC application in a Linux environment, such as LibreOffice, then install the JDBC driver on your Linux server.

Step 4: Test the JDBC Client/Server Connection You may need to provide the following, depending on the application you use to connect to the Ryft ONE:

• Classname: com.simba.client.core.jdbc42.SCJDBC42Driver

• Connection URL: IP Address of Ryft ONE and port the server is listening on (e.g. “jdbc:simba://127.0.0.1:7409”).

Connection String Parameters

The Ryft Client for JDBC responds to configuration keywords similar to those for the Ryft Client for ODBC. However, since JDBC does not use the idea of a DSN, the user application must add the keywords and values to the connection string. Ryft Client for JDBC parses the connection string for configuration keywords, and extracts and acts on the values.

The general form of the connection URL is:

jdbc:simba://<ServerHost>:<ServerPort>[;<property>=<value>[;…]]

where [ ] indicates optional values. Note that additional values that need to be passed through the client, such as UID and PWD, can be specified in the property=value portion of the URL.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 13

Keyword Description

ServerHost

Description The hostname or IP address of the Ryft Server

Required Yes

Data Type String

Range Any valid hostname or IP address

Default Value (No Default)

Example 192.168.0.1 or [2001:0db8:85a3:0000:0000:8a2e:0370:7334]

Specification This value must be present in the connection URL. Example: jdbc:simba://<ServerHost> where <ServerHost> is replaced with the appropriate value. Note that the use of [ ] is optional for IPv4 addresses, but required for IPv6 addresses.

Comment Ryft Client must be able to find the Ryft Server on the network and will try to make a network connection to this hostname or address.

ServerPort

Description The port on which Ryft Server is listening

Required Yes

Data Type Integer

Range 0 – 65535

Default Value (No Default)

Example ServerPort=7409

Specification This value may be present in the connection URL. Example: jdbc:simba://172.0.0.1:<ServerPort> where <ServerPort> is replaced with the appropriate value. Typically, the Ryft ODBC Server installation uses port 7409.

Comment Ryft Client must be able to make a network connection to the host and port on which the Ryft Server is listening.

UID

Description User ID/username to use when accessing the driver

Required Yes, if the server requires authentication

Data Type String

Default Value No default value

Example UID=jwashington

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 14

Keyword Description

Specification This value may be present in the connection URL. For example: jdbc:simba://<HOST>[...];UID=<UserIDValue> where the values in < > are replaced with the appropriate values and [ ] indicates optional portions of the connection URL.

PWD

Description The password of the User ID/username, specified by UID, to use when accessing the driver

Required Yes, if the server requires authentication

Data Type String

Default Value No default value

Example PWD=123HelloWorld

Specification This value may be present in the connection URL. For example: jdbc:simba://<HOST>[...];PWD=<Password> where the values in < > are replaced with the appropriate values and [ ] indicates optional portions of the connection URL.

LogLevel

Description Level of log detail/how much information to log

Required No

Data Type Enumeration

Range Options are: • OFF or 0

• FATAL or 1

• ERROR or 2

• WARNING or 3

• INFO or 4

• DEBUG or 5

• TRACE or 6

Default Value OFF (0)

Example LogLevel=DEBUG / LogLevel=5

Specification This value may be present in the connection URL. For example: jdbc:simba://<HOST>[...];LogLevel=<LevelValue> where the values in < > are replaced with the appropriate values and [ ] indicates optional portions of the connection URL.

Comment With this keyword, you can control the amount of log output by controlling the kinds of events that are logged.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 15

Keyword Description Available options are: • OFF (0): no logging occurs

• FATAL (1): only log fatal errors

• ERROR (2): log all errors

• WARNING (3): log all errors and warnings

• INFO (4): log all errors, warnings, and informational messages

• DEBUG (5): log method entry and exit points and parameter values for debugging

• TRACE (6): log all method entry points.

LogPath

Description Directory to store log files.

Required No

Data Type String

Range Valid directory path or blank

Default Value Blank. By default, stores log files in the current working directory.

Example LogDirectory=”C:\RyftJDBC”

Specification This value may be present in the connection URL. Example: jdbc:simba://<HOST>[...];LogLevel=<NotOff>;LogDirectory=<DirectoryValue> where the values in < > are replaced with the appropriate values and [ ] indicates optional portions of the connection URL.

Comment This keyword specifies where Ryft Client for JDBC will write all log files. If no path is specified then the log files will be written to the current working directory.

Example: Connect to Ryft ONE Using Pentaho This example shows you how to connect Pentaho to the Ryft ONE using the Ryft Connector for JDBC

Install Ryft JDBC Driver

In order to connect to the Ryft ONE with Pentaho, you need to add a new database connection. This requires you to install the Ryft JDBC Driver (RyftJDBCClient42.jar) to the folder specified in the Pentaho help documentation: /pentaho/server/pentaho-server/tomcat/lib/. This step must be completed before adding a database connection.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 16

NOTE: Pentaho requires you to stop and re-start Pentaho server or the client tool on which you installed the new driver JAR before continuing.

Connect to Ryft Using Pentaho User Console

Start Pentaho and log in as the System Administrator. From the main menu, click File > Manage Data Sources, or click the Manage Data Sources button on the Pentaho User Console (PUC).

The Manage Data Sources pop-up displays.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 17

Click New Data Source and the Data Source Wizard displays.

Enter the Data Source Name for your Ryft ONE server, and then select Database Table(s) as the Source Type. The list of available database connections displays.

You can name this for the table you connect to or the report you’re going to create. So instead of using “Ryft” in our example, above, you can call it Ryft Passengers, for example, because you want to connect to the Ryft ONE Passengers data table.

NOTE: Pentaho only allows you to connect to one table at a time so you have to build a unique connection to each table you wish to access.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 18

Ensure Reporting only is selected at the bottom, and then click +, the Add Connections icon, to add a database connection.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 19

The Database Connection dialog box displays.

Just beneath the Database Type selection box is the Adding Databases help link. Click the link to determine where to install the driver.

For the Ryft ONE JDBC driver, copy it to the directory for the Pentaho BA Server on your local hard drive, as specified by Pentaho.

Using the information provided in the Ryft JDBC README file, copy and paste the Connection URL into the Custom Connection URL field.

NOTE: Replace the generic the IP address in the Custom Connection URL with the specific IP address for your Ryft ONE server. Copy and paste the Class Name for the Ryft Client for JDBC in to the Custom Driver Class Name field.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 20

The Database Type is Generic database and the Access is Native (JDBC).

Enter the User Name and Password for your Ryft ONE server, and then click Test to verify connectivity. A message displays with the test results:

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 21

Click OK to the verification message.

• If the test failed, verify the information entered into the Database Connections fields and test again until you have a successful test.

• If the test was successful, click OK again on the Database Connection dialog box. The Data Source Wizard displays and now shows the newly added connection “Ryft-310” in the list of Connections.

Continue by specifying the Data Source Name and clicking Next to select from the Available Tables.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 22

Select a table from the list of Available Tables and then click > to move it to the Selected Tables list on the right.

Click Finish to create the data source. The Data Source Created pop-up displays. Select Customize model now radio button, and then click OK.

Pentaho displays the Data Source Model Editor and enables you to verify the table and fields

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 23

Once verified, click OK, and the Manage Data Sources screen displays.

Verify that your newly added data source, Ryft, and the newly added JDBC connection Ryft-310, displays. Click Close.

From the home page, select Create New > Interactive Report, and then select Ryft, your new data source:

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 24

Click OK and then create your report.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 25

3 3: Troubleshooting The ODBC/JDBC Server creates the “ryftone_server.log” log file for all submitted transactions. By default, the log file is located in the “/usr/local/ryft/bin/x8664” directory. You can change the location by updating the LogPath in the “.ryftone.server.ini” file.

/usr/local/ryft/bin/x8664$ ls -al total 54008 drwxrwxr-x 2 ryftuser ryftuser 4096 Sep 6 17:10 . drwxrwxr-x 4 ryftuser ryftuser 4096 Sep 6 16:38 .. -rwxrwxr-x 1 ryftuser ryftuser 12019802 Feb 27 2016 libSimbaClient.so -rw-r----- 1 root root 5 Sep 6 17:14 .r1odbcd.pid -rwsr-sr-x 1 root root 1769945 May 25 19:34 ryft1_odbcctl -rwsr-sr-x 1 root root 22812002 May 25 19:35 ryft1_odbcd -rw-rw-rw- 1 ryftuser ryftuser 588 Sep 6 16:48 .ryftone.server.ini -rw-r--r-- 1 root root 18672423 Sep 8 16:37 ryftone_server.log

The logging level is controlled by the LogLevel parameter in the “.ryftone.server.ini” file.

Options are:

• 0 = Off

• 1 = Fatal; only fatal issues are logged

• 2 = Error; error conditions and fatal issues

• 3 = Warning; warnings, errors and fatal issues

• 4 = Informational; informational messages, warnings, etc.

• 5 = Debug; all debugging information, information messages, etc.

• 6 = Trace; function level entry points, debugging info, etc. The default level for logging is "0" or no logging. The maximum setting is 6. The LogLevel should only be modified when you are troubleshooting an issue to capture necessary information.

NOTE: If you modify the level, you must restart the ODBC server.

See Also: Step 3: Modify ryftone.server.ini File (Optional)

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 26

A Appendix A: Commonly Used Acronyms and Terms This guide frequently uses the following acronyms and terms:

Word / Term Description

API Application Programming Interface * Code that allows two software programs to communicate with each other. It defines the correct way for a developer to write a program that requests services from an operating system (OS) or other application.

CLI Command Line Interface * A user interface to a computer’s operating system or an application in which the user responds to a visual prompt by typing in a command on a specified line, receives response back from the system, etc.

JDBC Java Database Connectivity A Java API that enables Java programs to execute SQL statements. This allows Java programs to interact with any SQL-compliant database.

LDAP Lightweight Directory Access Protocol A software protocol for enabling anyone to locate organizations, individuals, and other resources such as files and devices in a network, whether on the public Internet or on a corporate intranet.

ODBC Open Database Connectivity A standard API for accessing database management systems. Built to be independent of database systems and operating systems.

Spark RDD Spark Resilient Distributed Dataset A collection of elements partitioned across the nodes of the cluster that can be operated on in parallel. (See Spark Programming Guide: http://spark.apache.org/docs/latest/programming-guide.html)

RDF Record Definition File It defines how files with a particular extension should be treated by the Ryft system. These settings determine how the file is to be broken up for

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 27

Word / Term Description optimized reads/writes, and specifies whether the file is raw data, text, or structured text (records-based). When dealing with structured text, it is best to define an RDF for that file extension type, so that each record will stay intact as a single entity, and so that operations can be tailored to specific fields, if desired.

REST API Representational State Transfer Application Programming Interface * An application program interface (API) that allows communication between a web-based client and server that employs representational state transfer (REST) constraints. It uses HTTP requests to GET, PUT, POST and DELETE data.

ROL Ryft Open API Library The library that abstracts and manages Ryft ONE hardware resources.

RHFS Ryft Hybrid File System The file system that manages data flow into and out of the Ryft ONE’s advanced array of 48 solid state drives (SSDs).

NOTE: * - Definitions from www.techtarget.com/network.

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 28

B Appendix B: Open Source Ryft uses the following Open Sources in the deployment of the Ryft ONE server, obtained from third parties, that Ryft Systems, Inc. has developed and contribute as open source, and some that are optional open source for the Ryft ONE.

3rd Parties Used in Deployment: Open Source • Ansible – simple IT automation platform that makes your applications and systems easier to

deploy (if customer elects to deploy Ryft Cluster)

• Apache Spark (If customer elects to deploy the Spark connector)

• Consul – cluster management software (if customer elects to deploy Ryft Cluster)

• DKMS – driver management

• Fuse - file systems

• iSQL – interactive SQL tool (only needed if customer elects to deploy the ODBC/JDBC Connector)

• SQL Lite – used for settings database for core Ryft ONE: also used for simple database tool used for caching ODBC/JDBC connector.

• Swagger – simple yet powerful framework for the RESTful API

• Ubuntu - open source operating system platform

3rd Parties Used in Deployment: 3rd Party Purchased • Simba ODBC SDK (only needed if customer elects to deploy the ODBC connector)

Ryft-Developed Code • Ryft Open API – the set of bindings description (headers, etc.) provided for C, C++, Java, see

ryft.com/api for details (API document is a freely downloadable (no login required) PDF document.)

• Ryftprim – an open source command line tool that wraps the Ryft Open API, which enables bash scripting that Ryft provides to invoke Ryft analytics functions from standard Ubuntu 14.04 LTS Linux.

• Open source web-based demo software that Ryft created.

• JSON RESTFul API soon to be published on GitHub

Doc #1193, V1.2.1/ May 2017 Ryft JDBC Connector: Installation and User Guide

Ryft Systems, Inc. Page 29

Optional Ryft-Developed Open Source These are Ryft-developed open source that the customer may choose to add to the system.

• Open source ODBC/JDBC connector for SQL access to Ryft functionality; soon to be published on GitHub.

• Open source Spark connector for seamless Ryft ONE integration into Spark clusters. Published on GitHub and also available in Spark-Packages: http://spark-packages.org/package/getryft/spark-ryft-connector.

• Open source Consul connector for integration with Ryft ONE; soon to be published on GitHub.