API DocumentationProduct Documentation
Product Documentation

Tetra IoT Agent Box Local Setup and Configuration

Suggest Edits

Once you have created a Tetra IoT Agent in the Tetra Data Platform (TDP), you must set up the Tetra IoT Agent Box locally to ensure outbound network connectivity to the TDP.

To set up the Tetra IoT Agent Box locally, do the following.

Step 1: Connect to the Box

To access the Local Configuration user interface of the Tetra IoT Agent Box, you can connect by using either of the following methods:

2458

Figure 1: IoT NeuroQ Box

Wi-Fi Hotspot Box Access

To access the Tetra IoT Agent Box user interface by using a Wi-Fi hotspot, do the following:

  1. Connect the provided power supply to component 10 on the IoT NeuroQ Box in Figure 1.
  2. The Tetra IoT box ships with a USB adapter that broadcasts a Wi-Fi signal. Connect the USB adapter to components 5 or 7 as illustrated in Figure 1.
  3. Connect your computer or laptop to the Wi-Fi SSID associated with the USB adapter by using the provided credentials. Please contact your TetraScience Customer Success Manager (CSM) if you can't connect.

LAN Port Box Access

To access the Tetra IoT Agent Box user interface by using a LAN port, do the following:

  1. Connect provided the power supply to component 10 in Figure 1.
  2. Connect your computer to the Tetra IoT box through component 8 in Figure 1 with an ethernet cable (CAT5e or newer standards).
  3. If you have custom or restrictive networking settings on your computer, make sure that the IP address and subnet range allows you to connect to 192.168.101.204 (the default Tetra IoT Agent Box IP).

Step 2: Configure Tetra IoT Agent Box

Once you've connected to the box, configure it by doing the following:

  1. Open http://192.168.101.204 in your browser and enter the username and password provided by TetraScience.
  2. If you want to change the default password, click Advanced > Modify Password. Enter data in the required fields, and choose Save to confirm.
1198

Figure 2: Change Password

  1. Click Advanced > Network Config and set up the method that you would like the Tetra IoT Agent Box to use for connecting to the public internet so that it can reach the TDP. You can choose either of the following connection options:
    • Wi-Fi
    • LAN Connection
1198

Figure 3: Network Config

  1. Click Advanced > Agent Config and configure the following fields with default settings:
    • MQTT Publish: iot.<TDP domain>
    • MQTT PubPort: 8883
    • MQTT Subscription: iot.<TDP domain>
    • MQTT SubPort: 8883
    • MQTT TLS Encryption: On
    • External ID: enter the agent ID of the TDP agent you have created
1198

Figure 4: Box Config

  1. After a few minutes, verify the connectivity of your Tetra IoT Agent Box to the TDP by looking at the Connected indicator.
1198

Figure 5: Connected Indicator

📘

Next Step

Proceed to Tetra IoT Agent Cloud Setup and Management to continue the setup process through the IoT Agent Cloud Configuration.

(Optional) Configure a Tetra Hub as a Proxy for a Tetra IoT Agent Box

📘

NOTE

The following procedure requires you to have a Tetra IoT Agent Box and Tetra Hub installed and configured. Tetra Data Hub doesn’t support proxy settings for Tetra IoT Agents.

To configure an existing Tetra Hub to act as a proxy server for a Tetra IoT Agent, do the following.

Step 1: Configure the Hub’s IoT Proxy Settings

  1. Sign in to the TDP with admin or organization owner credentials.
  2. In the left navigation menu, choose Data Sources. Then, choose Hubs. The Hubs page appears.
  3. Find the Hub that you want to use as a proxy, and then select the Hub’s name. The Hub Details page appears.
  4. Select the Configuration tab. Then, at the bottom of the page, move the Show IoT Proxy Settings toggle to the right. A list of fields for IoT proxy settings appears.
  5. Enter the following:
    • For IOT PROXY PORT, enter 8883 (or another port value, if needed for your environment).
    • For IOT TUNNEL PORT, enter 1883
  6. Choose Update. After a few minutes the Hub is updated with the new proxy settings.

Step 2: Configure the Tetra IoT Agent to Use the Hub as a Proxy

  1. Open the Local Configuration UI of the Tetra IoT box .
  2. Select the Advanced tab. Then, in the left navigation menu, choose Agent Config. The Agent Configuration page appears.
  3. Enter the following settings:
    • For MQTT Publish and MQTT Subscription, enter your Hub’s IP address.
    • For MQTT PubPort and MQTT SubPort*, enter the IOT PROXY PORT** value that you configured when setting up the Hub’s IoT proxy settings (8883 is recommended).
  4. Choose Save.

Step 3: Verify the Setup

  1. Open the Local Configuration UI of the Tetra IoT box .
  2. In the upper right, next to Cloud Connection, make sure that it shows Online. If the status is Disconnected, then verify that your Hub’s and IoT box’s proxy settings are configured correctly.

📘

NOTE

If you have configured the box to use a proxy, you should configure the agent in TDP to use a custom config. See Tetra IoT Agent Cloud Setup and Management for details.

Updated 29 days ago