Tetra IoT Agent Local Setup and Configuration

Before you establish an integration on the Tetra Data Platform, you need to set up the Tetra IoT Agent locally to ensure outbound network connectivity is enabled.

Step 1: Connect via Hotspot or LAN Port

To access the Local Configuration UI of the Tetra IoT Agent you can connect via:

• Wi-Fi Hotspot
• LAN Port

Here is how you do each of these. Please reference the following image as you work through these instructions.

Accessing the Tetra IoT Agent Local Configuration User Interface via Wi-Fi Hotspot

To access the user interface:

1. Connect the provided power supply to component 10 on the IoT NeuroQ Box in Figure 1.
2. The Tetra IoT Agent 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 using provided credentials; Contact your TetraScience Customer Success Manager or via the TetraScience Support if you have issues connecting.
4. You are now connected to the Tetra IoT Agent; Proceed to step: Configure Tetra IoT Agent via Local Config UI

Access Tetra IoT Agent Local Config UI via LAN Port

To access the user interface:

1. Connect provided the power supply to component 10 in Figure 1.
2. Connect your computer to the Tetra IoT Agent via 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, ensure that IP address and subnet range allows you to connect to 192.168.101.204 (default IP of the Tetra IoT Agent)
4. You are now connected to the Tetra IoT Agent; Proceed to step: Configure Tetra IoT Agent via Local Config UI

Step 2: Configure Tetra IoT Agent via Local Config UI

Once you've connected either via WiFi or the LAN, do 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 click Save to confirm.

3. Click Advanced > Network Config and set up the method you would like the Tetra IoT Agent to use for connecting to the public internet in order to reach the Tetra Data Platform. You can choose either:
   • Wi-Fi
   • LAN Connection

4. 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

5. After a few minutes, verify the connectivity of your Tetra IoT Agent to the Tetra Data Platform via the Connected indicator.

📘

Next Step

Proceed to [Tetra IoT Agent Cloud Setup and Management] (https://developers.tetrascience.com/docs/iot_agent_cloud_configuration) to continue the setup process through the IoT Agent Cloud Configuration.

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

📘

NOTE

The following procedure requires you to have a Tetra IoT Agent and [Tetra Hub] (https://developers.tetrascience.com/docs/create-and-install-a-tetra-hub) installed and configured. Tetra Data Hub doesn’t support proxy settings for IoT Agents.

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

Step 1: Configure the Hub’s IoT Proxy Settings

1. [Sign in to the TDP] (https://developers.tetrascience.com/docs/sign-in-and-out-of-tdp-and-manage-password#sign-in-to-the-tdp) with admin or organization owner credentials.
2. In the left navigation menu, select the hamburger menu. A drop-down menu appears.
3. Choose Data Sources. Then, choose Hubs. The Hubs page appears.
4. Find the Hub that you want to use as a proxy, and then select the Hub’s name. The Hub Details page appears.
5. 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.
6. Enter the following:
   • For IOT PROXY PORT, enter 8883 (or another port value, if needed for your environment).
   • For IOT TUNNEL PORT, enter 1883
7. 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 Agent] (https://developers.tetrascience.com/docs/setting-up-and-configuring-the-tetra-iot-agent#step-1--connect-via-hotspot-or-lan-port).
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 Agent] (https://developers.tetrascience.com/docs/setting-up-and-configuring-the-tetra-iot-agent#step-1--connect-via-hotspot-or-lan-port).
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 Agent’s proxy settings are configured correctly.