User Tools

Site Tools

You are here: Ahsay Wiki » Welcome to AhsayWiki » 8106_faq » [V8] FAQ: How to perform the initial backup to a removable drive then import the data onto its backup destination (command-line interface (CLI))?
public:8106_faq:how_to_perform_a_seedload_backup_and_import_cli

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision 		Previous revision
Next revision Both sides next revision
public:8106_faq:how_to_perform_a_seedload_backup_and_import_cli [2021/02/26 15:24]
edward.chan created 		public:8106_faq:how_to_perform_a_seedload_backup_and_import_cli [2021/02/26 19:01]
edward.chan
Line 30: Line 30:
  <​br/>​  <​br/>​
  <​br/>​  <​br/>​
- <​b>​Note:</b> This process is called "Seed Load" in version 6.+ <​b>​Note</​b>​: This process is called "Seed Load" in version 6.
 </​html>​ </​html>​
  
Line 47: Line 47:
  <​ul>​  <​ul>​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Login to AhsayOBM, execute the RunConfigurator.sh script file.+   Login to AhsayOBM, execute the RunConfigurator.sh script file in the AhsayOBM installation bin folder:
    <​br>​    <​br>​
    <​br>​    <​br>​
Line 108: Line 108:
            </​td>​            </​td>​
     </tr>     </tr>
-   </​table> ​     +   </​table> ​    
 +   <​b>​Note</​b>:​ It is assumed that the '​import destination',​ in this case the CBS / Predefined destination had already been added to the backup set.   
 +   <​br>​ 
 +   <​br>​
   </​font></​li>​   </​font></​li>​
   ​   ​
 +
   ​   ​
   ​   ​
 +  <​li><​font color=black>​
 +   Exit from AhsayOBM (e.g. choose 8 in the RunConfigurator.sh script), then browse to the backupSet.xml file location (e.g. /​root/​.obm/​config/​backupSet.xml):​
 +
 +   <​br>​
 +   <​br>​
 +   <​table border="​0"​ cellpadding="​0"​ cellspacing="​0"​ width="​750">​
 +    <tr>
 +     <​td style="​BACKGROUND-COLOR:​ black">​
 +      <font size=2 color=white><​p style="​font-family:​courier;"> ​   ​
 +      root@hostname:/​usr/​local/​obm/​bin#​ cd /​root/​.obm/​config/​
 +           </​td>​
 +    </tr>
 +   </​table> ​         ​
 +  </​font></​li>​
   ​   ​
   ​   ​
Line 118: Line 136:
   ​   ​
   ​   ​
 +  <​li><​font color=black>​
 +   Edit the backupSet.xml file with a text editor such as VI Editor:
 +   <​br>​
 +   <​br>​
 +   <​table border="​0"​ cellpadding="​0"​ cellspacing="​0"​ width="​750">​
 +    <tr>
 +     <​td style="​BACKGROUND-COLOR:​ black">​
 +      <font size=2 color=white><​p style="​font-family:​courier;"> ​   ​
 +      root@hostname:​~/​.obm/​config#​ vi backupSet.xml
 +           </​td>​
 +    </tr>
 +   </​table> ​    
 +  </​font></​li>​
   ​   ​
   ​   ​
-  ​+  ​<​li><​font color=black>​ 
 +   Next, add the local destination (e.g. directory path to the removable drive or on the client computer) as one of the backup destination of the backup set. 
 +<​br>​ 
 +<​br>​ 
 +Insert the following entries into the backupSet.xml file (edit the value of the Name and Local Path according to your setup), make sure that you are adding the entries at the correct location as shown in this example: 
 +   <​br>​ 
 +   <​br>​ 
 +   <​table border="​0"​ cellpadding="​0"​ cellspacing="​0"​ width="​750">​ 
 +    <​tr>​ 
 +     <​td style="​BACKGROUND-COLOR:​ black">​ 
 +      <font size=2 color=white><​p style="​font-family:​courier;"> ​    
 + &​lt;​!-- This is the collection of destinations --&​gt;<​br>​ 
 + &​lt;​Key name="​Destination Settings"&​gt;<​br>​ 
 + &​nbsp;&​nbsp;&​nbsp;&​lt;​Value data="​1"​ name="​concurrency-level"​ type="​integer"/&​gt;<​br>​ 
 + &​nbsp;&​nbsp;&​nbsp;&​lt;​Key name="​Local Destination Settings"&​gt;<​br>​ 
 + &​nbsp;&​nbsp;&​nbsp;&​lt;​Value data="​Local Dest" name="​Name"​ type="​string"​ /&​gt;<​br>​ 
 + &​nbsp;&​nbsp;&​nbsp;&​lt;​Value data="/​usr/​local/​obm/​local_dest"​ name="​Local Path" type="​string"​ /&​gt;<​br>​ 
 + &​nbsp;&​nbsp;&​nbsp;&​lt;/​Key&​gt;<​br>​ 
 + &​lt;/​Key&​gt;​ 
 +           </​td>​ 
 +    </​tr>​ 
 +   </​table> ​     
 +<​b>​Note</​b>:​ In the above example, the local destination path is /​usr/​local/​obm/​local_dest and the destination name is Local Dest. 
 +<​br>​ 
 +<​br>​ 
 +For more details on the backupSet.xml backup set template, refer to Appendix A and B of the <a target=_blank href="​https://​download.ahsay.com/​support/​document/​v8/​guide_obm_quickstart_nix_cli_v8.pdf">​AhsayOBM Quick Start Guide for Linux (CLI)</​a>​. 
 +<​br>​ 
 +<​br>​ 
 +  </​font></​li>​
   ​   ​
   ​   ​
   ​   ​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Select '​Destination', ​then click '​Add':​ +   Save then exit from the text editor. 
-   <​br/>​ +   <​br>​ 
-   <​br/>​ +   <​br>​
-   Note: This assumed that the '​import destination',​ in this case CBS had already been added to the backup set. +
-   <​br><​br>​ +
-      <img style="​width:​75%;​ border:thin solid black" src="​http://​wiki.ahsay.com/​lib/​exe/​fetch.php?​media=public:​5152_1.png"/>​ +
-   <​br/​> +
-   <​br/>+
   </​font></​li>​   </​font></​li>​
 +
 +
 +
   <​li><​font color=black>​   <​li><​font color=black>​
-   From the '​Destination storage'​ dropdown menu, select 'Local / Mapped Drive / Removable Drive'. +   Login to AhsayOBM, execute the RunConfigurator.sh script file again. 
-   <​br/> +   <​br>​ 
-   <​br/>+   <​br>​
   </​font></​li>​   </​font></​li>​
 +    ​
 +    ​
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Ensure that the destination type is set to '​Single storage destination'​, then click the '​Change'​ button to browse to the removable hard drive: +   Import ​the backup ​set setting by choosing 4, then Y when prompted for confirmation: 
-   <​br><​br>​ + 
-      <img style="​width:​75%; border:thin solid black" ​src="http://wiki.ahsay.com/​lib/​exe/​fetch.php?​media=public:5152_2.png"/> +   <​br>​ 
-   ​<​br/>​ +   <​br>​ 
-   <br/> +   ​<table border="​0"​ cellpadding="​0"​ cellspacing="​0" width="​750">​ 
-  </​font></​li>​+    <​tr>​ 
 +     <​td style="​BACKGROUND-COLOR: black"> 
 +      <font size=2 color=white><​p style="font-family:courier;"> ​   
 +      Main Menu<​br>​ 
 +---------<​br>​ 
 +&​nbsp;&​nbsp;​(1). List Backup Sets<​br>​ 
 +&​nbsp;&​nbsp;​(2). Delete Backup Set<​br>​ 
 +&​nbsp;&​nbsp;​(3). Export Backup Set Settings to XML<​br>​ 
 +&​nbsp;&​nbsp;​(4). Import Backup Set Settings from XML<​br>​ 
 +&​nbsp;&​nbsp;​(5). Generate new Backup Set Settings Template<​br>​ 
 +&​nbsp;&​nbsp;​(6). Change Language [English]<​br>​ 
 +&​nbsp;&​nbsp;​(7). Update Profile Settings<​br>​ 
 +&​nbsp;&​nbsp;​(8). Quit<​br>​ 
 +---------<​br>​ 
 +Your Choice: 4<​br>​ 
 +<​br>​ 
 +Reading xml...<​br>​ 
 +Reading xml...Done<​br>​ 
 +Verifying destination '​AhsayCBS'​...<​br>​ 
 +Verifying destination 'Local Dest'​...<​br>​ 
 +Backup Set '​backup_set'​ already exist. Confirm overwrite? (Y/N) ? Y<br> 
 +XML imported, uploading to server...<br> 
 +<​br>​ 
 +XML successfully uploaded to server<​br>​ 
 +<​br>​ 
 +    </td> 
 +    </tr> 
 +   </table>   
 +       
 +       
 +      ​ 
 +  </​font></​li> ​  
 +   
 +   
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Press 'OK', then 'Save'. +   Confirm that both the 'import destination' ​(e.g. CBS or Predefined destination) and the 'local destination' ​(e.g. path to the removeable drive or on the client computer) are added. 
-   <​br/> +   <​br>​ 
-   <​br/> +   <​br>​ 
-  </font></li> +   Choose 1 to list the corresponding backup set, then the number of the corresponding backup set number: 
-  <li><font color=black>​ +   <br> 
-   Make sure that the '​import destination'​ and the 'local destination'​ are added: +   <br> 
-   <​br><​br>​ +   ​<table border="​0"​ cellpadding="​0"​ cellspacing="​0"​ width="​750"​> 
-      <img style="​width:75%; border:thin solid black" src="​http://wiki.ahsay.com/lib/exe/fetch.php?​media=public:​5152_3.png"​/>+    ​<tr> 
 +     <​td style="​BACKGROUND-COLOR: ​black"> 
 +      <​font size=2 color=white><​p style="​font-family:courier;"> ​  ​ 
 +Main Menu<br> 
 +---------<​br>​ 
 +&​nbsp;&​nbsp;​(1). List Backup Sets<br> 
 +&​nbsp;&​nbsp;​(2). Delete Backup Set<​br>​ 
 +&​nbsp;&​nbsp;​(3). Export Backup Set Settings to XML<​br>​ 
 +&​nbsp;&​nbsp;​(4). Import Backup Set Settings from XML<​br>​ 
 +&​nbsp;&​nbsp;​(5). Generate new Backup Set Settings Template<​br>​ 
 +&​nbsp;&​nbsp;​(6). Change Language [English]<​br>​ 
 +&​nbsp;&​nbsp;​(7). Update Profile Settings<​br>​ 
 +&​nbsp;&​nbsp;​(8). Quit<​br>​ 
 +---------<​br>​ 
 +Your Choice: 1<​br>​ 
 +<​br>​ 
 + 
 +Select a Backup Set to show more details<​br>​ 
 +----------------------------------------<​br>​ 
 +&nbsp;&​nbsp;​(1). backup_set<​br>​ 
 +----------------------------------------<​br>​ 
 +Your Choice: 1<​br>​ 
 +<​br>​ 
 +Name            : backup_set<​br>​ 
 +Owner           : hostname<​br>​ 
 +Type            : FILE<​br>​ 
 +Selected Source ​: /usr/local/backup_source<​br>​ 
 +Destination Name: local_dest , Type: Local<​br>​ 
 +Destination Name: AhsayCBS ​  , Type: OBS<​br>​ 
 +Destination Name: GoogleDrive,​ Type: GDrive 
 + 
 +    </td> 
 +    </tr> 
 +   </table>   
 +<​b>​Note</​b>:​ In the above example, the 'local destination'​ (e.g. local_dest) was added properly, and the '​import destination'​ (e.g. CBS and a Google Drive Predefined destination) are also listed. 
 + 
 + 
   </​font></​li>​   </​font></​li>​
  </​ul>​  </​ul>​
- <br/>+<br> 
 +<br>
  
  
Line 168: Line 300:
  <​ul>​  <​ul>​
   <​li><​font color=black>​   <​li><​font color=black>​
-   In the client user interface, select ​the 'Backup'​ tile: +   Edit the RunBackupSet.sh file in the AhsayOBM installation bin folder with a text editor such as VI Editor: 
-   <​br><​br>​ +   <​br>​ 
-      <img style="​width:20%; border:thin solid black" ​src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5152_4.png"/>​ +   <​br>​ 
-   ​<​br/>​ +   In this example, we will edit the file by adding the corresponding backup set's name (backup_set), the local destination's destination name (e.g. local_dest). We will also enable Full delta mode for full backup. 
-   <br/>+   <​br>​ 
 +   <br> 
 +    
 +    
 +    
 +    
 +   <​table border="​0"​ cellpadding="​0"​ cellspacing="​0"​ width="​750">​ 
 +    <​tr>​ 
 +     <​td style="​BACKGROUND-COLOR:​ black"> 
 +      <font size=2 color=white><​p ​style="​font-family:courier;"> ​  
 +      ############################## ​ RunBackupSet.sh ​ ###############################<​br>​ 
 +# You can use this shell script to run any of your backup sets from the        #<​br>​ 
 +# command line. Just customize the "User Defined Section"​ below with your      #<​br>​ 
 +# values for your backup action. ​                                              #<​br>​ 
 +################################################################################<​br><​br>​ 
 + 
 +#########################​ START: User Defined Section ##########################<​br><​br>​ 
 + 
 +# --------------------------------- BACKUP_SET ---------------------------------<​br>​ 
 +# | The name or ID of the backup set that you want to run                      |<​br>​ 
 +# | If backup set name is not in English, please use ID instead. ​              ​|<​br>​ 
 +# | e.g. BACKUP_SET="1119083740107" ​                                           |<​br>​ 
 +# |  or  BACKUP_SET="FileBackupSet-1" ​                                         |<​br>​ 
 +# |                                                                            |<​br>​ 
 +# | You can leave this parameter blank if you have only 1 backup set.          |<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +BACKUP_SET="​backup_set"<​br><​br>​ 
 + 
 +# -------------------------------- BACKUP_DESTS --------------------------------<​br>​ 
 +# | The list of name or ID of the backup destinations that you want to run.    |<​br>​ 
 +# | If backup destination name is not in English, please use ID instead. ​      ​|<​br>​ 
 +# | e.g. BACKUP_DESTS="​1740107119083" ​                                         |<​br>​ 
 +# |  or  BACKUP_DESTS="​Destination-1,​Destination-2" ​                           |<​br>​ 
 +# |  or  BACKUP_DESTS="​ALL" ​                                                   |<​br>​ 
 +# |                                                                            |<​br>​ 
 +# | You can specify multiple destinations in comma-separated format, ​          ​|<​br>​ 
 +# | or use "​ALL"​ to run backup for all destinations. ​                          ​|<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +BACKUP_DESTS="​local_dest"<​br><​br>​ 
 + 
 +# -------------------------------- BACKUP_TYPE ---------------------------------<​br>​ 
 +# | Set backup type. You don't need to change this if you are backing up a     ​|<​br>​ 
 +# | file backup set.                                                           ​|<​br>​ 
 +# | Options available: FILE/DATABASE/DIFFERENTIAL/​LOG ​                         |<​br>​ 
 +# | e.g. BACKUP_TYPE="​FILE" ​         for file backup ​                          ​|<​br>​ 
 +# |  or  BACKUP_TYPE="​DATABASE" ​     for Full database backup ​                 |<​br>​ 
 +# |  or  BACKUP_TYPE="​DIFFERENTIAL" ​ for Differential database backup ​         |<​br>​ 
 +# |  or  BACKUP_TYPE="​LOG" ​          for Log database backup ​                  ​|<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +BACKUP_TYPE="​FILE"<​br><​br>​ 
 + 
 +# -------------------------------- SETTING_HOME --------------------------------<​br>​ 
 +# | Directory to your setting home.                                            |<​br>​ 
 +# | Default to ${HOME}/.obm when not set.                                      |<​br>​ 
 +# | e.g. SETTING_HOME="​${HOME}/.obm" ​                                          ​|<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +SETTING_HOME=""<​br><​br>​ 
 + 
 +# --------------------------------- DELTA_MODE ---------------------------------<​br>​ 
 +# | Set In-File Delta mode.                                                    |<​br>​ 
 +# | Options available: Incremental/Differential/​Full (I/​D/​F) ​                  ​|<​br>​ 
 +# | e.g. DELTA_MODE="​I" ​  for Incremental In-file delta backup ​                ​|<​br>​ 
 +# |  or  DELTA_MODE="​D" ​  for Differential In-file delta backup ​               |<​br>​ 
 +# |  or  DELTA_MODE="​F" ​  for Full File backup ​                                ​|<​br>​ 
 +# |  or  DELTA_MODE="" ​   for using backup set in-file delta setting ​          ​|<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +DELTA_MODE="​F"<​br><​br>​ 
 + 
 +# -------------------------------- CLEANUP_MODE --------------------------------<​br>​ 
 +# | You can enable Cleanup mode to remove obsolete files from your backup ​     |<​br>​ 
 +# | destinations after backup. ​                                                ​|<​br>​ 
 +# | Options available: ENABLE-CLEANUP/​DISABLE-CLEANUP ​                         |<​br>​ 
 +# | e.g. CLEANUP_MODE="ENABLE-CLEANUP" ​                                        ​|<​br>​ 
 +# |  or  CLEANUP_MODE="​DISABLE-CLEANUP" ​                                       |<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +CLEANUP_MODE="​DISABLE-CLEANUP"<​br><​br>​ 
 + 
 +# --------------------------------- DEBUG_MODE ---------------------------------<​br>​ 
 +# | Set Debug mode.                                                            |<​br>​ 
 +# | Options available: ENABLE-DEBUG/DISABLE-DEBUG ​                             |<br> 
 +# | e.g. DEBUG_MODE="​ENABLE-DEBUG" ​                                            |<br> 
 +# |  or  DEBUG_MODE="​DISABLE-DEBUG" ​                                           |<​br>​ 
 +# ------------------------------------------------------------------------------<​br>​ 
 +DEBUG_MODE="​DISABLE-DEBUG"​ 
 +    </td> 
 +    </tr> 
 +   </table>   
 +   
   </​font></​li>​   </​font></​li>​
 +  ​
 +  ​
 +  ​
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Select ​the corresponding backup set for backup: +   Save, then exit from the text editor. 
-   <br><br> +   <​br>​ 
-      <img style="​width:​75%;​ border:thin solid black" src="​http://​wiki.ahsay.com/​lib/​exe/​fetch.php?​media=public:​5152_5.png"/​> +   <​br>​ 
-   <​br/> +   </​font></​li>​ 
-   <​br/>​ +   
-  ​</​font></​li>​+   
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
-   Click on the 'Show advanced option'​ button, ensure that the '​In-File Delta' type is set to '​Full'​.+   Execute ​the RunBackupSet.sh file afterward:
    <​br/>​    <​br/>​
    <​br/>​    <​br/>​
   </​font></​li>​   </​font></​li>​
 +  ​
 +  ​
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
    Under '​Destination',​ deselect all destinations except for the newly created local destination:​    Under '​Destination',​ deselect all destinations except for the newly created local destination:​
Line 193: Line 420:
    <​br/>​    <​br/>​
   </​font></​li>​   </​font></​li>​
 +  ​
 +  ​
 +  ​
   <​li><​font color=black>​   <​li><​font color=black>​
    Click '​Backup'​ to start the initial backup.    Click '​Backup'​ to start the initial backup.
public/8106_faq/how_to_perform_a_seedload_backup_and_import_cli.txt · Last modified: 2021/12/14 08:50 by anna.olalia

Page Tools