Installing Enterprise Agents on Cisco Nexus Switches with Application Hosting
Last updated
Last updated
Due to recent platform-wide naming, navigation, and URL changes in the 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 .
This article covers the steps to install a ThousandEyes Enterprise Agent on supported Cisco Nexus switches using Cisco Application Hosting, rather than using the guestshell. For guestshell instructions, see
A ThousandEyes account with permissions to install new agents. For more information on setting up a ThousandEyes account, see .
A supported Cisco Nexus switch. For more information on supported devices, see the .
Log into the ThousandEyes web application.
Navigate to Network & App Synthetics > Agent Settings > Enterprise Agents > Agents.
Click Add New Enterprise Agent.
In the pop out panel, navigate to Cisco Application Hosting > Nexus Switches.
The TAR file can either be downloaded directly to the switch by using the NX-OS copy
command, or downloaded via a web browser from the ThousandEyes webapp and then transferred to the Nexus switch:
In a terminal window on the Cisco Nexus switch, run the copy
command shown in the ThousandEyes webapp to download the TAR file. It should look something like this:
copy https://downloads.thousandeyes.com/enterprise-agent/thousandeyes-enterprise-agent-VERSION.cisco.tar bootflash:
From the Cisco Application Hosting > Nexus Switches screen, click the Download - TAR button.
From the Cisco Application Hosting > Nexus Switches screen, configure the required fields (and any optional ones you want) to generate the basic command structure for installing and starting the agent:
App ID: The name used in the NX-OS CLI to manage the application hosting container.
IP Address: The IP address assigned to the interface inside the container.
Agent Hostname (Optional): The hostname assigned to the agent within the container. By default, this is the same hostname as the switch.
Name Server IP: The DNS IP address used within the container.
Gateway IP: The default gateway IP address used within the container. This is usually the IP address of the application hosting bridge.
Name Server IP 2 (Optional): An alternate DNS IP address.
Once the basic commands have been pre-configured, copy them from the web browser to a local machine.
Once the commands are ready, in a terminal window on the Nexus switch, run the commands in order from top to bottom, excluding the copy command.
NX-OS version 10.3(3) and earlier does not support configuring multiple interfaces.
There is an existing bug that prevents the NX-OS copy
command from working with HTTPS. This prevents users from downloading the ThousandEyes Enterprise Agent TAR file directly to the device.
Workaround
To workaround this issue, we recommend you download the TAR file, and then copy it to the switch using the same method used for copying the NX-OS system software image to the device.
The screenshot above shows a bridge configuration. For additional app-hosting configuration options, see the .
If you encounter an error running the copy command, follow the instructions in instead.
In a terminal window, use SCP, FTP, TFTP, or USB storage to copy the TAR file to the switch's bootflash: directory. We recommend using the same method used to copy the NX-OS system software image onto the switch. For more information, see .
Bridge ID: The number of the application hosting bridge instance created to connect the container to an L3 network on the switch. For more information, see .
Edit and expand the commands as necessary. Additional run-opts commands can be added as needed. For available commands, see .