For the complete documentation index, see llms.txt. This page is also available as Markdown.
Cortex XDR

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

Method
How it works

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.

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?