How do I modify the Java heap size of the software?

OS

Alle platforms

Software

8.x and higher

Error Message

• java.lang.OutOfMemoryError: Java heap space
• Error occurred during initialization of VM
• Could not reserve enough space for 2097152KB object heap

Cause

The software has reached the maximum amount of RAM allowed, resulting in the above error.

Solution

! Installing a new client will revert these changes.

To change the Java heap size of the installation on Windows, Mac OS X, Linux or NAS, you need to modify the following files:

For Windows:

• ${Install-Home}\config.ini
• ${Install-Home}\bin\RunCB.bat

For Mac OS X:

• ${Install-Home}/config.ini
• ${Install-Home}/bin/RunCB.sh

For Linux / Unix

• ${Install-Home}/config.ini
• ${Install-Home}/bin/RunCB.sh
• ${Install-Home}/bin/RunBackupSet.sh

For NAS

• ${Install-Home}/config.ini

(For Windows) Open the 'config.ini' and 'RunCB.bat' files with a text editor and change the Xmx value:

config.ini:

app.system.ui.vm.opt.xms=128 app.system.ui.vm.opt.xmx=2048 app.system.conf.language=en

 

RunCB.bat

… SET PATH=%JAVA_HOME%\bin;%PATH% … SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m ... …

(For Mac OS X) Open the 'config.ini' and 'RunCB.sh' files with a text editor and change the Xmx value:

config.ini:

app.system.ui.vm.opt.xms=128 app.system.ui.vm.opt.xmx=2048 app.system.conf.language=en

 

RunCB.sh

… JAVA_OPTS="-Xrs -Xms128m -Xmx2048m -client" JNI_PATH="-Djava.library.path=$LIB_HOME" …

(For Linux) Open the files 'config.ini', 'RunCB.sh' and 'RunBackupSet.sh' with a text editor and change the Xmx value:
(For NAS) Open the 'config.ini' file with a text editor and change the Xmx value:

config.ini:

app.system.ui.vm.opt.xms=128 app.system.ui.vm.opt.xmx=2048 app.system.conf.language

 

RunCB.sh / RunBackupSet.sh:

… JAVA_OPTS="-Xrs -Xms128m -Xmx2048m -client" JNI_PATH="-Djava.library.path=$LIB_HOME" …

Note: The value 2048 in the above examples is the current Java heap size (in MB).
Change the value to e.g. "4096" (value in MB) (depending on the amount of free system memory available)

Important: Save the changes and then restart the scheduler service.