✎ [V8] FAQ: How to run a Cyclic Redundancy Check (CRC) for legacy backup set created in version 6 (or for client without GUI)? [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.
===== [V8] FAQ: How to run a Cyclic Redundancy Check (CRC) for legacy backup set created in version 6 (or for client without GUI)?   =====
<html>
 <b>
  Article ID:
 </b>
 8057
 <br/>
 <b>
  Reviewed:
 </b>
 2019-06-27
 <br/>
 <br/>
 <b>
  Product Version:
 </b>
 <br/>
 AhsayCBS: 8.1  to 8.x
 <br/>
 OS: All platforms
</html>

===== Description =====
<html> 
After upgrading the backup server from version 6 to 8.1 or above, how to perform a Cyclic Redundancy Check (CRC) for legacy backup set that was created in version 6 for backup client installed on operating system without a Graphical User Interface (GUI)?
 <br/>
 <br/>
 <b>
  Steps:
 </b>
 <br/>
 To perform a Cyclic Redundancy Check (CRC) for a backup set, you can use the RunSingleUserRebuild.do API with the "CheckCrc" option enabled:
 <br/>
 <br/>
 Note: This article assumes that the reader has basic knowledge on JSON (JavaScript Object Notation).
 <br/>
 <br/>
 <u>Parameters of RunSingleUserRebuild.do</u>:
 <br/>
 <table 800"="" border="0" cellpadding="0" cellspacing="1" width="700">
  <tr>
   <td bgcolor="#000000" valign="top">
    <font color="#FFFFFF">
     Key</font>
    </b>
   </td>
   <td bgcolor="#000000" valign="top">
    <font color="#FFFFFF">
     Type</font>
    </b>
   </td>
   <td bgcolor="#000000" valign="top">
    <font color="#FFFFFF">
     Description</font>
    </b>
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    SysUser
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    String
   <td bgcolor="#FFFFFF" valign="top">
    <span>
    </b>
    Username of AhsayCBS system account with Admin or API Role (mandatory field)
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    SysPwd
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    String
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Password of AhsayCBS system account with Admin or API Role (mandatory field)
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    LoginName
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    String
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Username of the corresponding backup account (mandatory field)
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    Owner
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    String
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Owner of the corresponding backup account
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    BackupSetID
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    String
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Backup set ID of the corresponding backup set to be rebuild
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" valign="top">
    CheckCRC
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Boolean
   </td>
   <td bgcolor="#FFFFFF" valign="top">
    Enable or disable Cyclic Redundancy Check
   </td>
  </tr>
 </table>
 Example API call:
 <br/>
 <br/>
 http://cbs_hostname/obs/api/json/RunSingleUserRebuild.do
 <br/>
 <br/>
 {
 <br/>
 "SysUser":"system",
 <br/>
 "SysPwd":"system",
 <br/>
 "LoginName":"username",
 <br/>
 "BackupSetID":"1449711651766",
 <br/>
 "CheckCrc":"Y"
 <br/>
 }
 <br/>
 <br/>
 Administrator can uses application such as the
 <a href="https://github.com/wiztools/rest-client/wiki/News">
  WizTools.org RESTClient
 </a>
 (this is a 3rd party tool used as an example, you can use any other application as desired) to test on the above API call:
 <br/>
 <br/>
 <ol>
  <li><font color=black>
   Start the RESTClient by executing the downloaded jar file.
   <br/>
   <br/>
  </font></li>
  <li><font color=black>
   Select POST as the HTTP method.
   <br/>
   <br/>
      <img style="width:30%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5055_0.png"/>
   <br/>
  </font></li>
  <br>
  <li><font color=black>
   Select the Body tab, then click the drop down menu just under it and choose String body.
   <br/>
   <br/>
  </font></li>
  <li><font color=black>
   For the URL field, enter the following:
   <br/>
   <br/>
    http://cbs_hostname/obs/api/json/RunSingleUserRebuild.do
   <br/>
   <br/>
   Where cbs_hostname is the hostname or IP address of your AhsayCBS server.
   <br/>
   <br/>
  </font></li>
  <li><font color=black>
   For the String body, enter the following:
   <br/>
   <br/>
    {
    <br/>
    "SysUser":"system",
    <br/>
    "SysPwd":"system",
    <br/>
    "LoginName":"username",
    <br/>
    "BackupSetID":"1449711651766",
    <br/>
    "CheckCrc":"Y"
    <br/>
    }
   <br/>
   <br/>
   Where 'system' and 'system' is the login credentials of an AhsayCBS admin account with Admin or API role,  'username' is the login name of the corresponding backup account, '1449711651766' is the ID of the backup set to be rebuild, with CRC enabled.
   <br/>
   <br/>
  </font></li>
  <li><font color=black>
   Click on the 'Go' button beside the URL.
   <br/>
   <br/>
      <img style="width:30%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5055_1.png"/>
  </font></li>
 </ol>
The RunSingleUserRebuild.do will return status as 'OK' if the CRD job is started successfully. Now, to check on the progress of a CRC job, login to AhsayCBS console, select [Backup / Restore Logs]:
 <br/>
 <br/>
    <img style="width:10%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5055_2.png"/>
 <br/><br>
 Select [Activities Log], when the rebuild job is started the following log entry can be found:
 <br/>
 <br/>
 <table 900"="" border="0" cellpadding="0" cellspacing="1" width="700">
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Timestamp
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Login Name
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Owner
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Type
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Message
    </b>
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    <br/>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    YYYY-MM-DD
    </b>
    hh:mm:ss
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    username
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    RoutineJobInfo
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    Rebuild-username Starting single user rebuild

   </td>
  </tr>
 </table>
 When the rebuild job is completed, the following log entry can be found:
 <br/>
 <br/>
 <table 900"="" border="0" cellpadding="0" cellspacing="1" width="700">
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Timestamp
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Login Name
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
     <b>
     Owner
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Type
    </b>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-RIGHT: #A0A0A0 2px solid; BORDER-BOTTOM: #A0A0A0 2px solid" valign="middle">
    <b>
     Message
    </b>
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    <br/>
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    ...
   </td>
  </tr>
  <tr>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    YYYY-MM-DD
    <br/>
    hh:mm:ss
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    username
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    RoutineJobInfo
   </td>
   <td bgcolor="#FFFFFF" style="BORDER-BOTTOM: #C8C8C8 1px solid" valign="middle">
    Rebuild-username [SingleBackupSetRebuild] Finished single backup set
    <br/>
    rebuild. User='username' Owner='' Backup Set='BackupSet(backupset_id)'
    <br/>
    DataSize(compressed)=size DataSize=size DataFileNo=number
    <br/>
    RetentionSize(compressed)=size RetentionSize=size RetentionFileNo=
    <br/>
    number
   </td>
  </tr>
 </table>
 Note: Note that a Cyclic Redundancy Check can only be started when there is no backup job running (of the corresponding backup set), and vice versa.
 <br/>
 <br/>
 The time taken to complete the CRC job depends on number of factors such as the number of files / folders in the backup set(s), the number of backup sets, the hardware specifications of your AhsayCBS server such as the disk I/O and CPU performance, and if there are other resource intensive jobs running.


</html>

===== Keywords =====
 single, user, rebuild, index, rebuilding, crc, cyclic, redundancy, check, rebuilt, backupset, set, perform
User Tools

Site Tools

Page Tools
