Endpoint Agent Installation on Cisco Webex Devices (RoomOS)
Last updated
Last updated
Due to recent platform-wide naming, navigation, and URL changes in the ThousandEyes product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on .
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.
Activate the ControlHub integration by following all the steps mentioned .
Get the for the account group you want the agent on the device to register with. Please make sure that this account group corresponds to the one where ControlHub integration was enabled in the previous prerequisite step.
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.
Room Bars and Kits:
Cisco Room Bar
Cisco Room Panarama
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
Cisco Desk Mini
Cisco Desk Pro
Cisco Desk
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:
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:
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.
Select Next, then Apply, and then Review.
Repeat the steps for the devices you would like to enable.
To enable the Endpoint agents on all the devices:
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.
Save the changes to activate all the devices. Also, any new devices added in the future will get activated automatically.
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://docs.thousandeyes.com/whats-new/changelog#webex-dynamic-test-2.0-limited-preview
For deletion of Endpoint Agents:
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.
This installation works only on the current portfolio RoomOS-11 devices and does not support DX/SX/MX.
After completing this integration, the following links will help you in getting the most out of the ThousandEyes Endpoint Agents:
You can find the complete list of supported devices
Login to your .
Login to your .
Login to your .
Upon activating the agents, go to the section in the ThousandEyes application and make sure the agent is registered. You will see the devices listed either by its SEPMAC name or the Device name by which it is registered in ControlHub
Once you have installed the agent, you should enable the appropriate test set. The ThousandEyes Endpoint Agent offers , 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.
You can select the pre-configured template for the desired application. For example, Webex, Webex calling, and / calls can be monitored with the Webex template. Similarly, can be monitored using the Microsoft Teams template.
Webex calling is only supported in Webex 2.0 Limited Preview, you can learn more about it .
These templates can further be configured and customized. For detailed instructions on test configuration, see .
Once the agents are activated and devices have participated in a few meetings you can go to the ControlHub to verify the integration is working and that agents are sending data.
You can delete an agent from the ThousandEyes application within the Endpoint Experience > Agent Settings section. The detailed instructions can be found .
The 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.
Endpoint agents deleted via the ThousandEyes dashboard can be 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.