Tetra IoT Agent Local Setup and Configuration

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

<Image title="iot_neuroq.png" alt={2458} align="center" src="https://files.readme.io/b3bc14a-iot_neuroq.png">
  Figure 1: IoT NeuroQ Box
</Image>

## 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](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.

<Image title="iot_neuroq2.png" alt={1198} align="center" src="https://files.readme.io/1a75cf9-iot_neuroq2.png">
  Figure 2: Change Password
</Image>

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

<Image title="iot_neuroq3.png" alt={1198} align="center" src="https://files.readme.io/439046e-iot_neuroq3.png">
  Figure 3: Network Config
</Image>

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

<Image title="iot_neuroq4.png" alt={1198} align="center" src="https://files.readme.io/f1775ca-iot_neuroq4.png">
  Figure 4: Agent Config
</Image>

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

<Image title="iot_neuroq5.png" alt={1198} align="center" src="https://files.readme.io/b85028c-iot_neuroq5.png">
  Figure 5: Connected Indicator
</Image>

> 📘 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 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 with admin or organization owner credentials. [Sign in to the TDP](https://developers.tetrascience.com/docs/sign-in-and-out-of-tdp-and-manage-password#sign-in-to-the-tdp).
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. Access the Local Configuration UI of the Tetra IoT Agent. [Connect via Hotspot or LAN Port](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. Access the Local Configuration UI of the Tetra IoT Agent. [Connect via Hotspot or LAN Port](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.