✎ [V7][V8] FAQ: How do I increase the number of replication threads on my AhsayCBS backup server to improve replication speed? [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][V8] FAQ: How do I increase the number of replication threads on my AhsayCBS backup server to improve replication speed?   =====

<html><div class="content">
 <b>
  Article ID:
 </b>
 5276
 <br/>
 <b>
  Reviewed:
 </b>
 2020-01-15
 <br/>
 <br/>
 <b>
  Product Version:
 </b>
 <br/>
 <b>
  AhsayCBS:
 </b>
 7.13.0.6 - 7.17.2.x, 8.1.0.0 - 8.3.0.30, 8.3.2.11 to 8.x
 <br/>
 OS: All
 <br/>
 <br/>
</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 =====
<html>
 This document contains instructions on how to increase the number of available replication threads on an AhsayCBS backup server to improve the overall replication speed.
 <br/>
 <br/>
 <b>
  <u>
   Default Setting
  </u>
 </b>
 <br/>
 AhsayCBS v7.5.0.0 introduced support for multiple concurrent replication threads to improve the performance of the replication process and to ensure the replication process did not have a negative impact on the overall performance of AhsayCBS backup server. The maximum number of replication threads is determined using the following formula:
 <br/>
 <br/>
 <b>
  Maximum of replication threads
 </b>
  = INT((N+1)/2)
 <br/>
 <i>
  (N = total number of CPU cores)
 </i>
 <br/>
 <br/>
 For example, an AhsayCBS server with a 16 core CPU, up to 8 concurrent replication threads can be configured.
 <br/>
 <br/>
 <b>
  <u>
   Enhanced Setting
  </u>
 </b>
 <br/>
 From AhsayCBS v7.13.0.6 or above, for underutilized AhsayCBS backup servers running on high performance hardware and storage configurations, with spare network bandwidth capacity, there is an option to increase the maximum number of replication threads equal to N, the total number of CPU cores.
 <br/>
 <br/>
 For example, an AhsayCBS server with a 16 core CPU, up to 16 concurrent replication threads can be configured.
 <br/>
 <br/>
 <span style="color: #FF0000">
  <b>
   WARNING:
   <br/>
   Please consider carefully before increasing the maximum number of concurrent replication threads on your AhsayCBS backup server. As this change could have a negative impact on your AhsayCBS backup server and therefore your backup service, for example:
  </b>
 </span>
 <br/>
 <ol style="list-style-type: decimal">
  <span style="color: #FF0000">
   <b>
    <br/>
    <li><font color=black>
     The AhsayCBS backup server could become unresponsive or sluggish.
    </font></li>
    <li><font color=black>
     Slow AhsayOBM/AhsayACB backup/restore performance.
    </font></li>
    <li><font color=black>
     Your AhsayOBM/AhsayACB clients may be unable to connect to the backup server, resulting in missed backups.
    </font></li>
    <li><font color=black>
     The AhsayCBS replication server may become overloaded if it is unable to process the increased number of threads and data sent from the AhsayCBS backup server.
    </font></li>
   </b>
  </span>
 </ol>
 <br/>
 <b>
  Assumptions:
 </b>
 <br/>
 <ol style="list-style-type: decimal">
  <li><font color=black>
   AhsayCBS v7.13.0.6 or above is installed.
  </font></li>
  <li><font color=black>
   AhsayCBS Java heap size setting.
   <br/>
   <br/>
   Increasing the number of concurrent replication threads will result in increased Java memory usage. As a general rule of thumb, twice as many replication threads will utilize twice as the amount of Java memory.
   <br/>
   <br/>
   Therefore, it is highly recommended to increase your Java heap size setting before using a higher replication thread setting, if the peak Java memory usage on your AhsayCBS server is over 50% of the maximum Java heap size setting. (The peak Java memory usage can be obtained from
   <b>
    [Monitoring]&gt; [Dashboard]&gt;[Memory]
   </b>
   )
   <br/>
   <br/>
   For example:
   <br/>
   <ul>
    <li><font color=black>
     If current maximum Java heap setting is 4096M and the peak Java memory usage exceeds 2048M, then you should consider increasing the maximum Java heap size up to 8196M.
    </font></li>
    <li><font color=black>
     If current maximum Java heap setting is 4096M and the peak Java memory usage is only 1500M, you may not need any maximum Java heap size adjustment in the short term.
     <br/>
     <br/>
     Please refer to the following
     <b>
      FAQ: How to modify the Java heap size of AhsayCBS? (5002)
     </b>
     <a class="postlink" href="http://wiki.ahsay.com/doku.php?id=public:5002_faq:how_to_modify_the_java_heap_size_of_ahsaycbs
">
      http://wiki.ahsay.com/doku.php?id=public:5002_faq:how_to_modify_the_java_heap_size_of_ahsaycbs

     </a>
    </font></li>
   </ul>
   3.	AhsayCBS installation path: %CBS_INSTALL_PATH%
   <br/>
   <br/>
   <b>
    Windows:
   </b>
   C:\Program Files\AhsayCBS
   <br/>
   <b>
    Linux/Unix:
   </b>
   /usr/local/cbs
   <br/>
   <b>
    AhsayUBS:
   </b>
   /ubs/mnt/eslsfw/obsr
  </font></li>
 </ol>
 <br/>
</html>
===== Steps =====
<html>
 <ol style="list-style-type: decimal">
  <li><font color=black>
   Shutdown the AhsayCBS service.
  </font></li>
  <li><font color=black>
   Using a text editor open the
   <b>
    %CBS_INSTALL_PATH%/conf/cbs.opt
   </b>
   file
  </font></li>
  <li><font color=black>
   Add the following setting to the end of file and save:
   <b>
    <i>
     com.ahsay.cbs.obs.config.Index.RepMaxThreads=true
    </i>
   </b>
  </font></li>
  <li><font color=black>
   Restart the AhsayCBS service.
  </font></li>
  <li><font color=black>
   Login to the AhsayCBS web management console.
  </font></li>
  <li><font color=black>
   Go to
   <b>
    [Replication]&gt;[Sending Data]
   </b>
   and click on the
   <b>
    “No. of backup sets to replicate concurrently”
   </b>
   and select the number of replication threads you wish to configure.
   <br/>
   <br/>
   <div class="inline-attachment">
      <img style="width:75%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5276_0.png"/>
      <br/>
      <em>
       Example: An AhsayCBS backup server with 16 core CPU
      </em>
   </div>
  </font></li>
 </ol>
 <br/>
</html>
===== Keywords =====
 replication, threads, performance, server load, CPU core, concurrent, Java memory, Java heap size
User Tools

Site Tools

Page Tools
