Tetra Data Hub Frequently Asked Questions (FAQ)

What is the Tetra Data Hub?

The Tetra Data Hub is the on-premise component of the Tetra Data Platform. Its job is to facilitate securely transferring customer data to the platform through configuration.

How does the Tetra Data Hub work?

The Tetra Data Hub relies heavily on AWS services such as Systems Manager and AWS IoT. The Tetra Data Hub will ask periodically for new instructions and configuration from the TetraScience platform. The Data Hub will download and run Data Connectors based off configuration specified in the web interface of the platform under your account.

How many Tetra Data Hubs do I need?

If the Tetra Data Hub host can be reached from anywhere in the enterprise network, theoretically you only need one and create as many connectors on this Data Hub as you want. Of course, depending on your location and team, you may want to create separate ones so it's easier to manage.

How can I troubleshoot if the Tetra Data Hub or Connector is offline?

  1. Please make sure the network requirements are met. If you need to set up a proxy, please refer to the proxy setup guide.
  2. Open the command line on the Tetra Data Hub machine, on CentOS, RedHat and Ubuntu v18.04 and up run systemctl status amazon-ssm-agent to see if the SSM agent is running. On older versions of Ubuntu, run service amazon-ssm-agent status.
  3. Open the command line on the Data Hub machine, type docker ps to see if there is any Docker container running (TetraScience connectors are run in Docker containers).
  4. Check SSM agent logs to see if there is any error: /var/log/amazon/ssm/amazon-ssm-agent.log and /var/log/amazon/ssm/errors.log

Is it secure?

The core components of the Tetra Data Hub leverage AWS technologies, such as AWS IoT and AWS SSM agent (https://github.com/aws/amazon-ssm-agent). Data uploaded by the Data Connectors follow AWS IoT best practices - connectors are only given very restrictive, temporary credentials for uploading data to the platform. Communication from a Tetra Data Hub is only initiated outbound; TetraScience will never send commands directly to a Tetra Data Hub.

How can I configure Tetra Data Hub to use a proxy?

Please refer to this link: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-proxy-with-ssm-agent.html. Note that these steps must be repeated whenever the proxy settings change.

Will the Tetra Data Hub restart if the host server is rebooted?

Yes, the Tetra Data Hub will autostart when the server restarts.

How can I check the Tetra Data Hub, Connector, and Agent status?

  1. Click the Hamburger Menu on Tetra Data Platform.
186186

Hamburger Menu

  1. Select Data Sources, then Data Hub.
219219

Data Hub Option

  1. The online/offline status indicator is shown in the screenshot below
19051905

How soon will the Tetra Data Hub activation expire?

It will expire after 24 hours after the Tetra Data Hub is created. You then need to create a new Tetra Data Hub and run the new installation script. The activation code can only be used once.