> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/cisco-devices/install-roomos.md).

# Endpoint Agent Installation on Cisco Webex Devices (RoomOS)

Cisco's RoomOS is the cloud-connected operating system that enables your Cisco devices to deliver great hybrid work experiences – enhancing productivity and collaboration. The Endpoint agents are natively incorporated into RoomOS devices and provide hop-by-hop network path visibility when these devices are part of the meetings. These agents can be activated explicitly using Control Hub, the same integration used for Windows and macOS clients. Therefore, network administrators will have familiar troubleshooting experience.

This document lets you learn how to set up the Endpoint agents on RoomOS devices.

## Prerequisites

* Activate the ControlHub integration by following all the steps mentioned [here](https://help.webex.com/en-us/article/nymfj2d/Integrate-ThousandEyes-with-Troubleshooting-in-Control-Hub#task-template_bdd45fbb-9087-45e4-87f1-ec396d886b57).
* Get the [connection string](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md#connection-string) for the account group you want the agent on the device to register with. Ensure this account group corresponds to the one where Control Hub integration was enabled in the previous prerequisite step.
* Disable [Federal Information Processing Standards (FIPS) mode](https://roomos.cisco.com/xapi/Configuration.Security.Fips.Mode/) on each device before you register its Endpoint Agent. Keep FIPS mode disabled while you use the Endpoint Agent. You cannot disable FIPS mode in bulk.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-598fbb665c80b70159021d372c5716f9ebf14739%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_download_installer-1a.png?alt=media\&token=25450186-0b7a-4fcc-94d1-fa56426a0545)

* Ensure sufficient Endpoint licenses (Advantage or Essentials) as this integration consumes one Endpoint license per device.
* The version for RoomOS device firmware must be **RoomOS 11.7.1.6 16945c93906** or higher.

{% hint style="info" %}
From November 14, 2023, the installation will support deployments with **Proxy**. For Proxy support, the version of RoomOS device firmware must be **RoomOS 11.10.0.18 64aface44e2** or higher. If you are connecting the agent to the cloud using a **TLS Interception Proxy**, contact the WebEx Support Team (Webex TAC) for information on updating the WebEx SRP Certificate.
{% endhint %}

### Supported RoomOS Devices

#### Room Devices:

* **Room Bars and Kits**:
  * Cisco Room Bar
  * Cisco Room Panorama
  * Cisco Room 55
  * Cisco Room 55 Dual
  * Cisco Room 70
  * Cisco Room 70 Panorama
  * Cisco Room 70 G2
  * Cisco Webex Room USB
  * Cisco Room Navigator
  * Cisco Room Bar Pro
  * Cisco Room Kit
  * Cisco Room Kit Pro
  * Cisco Room Kit Plus
  * Cisco Room Kit EQ
  * Cisco Room Kit Mini
* **Codecs**:
  * Cisco Codec EQ
  * Cisco Codec Pro
  * Cisco Codec Plus
* **Boards**:
  * Cisco Board Pro
  * Cisco Board 85S
  * Cisco Board 55
  * Cisco Board 55S
  * Cisco Board 70
  * Cisco Board Pro 55
  * Cisco Board Pro 75
  * Cisco Board 70S

#### Desks Devices:

* Cisco Desk Mini
* Cisco Desk Pro
* Cisco Desk

You can find the complete list of supported devices [here](https://help.webex.com/en-us/article/gg3kd3/ThousandEyes-Agent-integration-for-Board,-Desk,-and-Room-Series-devices#sx10_t_te_single_device)

## Getting Started

1. To enable the Endpoint agent on select devices (you can skip this step if you intend to enable the agents for all the devices in the organization):

   First, enable the feature for the organization:

   * Login to your [ControlHub Admin Console](https://admin.webex.com).
   * On the left navigation bar, select **Devices** in the **Management Section**.
   * At the top of the screen, choose **Settings**.
   * In the ThousandEyes section, turn on the **Enable ThousandEyes Agent** toggle.
   * **Do not** click the Add button for the Connection String. That needs to be done on the individual device configuration shown in the next steps.

   To activate a single device:

   * Login to your [ControlHub Admin Console](https://admin.webex.com).
   * On the left navigation bar, select **Devices** in the **Management Section**.
   * Search for the device that you intend to enable.
   * On the right-hand side, in the **Configuration Section**, select **All Configurations**.
   * In the search bar, type **ThousandEyes Connection String**.
   * Enter the connection string you obtained in the first step.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-6c6caebecbfa3332a5aa70d3fb5cf5c1b0855e61%2Fproduct-documentation_roomos-1.png?alt=media\&token=a8a89b55-cda5-492c-8bee-47f1fd760c2b)

* Select Next, then Apply, and then Review.
* Repeat the steps for the devices you would like to enable.

2. To enable the Endpoint agents on all the devices:
   * Login to your [ControlHub Admin Console](https://admin.webex.com).
   * On the left navigation bar, select **Devices** in the **Management Section**.
   * At the top of the screen, choose **Settings**.
   * In the ThousandEyes section, turn on the **Enable ThousandEyes Agent** toggle.
   * Click the **Add** button.
   * Enter the connection string you obtained in the first step.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-c16d4327023922453973a4f3d06651b8b760dbdc%2Fproduct-documentation_roomos-2.png?alt=media\&token=86643f0f-2127-4dc1-a0db-303d81ef77a2)

* **Save** the changes to activate all the devices. Also, any new devices added in the future will get activated automatically.

{% hint style="info" %}
It takes about 10 minutes for an agent activated through ControlHub to register in ThousandEyes. This happens only for the first time an agent is enabled. However, you can restart the device to register the agent instantly.
{% endhint %}

3. After activating the agents, go to [**Endpoint Experience > Agent Settings**](https://app.thousandeyes.com/endpoint/agent-settings/?section=agents) and confirm that the agent is registered.

![Registered Endpoint Agents in Agent Settings](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-1dd00552d8666dee7997240b641831b262da57e5%2Fproduct-documentation_global-vantage-points_endpoint-agents_secure-client-integration-1.png?alt=media\&token=057455cd-0799-4825-99c2-a3b16a1cae6b)

## Naming RoomOS Agents

By default, when a RoomOS Endpoint Agent first registers, ThousandEyes uses the device hostname as the agent name. If the device does not have a hostname, ThousandEyes uses its SEPMAC address. Later changes to the RoomOS device name in Control Hub do not update the agent name automatically, and you can edit the name in **Endpoint Experience > Agent Settings**.

To sync RoomOS agent names with their device names in Control Hub, enable **Obtain RoomOS name from ControlHub** on the [**Advanced Agent Settings** tab](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/managing/manage-endpoint-agent-settings#syncing-roomos-agent-names-from-control-hub) under **Endpoint Experience > Agent Settings**. This setting requires RoomOS version 11.39.0.0 or later, or version 26.7.0.0 or later. After you enable the setting, supported RoomOS Endpoint Agents use the Control Hub device name on their next check-in. The agent name becomes read-only in the ThousandEyes platform, and later device-name changes in Control Hub sync on subsequent check-ins.

If you disable **Obtain RoomOS name from ControlHub**, ThousandEyes stops syncing names but does not revert names that were synced previously. The agent name becomes editable again in **Endpoint Experience > Agent Settings**.

## Configuring Endpoint Agent Tests

Once you have installed the agent, you should enable the appropriate test set. The ThousandEyes Endpoint Agent offers [Synthetic Tests](https://docs.thousandeyes.com/product-documentation/end-user-monitoring/test-settings/synthetic-tests), which are a combination of scheduled and dynamic tests. Synthetic tests provide ThousandEyes-certified templates that allow you to quickly configure tests for commonly used applications and services.

To access the synthetic tests, navigate (within the ThousandEyes application) to the **Endpoint Experience > Test Settings** section and click the **Monitor Application** button in the Tests tab, nested in the **Synthetic Tests** tab.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-8ecc833ecc15fd220124f85cc54e442c4ddb9e97%2Fproduct-documentation_end-user-monitoring_test-settings_synthetic-tests-1a.png?alt=media\&token=1a15b798-2b89-45be-9223-c38824122e1b)

You can select the pre-configured template for the desired application. For example, Webex, Webex calling, and [Webex Video Integration with Microsoft Teams (VIMT)](https://help.webex.com/en-us/article/n5m305x/Webex-Video-Integration-for-Microsoft-Teams#reference_k3l_r45_vsb)/ [Video Mesh Node(VMN)](https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cloudCollaboration/wbxt/videomesh/cmgt_b_webex-video-mesh-deployment-guide.html) calls can be monitored with the **Webex** template. Similarly, [Microsoft Teams Rooms](https://roomos.cisco.com/doc/MTR/Requirements) can be monitored using the **Microsoft Teams** template.

{% hint style="info" %}
Webex Calling is supported only in Webex Dynamic Test 2.0 Limited Preview. For more information, see [Webex Dynamic Test 2.0 Limited Preview](https://docs.thousandeyes.com/release-notes/2024/2024-02-release-notes#webex-dynamic-test-2.0-limited-preview).
{% endhint %}

These templates can further be configured and customized. For detailed instructions on test configuration, see [Configuration Options for Synthetic Tests](https://docs.thousandeyes.com/product-documentation/end-user-monitoring/test-settings/configure-tests).

### How to verify Endpoint Agents are sending data?

Once the agents are activated and devices have participated in a few meetings you can go to the ControlHub [troubleshooting page](https://help.webex.com/en-us/article/nymfj2d/Integrate-ThousandEyes-with-Troubleshooting-in-Control-Hub#task-template_9e89f1ee-ce51-4e63-8e63-45dd29d6dd5a) to verify the integration is working and that agents are sending data.

### Deleting the Endpoint Agent

You can delete an agent from the ThousandEyes application within the **Endpoint Experience > Agent Settings** section. See [Uninstall or Delete the Endpoint Agent on Windows](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/uninstall-or-delete-the-endpoint-agent.md#delete-an-endpoint-agent-from-the-platform) for detailed instructions.

The [Agent Status Settings](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/managing/manage-endpoint-agent-settings#auto-manage-the-status-for-endpoint-agents) offer configuration options to manage and handle the statuses of endpoint agents automatically. It's important to note that, unlike Windows and macOS, it's not possible to uninstall the endpoint agent installed on Cisco RoomOS devices.

For deletion of Endpoint Agents:

* Endpoint agents deleted via the ThousandEyes dashboard can be [recovered](https://docs.thousandeyes.com/product-documentation/archived-documentation/managing-the-endpoint-agent#deleting-an-endpoint-agent) only if the agent version is 1.166.0 or higher. Also, it may take the agents up to one hour to start functioning again post-recovery.
* Endpoint agents with the version below 1.166.0 cannot be recovered if deleted.
* If you cannot recover the Endpoint agent, you can use ControlHub to reactivate it. However, it might show up as a duplicate of the previously removed agent in filters until the data produced by the deleted agent becomes obsolete.

### Limitations

* This installation works only on the current portfolio RoomOS-11 devices and does not support DX/SX/MX.

### Next Steps

After completing this integration, the following links will help you in getting the most out of the ThousandEyes Endpoint Agents:

* [Viewing data for tests run by the Endpoint Agents](https://docs.thousandeyes.com/product-documentation/end-user-monitoring/viewing-data)
* [Manage Endpoint Agent Settings](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/managing/manage-endpoint-agent-settings)
* [Data collected by an Endpoint Agent](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/data-collected-by-endpoint-agent)
* [Endpoint Agent Licensing](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/endpoint-agent-licensing)