When needed, you can move Cortex XDR agents to other
Cortex XDR managing servers.
can move existing agents between
managing servers directly from the
management console. This can be useful
during POCs or to better manage your agents allocation between tenants.
When you change the server that manages the agent, the agent transfers
to the new managing server as a freshly installed agent, without
any data that was previously stored for it on the original managing
server. After the
with the new server, it can no longer communicate with the previous
The following are prerequisites to enable you change
the managing server of a
Ensure that you are running a
agent 7.2 or later
Ensure you have administrator privileges for
in the hub.
To register to
another managing server, the
agent requires a distribution ID of an installation package
on the target server in order to identify itself as a valid
agent. The agent must
provide an ID of an installation package that matches the same operating
system and for the same or a previous agent version. For example,
if you want to move a
Agent 7.0.2 for Windows, you can select from the target
managing server the ID of an installation package created for a
Agent 5.0.0 for Windows.
The operating system version can be different.
XDR does not support moving agents between FedRamp and commercial
To change the managing server of a
Obtain an installation package ID from the target
Log in to
on the target management server, then navigate to
From the agent installations table, locate a valid installation
package you can use to register the agent. Alternatively, you can
create a new installation package if required.
Right-click the ID field and copy the value. Save
this value, you will need it later for the registration process.
If the ID column is not displayed in the table, add it.
agent you want to move.
Log in the current managing server of the
agent and navigate to
Change the managing server.
Select one or more agents that you want
to move to the target server.
Right click + Alt to open the options menu in advanced
mode, and select
Change managing server
option is available only for an administrator in
agent 7.2 and later releases.
Enter the ID number of the installation package you
obtained in Step 1. If you selected agents running on different
operating systems, for example Windows and Linux, you must provide
an ID for each operating system. When done, click
Track the action.
When you track the action in the
the original managing server will keep displaying
status also after the action has ended
successfully, since the agent no longer reports to this managing
server. The new managing server will add this as a new agent registration