Move Cortex XDR Agents Between Managing XDR Servers
When needed, you can move Cortex XDR agents to other
Cortex XDR managing servers.
You can move existing agents between Cortex
XDR managing servers directly from the Cortex XDR 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 Cortex XDR registers with the
new server, it can no longer communicate with the previous one.
following are prerequisites to enable you change the managing server
of a Cortex XDR agent:
Ensure that you are running
a Cortex XDR agent 7.2 or later release.
Ensure you have administrator privileges for Cortex XDR in
register to another managing server, the Cortex XDR agent requires
a distribution ID of an installation package on the target server
in order to identify itself as a valid Cortex XDR 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 Cortex XDR Agent 7.0.2 for Windows,
you can select from the target managing server the ID of an installation package
created for a Cortex XDR Agent 5.0.0 for Windows. The operating
system version can be different.
To change the managing server
of a Cortex XDR Agent:
Obtain an installation package ID from the target
Log in to Cortex XDR 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.
Locate the Cortex XDR agent you want to move.
Log in the current managing server of the Cortex XDR 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 Cortex XDR and
for Cortex XDR 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