Configure heap memory

You may need to fix heap space memory if Server Backup Manager is running into *Java Heap: Out of Memory* errors. One case where this may happen is if both versions (2.x and 3.x+) of Backup Manager are running on the same machine.


----
{toc:location=top|maxLevel=3|minLevel=3|type=flat|separator=pipe|style=border:1}

----
h3. Linux installations

The {{\--set-max-mem}} setup command allows you to set the max heap your server uses. In the following example the max memory heap size is set to 1 gigabyte.

{code}serverbackup-setup --set-max-mem 1g{code}


!set-max-mem.png|border=1!


You can get examples of the input with:
{code}serverbackup-setup --help{code}


!setup-help1.png|border=1!

Alternatively, you can configure the heap memory manually in the {{server.conf}} file.

1. Access the {{server.conf}} file. By default, in Server Backup Manager the file is located in:
{code}/usr/sbin/r1soft/conf/server.conf{code}

2. Edit {{server.conf}} as follows:
* Change {{compute.maxmemory}}:
{code}compute.maxmemory=false{code}
* Uncomment {{maxmemory}} and set to new value in MB. For example:
{code}maxmemory=1024{code}

!server_conf file_2 options outlined_English.png!

3. Save the {{server.conf}} file.

4. Restart the Server Backup Manager Server Service.

----
h3. Windows Installations

|| Free Edition | !Backup Manager Configuration Utility_Advanced_Set Heap Size tab_shortened_English.png!\\
\\ ||
|| Enterprise Edition | !Configuration Utility window_Enterprise_Set Heap Size tab_shortened_English.png!\\
\\ ||


3. In the "Set Heap Size" tab, move the slider to adjust the heap size of the server. The currently selected value is displayed in the editable box. The percentage of the memory is calculated automatically.

!Configuration Utility window_Enterprise_Set Heap Size tab_slider selected_English.png!

If necessary, click "Default" to return to the default value.

!Configuration Utility window_Enterprise_Set Heap Size tab_Default button_English.png!

4. Click "Apply" to save the selected value.

!Configuration Utility window_Enterprise_Set Heap Size tab_Apply button_English.png!

Alternatively, you can configure the heap memory manually in the {{server.conf}} file.

1. Access the {{server.conf}} file. By default, in Enterprise Edition the file is located in:
{code}C:\Program Files\Idera Server Backup\conf\server.conf{code}
Note that users who upgrade to Server Backup 5.0.2 or later from a previous version, the {{server.conf}} file path is:

{code}C:\Program Files\R1Soft CDP Server Enterprise\conf\server.conf{code}
2. Edit {{server.conf}} as follows:
* Change {{compute.maxmemory}}:
{code}compute.maxmemory=false{code}
* Uncomment {{maxmemory}} and set to new value in MB. For example:
{code}maxmemory=1024{code}

!server_conf file_2 options outlined_English.png!

3. Save the {{server.conf}} file.

4. Restart the Server Backup Manager Server Service.
----
h3. Defaults

*Free & Advanced Editions:*
Physical RAM < 1 GB fail to install
Physical RAM < 4 GB - Max Heap is 256 MB
Physical RAM >= 4 GB - Max Heap is 512 MB

*Server Backup Manager Editions:*
Physical RAM < 2 GB fail to install
Physical RAM < 4 GB - Max Heap is 1 GB
Physical RAM >= 4 GB AND 64-Bit Install - Max Heap is 2 GB

{excerpt:hidden=true}Instructions on how to set up heap space memory in the Linux and Windows Backup Manager. Default heap memory values. {excerpt}