Install BrowserBot on a ThousandEyes agent on a Cisco Catalyst switch

[atsukane]

Hi All,

We've installed SSD on Catalyst switches so that we can run synthetic test from the TE agent.

What are the required steps to install BrowserBot on TE agents that are already running on Cat switches?

CoPilot tells me the following steps, but can't see anywhere to download the browserbot install package, nor I have any idea of where in CLI to run the suggested command, or this is even correct.

To install BrowserBot on a ThousandEyes agent on a Cisco Catalyst switch, follow these steps:

1. Ensure Prerequisites:

   • Verify that your ThousandEyes Enterprise Agent is already installed and running on the Cisco Catalyst switch.
   • Ensure your switch is running a compatible version of Cisco IOS XE (e.g., Cisco IOS XE Bengaluru 17.6.1 or later.

2. Download BrowserBot:

   • Access the ThousandEyes platform and download the BrowserBot package. Ensure you have the necessary license and credentials.

3. Install BrowserBot:

   • Use the command line interface (CLI) on your Cisco Catalyst switch to install BrowserBot. You can use the following command:

     te-agent-01 systemd[1]: Started ThousandEyes BrowserBot

   • If you encounter issues, try disabling, rebooting, and re-enabling BrowserBot.

Many thanks,

[Tyler Langston · Accepted solution]

Hi @atsukane - welcome to the ThousandEyes forum! I ran your situation by our experts and they had some input:

We see similar reports of this when a customer installs the SSD on a switch with an existing Enterprise Agent deployment, and have found that typically a restart for the IOX service is needed.

A customer can follow the steps below to kickstart the BrowserBot install (essentially stopping the agent, restarting IOX and the agent directly from the switch CLI):

1. app-hosting stop appid <agent-name>
2. app-hosting deactivate appid <agent-name>
3. conf t
4. no iox (wait around 5 - 10 seconds)
5. iox (wait around 5 - 10 seconds)
6. exit
7. app-hosting activate appid <agent-name>
8. app-hosting start appid <agent-name>

With the IOX restarted as above, the app-hosting should automatically migrate from the flash > to the ssd, and then automatically install browserbot.

If you run into any other issues with this will you reply and let me know? Thanks!

[atsukane]

Hi @Tyler Langston 

Thanks for this information.

I've followed your steps and I can confirm that browserbot has been added successfully to the existing enterprise agent.

After issuing "no iox" and "iox" I made sure iox services are stopped/started before moving on to the next step.

Also learnt that when you issue "show app-hosting detail appid <appid_nam>" you'd have "Child application" when the browserbot is successfully added. Without the bot, the Child application details are missing.

Many thanks,