How to Allocate More RAM to NAKIVO Transporter Service

Product version: 11.0

Last modified: 31 July 2025

Problem

The Transporter service may be configured with low JVM heap size parameters. When such limits are applied, backup and replication jobs fail due to insufficient heap memory with the following error message:

Backup of the "trang0902" mailbox has failed

An internal error has occurred while backing up the "trang0902" mailbox. Reason: Not enough available RAM to run operation.

Please increase available RAM (max.heap.size.megabyte) for Java Transporter, or decrease count of parallel jobs. Learn more"

Solution

To allocate more RAM to the Transporter service, increase the Java heap memory size. To do this, take the following steps:

  1. Stop the NAKIVO Backup & Replication Transporter service.

  2. Enable Expert mode in your instance by adding “expert” (or “&expert”) to the end of the URL of the Settings page.

  3. Increase the maximum heap size (Xmx) and minimum heap size (Xms) by changing the following expert settings:

    • system.transporter.modern.min.heap.size.megabyte

    • system.transporter.modern.max.heap.size.megabyte

      Notes

      • It is not possible to set the JAVA heap memory size parameters to a value larger than the RAM size.

      • You can check the Transporter heap memory usage in the <Tranporter_folder>/bh-logs/transporter.log file.

      • In multi-tenant mode with a single Transporter, the tenant that initiates the Transporter first defines its configuration settings, including heap memory size. To ensure consistent behavior, all tenants sharing the same Transporter must be configured with identical settings.

  4. Start the NAKIVO Backup & Replication Transporter service. If the error persists, increase the memory settings until the error no longer occurs.