EDSL Quick Start - Step 1: Set Up Connector



This topic is part of the Empower Data Science Link (EDSL) Quick Start Guide. If you need more details about the topics discussed in this section, see the For More Information section at the bottom of this page.


In this step, you’ll learn how to set up a connector. Connectors receive extracted data from Empower, then transmit that data from the agent to the Tetra Data Platform, where it is placed in the data lake and processed by a pipeline. Pipelines are discussed in more detail in the next step.

Although this step primarily addresses the User Defined Integration (UDI), there are several ways to extract data from Empower and send them to the Tetra Data Lake. Two commonly-used ways are to use the User Defined Integration (UDI) and Generic Data Connector (GDC).

To determine which type of connector to use, you’ll need to know two things:

  • Is the agent installed on a machine that has internet access?
  • Are the files to be transferred to the data lake large (more than 500 MB) or small (less than 500 MB)?

*Connector Decision Table

Agent Internet AccessSmall Files (less than 500 MB)Large Files (more than 500 MB)
Agent HAS Internet AccessUDI (API upload)UDI (S3 upload)
Agent DOES NOT HAVE Internet AccessGDC/DataHub (API Upload)GDC/DataHub (S3 Upload) with the L7 Proxy Connector

In this Quick Start Guide, we will set up User Defined Integration that will use the S3 upload, which is the recommended method. If you want to learn more about GDC or DataHub, check out the documentation listed at the bottom of this page.

Log into the TDP

To log into the TetraScience Data Platform (TDP) complete the following steps.

  1. Open a supported browser and go to the Tetra Data Platform site.

TDP Login Page

  1. Enter your username and password, then click Sign In.
  2. Before you proceed further, read the [Tour of the TPD](https://developers.tetrascience.com/docs/basic-tetrascience-data-platform-administration) section so that you become familiar with the basic interface.

Set up the UDI

To set up the UDI, complete the following steps.

  1. Click the Main Menu button, select Data Sources, then User Defined Integration.

Main Menu Icon


User Defined Integration Option on Main Menu

  1. In the User Defined Integrations page, click Add User Defined Integration in the upper right corner of the page.
  1. Type the Integration Name, then click Create.

Create User Defined Integration Page

  1. The UDI you just named appears in the ist of User Defined Integrations. Click Add Agent.
  1. The Add a User Defined Agent page appears. There are three sections: Source Type, Name and Description, and Attributes. For the Source Type, select Empower from the drop down menu. (Note that the Agent ID has already been created.) Make note of the Agent ID; you'll need it when you set up the Empower Agent later in these instructions. When finished, click the Next button.

Add a User Defined Agent, Source Type Section

  1. The Name and Description section appears. Add a name and a description, then click Next.

Add a User Defined Agent, Name and Description Section

  1. The Attributes section appears. You can add labels, metadata, and tags here. For this quickstart, let's add a metadata item named "Quick Start" to the files.



The differences among each of these options are addressed in Basic Concepts: Labels, Metadata, and Tags.

a. Click Advanced Fields to display the Add Metadata and Add Tags options.


Add a User Defined Agent, Attributes Section

b. Click Add Metadata.
c. Click the drop down, then type "Quick Start" (without the quotes).


Adding Metadata

d. A message appears: "Create: Quick Start". Click it to create the metadata tag.
e. Add the metadata value "True".

  1. Click Finish. The Agent is added to the UDI list.

New User Defined Integration Has Been Added

Viewing Organizational Details and Adding a Service User Account

You'll need to add a service user's account so that you can obtain a JSON Web Token (JWT), which you will need when you set up the Empower Agent in a later step.

  1. Click the profile icon at the top right corner of the page.
  2. Click Account.

Profile Menu

  1. On the left side of the screen, select the Organization option.
  2. Click the Add User button in the Organization details page.

Organization Details

  1. In the Add a New Service User page, add the service user's name and assign the user to a role.

Add a New Service User

  1. Click the Add button to add the service user.

Generating a JSON Web Token (JWT) for a Service User Account

You can generate a JWT Token for a service account, regardless of role. To generate the token, complete the following steps.

  1. In the Organizational Details page, select Generate Token from the menu options that appear at the right side of the service user account entry.
  2. In the Create New Token page enter the number of days the token should be valid (1 - 180 days), then click the Generate Token button.

Create New Token page

  1. The token appears in the next window. Click the Copy Token button. The token is now on your clipboard and is ready for you to paste it where it is needed. Put it in a safe place; you'll need it when you set up the Empower Agent in a later step.
  2. Click the Close button.



At the end of this step, you should have set up a UDI, created a service user, and generated a JWT Token.

For More Information

For more information on the topics discussed in this page, see the following documentation: