Create, Configure, and Update Pluggable Connectors

You can use the Connectors page in the Tetra Data Platform (TDP) to do any of the following:

You can also use the Organization Settings page to manage self-signed and private SSL/TLS Certificates for Pluggable Connectors.

For information about the different Connectors that TetraScience supports, or how to manage Legacy Connectors, see Tetra Connectors.

Access the Connectors Page

To open the Connectors page, do the following:

  1. Sign in to the TDP. Then, in the left navigation menu, select the hamburger menu icon.
  2. Choose Data Sources. Then, choose Connectors. The Connectors page appears and displays a list of your Connectors.

Information Available on the Connectors Page

The following table shows the details that are available on the Connectors page.

FieldDescription
NAMEConnector name
TYPEConnector version
HOSTDeployment type: Either Hub or Cloud
NETWORKIndicates whether the Connector is ONLINE or OFFLINE
HEALTHIndicates whether the Connector is in a HEALTHY, UNHEALTHY, or CRITICAL state.

Note: For more information on health statuses, see Component Health Status.
MODEIndicates whether the Connector is in RUNNING mode or IDLE mode
CONNECTOR IDConnector ID
Search Text BoxAllows you to search for specific Connectors by name
Connector Type FiltersAllows you to see all results (All), or to view only Online, Offline, or Disabled Connectors

Create a Pluggable Connector

To create a new Pluggable Connector, do the following:

  1. On the Connectors page, choose the Create Connector button. The Create Connector page appears.
  2. On the Create Connector page, enter the following information:
    • For NAME, enter the Connector’s name.
    • (Optional) For DESCRIPTION, enter a description of the Connector.
    • For HUB OR CLOUD, select the deployment mode (Hub or Cloud) from the drop-down list.
    • For CONNECTOR TYPE, select a Connector type from the drop-down list.
    • For CONNECTOR VERSION, select the latest version available.
    • (Optional) Select Add / Edit Attributes to add labels.
  3. Choose Create. After a few seconds, the Connector instance is created and appears online.

📘

NOTE

After the Connector is created, the initial MODE status is set to IDLE by default. To activate the Connector, you must configure its settings. For instructions, see the Configure a Connector section.

Configure a Pluggable Connector

To configure a Connector's settings, do the following:

  1. On the Connectors page, select the name of the Connector that you want to configure. The Connector Details page appears for the Connector that you selected.
  2. Select the Configuration tab and configure the required settings.

📘

NOTE

The configuration parameters for each Connector are different. For more information about how to configure a specific Connector type, see Tetra Connectors.

Review and Edit a Pluggable Connector’s Information

Each Connector has a Connector Details page that provides information about the connector, and that allows you to edit that information.

To access the Connector Details page for a specific Connector, do the following:

  1. On the Connectors page, select the name of the Connector that you want to review or edit. The Connector Details page appears for the Connector that you selected.
  2. Select the Information tab to display information about the Connector, including the files it has pending, successfully uploaded, or failed.
FieldDescription
CONNECTION- ENABLED
- DISABLED

Note: When the connection is disabled, no container is running for the Connector.
NAMEName of the Connector
NETWORK- ONLINE: Container is created and can be reached by the TDP.
- OFFLINE: Container can't be reached by the TDP.
HEALTH- HEALTHY: Everything is fine, Connector doesn’t see any issues.
- WARNING: There is some issue but it’s not critical.
- CRITICAL: Critical issue that prevents Connector from running. Connector cannot upload data or execute some commands even in case its operational status is running.
- N/A: The Connector doesn’t have a health status yet. This generally indicates that a Connector was created but has not been configured.
MODE- IDLE: Connector is enabled, but should not be uploading data. The Connector may accept and execute commands. When the Connector is first created, its MODE status is IDLE by default.
- RUNNING: Connector is enabled, should be running and uploading data. The Connector may accept and execute commands.
- DISABLED: Connector container is shut down.
HOST- Cloud: Connector was deployed as a standalone server in the Cloud
- Hub: Displays the Hub Name as a link to the hub’s details page.
CONNECTOR IDThe Connector’s ID.
TYPEThe Connector type.
VERSIONThe Connector’s version.
LAST SEENThe last NETWORK check.
DESCRIPTIONThe user-defined Connector’s description.
OTHER PAGESContains any additional functionality that's available for the Connector.

Edit a Pluggable Connector's Information

To edit a Connector’s information, select the Edit button on the Connector Details page’s Information tab. The Edit Connector Information page appears.

Connector Information That You Can Edit

The following table shows the Connector information that can be edited after a Connector is created.

FieldDescription
NAMEConnector’s name
DESCRIPTIONConnector’s description
CONNECTOR VERSIONConnector version

Note: For beta releases, the version update is not fully supported.
Add / Edit AttributesSelect this option to add or edit labels, metadata, and tags associated with the Connector.

Change a Pluggable Connector's Status

To change a Connector’s status, do the following:

  1. Open the Information tab on on the Connector Details page for the Connector that you want to update.
  2. Select one of the following buttons to change the Connector’s status (the options available depend on the Connector's current status):
    • Enable: Changes a Disabled Connector’s mode to Enabled
    • Disable: Changes an Enabled Connector’s mode to Disabled
    • Set to Idle: Changes a Running Connector’s mode to Idle
    • Set to Running: Changes an Idle Connector’s mode to Running
    • Sync: Synchronizes a Connector with the TDP (Note: This action recreates the Connector’s components and restarts its container for troubleshooting purposes)

Monitor a Pluggable Connector's Metrics

After a Connector instance is created and running, you can monitor the Connector’s metrics by selecting the Metrics tab on the Connector Details page. The Metrics tab displays the Connector's container metrics as well as aggregated states on total files scanned and uploaded as well as files that returned errors or are pending.

Manage Self-Signed and Private SSL/TLS Certificates for Pluggable Connectors

Tetra Connectors sometimes need to trust self-signed or private Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificates used by local systems. Pluggable Connectors provide the ability to upload and manage self-signed or private SSL/TLS certificates in the Tetra Data Platform (TDP).

📘

NOTE

Legacy Connectors don’t use certificate verification. For more information about the different Connector types, see Tetra Connectors.

Upload Self-Signed and Private SSL/TLS Certificates

To upload a self-signed or private SSL/TLS certificate to the TDP for a Pluggable Connector, do the following:

  1. Open the Organization Settings page.
  2. Select the Certificates tab. Then, select the upper right Upload Certificate button. The Upload Certificate dialog appears.
  3. For CERTIFICATE NAME, enter a name for your certificate. Then, select a certificate file or drag and drop one into the Upload Certificate dialog.
  4. Choose Add. The certificate appears on the Certificates tab view.

📘

NOTE

Existing Connectors won’t pick up new certificates or stop using old certificates until the Connector is restarted. SSL/TLS certificates have an expiration date, after which they’re no longer valid. Users can't upload expired certificates. If a certificate is expired, the TDP rejects it.

Manage Self-Signed and Private SSL/TLS Certificates

To deactivate, rename, download, or delete a self-signed or private SSL/TLS certificate from the TDP for a Pluggable Connector, do the following:

  1. Open the Organization Settings page.
  2. Select the Certificates tab.
  3. In the list of certificates, find the certificate that you want to manage or download. Then, in that certificate’s row, select the far right hamburger menu icon. A drop-down menu appears that provides the following options:
  • Disable
  • Rename
  • Download
  • Delete
  1. Select an action from the menu.