Skip to main content

How to configure the maximum number of concurrent Run-on-Server backup that can be run on AhsayCBS server

Article ID
5027
Last Reviewed Date
Product Version
AhsayCBS: 7 or above
Operating System
All Platforms
Description

This Know-How article will discuss how to configure the maximum number of concurrent agentless backup that can be run on AhsayCBS server.

Solution

To ensure agentless backup jobs (both manual triggered and schedules job) do not consume all available memory of the AhsayCBS server, the default maximum number of manual and schedule agentless backup jobs is limited to 2 (each agentless backup job requires an average of 170 MB of Java heap memory, for agentless backup sets that contain a lot of files / folder, the memory will increase in proportion).

If the number of scheduled backup jobs exceed the maximum concurrent setting, then the backup status of the job to be started, will be set to pending. AhsayCBS will attempt to retry and start the pending backup job(s) every minute, until the job can be successfully started.

On the other hand, if you try to start an agentless backup job via the AhsayCBS web console when there are already 2 concurrent jobs running, the following error message would be displayed.

Error Message

To increase / decrease the maximum number of concurrent agentless backup jobs (both manual and scheduled) that can be run on AhsayCBS:

  1. Stop the AhsayCBS service.

  2. Open the afc.opt file with a text editor, which can be found in the path ${AhsayCBS_Install_Home}/conf.

  3. Add the following line to the end of the file:

    com.ahsay.obs.core.job.ScheduleBackup.MaxConcurrentJob=MAX_NUMBER 

    For example, to set the maximum number of concurrent scheduled agentless backup jobs to 20.

    ...
    com.ahsay.obs.core.job.ScheduleBackup.MaxConcurrentJob=20
    ...
    
    This limit applies to both manually started and scheduled run-on-server backup.
  4. Save and exit from the text editor.
  5. Restart the AhsayCBS service

Ensure that the AhsayCBS server has sufficient RAM installed and that, there are sufficient free memory to accommodate the additional resource requirements for all manual and scheduled agentless backup jobs (each agentless backup job requires an average of 170 MB of Java heap memory, for agentless backup sets that contain a lot of files / folder, the memory requirement will increase in proportion).

In addition to the extra Java memory usage, agentless backup jobs will also require extra CPU resources from AhsayCBS server due to the compression and encryption process during a backup job.