✎ [V7] FAQ: How do I configure the maximum of concurrent run-on-server backup that can be run on my AhsayCBS server [Ahsay Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== [V7] FAQ: How do I configure the maximum of concurrent run-on-server backup that can be run on my AhsayCBS server ======

<html>
 <b>
  Article ID:
 </b>
 5197
 <br/>
 <b>
  Reviewed:
 </b>
 2020-08-04
 <br/>
 <br/>
 <b>
  Product Version:
 </b>
 <br/>
 AhsayCBS: 7.9.0.0 - 7.17.2.31, 8.1.0.0 - 8.3.2.200
 <br/>
 OS: All platforms
</html>




<html>
<FONT COLOR=red SIZE=+1>
<B>ATTENTION</B>
1st January, 2022: v7 officially End-of-Life [<A HREF=https://wiki.ahsay.com/doku.php?id=public:announcement:ahsay_v7_eol>details</A>]
</FONT>
</html>

===== Description =====
How do I configure the maximum of concurrent agentless backup that can be run on my AhsayCBS server (e.g. setting a max limit)?
<html>
<br>
<br>
<a class="postlink" href="http://download.ahsay.com/support/document/v8/datasheet_run_on_server.pdf">
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</a>
</html>
===== Steps =====
<html>

<font color=red>Important:
<br>
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).
 <br/>
 <br/>
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.
<br>
<br>
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:
<br>
<br>
<img style="width:30%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5197_new.png"/>
</font>


 <br/>
 <br/>
To increase / decrease the maximum number of concurrent agentless backup jobs (both manual and scheduled) that can be run on AhsayCBS:
 <br/>
 <ol>
  <li>
   <font color=black>Stop the AhsayCBS service.</font>
  </li>
  <br>
  <li>
   <font color=black>Open the afc.opt file in the following path, with a text editor 
   <br>
   <br>
    ${CBS_Install_Home}/conf/
  </li>
  <br>
  <li>
   <font color=black>Add the following line to the end of the file: 
   <br>
   <br>
    com.ahsay.obs.core.job.ScheduleBackup.MaxConcurrentJob=MAX_NUMBER
   <br>
   <br/>
    For example, to set the maximum number of concurrent scheduled agentless jobs to 20:</font>
   <br/>
   <br/>
   <table border="0" cellpadding="0" cellspacing="0" width="750">
    <tr>
     <td align="center" style="BORDER-TOP: gray 1pt solid; BORDER-LEFT: gray 1pt solid; BORDER-RIGHT: gray 1pt solid; BORDER-BOTTOM: gray 1pt solid; BACKGROUND-COLOR: #969696">
      <b>
       <font color=black>afc.opt</font>
      </b>
     </td>
    </tr>
    <tr>
     <td style="BORDER-LEFT: gray 1pt solid; BORDER-RIGHT: gray 1pt solid; BACKGROUND-COLOR: #eaeaea">
      ...
     </td>
    </tr>
    <tr>
     <td style="BORDER-LEFT: gray 1pt solid; BORDER-RIGHT: gray 1pt solid; BACKGROUND-COLOR: #eaeaea">
      <font color=black>com.ahsay.obs.core.job.ScheduleBackup.MaxConcurrentJob=20</font>
     </td>
    </tr>
    <tr>
     <td style="BORDER-LEFT: gray 1pt solid; BORDER-RIGHT: gray 1pt solid; BORDER-BOTTOM: gray 1pt solid; BACKGROUND-COLOR: #eaeaea">
      ...
     </td>
    </tr>
   </table>
   <font color=red>Important:
<br>
This limit applies to both manually started, and scheduled run-on-server backup.
</font>
<br><br>

  </li>
  <li>
   <font color=black>Save and exit from the text editor.</font>
  </li>
  <br>
  <li>
   <font color=black>Restart your AhsayCBS service.</font>
  </li>
 </ol>
<font color=red>Important:
<br>
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).

  <br/>
  <br/>
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.

</font>
</html>


===== Keywords =====
Office365, Cloud File, agentless, scheduled backup, Java heap size
User Tools

Site Tools

Page Tools
