You can use the Connectors page in the Tetra Data Platform (TDP) to do any of the following:
- Create a Pluggable Connector
- Configure a Pluggable Connector
- Review and edit a Pluggable Connector’s information
- Monitor a Pluggable Connector’s metrics
You can also use the Organization Settings page to manage self-signed SSL Certificates for Pluggable Connectors.
For information about the different Connectors that TetraScience supports, or how to manage Legacy Connectors, see Tetra Connectors.
To open the Connectors page, do the following:
- Sign in to the TDP. Then, in the left navigation menu, select the hamburger menu icon.
- 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.
|HOST||Deployment type: Either Hub or Cloud|
|NETWORK||Indicates whether the Connector is ONLINE or OFFLINE|
|HEALTH||Indicates whether the Connector is in a HEALTHY, UNHEALTHY, or CRITICAL state.|
Note: For more information on health statuses, see Component Health Status.
|MODE||Indicates whether the Connector is in RUNNING mode or IDLE mode|
|CONNECTOR ID||Connector ID|
|Search Text Box||Allows you to search for specific Connectors by name|
|Connector Type Filters||Allows you to see all results (All), or to view only Online, Offline, or Disabled Connectors|
To create a new Pluggable Connector, do the following:
- On the Connectors page, choose the Create Connector button. The Create Connector page appears.
- 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.
- Choose Create. After a few seconds, the Connector instance is created and appears online.
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.
To configure a Connector's settings, do the following:
- 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.
- Select the Configuration tab and configure the required settings.
The configuration parameters for each Connector are different. For more information about how to configure a specific Connector type, see Tetra Connectors.
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:
- 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.
- Select the Information tab to display information about the Connector, including the files it has pending, successfully uploaded, or failed.
Note: When the connection is disabled, no container is running for the Connector.
|NAME||Name 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 ID||The Connector’s ID.|
|TYPE||The Connector type.|
|VERSION||The Connector’s version.|
|LAST SEEN||The last NETWORK check.|
|DESCRIPTION||The user-defined Connector’s description.|
|OTHER PAGES||Contains any additional functionality that's available for the Connector.|
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.
|CONNECTOR VERSION||Connector version|
Note: For beta releases, the version update is not fully supported.
|Add / Edit Attributes||Select this option to add or edit labels, metadata, and tags associated with the Connector.|
To change a Connector’s status, do the following:
- Open the Information tab on on the Connector Details page for the Connector that you want to update.
- In the ACTIONS section, select one of the following buttons to change the Connector’s status (the options available depend on the current status):
- To activate a Connector, choose Set to Running.
- To turn off a Connector, choose Disable.
- To make a Connector idle, choose Set to Idle.
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.
Tetra Connectors sometimes need to trust self-signed SSL certificates used by local systems. Pluggable Connectors provide the ability to upload and manage self-signed SSL certificates in the Tetra Data Platform (TDP).
Legacy Connectors don’t use certificate verification. For more information about the different Connector types, see Tetra Connectors.
To upload a self-signed SSL certificate to the TDP for a Pluggable Connector, do the following:
- Open the Organization Settings page.
- Select the Certificates tab. Then, select the upper right Upload Certificate button. The Upload Certificate dialog appears.
- For CERTIFICATE NAME, enter a name for your certificate. Then, select a certificate file or drag and drop one into the Upload Certificate dialog.
- Choose Add. The certificate appears on the Certificates tab view.
Existing Connectors won’t pick up new certificates or stop using old certificates until the Connector is restarted. SSL 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.
To deactivate, rename, download, or delete a self-signed SSL certificate from the TDP for a Pluggable Connector, do the following:
- Open the Organization Settings page.
- Select the Certificates tab.
- 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:
- Select an action from the menu.
Updated about 1 month ago