Cortex XDR agent upgrade and rollout control
Control Cortex XDR agent upgrades and rollout rates in Cortex XDR, including automatic updates, schedules, and failure handling.
Cortex XDR lets you control when, and how quickly, new Cortex XDR agent releases and content updates reach your endpoints. Upgrades are driven from the console; you don't need third-party software distribution tools.
Upgrade methods
Manual upgrade
Select endpoints in All Endpoints, then right-click and select Endpoint Control → Upgrade Agent Version. You can push a package to up to 5,000 endpoints per action. Track progress in the Action Center.
Automatic upgrade
Enable auto-upgrade in an Agent Settings profile. Auto-upgrade is disabled by default.
Mobile
Upgrade Android from Google Play and iOS from the App Store, or push the app from your MDM.
Automatic upgrade scope
When auto-upgrade is enabled, choose which releases endpoints receive:
Latest agent release
One release before the latest one, including its maintenance releases
Only maintenance releases (no move to a newer major release)
Only maintenance releases in a specific version
You can also schedule rollouts to run immediately or delayed after a release, and restrict upgrades to specific days and hours.
Limit the rollout rate
To reduce risk, auto-upgrades of a new release roll out to a single batch of agents during the first week. After that, the number of parallel upgrades follows the value you configure in global agent settings. Content-update bandwidth is controlled in the same place.
Monitor upgrades and handle failures
Track the status and failure reason of each upgrade in Monitor agent upgrade status.
While an upgrade action is Pending, you can cancel it from the Action Center.
If an upgrade does not complete, the endpoint keeps running its installed Cortex XDR agent version. To move it to a known-good release, push the installation package for that release.
For recommended practices, see Guidelines for keeping Cortex XDR agents and content updated.
Remove Cortex XDR agents after a migration
To retire Cortex XDR agents in bulk, for example after a pilot or a migration, uninstall them from the console. See Uninstall the Cortex XDR agent.
Last updated
Was this helpful?
