For a variety of reasons, customers may need to replace an Enterprise Agent which is currently operational. When replacement is required, customers may want to preserve the agent's configuration (such as the agent's name, or settings from the Advanced Settings tab of the agent's entry on the Enterprise Agent page) and the tests and accoung groups to which the Enterprise Agent has been assigned. The information below provides a process to quickly substitute the new Enterprise Agent for the old, using the ThousandEyes Enterprise Agent cluster feature.
Replacement using the process below not only makes replacement faster and simpler than manual reconfiguration of an agent, but ensures that organizations which have limits or which are billed for overages to their contracted number of concurrently active Enterprise Agents do not encounter problems due to those limits.
NOTICE: Customers with accounts using metered billing model are advised against using this method.
For more information and alternative upgrading methods, see How to Plan for Enterprise Agent Upgrades.
The replacement process consists principally of the following steps:
Create a new cluster using the agent requiring replacement
Disable the new cluster
Create the new Agent
Add the new agent to the cluster
Delete the old agent
Enable the new cluster or remove the cluster and enable the agent
For more detailed instructions, see the section below.
Name the new cluster.
Disable the new cluster.
Disabling the cluster will prevent overages for additional agents or errors for exceeding your contracted number of concurrent agents.
Create the new agent.
Links to the most common deployment options are below.
Re-Initializing an Enterprise Agent (This will wipe an existing Agents settings and cause it to appear as a new Agent)
Add the new agent to the cluster.
Expand the row belonging to the new agent, and click Add agent to cluster.
When the Add Agent to Cluster window appears, click Add to existing cluster, then select the name of the cluster in the drop-down box.
Delete the old agent.
Enable the new cluster (1) or convert the cluster back into an agent (2)
Consult the How to Plan for Enterprise Agent Upgrades article for more information regarding Enterprise Agent upgrades and available upgrading options.
If you have any questions, contact the ThousandEyes Customer Engineering team.