Article ID: 5197
Reviewed: 2020-08-04

Product Version:
AhsayCBS: 7.9.0.0 - 7.17.2.31, 8.1.0.0 - 8.3.2.200
OS: All platforms

ATTENTION 1st January, 2022: v7 officially End-of-Life [details]

How do I configure the maximum of concurrent agentless backup that can be run on my AhsayCBS server (e.g. setting a max limit)?

For AhsayCBS v8.3.4.0 or above please click here for details of New Run On Server (Agentless) Office 365 and Cloud File Backup Feature

Important:
To ensure agentless backup jobs (both manual triggered and scheduled job) do not consume all available memory of the AhsayCBS server, the default maximum number of manual and scheduled 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 requirement 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:



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 in the following path, with a text editor
   
   ${CBS_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 jobs to 20:
   
   

   afc.opt

   ...

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

   ...

   Important:
   This limit applies to both manually started, and scheduled run-on-server backup.
   
   
4. Save and exit from the text editor.


5. Restart your AhsayCBS service.