What's New
Replacing an Enterprise Agent Using the Agent Clustering Method
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.
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.

Detailed Instructions

    Create a new cluster using the agent requiring replacement.
    Go to the Enterprise Agents page, expand the row of the agent requiring replacement, and click Add agent to cluster. More information about clusters can be found in Working with Enterprise Agent Clusters.
    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.
    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.
    Confirm deletion.
    Enable the new cluster (1) or convert the cluster back into an agent (2)

Related Information

Consult the How to Plan for Enterprise Agent Upgrades article for more information regarding Enterprise Agent upgrades and available upgrading options.
Last modified 5mo ago