---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Configure upgrade properties

# Configure Agent Client Collector upgrade properties {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Set the system properties that control Agent Client Collector upgrade behavior, including the target version and rate limits for mass upgrades.

## Before you begin

Role required: agent_client_collector_admin

## About this task

Two properties are required before any upgrade can run. Additional optional properties let you control rate limits, retry behavior, and timeout thresholds.

## Procedure

1. Navigate to AllSystem PropertiesAll Properties.
2. Set the required upgrade properties.  
   {#configure-agent-upgrade-properties__table_required_upgrade_props__entry__3}

   | Property | Value | Description |
   |-|-|-|
   | sn_agent.auto_upgrade.enabled | <kbd class="ph userinput">true</kbd> | Enables the upgrade feature. Set to true before running any upgrade, manual or scheduled. |
   | sn_agent.agent_upgrade_version | Target version number, for example <kbd class="ph userinput">5.0.1</kbd> | The version agents upgrade to. If left empty, the system uses the current Agent Client Collector Framework application version. |
   [Table 1. Required upgrade properties]

   {#configure-agent-upgrade-properties__table_required_upgrade_props}
3. **Optional:** Set optional properties to adjust rate limits and timeout behavior.  
   {#configure-agent-upgrade-properties__table_optional_upgrade_props__entry__3}

   | Property | Default | Description |
   |-|-|-|
   | sn_agent.auto_upgrade.max_upgrades_per_hour | 1000 | Maximum agents upgraded per job run. Lower this value for a more gradual rollout. |
   | sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour | 50 | Maximum agents upgraded through a single MID Server per job run. Prevents overloading individual MID Servers. |
   | sn_agent.auto_upgrade.retry_limit | 3 | Number of times the system retries a failed upgrade before permanently skipping the agent. |
   | sn_agent.agent_upgrade_wait_time | 30 | Minutes the system waits for an agent to complete its upgrade before marking it as failed. |
   | sn_agent.upgrade.timeout_minutes | 10 | Minutes allowed for the initial upgrade validation check on the agent. |
   | sn_agent.min_upgrade_history_per_agent | 2 | Number of upgrade history records kept per agent. Older records are automatically removed. |
   [Table 2. Optional upgrade properties]

   {#configure-agent-upgrade-properties__table_optional_upgrade_props}

*[\>]: and then