All Products
Search
Document Center

Security Center:Troubleshoot high disk or memory usage from anti-ransomware backups

Last Updated:Mar 31, 2026

Anti-ransomware backup caches data in server memory and on disk before uploading it to the cloud. Backing up large numbers of files or very large files — or abnormal client behavior — can push resource usage high enough to trigger alerts or cause backup failures.

This topic covers two scenarios: insufficient disk space and high memory usage (OOM). For each scenario, it explains the cause and the available solutions.

Important

The anti-ransomware feature and Cloud Backup share the same client. Configuration changes to the anti-ransomware client also apply to Cloud Backup. Assess the impact on Cloud Backup before adjusting any settings.

Before you start

Check these items first. Any one of them may resolve the issue without further troubleshooting:

  • Upgrade to the latest anti-ransomware client. The latest version automatically excludes mounted directories, a common cause of high memory usage.

  • Check whether the protected directory includes network-mounted paths such as OSS or NAS. If so, remove them. See Exclude network-mounted paths.

  • Check whether a backup network bandwidth limit is set. No limit means unconstrained throughput, which increases memory and disk usage.

  • Confirm that the server has enough free disk space. The backup cache requires at least file_cache_disk_free_space_hint (default: 1 GB) of free space at all times.

Insufficient disk space

Symptoms and cause

The backup cache directory consumes a large amount of disk space, triggering alerts or causing backup failures.

Under normal conditions, the cache is temporary: once backup data uploads to the cloud, the local cache is deleted automatically. Excessive usage occurs when:

  • The backup set contains a very large number of files or very large individual files.

  • The client runs abnormally and cached data is not cleaned up.

Modify backup cache settings

Change the cache location and configure cache parameters in the hbr.config file.

Prerequisites

Procedure

  1. If client self-protection is enabled, disable it first:

    1. Log on to the .

    2. In the left navigation pane, choose Assets > Host. In the upper-left corner, select the region where your assets reside: Chinese Mainland or Outside Chinese Mainland.

    3. On the Host Assets page, click View in the Actions column for the target server.

    4. In the Defense Status section, turn off the client self-protection toggle.

    image.png

  2. Log on to the server with administrative permissions.

  3. Go to the anti-ransomware client installation directory (default: ../client) and create an hbr.config file if it does not already exist.

  4. Add the cache parameters below to hbr.config and save the file.

Important

No service restart is required — settings take effect immediately. The new settings apply only to new backup tasks; they do not affect tasks already in progress.

Example `hbr.config`

disable_blob_cache = false
max_blob_cache_weight = 0.15
cache_prefix = D:\CacheFolder
max_retain_count = 16
disable_file_cache = false
file_cache_max_size_hint = 32GB
file_cache_disk_free_space_hint = 1GB
file_cache_max_retain_count = 2

Parameter reference

ParameterDescriptionDefault
disable_blob_cacheControls data ID caching. false enables caching (reduces network requests and speeds up backup). true disables it.
max_blob_cache_weightMaximum percentage of total system memory used for data ID caching. Valid range: (0, 1).0.15 (15%)
cache_prefixAbsolute path where cache files are stored. Use this to move the cache off a full or small disk.
max_retain_countMaximum number of data ID cache entries to retain.16
disable_file_cacheControls metadata caching. false enables caching. true disables it.
file_cache_max_size_hintMaximum disk space for the file cache. If the cache exceeds this limit, the backup fails with an insufficient cache space error. Requires client version 2.13.1 or later.32 GB
file_cache_disk_free_space_hintMinimum free disk space required for file caching. If free space drops below this value, the backup fails with an insufficient cache space error. Requires client version 2.13.1 or later.1 GB
file_cache_max_retain_countNumber of file cache entries retained per backup path. A value of 2 keeps the two most recent backups, so you can still restore from the previous backup after deleting the latest one. Requires client version 2.13.1 or later.2

Estimating required disk space

Backing up 10 million files typically requires about 1.5 GB of cache space (actual usage varies by file count, total data size, and full path length). During a backup, one additional cache is created.

Use this formula to estimate total disk space needed:

Required disk space = 1.5 GB × (file_cache_max_retain_count + 1) + file_cache_disk_free_space_hint

For example, with the default values (file_cache_max_retain_count = 2, file_cache_disk_free_space_hint = 1 GB):

1.5 GB × (2 + 1) + 1 GB = 5.5 GB

High memory usage (OOM)

Symptoms and cause

The backup task status is Failed and the error message shows OOM (out of memory). The hbrclient process consumes large amounts of memory while running and typically terminates after the task ends.

Common causes:

  • The protected directory includes network-mounted paths (OSS or NAS mounted on an ECS instance), causing frequent data access.

  • No backup network bandwidth limit is set, leading to excessive throughput.

  • The server does not have enough memory for the volume of data being backed up.

Solutions

Apply one or more of the following solutions based on your situation.

Exclude network-mounted paths

Do not add network-mounted paths — such as OSS or NAS mounted on an Elastic Compute Service (ECS) instance — to the anti-ransomware protected directory. Frequent access to these paths increases memory usage and incurs extra API call fees.

Instead:

Split the protected directory

Split the protected directory in your anti-ransomware policy into multiple subdirectories. Within the same policy, backup tasks run sequentially for each subdirectory — so each task covers less data and uses fewer resources.

For example, split /user/bin into multiple subdirectories. For instructions, see Manage anti-ransomware policies.

image
Note

Splitting the protected directory does not affect restoration of previously backed-up data. Security Center runs backup tasks for each subdirectory going forward.

Limit backup network bandwidth

Limiting throughput reduces disk, memory, and CPU usage. In the Edit Anti-ransomware Policy panel, set the Maximum Backup Network Bandwidth to a value that fits your environment. For instructions, see Manage anti-ransomware policies.

image
Note

Setting Maximum Backup Network Bandwidth to 0 removes all limits.

Increase CPU allocation for backup tasks

If the server has enough resources for the backup workload, allocate more CPU cores to backup tasks. More cores improve concurrent processing, shorten backup time, and reduce cumulative memory usage.

Important

Assess current system load thoroughly before increasing CPU allocation. Make sure the system can handle the additional workload.

To set the CPU allocation, add cpu_max_procs to the hbr.config file in the client installation directory (default: ../client). For example, to use 2 cores on an 8-core server:

cpu_max_procs = 2

If hbr.config does not exist, create the file and add this line. The setting takes effect when the next backup task starts.

For default installation directories, see View client installation directory.

Upgrade the server's memory

Large backup volumes require more memory. If the server consistently runs out of memory during backups, upgrade its memory configuration.

For hardware requirements, see Resource requirements for backups.

For ECS instances, upgrade the instance type. See Change instance types.

Appendix: View client version and installation directory

View client version

View the anti-ransomware client version on the Protection Configuration > Host Protection > Anti-ransomware page.

image

View client installation directory

Client versionOperating systemDefault installation directory
1.X.XWindowsC:\Program Files (x86)\Alibaba\Aegis\hbr\client
1.X.XLinux/usr/local/aegis/hbr/client
2.X.XWindowsC:\Program Files (x86)\Alibaba\Aegis\hbrclient\client
2.X.XLinux/usr/local/aegis/hbrclient/client

FAQ

The anti-ransomware backup cache is using too much space on drive C. Can I move the cache to a different location?

Yes. Set the cache_prefix parameter in the hbr.config file to an absolute path on a different drive or disk. See Modify backup cache settings.

My anti-ransomware data protection capacity is insufficient. What should I do?

Insufficient capacity causes backup failures and prevents data restoration. Resolve it by scaling out or releasing capacity.

Scale out capacity

  1. Log on to the Security Center console.

  2. In the left navigation pane, choose Protection Configuration > Host Protection > Anti-ransomware. Select the region where your assets reside: Chinese Mainland or Outside Chinese Mainland.

  3. On the Anti-ransomware page, click Used Capacity/Total Capacity, then click Upgrade.

Allocate at least 50 GB of data protection capacity per server.

Release capacity

Contact us

If the solutions above do not resolve the issue, contact technical support and provide:

  • Total memory and available memory on the device

  • Memory used by backup processes during backup

  • Total number of backup files and total backup data size

  • Backup client version

  • Disk I/O and network throughput

  • CloudMonitor screenshots of CPU and memory usage before and during backup — see Cloud service monitoring