This shows you the differences between two versions of the page.
Both sides previous revision Previous revision 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 17:22] edward.chan |
public:8106_faq:how_to_perform_a_seedload_backup_and_import_cli [2021/02/26 21:00] edward.chan |
||
---|---|---|---|
Line 4: | Line 4: | ||
<b> | <b> | ||
Article ID:</b> 8106 | Article ID:</b> 8106 | ||
- | <br/> | + | <br> |
<b> | <b> | ||
Reviewed:</b> 26/02/2021 | Reviewed:</b> 26/02/2021 | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<b> | <b> | ||
Product Version: | Product Version: | ||
</b> | </b> | ||
- | <br/> | + | <br> |
Ahsay Software: 8.1 or above | Ahsay Software: 8.1 or above | ||
- | <br/> | + | <br> |
OS: Linux | OS: Linux | ||
</html> | </html> | ||
Line 25: | Line 25: | ||
This procedure is highly recommended for backup set with large data size and or network with slow connection speed. | This procedure is highly recommended for backup set with large data size and or network with slow connection speed. | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
Although the instruction is described for AhsayCBS / Predefined destination, the same steps can also be performed for other backup destinations like FTP, SFTP, and Cloud Storage destinations. | Although the instruction is described for AhsayCBS / Predefined destination, the same steps can also be performed for other backup destinations like FTP, SFTP, and Cloud Storage destinations. | ||
- | <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 37: | Line 37: | ||
<html> | <html> | ||
Refer to the following steps for details: | Refer to the following steps for details: | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
Line 44: | Line 44: | ||
1. First, configure the backup set to perform the initial backup to a local destination (e.g. the removable hard drive). | 1. First, configure the backup set to perform the initial backup to a local destination (e.g. the removable hard drive). | ||
</b> | </b> | ||
- | <br/> | + | <br> |
<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 282: | Line 282: | ||
</tr> | </tr> | ||
</table> | </table> | ||
- | <b>Note</b>: In the above example, the 'local destination' (e.g. local_dest) was added properly, and the 'import destination' (e.g. AhsayCBS and a Google Drive Predefined destination) are also listed. | + | <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. |
Line 296: | Line 296: | ||
2. Next, perform the initial backup to the local destination (e.g. the removable hard drive). | 2. Next, perform the initial backup to the local destination (e.g. the removable hard drive). | ||
</b> | </b> | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<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> |
+ | Save, then exit from the text editor. | ||
+ | <br> | ||
+ | <br> | ||
+ | </font></li> | ||
| | ||
| | ||
<li><font color=black> | <li><font color=black> | ||
- | Select the corresponding backup set for backup: | + | Execute the RunBackupSet.sh file afterward: |
- | <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/> | + | <table border="0" cellpadding="0" cellspacing="0" width="750"> |
- | <br/> | + | <tr> |
+ | <td style="BACKGROUND-COLOR: black"> | ||
+ | <font size=2 color=white><p style="font-family:courier;"> | ||
+ | root@hostname:/usr/local/obm/bin# sh RunBackupSet.sh<br> | ||
+ | -<br> | ||
+ | Using APP_HOME : /usr/local/obm<br> | ||
+ | Using SETTING_HOME : <br> | ||
+ | Using JAVA_HOME : /usr/local/obm/jvm<br> | ||
+ | Using JAVA_EXE : /usr/local/obm/jvm/bin/java<br> | ||
+ | Using JAVA_OPTS : -Xrs -Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -client -Dsun.nio.PageAlignDirectMemory=true<br> | ||
+ | Using JNI_PATH : -Djava.library.path=.:./LinX64<br> | ||
+ | Using CLASSPATH : .:./cb.jar<br> | ||
+ | -<br> | ||
+ | Running Backup Set - 'backup_set' ...<br> | ||
+ | [2021/02/26 19:04:26] [info] [-] Start [ AhsayOBM v8.5.0.63 ]<br> | ||
+ | [2021/02/26 19:04:26] [info] [-] Saving encrypted backup set encryption keys to server...<br> | ||
+ | [2021/02/26 19:04:28] [info] [1614318606096] Start Backup ... [In-File Delta: Full]<br> | ||
+ | [2021/02/26 19:04:28] [info] [1614318606096] Using Temporary Directory /root/temp/1614311678846/Local@1614318606096<br> | ||
+ | [2021/02/26 19:04:31] [info] [-] Start running pre-commands<br> | ||
+ | [2021/02/26 19:04:31] [info] [-] Finished running pre-commands<br> | ||
+ | [2021/02/26 19:04:31] [info] [1614318606096] Downloading server file list...<br> | ||
+ | [2021/02/26 19:04:34] [info] [1614318606096] Downloading server file list... Completed<br> | ||
+ | [2021/02/26 19:04:35] [info] [1614318606096] Reading backup source from hard disk...<br> | ||
+ | [2021/02/26 19:04:35] [info] [1614318606096] [New Directory]... /<br> | ||
+ | [2021/02/26 19:04:35] [info] [1614318606096] [New Directory]... /usr<br> | ||
+ | [2021/02/26 19:04:35] [info] [1614318606096] [New Directory]... /usr/local<br> | ||
+ | [2021/02/26 19:04:35] [info] [1614318606096] [New Directory]... /usr/local/backup_source<br> | ||
+ | [2021/02/26 19:04:36] [info] [1614318606096] Reading backup source from hard disk... Completed<br> | ||
+ | [2021/02/26 19:04:36] [info] [1614318606096] [New File]... 100% of "/usr/local/backup_source/dir/.../data"<br> | ||
+ | [2021/02/26 19:04:36] [info] [1614318606096] [New File]... 100% of "/usr/local/backup_source/dir/.../data"<br> | ||
+ | [2021/02/26 19:04:37] [info] [1614318606096] Start validating the presence and size of backup data in destination "local_dest"...<br> | ||
+ | <br> | ||
+ | ...<br> | ||
+ | ...<br> | ||
+ | <br> | ||
+ | [2021/02/26 19:04:43] [info] [1614318606096] Deleting temporary file /root/temp/1614311678846/Local@1614318606096<br> | ||
+ | [2021/02/26 19:04:44] [info] [1614318606096] Backup Completed Successfully<br> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </font></li> | ||
+ | |||
+ | </ul> | ||
+ | <br> | ||
+ | <br> | ||
+ | |||
+ | |||
+ | |||
+ | <b> | ||
+ | 3. Import the data from the local destination (e.g. the removable hard drive) to the AhsayCBS and Predefined destination (e.g. Google Drive, OneDrive, Dropbox). | ||
+ | </b> | ||
+ | <br> | ||
+ | <br> | ||
+ | <ul> | ||
+ | <li><font color=black> | ||
+ | To import the data to <b>AhsayCBS</b>, copy the data (the entire 'backupset_id' folder) from the removable drive at: | ||
+ | <br> | ||
+ | <br> | ||
+ | %Local_Destination%/<font color=#FF0000>%backupset_id%/*</font> | ||
+ | <br> | ||
+ | <br> | ||
+ | to the user home path of the corresponding backup user at: | ||
+ | <br> | ||
+ | <br> | ||
+ | %User_Home%/username/ | ||
+ | <br> | ||
+ | <br> | ||
+ | For example: | ||
+ | <br> | ||
+ | <br> | ||
+ | %Local_Destination%/1614311678846/* | ||
+ | <br> | ||
+ | <br> | ||
+ | to | ||
+ | <br> | ||
+ | <br> | ||
+ | %User_Home%/username/1614311678846/* | ||
+ | <br> | ||
+ | <br> | ||
+ | <font color=#FF0000><b>Important:</b> Do not perform another backup job while the data are being copied from the removable hard drive to the backup destination. | ||
+ | </font> | ||
+ | <br> | ||
+ | <br> | ||
+ | Administrator can: | ||
+ | <br> | ||
+ | <br> | ||
+ | <ul> | ||
+ | <li><font color=black> | ||
+ | Temporarily suspend the backup user while the data are being copied, and | ||
+ | </font></li> | ||
+ | <li><font color=black> | ||
+ | Temporarily disable the backup schedule(s) of the corresponding backup set. | ||
+ | </font></li> | ||
+ | </ul> | ||
+ | </b> | ||
</font></li> | </font></li> | ||
- | | + | <br> |
+ | <br> | ||
| | ||
| | ||
<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'. | + | To import the data to a <b>Google Drive destination</b>, copy the data (the entire 'backupset_id' folder) from the removable drive at: |
- | <br/> | + | <br> |
- | <br/> | + | <br> |
- | </font></li> | + | %Local_Destination%\<font color=#FF0000>%backupset_id%\*</font> |
- | | + | <br> |
+ | <br> | ||
+ | to the corresponding location on Google Drive at: | ||
+ | <br> | ||
+ | <br> | ||
+ | My Drive > Ahsay > <font color=#FF0000>%backupset_id%</font> | ||
+ | <br><br> | ||
+ | <img style="width:55%" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:8106_1.png"/> | ||
+ | <br> | ||
+ | <br> | ||
+ | For example: | ||
+ | <br> | ||
+ | <br> | ||
+ | %Local_Destination%\1614311678846\* | ||
+ | <br> | ||
+ | <br> | ||
+ | to | ||
+ | <br> | ||
+ | <br> | ||
+ | My Drive > Ahsay > 1614311678846 | ||
+ | <br> | ||
+ | <br> | ||
+ | <font color=#FF0000><b>Important:</b> Do not perform another backup job while the data are being copied from the removable hard drive to the user home path on AhsayCBS. | ||
+ | </font> | ||
+ | <br> | ||
+ | <br> | ||
+ | Administrator can: | ||
+ | <br> | ||
+ | <br> | ||
+ | <ul> | ||
+ | <li><font color=black> | ||
+ | Temporarily suspend the backup user while the data are being copied, and | ||
+ | </font></li> | ||
+ | <li><font color=black> | ||
+ | Temporarily disable the backup schedule(s) of the corresponding backup set. | ||
+ | </font></li> | ||
+ | </ul> | ||
+ | </b> | ||
+ | </font></li> | ||
+ | <br> | ||
+ | <br> | ||
| | ||
| | ||
<li><font color=black> | <li><font color=black> | ||
- | Under 'Destination', deselect all destinations except for the newly created local destination: | + | To import the data to a <b>OneDrive destination</b>, copy the data (the entire 'backupset_id' folder) from the removable drive at: |
+ | <br> | ||
+ | <br> | ||
+ | %Local_Destination%\<font color=#FF0000>%backupset_id%\*</font> | ||
+ | <br> | ||
+ | <br> | ||
+ | to the corresponding location on OneDrive at: | ||
+ | <br> | ||
+ | <br> | ||
+ | My files > Apps > Ahsay > <font color=#FF0000>%backupset_id%</font> | ||
<br><br> | <br><br> | ||
- | <img style="width:75%; border:thin solid black" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5152_6.png"/> | + | <img style="width:55%" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:8106_2.png"/> |
- | <br/> | + | <br> |
- | <br/> | + | <br> |
- | </font></li> | + | For example: |
- | | + | <br> |
+ | <br> | ||
+ | %Local_Destination%\1614311678846\* | ||
+ | <br> | ||
+ | <br> | ||
+ | to | ||
+ | <br> | ||
+ | <br> | ||
+ | My Drive > Ahsay > 1614311678846 | ||
+ | <br> | ||
+ | <br> | ||
+ | <font color=#FF0000><b>Important:</b> Do not perform another backup job while the data are being copied from the removable hard drive to the user home path on AhsayCBS. | ||
+ | </font> | ||
+ | <br> | ||
+ | <br> | ||
+ | Administrator can: | ||
+ | <br> | ||
+ | <br> | ||
+ | <ul> | ||
+ | <li><font color=black> | ||
+ | Temporarily suspend the backup user while the data are being copied, and | ||
+ | </font></li> | ||
+ | <li><font color=black> | ||
+ | Temporarily disable the backup schedule(s) of the corresponding backup set. | ||
+ | </font></li> | ||
+ | </ul> | ||
+ | </b> | ||
+ | </font></li> | ||
+ | <br> | ||
+ | <br> | ||
| | ||
| | ||
<li><font color=black> | <li><font color=black> | ||
- | Click 'Backup' to start the initial backup. | + | To import the data to a <b>Dropbox destination</b>, copy the data (the entire 'backupset_id' folder) from the removable drive at: |
- | </font></li> | + | <br> |
- | </ul> | + | <br> |
- | <br/> | + | %Local_Destination%\<font color=#FF0000>%backupset_id%\*</font> |
- | + | <br> | |
- | + | <br> | |
- | + | to the corresponding location on Dropbox at: | |
- | <b> | + | <br> |
- | 3. Import the data from the local destination (e.g. the removable hard drive) to the AhsayCBS server. | + | <br> |
- | </b> | + | Dropbox > Apps > Ahsay > <font color=#FF0000>%backupset_id%</font> |
- | <br/> | + | |
- | <br/> | + | |
- | <ul> | + | |
- | <li><font color=black> | + | |
- | Copy the data (the entire 'blocks' folder) from the removable drive at: | + | |
- | <br/> | + | |
- | <br/> | + | |
- | %Local_Destination%\<font color=#FF0000>%backupset_id%\blocks\*</font> | + | |
- | <br/> | + | |
- | <br/> | + | |
- | to the user home path of the corresponding backup user at: | + | |
- | <br/> | + | |
- | <br/> | + | |
- | %User_Home%\username\<font color=#FF0000>%backupset_id%\</font> | + | |
<br><br> | <br><br> | ||
- | <img src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:5152_7.png" style="border:thin solid black"/> | + | <img style="width:55%" src="http://wiki.ahsay.com/lib/exe/fetch.php?media=public:8106_3.png"/> |
- | <br/> | + | <br> |
- | <br/> | + | <br> |
For example: | For example: | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
- | %Seedload_Destination%\1461745430428\blocks\* | + | %Local_Destination%\1614311678846\* |
- | <br/> | + | <br> |
- | <br/> | + | <br> |
to | to | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
- | %User_Home%\username\1461745430428\blocks\* | + | My Drive > Ahsay > 1614311678846 |
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<font color=#FF0000><b>Important:</b> Do not perform another backup job while the data are being copied from the removable hard drive to the user home path on AhsayCBS. | <font color=#FF0000><b>Important:</b> Do not perform another backup job while the data are being copied from the removable hard drive to the user home path on AhsayCBS. | ||
</font> | </font> | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
Administrator can: | Administrator can: | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<ul> | <ul> | ||
<li><font color=black> | <li><font color=black> | ||
Line 395: | Line 646: | ||
</ul> | </ul> | ||
</b> | </b> | ||
- | </font></li> | + | </font></li> |
+ | |||
+ | |||
+ | | ||
</ul> | </ul> | ||
<br> | <br> | ||
Line 403: | Line 657: | ||
4. Perform a Data Integrity Check for the corresponding backup set. | 4. Perform a Data Integrity Check for the corresponding backup set. | ||
</b> | </b> | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<ul> | <ul> | ||
<li><font color=black> | <li><font color=black> | ||
Line 427: | Line 681: | ||
5. The import procedure is completed. | 5. The import procedure is completed. | ||
</b> | </b> | ||
- | <br/> | + | <br> |
- | <br/> | + | <br> |
<ul> | <ul> | ||
<li><font color=black> | <li><font color=black> |