www.bobcloud.net
Ahsay Online Backup Manager v8
Quick Start Guide for Linux (GUI)
Ahsay Systems Corporation Limited
8 February 2019
This is the original Ahsay manual
Depending on the service you have with us, some of the content won’t be applicable to
you.
Note:
We don’t supply the following services, Open direct, Run Direct, or Run on Server on
our BOBcloud service. These are only provided on our System Provider service.
All accounts must be created on our reseller portal https://portal.data-stor.net
Any Ahsay professional services are provided by them and not us.
Definitions:
Our Desktop version is named ACB \ AhsayACB in this manual.
Our Server version is named OBM \ AhsayOBM in this manual.
The AhsayCBS Web Console is mapped to our own portal https://portal.data-stor.net
www.bobcloud.net
Copyright Notice
© 2019 Ahsay Systems Corporation Limited. All rights reserved.
The use and copying of this product is subject to a license agreement. Any other use is prohibited. No part of this publication
may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any
means without prior written consent of Ahsay Systems Corporation Limited. Information in this manual is subject to change
without notice and does not represent a commitment on the part of the vendor. Ahsay Systems Corporation Limited does not
warrant that this document is error free. If you find any errors in this document, please report to Ahsay Systems Corporation
Limited in writing.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
Trademarks
Ahsay, Ahsay Cloud Backup Suite, Ahsay Online Backup Suite, Ahsay Offsite Backup Server, Ahsay Online Backup Manager,
Ahsay A-Click Backup, Ahsay Replication Server, Ahsay BackupBox Firmware, Ahsay Universal Backup System and Ahsay
NAS Client Utility are trademarks of Ahsay Systems Corporation Limited.
Amazon S3 is registered trademark of Amazon Web Services, Inc. or its affiliates.
Apple and Mac OS X are registered trademarks of Apple Computer, Inc.
Dropbox is registered trademark of Dropbox Inc.
Google Cloud Storage and Google Drive are registered trademarks of Google Inc.
Lotus, Domino and Notes are registered trademark of IBM Corporation.
Microsoft, Windows, Microsoft Exchange Server, Microsoft SQL Server, Microsoft Hyper-V, Microsoft Azure, One Drive and
One Drive for Business are registered trademarks of Microsoft Corporation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
owners.
Oracle, Oracle 10g, Oracle 11g and MySQL are registered trademarks of Oracle Corporation.
Rackspace and OpenStack are registered trademarks of Rackspace US, Inc.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo and JBoss are registered trademarks of Red Hat, Inc.
www.redhat.com in the U.S. and other countries. Linux is a registered trademark of Linus Torvalds.
ShadowProtect is registered trademark of StorageCraft Technology Corporation.
VMware, ESX, ESXi and vCenter are registered trademarks of VMware, Inc.
All other product names are registered trademarks of their respective owners.
Disclaimer
Ahsay Systems Corporation Limited will not have or accept any liability, obligation or responsibility whatsoever for any loss,
destruction or damage (including without limitation consequential loss, destruction or damage) however arising from or in
respect of any use or misuse of reliance on this document. By reading and following the instructions in this document, you
agree to accept unconditionally the terms of this Disclaimer and as they may be revised and/or amended from time to time by
Ahsay Systems Corporation Limited without prior notice to you.
www.bobcloud.net
Revision History
Date
Descriptions
Type of modification
22 Dec 2018
Added Open JDK and GNU C LIB requirement in
Ch. 1; Updated Software Compatibility link in Ch.
1; Revised online installation instructions in Ch.
3.1; Revised offline installation instructions in Ch.
3.2.2; Added verify checksum in Ch. 8
Modification
www.bobcloud.net
Table of Contents
1 System Requirements ..................................................................................................................1
Supported Platforms ..................................................................................................................1
GUI Desktop Environment .........................................................................................................1
Linux Packages .........................................................................................................................1
2 Getting Started ..............................................................................................................................2
3 Download and Install AhsayOBM................................................................................................3
Online Installation ......................................................................................................................4
Offline Installation ....................................................................................................................17
Check Version of AhsayOBM ..................................................................................................25
4 Starting AhsayOBM ....................................................................................................................26
Login to AhsayOBM.................................................................................................................26
5 Creating a File Backup Set.........................................................................................................28
6 Overview on the Backup Process .............................................................................................37
7 Running Backup Jobs ................................................................................................................38
Login to AhsayOBM.................................................................................................................38
Start a Manual Backup ............................................................................................................38
Configure Backup Schedule for Automated Backup................................................................40
8 Restoring Data ............................................................................................................................41
Login to AhsayOBM.................................................................................................................41
Restore Data............................................................................................................................41
9 Contacting Ahsay .......................................................................................................................48
Technical Assistance ...............................................................................................................48
Documentation.........................................................................................................................48
Appendix .............................................................................................................................................49
Uninstall AhsayOBM (rpm) ......................................................................................................49
Uninstall AhsayOBM (sh).........................................................................................................51
Uninstall AhsayOBM (deb) ......................................................................................................53
Handling of Non-regular Files ..................................................................................................55
www.bobcloud.net 1
1 System Requirements
Supported Platforms
Refer to the following KB article for the list of supported operating systems:
FAQ: Ahsay Software Compatibility List (SCL) for version 8.1 or above
http://wiki.ahsay.com/doku.php?id=public:8001
GUI Desktop Environment
The Linux machine must be installed with a GUI desktop environment, i.e. GNOME, KDE,
Cinnamon etc.
Linux Packages
The following packages have to be present on the Linux machine in order for AhsayOBM
version 8 to be installed.
curl https://curl.haxx.se
The ‘curl’ command is used by both the AhsayOBM sh script and rpm installer to
download components from AhsayCBS server during the installation process.
tar https://www.gnu.org/software/tar
The ‘tar’ command is used by both the AhsayOBM sh script, gz, and rpm installer to
uncompress and extract installation files or components downloaded from the AhayCBS
backup server onto the Linux machine.
rpm http://rpm.org
The ‘rpm’ package must be installed to use the AhsayOBM rpm installation method.
dpkg https://packages.ubuntu.com/trusty/dpkg
The ‘dpkg’ package must be installed to use the AhsayOBM deb installation method on
Ubuntu LTS Linux platforms supported from version 7.15.0.0 or above.
psmisc http://psmisc.sourceforge.net/
The ‘psmisc’ package which contains the ‘fuser’ components must be installed for
AhsayOBM on CentOS / Red Hat Enterprise Linux (RHEL), for the auto update agent
(AUA) process to work properly.
OpenJDK Version 1.8 https://www.freebsd.org/java/
The installed Java Development Kit version must at least be 8.
GNU LIBC 2.14 https://www.gnu.org/software/libc/
The installed ‘GNU LIBC’ version must at least be 2.14 for OpenJDK 8 to work.
www.bobcloud.net 2
This quick start guide will walk you through the following 5 major parts to get you started with using
AhsayOBM.
Download and Install
Download and Install AhsayOBM
on your Linux machine
Launch AhsayOBM
Launch and log in to AhsayOBM
Create File Backup Set
Create backup set according to
your preferences
Run Backup Jobs
Run the backup job to back up
data
Restore Data
Restore backed up data to your
system
www.bobcloud.net 3
3 Download and Install AhsayOBM
There are two installation modes of AhsayOBM, online installation and offline installation. Below is the
table of comparison between online installation and offline installation.
Online Installation
Offline Installation
Installation
Time
Takes more time as it needs to
download the binary and
component files (80MB to 132MB
depending on operating system)
each time the installation is run.
Online installer size is 6KB to
3.5MB depending on operating
system as it contains only the initial
installation package files.
Takes less time as all the
necessary binary and component
files are already available in the
offline installer and offline installer
can be downloaded once but
reused many times.
Offline installer size is 80MB to
132MB depending on operating
system as it contains all the
necessary binary and component
files.
Deployments
Suitable for single or small amount
of device installations.
Suitable for sites with fast and
stable internet connection as
internet connection is needed each
time when an installation is run.
A slow internet connection will
result in longer installation time and
interrupted or unstable internet
connection may lead to
unsuccessful installation.
Ensures the latest version of the
product is installed.
Suitable for multiple or mass
device installations.
Suitable for client sites with
metered internet connections as
once the offline installer is
downloaded, internet connection is
not needed each time when an
installation is run.
May need to update the product
version after installation if an older
offline installer is used.
www.bobcloud.net 4
Online Installation
3.1.1 rpm
1. Login as root on Linux GUI. (Alternatively, you can remotely invoke the GUI of another Linux
machine using SSH client.)
2. To download the AhsayOBM rpm installation package file from your backup service
provider’s website:
3. Go to the download page and click on Download (rpm) (Online) button to download the
AhsayOBM installer.
www.bobcloud.net 5
4. Click OK to launch the installation package you have downloaded.
5. When the notification message “Application Installer Software is ready” appears, click the
Software tab to proceed.
6. Click Install to start the installation.
www.bobcloud.net 6
7. Upon successful installation, the AhsayOBM icon will be added to the desktop as a shortcut.
Alternatively, you can also click the Applications menu bar and then select Other to see the
AhsayOBM.
www.bobcloud.net 7
3.1.2 Linux sh
1. Login as root on Linux GUI. (Alternatively, you can remotely invoke the GUI of another Linux
machine using SSH client.)
2. Right-click on the desktop and click Open Terminal to launch the application.
www.bobcloud.net 8
Alternatively, you can also click the Applications menu bar and then select Utilities >
Terminal.
3. Create a new directory /usr/local/obm for the installation of AhsayOBM. Then, go to the
new directory.
# mkdir -p /usr/local/obm
# cd /usr/local/obm
4. To download the AhsayOBM sh script from your backup service provider’s website:
5. Go to the download page and right click on Download (sh) (Online) button to download the
AhsayOBM installer. Save the file in the directory you just created.
6. Execute the AhsayOBM install script.
# sh obm-linux-443-10.23.6.67-https-0O.sh
7. The installation is completed when Done shows at the end of the script.
# sh obm-linux-443-10.23.6.67-https-0O.sh
Log Time: Mon Jan 21 18:22:19 HKT 2019
Host address: https://10.23.6.67:443
Downloading file... jre-std-linux-amd64.tar.gz
www.bobcloud.net 9
% Total % Received % Xferd Average Speed Time
Time Time Current
Dload Upload Total
Spent Left Speed
100 43.7M 100 43.7M 0 0 14.8M 0 0:00:02
0:00:02 --:--:-- 16.7M
Download file completed
Untar component file to /tmp/_obm.190115112202/jvm
Downloading file app-common.tar.gz
% Total % Received % Xferd Average Speed Time
Time Time Current
Dload Upload Total
Spent Left Speed
100 26.8M 100 26.8M 0 0 15.8M 0 0:00:01
0:00:01 --:--:-- 16.4M
Download file completed
Untar component file to /tmp/_obm.190115112202
.
.
.
No old application found, begin fresh install
Install Application Path: /usr/local/obm
Done
8. Upon successful installation, the AhsayOBM icon will be added to the desktop as a shortcut.
www.bobcloud.net 10
Alternatively, you can also click the Applications menu bar and then select Other to see
the AhsayOBM.
www.bobcloud.net 11
3.1.3 deb
1. Login as root on Ubuntu GUI. (Alternatively, you can remotely invoke the GUI of another
Ubuntu machine using SSH client.)
2. To download the AhsayOBM deb installation package file go to your backup service
provider’s website:
3. Go to the download page and click on Download (deb) (Online) button to download the
AhsayOBM installer.
4. Click Save File to proceed.
www.bobcloud.net 12
5. Go to Downloads folder and double click on the file you just downloaded.
6. Click Install Package to start the installation.
www.bobcloud.net 13
7. After installation is done Installation finished message will be shown.
8. Upon successful installation, AhsayOBM will be added to the menu under Other.
www.bobcloud.net 14
3.1.4 Ubuntu sh
1. Login as root on Ubuntu GUI.
2. Create a new folder named obm in the /usr/local directory in the Files window or you can
create the folder through the Terminal.
# mkdir -p /usr/local/obm
# cd /usr/local/obm
www.bobcloud.net 15
3. To download the AhsayOBM sh installation package file go to your backup service provider’s
website:
4. Right click on the Download (sh) (Online) button and click Save Link As. Save it in the
obm folder that you created.
5. Go to the Terminal and execute the AhsayOBM script to begin the installation.
# cd /usr/local/obm
# sh obm-ubuntu-443-10.90.10.12-https-0O.sh
6. The installation is completed when Done is shown at the end of the script.
Log Time: Tue Jan 22 01:45:52 UTC 2019
Host address: https://10.90.10.12:443
Downloading file... jre-std-linux-amd64.tar.gz
% Total % Received % Xferd Average Speed Time
Time Time Current
Dload Upload Total
Spent Left Speed
100 43.7M 100 43.7M 0 0 15.7M 0 0:00:02
0:00:02 --:--:-- 15.7M
Download file completed
Untar component file to /tmp/_obm. 181228112412/jvm
Downloading file... properties-common.tar.gz
% Total % Received % Xferd Average Speed Time
Time Time Current
Dload Upload Total
Spent Left Speed
100 3192k 0 3192k 0 0 1058k 0 --:--:--
0:00:03 --:--:-- 1058k
Download file completed
Untar component file to /tmp/_obm. 181228112412
.
.
.
www.bobcloud.net 16
Downloading file... aua-inst-nix-obm.tar.gz
% Total % Received % Xferd Average Speed Time
Time Time Current
Dload Upload Total
Spent Left Speed
100 48657 100 48657 0 0 240k 0 --:--:-- --:-
-:-- --:--:-- 239k
Download file completed
Untar component file to /tmp/_obm.181228112412
No old application found, begin fresh install
Install Application Path: /usr/local/obm
Done
7. Upon successful installation, the AhsayOBM will be added to the menu under Other.
www.bobcloud.net 17
Offline Installation
3.2.1 Linux sh
1. Login as root on Linux GUI. (Alternatively, you can remotely invoke the GUI of another Linux
machine using SSH client.)
2. To download the AhsayOBM sh installation package file from your backup service provider’s
website:
3. Go to the download page and right click on Download (sh) (Offline) button to download the
AhsayOBM installer.
www.bobcloud.net 18
4. Right click on the AhsayOBM installation package .gz file to extract.
5. Open the folder to check the extracted installation package.
6. Create a folder under the /usr/local directory. You could name the folder obm. Move the
extracted obm-linux.sh to the obm folder.
www.bobcloud.net 19
7. Right-click on the desktop and click Open Terminal to launch the application.
Alternatively, you can also click the Applications menu bar and then select Utilities >
Terminal.
8. Go to the the /usr/local/obm directory.
# cd /usr/local/obm
9. Execute the AhsayOBM install script.
# sh obm-linux.sh
10. The installation is completed when Done shows at the end of the script.
Log Time: Tue Jan 22 11:51:55 HKT 2019
Using package in usr/local/obm/app.pkg
Package version: 8.1.0.24
www.bobcloud.net 20
Untar jre-std-linux-amd64.tar.gz to
/tmp/_obm.190115115155/jvm
Untar app-common.tar.gz to /tmp/_obm.190115115155
Untar app-native-nix-x64.tar.gz to /tmp/_obm.190115115155
Untar app-nix-obm.tar.gz to /tmp/_obm.190115115155
Untar aua-common.tar.gz to /tmp/_obm.190115115155
Untar aua-native-nix-x64.tar.gz to /tmp/_obm.190115115155
Untar aua-nix-obm.tar.gz to /tmp/_obm.190115115155
Untar util-common.tar.gz to /tmp/_obm.190115115155
Untar util-nix-obm.tar.gz to /tmp/_obm.190115115155
Untar properties-common.tar.gz to /tmp/_obm.190115115155
Untar app-inst-nix-obm.tar.gz to /tmp/_obm.190115115155
Untar aua-inst-nix-obm.tar.gz to /tmp/_obm.190115115155
No old application found, begin fresh install
Install Application Path: /usr/local/obm
Done
11. Upon successful installation, the AhsayOBM icon will be added to the desktop as a shortcut.
Alternatively, you can also click the Applications menu bar and then select Other to see the
AhsayOBM option.
www.bobcloud.net 21
3.2.2 Ubuntu sh
1. Login as root on Ubuntu GUI.
2. Create a new folder named obm in the /usr/local directory in the Files window or you can
create the folder through the Terminal.
# mkdir -p /usr/local/obm
# cd /usr/local/obm
www.bobcloud.net 22
3. To download the AhsayOBM sh installation package file go to your backup service provider’s
website:
4. Click on Download (sh) (Offline) button to save.
5. Click on Save File to continue.
6. Go to your Downloads folder and right-click on the AhsayOBM installation package .gz file to
extract.
www.bobcloud.net 23
7. Open the extracted folder then cut and paste the files to the obm folder that you created.
8. Open the Terminal and execute the AhsayOBM script to begin the installation.
# cd /usr/local/obm
# sh obm-ubuntu.sh
9. The installation is completed when Done is shown at the end of the script.
Log Time: Tue Jan 22 2:31:26 UTC 2019
Using package in /usr/local/obm/app.pkg
Package version: 8.1.0.24
Untar jre-std-linux-amd64.tar.gz to
/tmp/_obm.190122023134/jvm
Untar app-common.tar.gz to /tmp/_obm.190122023134
Untar app-native-nix-x64.tar.gz to /tmp/_obm.190122023134
Untar app-nix-obm.tar.gz to /tmp/_obm.190122023134
Untar aua-common.tar.gz to /tmp/_obm.190122023134
Untar aua-native-nix-x64.tar.gz to /tmp/_obm.190122023134
Untar aua-nix-obm.tar.gz to /tmp/_obm.190122023134
www.bobcloud.net 24
Untar util-common.tar.gz to /tmp/_obm.190122023134
Untar util-nix-obm.tar.gz to /tmp/_obm.190122023134
Untar properties-common.tar.gz to /tmp/_obm.190122023134
Untar app-inst-nix-obm.tar.gz to /tmp/_obm.190122023134
Untar aua-inst-nix-obm.tar.gz to /tmp/_obm.190122023134
No old application found, begin fresh install
Install Application Path: /usr/local/obm
Done
10. Upon successful installation, AhsayOBM will be added to the menu under Other.
www.bobcloud.net 25
Check Version of AhsayOBM
1. Login to the AhsayOBM application according to the instructions in section 4 Login to
AhsayOBM.
2. Click the Information icon at the top right corner.
3. The version information of your installed AhsayOBM will appear.
www.bobcloud.net 26
4 Starting AhsayOBM
Login to AhsayOBM
1. The Free Trial Registration menu may be displayed when you login for the first time.
2. Click Login if you already have an AhsayOBM account or click Free Trial to register for a
trial backup account.
3. Click Show advanced option to enter the backup server settings provided by your backup
service provider.
www.bobcloud.net 27
4. Enter the login name and password of your AhsayOBM account. Then, click OK to login.
www.bobcloud.net 28
5 Creating a File Backup Set
1. Click the Backup Sets icon on the main interface of AhsayOBM.
2. Create a new backup set by clicking the “+” icon next to Add new backup set.
3. Name your new backup set and select the Backup set type. Then, click Next to proceed.
www.bobcloud.net 29
4. In the Backup Source menu, select the files and folder that you would like to backup. Click I
would like to choose the files to backup to select individual files for backup.
5. In the Advanced Backup Source menu, select the folder to back up all files in the folder.
www.bobcloud.net 30
6. Alternatively, if you want to back up a specific file instead of all files in your selected folder,
select the Show files checkbox at the bottom of the screen. A list of files will appear on the
right hand side. Select the checkbox(es) next to the file(s) to back up. Then, click OK to
close the Advanced Backup Source menu.
7. In the Backup Source menu, click Next to proceed.
8. In the Schedule menu, you can configure a backup schedule for backup job to run
automatically at your specified time interval. Click Add to add a new schedule. Then, click
Next to proceed.
www.bobcloud.net 31
9. In the Destination menu, the default backup mode selected is Sequential since only one
backup set is being created.
You can choose from one of the following two Backup mode options:
Sequential – if there are multiple destinations configured in the backup set,
AhsayOBM will backup to one destination at a time.
Concurrent - if there are multiple destinations configured in the backup set,
AhsayOBM will backup to all destinations at the same time or concurrently.
Note: For backup sets with multiple destinations, sequential backup mode will take longer
compared with concurrent backup mode.
www.bobcloud.net 32
10. Add a backup destination where the backup data will be stored. Click the “+” icon next to
Add new storage destination / destination pool.
Select the destination storage. Then, click OK to proceed.
www.bobcloud.net 33
11. Click Next on the Destination menu page to proceed.
12. In the OpenDirect window, the default option is disabled. Keep it off since this is not
supported in Linux.
www.bobcloud.net 34
13. In the Encryption window, the default Encrypt Backup Data option is enabled with an
encryption key preset by the system which provides the most secure protection.
You can choose from one of the following three Encryption Type options:
Default – an encryption key with 44 alpha numeric characters will be randomly
generated by the system.
User password – the encryption key will be the same as the login password of your
AhsayOBM at the time when this backup set is created. Please be reminded that if
you change the AhsayOBM login password later, the encryption keys of the backup
sets previously created with this encryption type will remain unchanged.
Custom – you can customize your encryption key, where you can set your own
algorithm, encryption key, method and key length.
Note: For best practice on managing your encryption key, refer to the following KB article.
http://wiki.ahsay.com/doku.php?id=public:5034
Click Next when you are done setting.
www.bobcloud.net 35
14. If you have enabled the Encryption Key feature in the previous step, the following pop-up
window shows, no matter which encryption type you have selected.
The pop-up window has the following three options to choose from:
Unmask encryption key – The encryption key is masked by default. Click this option
to show the encryption key.
Copy to clipboard – Click to copy the encryption key, then you can paste it in
another location of your choice.
Confirm – Click to exit this pop-up window and proceed to the next step.
www.bobcloud.net 36
15. The following screen shows when the new backup set is created successfully.
www.bobcloud.net 37
6 Overview on the Backup Process
The following steps are performed during a file backup job:
www.bobcloud.net 38
7 Running Backup Jobs
Login to AhsayOBM
Login to the AhsayOBM application according to the instructions in section 4 Login to AhsayOBM.
Start a Manual Backup
1. Click Backup on the main interface of AhsayOBM.
2. Select the backup set which you would like to start a backup for.
www.bobcloud.net 39
3. The Choose Your Backup Options screen will appear. If you would like to modify the In-File
Delta type, Destinations and Retention Policy settings, click Show advanced option.
4. Click Backup to start the backup.
www.bobcloud.net 40
Configure Backup Schedule for Automated Backup
1. Click Backup Sets on the AhsayOBM main interface.
2. Select the backup set that you would like to create a backup schedule for.
3. Click Backup Schedule. Then, create a new backup schedule by clicking Add.
4. Configure the backup schedule settings. Then, click OK to proceed.
5. Click Save to confirm your settings.
www.bobcloud.net 41
8 Restoring Data
Login to AhsayOBM
Login to the AhsayOBM application according to the instructions in section 4 Login to AhsayOBM.
Restore Data
1. Click Restore on the AhsayOBM main interface.
2. After logging in to your backup account successfully, you should see a screen showing all
the available backup sets for restore. Double click on the one you would like to restore.
www.bobcloud.net 42
3. Click on the location from which you would like to restore the data from.
4. Select to restore files from a specific backup job, or from all files available, then select the
files or folders that you would like to restore.
There are two options from the Select what to restore drop-down menu:
Choose from files as of job – this option allows you to select a backup version
from a specific date and time to restore.
www.bobcloud.net 43
Choose from ALL files – this option allows you to restore all the available
backup versions for this backup set. Among all the available backup versions,
you can even select only some of the backup versions of a file to restore.
Below is an example showing all the available backup versions of the file File
snapshot testing.txt. The latest version is shown in solid black color and all the
previous versions are shown in grey color. You can identify the file version from
the Date modified column.
When the restore is done, you will see all the selected backup versions in the
restore destination. The latest backup version has the file name as the original
file, while the previous versions have the time stamps added to their file names
for easy identification.
5. Click Next to proceed when you are done with the selections.
www.bobcloud.net 44
6. Select to restore the files to their Original location, or to an Alternate location, then click
Next to proceed.
Original location – the backed up data will be restored to the computer running
the AhsayOBM under the same directory path as on the machine storing the
backup source. For example, if the backup source files are stored under
root/Downloads folder, the data will be restored to root/Downloads as well on
the computer running the AhsayOBM.
Alternate location – you can choose to restore the data to a location of your
choice on the computer where AhsayOBM is running.
www.bobcloud.net 45
7. Click Show advanced option to configure other restore settings:
Restore file permissions
By enabling this option, file permissions of the operating system files will be
restored. File permission defines, for example, the right to view or change a file
by the system owner/group/individual. If file permission is not restored properly,
there is a potential risk that the restored data could be viewed by group/individual
who is not supposed to have the access to.
Follow Link (Enabled by default)
When this option is enabled, not only the symbolic link will be restored, the
directories and files that the symbolic link links to will also be restored.
The table below summarizes the behaviors when a restore is performed with
different settings.
Follow Link
Restore to
Behavior
Original
location
Symbolic link is restored to the original backup
location.
Target directories or files are also restored to
the original backup location.
Enabled
Alternate
location
Symbolic link is restored to the location
specified.
Target directories or files are also restored to
the alternate location specified.
Disabled
Original
location
Symbolic link is restored to the original backup
location.
Target directories or files are NOT restored to
the original backup location.
www.bobcloud.net 46
Alternate
location
Symbolic link is restored to the location
specified.
Target directories or files are NOT restored to
the alternate location specified.
Resolve Link (Only for restoring to Alternate Location)
This option must be used in conjunction with the Follow Link option. When this
option is enabled, the symbolic link, as well as the directories and files that the
symbolic link links to will also be restored in the alternate location you have
chosen. That means the symbolic link will point to the alternate location instead of
the original location.
The table below summarizes the behaviors when a restore is performed with this
option turned on and off.
Resolve Link
Behavior
Enabled
Symbolic link is restored to the alternate location specified,
with its target directories and files also restored to the same
location in their relative path.
Target of the link is updated to the new relative path. In
other word, the link now points to the new alternate location.
Disabled
Symbolic link is restored to the alternate location specified,
with its target directories and files also restored to the same
location in their relative path.
However, target of the link is NOT updated to the new
relative path. In other word, the link still points to the original
location.
Verify checksum of in-file delta files during restore
By enabling this option, the checksum of in-file delta files will be verified during
the restore process. This will check the data for errors during the restore process
and create a data summary of the in-file delta files which will be included in the
report.
8. Click Next to proceed once you are done with the settings.
9. Select the temporary directory for storing temporary files, such as delta files when they are
being merged.
By default, the temporary files are stored under the temp directory of the user profile
directory. However, there is a chance that the same directory path does not exist in the
computer you are running the AhsayOBM. In that case, you will have to click Browse to
define a new location for storing the temporary files, otherwise you will not be able to
www.bobcloud.net 47
perform a restore.
10. Click Restore to start the restore.
11. You will see a screen like the one shown below with the restore progress bar.
12. The progress bar shows Restore Completed Successfully when the restore is done. Click
Close to exit the confirmation screen.
www.bobcloud.net 48
9 Contacting Ahsay
Technical Assistance
To contact Ahsay support representatives for technical assistance, visit the following website:
https://www.ahsay.com/jsp/en/contact/kbQuestion.jsp
Also use the Ahsay Knowledge Base for resource such as Hardware Compatibility List, Software
Compatibility List, and other product information:
http://wiki.ahsay.com
Documentation
Documentations for all Ahsay products are available at:
https://www.ahsay.com/jsp/en/home/index.jsp?pageContentKey=ahsay_downloads_documentation
_guides
You can send us suggestions for improvements or report on issues in the documentation, by
contacting us at:
https://www.ahsay.com/jsp/en/contact/kbQuestion.jsp
Please specify the specific document title as well as the change required/suggestion when
contacting us.
www.bobcloud.net 49
Appendix
Uninstall AhsayOBM (rpm)
1. Under the Applications menu bar on the top of the screen, select System Tools >
Application Installer option.
2. Go to the Installed tab and locate Ahsay Online Backup Manager, click the Remove button
to proceed.
www.bobcloud.net 50
3. Click the Remove button to uninstall the AhsayOBM package.
4. Upon successful uninstallation, the AhsayOBM icon will disappear from the desktop.
www.bobcloud.net 51
Uninstall AhsayOBM (sh)
1. Login to the Linux machine using the root account.
2. Right-click on the desktop and click Open Terminal to launch the application.
3. Go to the /usr/local/obm/bin directory.
# cd /usr/local/obm/bin
4. Uninstall AhsayOBM with the sh command.
# sh uninstall.sh
www.bobcloud.net 52
5. The uninstallation is completed when “Ahsay Online Backup Manager uninstall
procedure is complete!” shows at the end of the script.
# sh uninstall.sh
Log Time: Tue Jan 15 11:05:39 HKT 2019
Verifying current user privilege ...
Current user has enough privilege to "uninstall".
Uninstall Ahsay Online Backup Manager from /usr/local/obm
Shutting down Scheduler
Wait 5 seconds before Scheduler exits
Kill running Ahsay Online Backup Manager
Kill Process by Image Name: /usr/local/obm/jvm/bin/bJW
Ignore Process by Image Name:
Kill Process by Image Name: /usr/local/obm/jvm/bin/bschJW
Ignore Process by Image Name:
Kill Process by Image Name: /usr/local/obm/jvm/bin/java
Ignore Process by Image Name:
Removing Scheduler script obmscheduler from service
Uninstall Service for NIX type OS
Using init script path /etc/init.d
Using run level script path /etc/rc.d
Removing symbolic link from run levels
Removing script file obmscheduler from /etc/init.d
Remove shortcut /usr/share/applications/obm.desktop
Remove shortcut /root/Desktop/obm.desktop
Ahsay Online Backup Manager uninstall procedure is complete!
It is now safe to remove files from /usr/local/obm
6. Upon successful uninstallation, the AhsayOBM icon will disappear from the desktop.
www.bobcloud.net 53
Uninstall AhsayOBM (deb)
1. Login as root on Ubuntu GUI. (Alternatively, you can remotely invoke the GUI of another
Ubuntu machine using SSH client.)
2. Go to your Package Installer.
www.bobcloud.net 54
3. Click on File > Open > Downloads and select the AhsayOBM file you downloaded.
4. When the following message appears, click Remove Package to proceed.
5. Upon successful uninstallation, this will be the message and the AhsayOBM icon will
disappear from the menu.
www.bobcloud.net 55
Handling of Non-regular Files
The following non-regular files/folders such as device files, block files, virtual files systems, pseudo
file systems etc will be automatically ignored if selected for backup. Backup log entries of these
files/folders will not appear in the backup logs.
Example:
/proc
/dev
/sys
/run
For AhsayOBM installations on Linux GUI, these devices will not be shown on the backup source
screen.