Create and Install a Tetra Hub v1

🚧

IMPORTANT

Tetra Hub v1 is on a deprecation track. For new deployments, Tetra Hub v2 should be installed, except for the following use cases:

For more information, see Tetra Hub v1 Deprecation.

This page describes how to create and install a Tetra Hub v1 (previously Tetra Data Hub).

Before you Begin

Verify that you meet the following requirements:

  • You have a TetraScience account, and you are either the organization owner or the Administrator.
  • You have a dedicated machine for the Hub, because the Hub will always be running.
  • You have admin access to the dedicated device.

For more information about the Hub v1 machine's system requirements, see Tetra Hub v1 System Requirements.

Create and Install the Hub v1

To create a Tetra Hub v1, do the following:

  1. In the Tetra Data Platform, click the Hamburger icon at the top left corner of the page to expand the TDP menu options (or hover over the list of icons to display the menu options):
47

Hamburger Menu

  1. Select Data Sources -> Data Hub from the list of menu options that appears on the left side of the page.
  1. Click + Create new DataHub at the top right corner of the page to open the Data Hub wizard.
710

Data Hub Wizard

  1. Enter a name for the new Hub and click Create DataHub.
702

Data Hub Wizard

  1. Click Download installer to download the installation script.
  2. Copy the installation script to your Hub environment.
  3. Open the Terminal app and navigate to the installation script directory. Change the installation script to run as an executable by entering: sudo chmod +x datahub-installer.sh

For TDP Versions 2.22.0 and Higher

If the Hub v1 machine is behind a proxy, then you can do the following:

  • Manually add environment variables for the proxy (usually done when network administrators prepare a clean machine for the Data Hub as part of their set up), or
  • Configure it automatically through an installation script*.
  1. Run the installation script as root by typing sudo ./datahub-installer.sh. Click here for details.
  2. The Hub installer performs various checks and prompts you for input and/or confirmation.
  • Installer checks if the machine has enough RAM memory:
    • if there < 4 GB of RAM, then the installer will abort.
    • if there >= 4 GB but <= 8 GB of RAM, then the installer will issue a warning and ask if you want to continue.
    • if there > 8 GB of RAM, then the installer will continue without any warning.

📘

MEM Configuration

The MEM configuration can be bypassed during installation. TetraScience has identified performance issues for AWS instance types < 4 GB of RAM. Therefore, we recommend that you use t3.small or larger AWS instance types.

  • Installer checks if the machine has enough allocated disk space:
    • if there < 20 GB of disk space, then the installer will abort.
    • if there >= 20 GB but <= 50 GB of disk space, then the installer will issue a warning and ask if you want to continue.
    • if there > 50 GB of disk space, then installer will continue without any warning.
  • Installer attempts to detect environment proxy variables:
    • If environment proxy variables are set, then the installer presents them and checks if they have the correct values.
    • If no environment proxy variables are detected, then the installer asks if the machine is behind the proxy. If you enter Yes, then you must provide the proxy settings.
    • If proxy settings were detected, or you manually entered the proxy settings in a previous step, then the installer will ask for permission to update the AWS SSM client settings with those proxy details after installation completes. If you reject to provide permission, then the installer will abort. Otherwise, if no proxy settings were detected and you did not provide proxy settings in a previous step, then the installer continues normally.
  • Installer checks if all required software is installed, and if not, it will install it.
  1. After the installation completes, return to the TDP platform UI to register and activate the Hub with AWS. Click Activate. The activation expires 24 hours after the Data Hub was created. You can only use the activation code once and it must be within the 24 hours after you created the Data Hub in the TDP UI. If it expires, then you must create a new Data Hub and run a new installation script.

The new Hub v1 should appear as activated and online. You can add connectors to this Hub.

For TDP Versions Earlier than 2.22.0

After the installation is complete, return to the TDP UI to activate the newly installed Hub v1. Click Activate to continue. The activation expires 24 hours after the Hub was created. You can only use the activation code once and it must be within the 24 hours after you created the Hub in the TDP UI. If it expires, then you must create a new Hub and run a new installation script.

The new Hub v1 should appear as activated and online. You can add connectors to this Hub.

Troubleshooting Common Tetra Hub v1 Installation Issues

These common issues may occur during the Tetra Hub v1 installation procedure:

  • Installation script fails because there is no network access. To fix this issue, you should check:

    • Does the Hub v1 machine have network access?
    • Does the Hub v1 machine have open 443 port?
    • Is the Hub v1 machine behind a proxy? If so, then you must configure the environment variables.
  • Installation script fails because some of required software components cannot be installed automatically. This generally occurs with Docker installation. If it does happen, then manually install Docker and run the installation script again.

  • Hub v1 activation fails. Please review the log at /var/log/amazon/ssm/amazon-ssm-agent.log and verify that there are no network related issues. If there are network issues, then review the network and proxy settings for the Hub machine.