www.bobcloud.net

Ahsay Online Backup Manager v8

Quick Start Guide for Linux (CLI)

Ahsay Systems Corporation Limited

22 May 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

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, 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, 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, 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

11 December

2018

Added OpenJDK and GNU LIBC requirement in

Ch. 1.2; Updated screen shots in Ch. 5.1

Modification

22 January 2019

Updated Software Compatibility link in Ch. 1;

Modified instructions on how to create a backup

set using AhsayCBS in Ch. 5.1; Updated screen

shot in Appendix H

Modification

www.bobcloud.net

Table of Contents

1 System Requirements.....................................................................................................................1

1.1 Supported Platforms ..................................................................................................................1

1.2 Linux Packages .........................................................................................................................1

2 Getting started ................................................................................................................................2

3 Download and Install AhsayOBM ...................................................................................................3

3.1 Online Installation ......................................................................................................................4

3.1.1 rpm......................................................................................................................................4

3.1.2 sh ........................................................................................................................................6

3.1.3 dpkg (Ubuntu) .....................................................................................................................8

3.2 Offline Installation ....................................................................................................................10

3.3 AhsayOBM Scheduler Service Check .....................................................................................12

3.4 RunLevel Symlink Check.........................................................................................................12

4 Starting AhsayOBM ......................................................................................................................13

5 Creating a File Backup Set ...........................................................................................................14

5.1 Using AhsayCBS .....................................................................................................................14

5.2 Using ssh .................................................................................................................................25

6 Overview on the Backup Process .................................................................................................29

7 Running Backup Jobs ...................................................................................................................30

8 Restoring Data ..............................................................................................................................32

9 Technical Assistance ....................................................................................................................37

10 Documentation..............................................................................................................................38

Appendix...............................................................................................................................................39

Appendix A File Backup Set XML Template (Raw)......................................................................39

Appendix B File Backup Set XML Template (with explanation) ...................................................46

Appendix C Example File Backup Set Setting..............................................................................56

Appendix D Uninstall AhsayOBM (rpm)........................................................................................58

Appendix E Uninstall AhsayOBM (sh)..........................................................................................59

Appendix F Uninstall AhsayOBM (dpkg)......................................................................................60

Appendix G Handling of Non-regular Files ...................................................................................61

Appendix H How to Create a File Backup Set in Predefined Destination.....................................62

www.bobcloud.net 1

1 System Requirements

1.1 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

1.2 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 AhsayCBS

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

2 Getting started

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

3.1 Online Installation

3.1.1 rpm

1. Login to the Linux machine via a ssh client using the root account.

2. To download the AhsayOBM rpm installation package file from your backup service

provider’s website:

3. Go to the download page and right click on Download (rpm) (Online) button to copy the

URL of the AhsayOBM installer.

4. Use the curl command to download the AhsayOBM installer from your backup service

provider’s website onto the Linux machine.

# curl -Ok https://10.16.30.21/cbs/download/obm-linux-noarch-

443-10.16.30.21-https-0O.rpm

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 7719 100 7719 0 0 4377 0 0:00:01 0:00:01

--:--:-- 4726

5. Run the rpm command to install AhsayOBM.

# rpm -i obm-linux-noarch-443-10.16.30.21-https-0O.rpm

Start install obm

Log Time: Mon Jan 14 18:35:12 HKT 2019

Checking host address... rpm -i obm-linux-noarch-443-

10.90.10.12-https-0O.rpm

Host address: https://10.90.10.12:443

Downloading file... jre-std-linux-amd64.tar.gz

www.bobcloud.net 5

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 91.3M 100 91.3M 0 0 2717k 0 0:00:34 0:00:34

--:--:-- 10.9M

Download file completed

.

Downloading file... app-inst-nix-obm.tar.gz

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 172k 100 172k 0 0 762k 0 --:--:-- --:--:--

--:--:-- 774k

Download file completed

Untar component file to /tmp/_obm.190114183512

Downloading file... aua-inst-nix-obm.tar.gz

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 54564 100 54564 0 0 240k 0 --:--:-- --:--:--

--:--:-- 254k

Download file completed

Untar component file to /tmp/_obm.190114183512

No old application found, begin fresh install

Install Application Path: /usr/local/obm

Done

Install obm finished

6. Check if AhsayOBM is installed properly.

# rpm -qi obm

Name : obm

Version : 8.1.0.10

Release : 0

Architecture: noarch

Install Date: Mon 14 Jan 2019 06:35:11 PM HKT

Group : Applications/System

Size : 22442

License : GPLv2+

Signature : (none)

Source RPM : obm-8.1.0.10-0.src.rpm

Build Date : Sat 12 Jan 2019 02:37:56 PM HKT

Build Host : cxb-cos6x.releng.dev.test

Relocations : (not relocatable)

URL : www.ahsay.com

Summary : Ahsay Online Backup Manager

Description :

Ahsay Online Backup Manager

www.bobcloud.net 6

3.1.2 sh

1. Login to the Linux machine via a ssh client using the root account.

2. Create a new directory to install AhsayOBM.

# mkdir -p /usr/local/obm

# cd /usr/local/obm

3. Download the AhsayOBM sh installation script file from your backup service provider’s

website:

4. Go to the download page and right click on Download (sh) (Online) button, then Copy

Link Address to copy the URL of the AhsayOBM installer.

5. Execute the curl command with the copied URL to download the AhsayOBM installer

from onto the Linux machine.

# curl -Ok https://10.120.10.12/cbs/download/obm-nix-443-

10.120.10.12-https-0O.sh?dlName=obm-linux-443-10.120.10.12-

https-0O.sh

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 17971 100 17971 0 0 9568 0 0:00:01 0:00:01

--:--:-- 9735

6. Rename the file by removing everything starting from the "?" character, from:

obm-nix-443-10.120.10.12-https-0O.sh?dlName=obm-linux-443-10.120.10.12-https-

0O.sh

www.bobcloud.net 7

to

obm-nix-443-10.120.10.12-https-0O.sh

7. Add executable permissions to the AhsayOBM install script.

# chmod 755 obm-nix-443-10.120.10.12-https-0O.sh

8. Execute the AhsayOBM install script. And the installation is completed when Done

shows at the end of the script.

Note: The .sh script file should be placed under the directory path which you want to

install the AhsayOBM application.

# ./obm-nix-443-10.120.10.12-https-0O.sh

Log Time: Mon Jan 14 18:42:40 HKT 2019

Host address: https://10.120.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 91.3M 100 91.3M 0 0 3672k 0 0:00:25 0:00:25

--:--:-- 12.0M

Download file completed

Untar component file to /tmp/_obm.190114184240/jvm

Downloading file... app-common.tar.gz

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 34.9M 100 34.9M 0 0 1126k 0 0:00:31 0:00:31

--:--:-- 4478k

Download file completed

.

Untar component file to /tmp/_obm.190114184240

Downloading file... aua-inst-nix-obm.tar.gz

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 54564 100 54564 0 0 329k 0 --:--:-- --:--:--

--:--:-- 330k

Download file completed

Untar component file to /tmp/_obm.190114184240

No old application found, begin fresh install

Install Application Path: /usr/local/obm

Done

www.bobcloud.net 8

3.1.3 dpkg (Ubuntu)

1. Login to the Ubuntu Linux machine via a ssh client using the root account.

2. To download the AhsayOBM deb package file from your backup service provider’s website:

3. Go to the download page and right click on Ubuntu [Download] button to copy the URL of

the AhsayOBM deb package installer.

4. Use the curl command to download the AhsayOBM installer from your backup service

provider’s website onto the Ubuntu Linux machine.

# curl -Ok https://10.16.30.68/cbs/download/obm-debian-noarch-

443-10.16.30.68-https-0O.deb?dlName=obm-ubuntu-noarch-443-

10.16.30.68-https-0O.deb

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 5768 100 5768 0 0 236 0 0:00:24 0:00:24 -

-:--:-- 237

5. Rename the file by removing everything starting from the "?" character, from:

obm-debian-noarch-443-10.16.30.68-https-0O.deb?dlName=obm-ubuntu-noarch-443-

10.16.30.68-https-0O.deb

to

obm-debian-noarch-443-10.16.30.68-https-0O.deb

6. Use dpkg –i to install AhsayOBM.

www.bobcloud.net 9

# dpkg -i obm-debian-noarch-443-10.16.30.68-https-0O.deb

Selecting previously unselected package obm.

(Reading database ... 210408 files and directories currently

installed.)

Preparing to unpack obm-debian-noarch-443-10.16.30.68-https-

0O.deb ...

Unpacking obm (8.1.0.10) ...

Setting up obm (8.1.0.10) ...

Start install obm

Log Time: Tue Jan 15 09:23:52 HKT 2019

Checking host address... dpkg -i obm-debian-noarch-443-

10.16.30.68-https-0O.deb

Host address: https://10.16.30.68: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 36.9M 100 36.9M 0 0 18.6M 0 0:00:01 0:00:01 -

-:--:-- 18.6M

Download file completed

.

Untar component file to /tmp/_obm. 181227113558

Downloading file... aua-inst-nix-obm.tar.gz

% Total % Received % Xferd Average Speed Time Time

Time Current

Dload Upload Total Spent

Left Speed

100 49002 100 49002 0 0 899k 0 --:--:-- --:--:-- -

-:--:-- 902k

Download file completed

Untar component file to /tmp/_obm. 181227113558

No old application found, begin fresh install

Install Application Path: /usr/local/obm

Done

Install obm finished

7. To check the status of the installation use dpkg –s obm

# dpkg -s obm

Package: obm

Status: install ok installed

Priority: optional

Section: utils

Installed-Size: 204800

Maintainer: Ahsay Systems Corporation <support-kb@ahsay.com>

Architecture: all

Version: 8.1.0.10

Description: Ahsay Online Backup Manager

Ahsay Online Backup Manager

www.bobcloud.net 10

3.2 Offline Installation

1. Login to the Linux machine via a ssh client using the root account.

2. Create a new directory to install AhsayOBM.

# mkdir -p /usr/local/obm

# cd /usr/local/obm

3. Download the AhsayOBM *.tar.gz file from your backup service provider’s website:

4. Go to the download page and right click on Download (sh) (Offline) button to copy the

URL of the AhsayOBM installer.

5. Use the wget command to download the AhsayOBM installer from your backup service

provider’s website onto the Linux machine.

# wget --no-check-certificate

https://10.120.10.30/cbs/download/obm-linux.tar.gz

--2017-10-17 17:30:48-- https://10.120.10.30/cbs/download/obm-

linux.tar.gz

Connecting to 10.120.10.30:443... connected.

WARNING: cannot verify 10.120.10.30’s certificate, issued by

“/C=CN/ST=Hong Kong (SAR)/L=Hong Kong/O=Ahsay System

Corporation Limited/OU=Information System

Department/CN=Ahsay System Corporation

Limited/emailAddress=ca@ahsay.com”:

Self-signed certificate encountered.

WARNING: certificate common name “Not Secure” doesn't match

requested host name “10.120.10.30”.

HTTP request sent, awaiting response... 200 OK

Length: unspecified [application/octet-stream]

Saving to: “obm-linux.tar.gz”

www.bobcloud.net 11

[ <=> ] 243,655,268

1.23MB/s in 7m 16s

2019-01-15 10:33:58 (546 KB/s) - ‘obm-linux.tar.gz’ saved

[243655268]

6. Use the tar command to extract the individual components from the tarball.

# tar xvzf obm-linux.tar.gz

app.pkg/version.txt

app.pkg/app-common.tar.gz

app.pkg/app-native-nix-x64.tar.gz

app.pkg/app-native-nix-x86.tar.gz

app.pkg/app-nix-obm.tar.gz

app.pkg/aua-common.tar.gz

app.pkg/aua-native-nix-x64.tar.gz

app.pkg/aua-native-nix-x86.tar.gz

app.pkg/aua-nix-obm.tar.gz

app.pkg/util-common.tar.gz

app.pkg/util-nix-obm.tar.gz

app.pkg/properties-common.tar.gz

app.pkg/app-inst-nix-obm.tar.gz

app.pkg/aua-inst-nix-obm.tar.gz

app.pkg/jre-std-linux-amd64.tar.gz

app.pkg/jre-std-linux-x86-586.tar.gz

obm-linux.sh

7. Run the obm-linux.sh script to install AhsayOBM.

# sh obm-linux.sh

Log Time: Tue Jan 15 10:35:02 HKT 2019

Using package in /usr/local/obm/app.pkg

Package version: 8.1.0.10

Untar jre-std-linux-amd64.tar.gz to /tmp/_obm.190115103502/jvm

Untar app-common.tar.gz to /tmp/_obm.190115103502

Untar app-native-nix-x64.tar.gz to /tmp/_obm.190115103502

Untar app-nix-obm.tar.gz to /tmp/_obm.190115103502

Untar aua-common.tar.gz to /tmp/_obm.190115103502

Untar aua-native-nix-x64.tar.gz to /tmp/_obm.190115103502

Untar aua-nix-obm.tar.gz to /tmp/_obm.190115103502

Untar util-common.tar.gz to /tmp/_obm.190115103502

Untar util-nix-obm.tar.gz to /tmp/_obm.190115103502

Untar properties-common.tar.gz to /tmp/_obm.190115103502

Untar app-inst-nix-obm.tar.gz to /tmp/_obm.190115103502

Untar aua-inst-nix-obm.tar.gz to /tmp/_obm.190115103502

No old application found, begin fresh install

Install Application Path: /usr/local/obm

Done

When completed successfully AhsayOBM will be installed in the following location

/usr/local/obm.

www.bobcloud.net 12

3.3 AhsayOBM Scheduler Service Check

The AhsayOBM scheduler service is used to kick automated or scheduled backup jobs, to

check if the AhsayOBM scheduler service is running use the ps command.

# ps -f|grep java

root 11569 1 9 10:35 pts/0 00:00:09

/usr/local/obm/jvm/bin/bschJW -Xms128m -Xmx768m -

Dsun.nio.PageAlignDirectMemory=true -Djava.library.path=. -

cp .:./cbs.jar cbs /usr/local/obm

root 11676 10144 0 10:37 pts/0 00:00:00 grep --color=auto

java

1. To manually start the scheduler service use the /usr/local/obm/bin/Scheduler.sh script.

2. To manually stop the scheduler service use the /usr/local/obm/bin/StopScheduler.sh

script.

3.4 RunLevel Symlink Check

During installation the following symlinks to the scheduler startup script

/etc/init.d/obmscheduler will be created for Runlevels 2 to 5, to allow the AhsayOBM

scheduler service to be started up automatically each time after the Linux machine is

rebooted or restarted.

To verify the symlinks have been created correctly:

Example: Ubuntu 16.04 LTS

# ls -la /etc/rc[2-5].d/*obm*

lrwxrwxrwx 1 root root 24 Jan 10 17:09 /etc/rc2.d/S99obmscheduler -

> /etc/init.d/obmscheduler

lrwxrwxrwx 1 root root 24 Jan 10 17:09 /etc/rc3.d/S99obmscheduler -

> /etc/init.d/obmscheduler

lrwxrwxrwx 1 root root 24 Jan 10 17:09 /etc/rc4.d/S99obmscheduler -

> /etc/init.d/obmscheduler

lrwxrwxrwx 1 root root 24 Jan 10 17:09 /etc/rc5.d/S99obmscheduler -

> /etc/init.d/obmscheduler

#

Example: CentOS 7

# ls -la /etc/rc.d/rc[2-5].d/*obm*

lrwxrwxrwx. 1 root root 24 Jan 15 10:35

/etc/rc.d/rc2.d/S99obmscheduler -> /etc/init.d/obmscheduler

lrwxrwxrwx. 1 root root 24 Jan 15 10:35

/etc/rc.d/rc3.d/S99obmscheduler -> /etc/init.d/obmscheduler

lrwxrwxrwx. 1 root root 24 Jan 15 10:35

/etc/rc.d/rc4.d/S99obmscheduler -> /etc/init.d/obmscheduler

lrwxrwxrwx. 1 root root 24 Jan 15 10:35

/etc/rc.d/rc5.d/S99obmscheduler -> /etc/init.d/obmscheduler

www.bobcloud.net 13

4 Starting AhsayOBM

To startup AhsayOBM and connect to AhsayCBS you need to use the RunConfigurator.sh

script, to configure the backup server URL, port and proxy server settings (if applicable) and

enter the user id and password.

Please contact your backup service provider to obtain your user login and password

and backup server URL settings.

# cd /usr/local/obm/bin

# sh RunConfigurator.sh

Startup Ahsay Online Backup Manager ...

User Configuration file not found

Create a new Configuration file at directory

[/root/.obm/config]

Login Menu (No configuration files found)

-----------------------------------------

(1). Login

(2). Free Trial

(3). Quit

-----------------------------------------

Your Choice: 1

Backup Server URL : 10.20.1.46

Port : 443

Protocol? (1) Http (2) Https : 2

Enable Proxy (Y/N) ? N

Login Name : your_username

Password : *******************

Please wait while verifying user account with server...

log4j:WARN No appenders could be found for logger

(org.apache.http.impl.conn.PoolingClientConnectionManager).

log4j:WARN Please initialize the log4j system properly.

log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig

for more info.

Your account (a1) is found on server (10.20.1.46:443).

New configuration file has been created

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice:

www.bobcloud.net 14

5 Creating a File Backup Set

There are two ways to create a File Backup Set. One is to create it using AhsayCBS while

another way is through ssh.

5.1 Using AhsayCBS

Initial backup set preferences may be configured using AhsayCBS then the Encryption settings

will be added once you log in AhsayOBM using ssh.

1. Log in to AhsayCBS and go to User.

www.bobcloud.net 15

2. Click Create to create a backup set.

3. Input the name and select the Type. Click Next.

4. For Linux, the folders under Select the items and folders that you want to backup

are not applicable so you can specify the backup source in the Other Selected Source

part. You can also choose if filters will be applied to the backup source. By default it is

turned off.

www.bobcloud.net 16

You can choose to apply filters by sliding the lever to the right. Then click the Create

button to set your filter preferences.

Add Other Selected Source by clicking the Create button.

Input the path of the source to be backed up. Click Add button to add the source. Keep

doing this until all backup source are added.

To exclude a source, you can add it under Deselected Source by clicking the Create

button.

Note: Some folders are automatically not included for backup. Please refer to Appendix

G for more information on these ignored folders.

www.bobcloud.net 17

Input the path of the source to be excluded in the backup. Click Add button to add the

deselected source. Keep doing this until all source to be excluded are added. Click

Next.

5. The Run scheduled backup for this backup set is turned on by default. If you do not

want to create a backup schedule you can turn it off by sliding the lever to the left. By

default there is already a backup schedule created that is scheduled to run daily at 8pm

until full backup is completed. This schedule may either be edited or deleted if you want

to create your own backup schedule.

Note: It is optional to input the computer name in the Run scheduled backup on

computers named field since it will be updated once backup set creation is completed

in AhsayOBM client. In Step 17, the computer name can be checked there as the Owner.

www.bobcloud.net 18

6. Input the Name for the backup schedule. Select the type whether Daily, Weekly,

Monthly or Custom. For the Daily, select the time back up will start.

For the Weekly, select the day of the week and time the backup will start.

For the Monthly, select the day of the month and time backup will start. You can also

create a schedule where you will choose the week and day of the week the backup will

start e.g. every First Sunday of every month

www.bobcloud.net 19

For Custom, you can specify the exact date and time the backup will start.

Also select when backup will stop. If until full backup completed is chosen, the

backup will run until all the files and folder in the selected source is backed up.

If after is chosen, you need to specify the number of hours the backup will run. Note that

even if the backup is not yet finished it will stop on the specified hour. Check the box if

you opt to Run Retention Policy after backup. Click the Add button to create the

backup schedule. Then click Next.

7. Select the Backup Mode if Concurrent or Sequential. By default Sequential is selected

since only one backup set is being created. In Sequential backup mode, if there are

multiple destinations configured in the backup set, AhsayOBM will backup to one

destination at a time. In Concurrent backup mode, 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 20

If Concurrent is selected, specify the maximum number of backup destinations.

Add a destination by clicking the Create button. Select the destination that you want to

add then click the Add button.

Standard and Predefined Destination may be added here. Note that a Predefined

Destination must be set up by your service provider before you can add it here. Then

click Next.

www.bobcloud.net 21

8. Uncheck the box to disable OpenDirect since it is not supported in Linux. Then click

Next.

9. Leave the Domain Name / Host Name and User name fields blank since Windows User

Authentication is not supported in Linux. Click Save to create the Backup Set.

www.bobcloud.net 22

10. Click on the backup set you just created.

Go to Others and input the path of your temporary directory. Check the box beside

Remove temporary files after backup if you want it removed. You can also change

the settings for Follow Link and Compressions.

11. Open ssh session in the Linux machine and execute the RunConfigurator.sh script. The

Login Menu will be displayed. Select (1). Login then press Enter to login. Input your

Login Name and Password. Set the encryption setting for the backup set.

# sh RunConfigurator.sh

Startup Ahsay Online Backup Manager ...

Config file found

Login Menu

www.bobcloud.net 23

----------

(1). Login

(2). Change Network Settings

(3). Forgot Password

(4). Quit

----------

Your Choice: 1

Login Name : LinuxGuide

Password : *******************

Please wait while verifying user account with server...

log4j:WARN No appenders could be found for logger

(org.apache.http.impl.conn.PoolingClientConnectionManager).

log4j:WARN Please initialize the log4j system properly.

log4j:WARN See

http://logging.apache.org/log4j/1.2/faq.html#noconfig for more

info.

Your profile has been downloaded and updated.

Encryption setting has not been defined for backup set "b1"

Do you want to set the encryption setting for this backup set?

(Y/N) ? y

Enable Encryption (Y/N) ? y

Choose Encryption Type

----------------------

(1). Default

(2). User password

(3). Custom

----------------------

Your Choice: 2

12. Check if Encryption Key was successfully added.

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice: 1

Select a Backup Set to show more details

----------------------------------------

(1). b1

----------------------------------------

Your Choice: 1

Name : b1

Owner : centos7

Type : FILE

Selected Source : /root/Documents

www.bobcloud.net 24

Deselected Source : /root/.obm

Deselected Source : /usr/local/obm

Deselected Source : /root/tmp

Destination Name : AhsayCBS, Type: OBS

Encryption Key : abc123$%

Encryption Algorithm : AES

Encryption Mode : CBC

Encryption Key Length: 256

Press Enter to continue...

13. Check in AhsayCBS web console if the Encyption setting was successfully added.

www.bobcloud.net 25

5.2 Using ssh

1. To create a File backup set select (5). Generate new Backup Set Settings Template

from the menu.

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice: 5

2. Select (1). File to generate a File Backup Set template file to the /root/.obm/config

directory.

Choose a template from a backup set type

----------------------------------------

(1). File

(2). MySQL Database

(3). Oracle Database Server

(4). IBM Domino

----------------------------------------

Your Choice: 1

XML file successfully exported to

/root/.obm/config/backupSet.xml

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice:

3. Configuring Backup Set Settings.

To configure the backup set setting you need to edit the

/root/.obm/config/backupSet.xml file using a text editor, for example vi

You can either quit the RunConfigurator.sh script or open a new ssh session to edit the

backupSet.xml file.

Please refer to Appendix A, B, and C for details and examples on how to create a

backup sets using the backupSet.xml file.

www.bobcloud.net 26

Notes:

i. Before importing the backupSet.xml file please remove any unused destinations and

backup schedule settings. Otherwise the following error will be displayed "Failed to

import XML file (Reason: Value of Name is empty!)" when trying to import the

backupSet.xml file.

ii. Setup of the following cloud storage destinations; OneDrive, OneDrive For Business,

DropBox, and Google Drive are not supported in Linux CLI environment, as these

cloud storage destinations require authentication using a web browser.

4. Importing the updated backupSet.xml file to AhsayOBM

After you have edited the backupSet.xml file with your chosen backup settings you need

to import the settings back to AhsayOBM so they can be uploaded to AhsayCBS backup

server in order to create the backup set.

For example: to create a new file backup set called “b4” with encryption enabled and

default encryption settings.

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice: 4

-----------------

The backup set "b4" is not owned by this computer, do you want

to take the ownership? (Y/N) ? Y1

New backup set created.

Enable Encryption (Y/N) ? Y

Use default encryption settings (Y/N) ? Y

XML imported, uploading to server...

XML successfully uploaded to server

5. Verify the Backup Set Settings

To verify the uploaded backup set settings are correct select (1). List Backup Sets and

then select the backup you wish to verify, for example backup set name b4.

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice: 1

www.bobcloud.net 27

Select a Backup Set to show more details

----------------------------------------

(1). b4

----------------------------------------

Your Choice: 1

Name : b4

Owner : centos7

Type : FILE

Selected Source : /root/Documents

Deselected Source : /root/.obm

Deselected Source : /usr/local/obm

Deselected Source : /root/tmp

Destination Name : AhsayCBS, Type: OBS

Encryption Key :

qtph1g3uNVfoYkuZN0MpsPNf3ct3cCBgFI0CAlb3LC4=

Encryption Algorithm : AES

Encryption Mode : CBC

Encryption Key Length: 256

Press Enter to continue...

Congratulations! The backup set configuration is now complete!

Notes:

i. We would like to stress that it is very important to keep a separate record of your

encryption key in a safe place, as you will not be able to restore your data without the

correct encryption key.

ii. If you re-install AhsayOBM or install AhsayOBM on another machine the encryption

will be required for restoring data from the backup set.

6. Verify the Backup Schedule

To verify the scheduled backup settings are correct, check the AhsayOBM scheduler log

(debug.log) located in /root/.obm/log/Scheduler folder.

# cat /root/.obm/log/Scheduler/debug.log

[2019/01/10 18:10:10][info] Scheduler Version='8.0.5.0'

[2019/01/10 18:10:10][info] OS Name='Linux 3.10.0-

514.10.2.el7.x86_64' Version='3.10.0-514.10.2.el7.x86_64'

[2019/01/10 18:10:10][info] Java Vendor='Oracle Corporation'

Version='1.8.0_181'

[2019/01/10 18:10:10][info] Computer Name='centos7'

[2019/01/10 18:10:10][info] User='LinuxGuide''

[2019/01/10 18:10:10][info] Starting UserScheduler ...

[2019/01/10 18:10:10][info] UserScheduler started.

[2019/01/10 18:40:37][info] [b1 (1547115965123)] Start

scheduler.

[2019/01/10 18:40:37][info] Profile is reloaded from server.

Reloading scheduler ... Completed

[2019/01/10 18:40:37][info] [b1 (1547115965123)] Next backup

will run in 1 hr 19 min 22 sec.

[2019/01/10 18:45:28][info] Reloading profile...

[2019/01/10 18:45:28][info] Reloading profile... Completed

www.bobcloud.net 28

[2019/01/10 18:45:28][info] Profile is updated. Reloading

scheduler ...

[2019/01/10 18:45:28][info] [b1 (1547115965123)] Next backup

will run in 1 hr 14 min 31 sec.

[2019/01/10 18:45:28][info] Profile is updated. Reloading

scheduler ... Completed

[2019/01/10 18:45:59][info] Reloading profile...

[2019/01/10 18:45:59][info] Reloading profile... Completed

[2019/01/10 18:45:59][info] Profile is updated. Reloading

scheduler ...

[2019/01/10 18:45:59][info] [b1 (1547115965123)] Next backup

will run in 1 hr 14 min 0 sec.

[2019/01/10 18:45:59][info] Profile is updated. Reloading

scheduler ... Completed

[2019/01/10 18:50:59][info] Loading profile...

[2019/01/10 18:50:59][info] Loading profile from server ...

[2019/01/10 18:51:00][info] Loading profile from server ...

Completed

[2019/01/10 18:51:00][info] Loading profile... Completed

[2019/01/10 18:51:00][info] Profile is reloaded from server.

Reloading scheduler ...

[2019/01/10 18:51:00][info] [b1 (1547115965123)] Next backup

will run in 1 hr 8 min 59 sec.

[2019/01/10 18:51:00][info] Profile is reloaded from server.

Reloading scheduler ... Completed

The AhsayOBM scheduler service connects to the AhsayCBS backup server every 5

minutes to retrieve the latest profile updates. It will display a countdown of when the

scheduled backup job(s) will be kicked off.

www.bobcloud.net 29

6 Overview on the Backup Process

The following steps are performed during a file backup job.

www.bobcloud.net 30

7 Running Backup Jobs

Use the RunBackupSet.sh script to start a backup job manually.

# cd /usr/local/obm/bin

# sh RunBackupSet.sh “b1”

-

Using APP_HOME : /usr/local/obm

Using SETTING_HOME :

Using JAVA_HOME : /usr/local/obm/jvm

Using JAVA_EXE : /usr/local/obm/jvm/bin/java

Using JAVA_OPTS : -Xrs -Xms128m -Xmx768m -client -

Dsun.nio.PageAlignDirectMemory=true

Using JNI_PATH : -Djava.library.path=.

Using CLASSPATH : .:./cb.jar

-

Running Backup Set - 'b1' ...

log4j:WARN No appenders could be found for logger

(org.apache.http.impl.conn.PoolingClientConnectionManager).

log4j:WARN Please initialize the log4j system properly.

log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig

for more info.

[2019/01/15 10:44:41] [info] [-] Start [ Linux 3.10.0-

514.10.2.el7.x86_64 (centos7), AhsayOBM v8.1.0.10 ]

[2019/01/15 10:44:48] [info] [-] Saving encrypted backup set

encryption keys to server...

[2019/01/15 10:44:54] [info] [1547519443172] Start Backup ... [In-

File Delta: Incremental]

[2019/01/15 10:44:54] [info] [1547519443172] Using Temporary

Directory /root/tmp/1547518835780/OBS@1547519443172

[2019/01/15 10:44:54] [info] [-] Start running pre-commands

[2019/01/15 10:44:54] [info] [-] Finished running pre-commands

[2019/01/15 10:44:55] [info] [1547519443172] Downloading server file

list...

[2019/01/15 10:44:57] [info] [1547519443172] Downloading server file

list... Completed

[2019/01/15 10:44:59] [info] [1547519443172] Reading backup source

from hard disk...

[2019/01/15 10:45:00] [info] [1547519443172] [New Directory]... /

[2019/01/15 10:45:01] [info] [1547519443172] Reading backup source

from hard disk... Completed

[2019/01/15 10:45:01] [info] [1547519443172] [New Directory]... /root

[2019/01/15 10:45:01] [info] [1547519443172] [New Directory]...

/root/Documents

[2019/01/15 10:45:01] [info] [1547519443172] [New Directory]... /usr

[2019/01/15 10:45:01] [info] [1547519443172] [New Directory]...

/usr/local

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing.txt"

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing1.txt"

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing2.txt"

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing3.txt"

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing4.txt"

[2019/01/15 10:45:01] [info] [1547519443172] [New File]... 100% of

"/root/Documents/File snapshot testing5.txt"

[2019/01/15 10:45:03] [info] [1547519443172] Total New Files = 6

www.bobcloud.net 31

[2019/01/15 10:45:03] [info] [1547519443172] Total New Directories =

5

[2019/01/15 10:45:03] [info] [1547519443172] Total New Links = 0

[2019/01/15 10:45:03] [info] [1547519443172] Total Updated Files = 0

[2019/01/15 10:45:03] [info] [1547519443172] Total Deleted Files = 0

[2019/01/15 10:45:03] [info] [1547519443172] Total Deleted

Directories = 0

[2019/01/15 10:45:03] [info] [1547519443172] Total Deleted Links = 0

[2019/01/15 10:45:03] [info] [1547519443172] Total Moved Files = 0

[2019/01/15 10:45:04] [info] [1547519443172] Saving encrypted backup

file index to 1547518835780/blocks at destination AhsayCBS...

[2019/01/15 10:45:05] [info] [1547519443172] Saving encrypted backup

file index to 1547518835780/blocks/2019-01-15-10-44-18 at destination

AhsayCBS...

[2019/01/15 10:45:06] [info] [-] Start running post-commands

[2019/01/15 10:45:06] [info] [-] Finished running post-commands

[2019/01/15 10:45:09] [info] [1547519443172] Deleting temporary file

/root/tmp/1547518835780/OBS@1547519443172

[2019/01/15 10:45:09] [info] [1547519443172] Backup Completed

Successfully

www.bobcloud.net 32

8 Restoring Data

1. To restore files that have been backed up from your backup destination, you need to use

the Restore.sh script by using a text editor like vi to configure the restore settings like:

Backup Set Name -> BACKUP_SET=""

Backup Destination -> DESTINATION=""

Location of Restored Files -> RESTORE_TO=""

Files/Folders to be Restored -> RESTORE_FROM=""

Snapshot to be restored ->POINT_IN_TIME=""

Applying the original permission to the restore files ->RESTORE_PERMISSION=""

Verifying in-file delta file checksum during restore ->VERIFY_CHKSUM=””

# cd /usr/local/obm/bin

# vi Restore.sh

#!/bin/sh

##################### Restore.sh

#################################

# You can use this shell script to restore backup files using

command-line. #

# Just customize the "User Define Section" below with values for

your restore #

# action.

#

#################################################################

##

############# Start: User Defined Section

######################

# --------------------- BACKUP_SET ----------------------------

--

# | The name or ID of the backup set that you want to restore.

# | If backup set name is not in English, please use ID instead.

# | e.g. BACKUP_SET="1119083740107"

# | or BACKUP_SET="FileBackupSet-1"

# |

# | You can leave this parameter blank if you have only 1 backup

set.

# ---------------------------------------------------------------

--

BACKUP_SET="b1"

# ------------------- DESTINATION -----------------------------

--

# The name or ID of the backup destination that you want to

restore from.

# If backup destination name is not in English, please use ID

instead.

# | e.g. DESTINATION="1740107119083"

# | or DESTINATION="Destination-1"

# |

# | You can leave this parameter blank if you have only 1

destination.

www.bobcloud.net 33

# ---------------------------------------------------------------

--

DESTINATION="CBS"

# -------------------- RESTORE_TO -----------------------------

--

# | Directory to where you want files to be restored

# | set to "" to restore files to original location

# | e.g. RESTORE_TO="/tmp"

# ---------------------------------------------------------------

--

RESTORE_TO="/root/restored"

# --------------------- RESTORE_FROM --------------------------

-

# | File/Directory on the backup server that you would like to

restore

# | e.g. RESTORE_FROM="/Data"

# ---------------------------------------------------------------

-

RESTORE_FROM="/root/Documents"

# ------------------ POINT_IN_TIME ----------------------------

-

# The point-in-time snapshot (successful backup) that you want to

restore |

# from the backup server. Use "Current" for the latest backup

snapshot |

# e.g. POINT_IN_TIME="2006-10-04-12-57-13"

# or POINT_IN_TIME="Current"

#

# You can retrieve the point in time by using the

ListBackupJob.sh

# ---------------------------------------------------------------

POINT_IN_TIME="Current"

# -------------- RESTORE_PERMISSION ---------------------------

# | set to "Y" if you want to restore file permissions

# | set to "N" if you do NOT want to restore file permissions

# ---------------------------------------------------------------

RESTORE_PERMISSION="N"

# --------------- SKIP_INVALID_KEY ----------------------------

# | set to "Y" if you want to skip restore file with invalid key

# | set to "N" if you do NOT want to enable sync option

# | set to "" to prompt for selection

# ---------------------------------------------------------------

-

SYNC_OPTION="N"

# ------------------ REPLACE_EXISTING_FILE --------------------

-

# set to "--all" to replace all existing file(s) of the same

filename

# set to "--none" to skip all existing file(s) with the same

filename

# set to "" to prompt for selection

# ---------------------------------------------------------------

-

REPLACE_EXISTING_FILE="--all"

# ------------------ SETTING_HOME -----------------------------

-

www.bobcloud.net 34

# | Directory to your setting home.

# | Default to ${HOME}/.obm when not set.

# | e.g. SETTING_HOME="${HOME}/.obm"

# ---------------------------------------------------------------

-

SETTING_HOME=""

# ---------------------------- FILTER -------------------------

-

# Filter out what files you want to restore

# -Pattern=xxx-Type=yyy-Target=zzz

# where xxx is the filter pattern,

# yyy is the filter type, whice can be one of the following:

# [exact | exactMatchCase | contains | containsMatchCase|

|

# startWith | startWithMatchCase | endWith | endWithMatchCase]

|

# zzz is the filter target, which can be one of the following:

# [toFile | toFileDir | toDir]

|

#

# e.g. FILTER="-Pattern=.txt-Type=exact-Target=toFile"

# ---------------------------------------------------------------

--

FILTER=""

# ------------------------- TEMP_DIR --------------------------

--

# | Directory to where you want to store restore files

temporarily

# | set to "" to use the temporary directory in the backup set

# | e.g. TEMP_DIR="/tmp"

# -------------------------------------------------------------

TEMP_DIR="/root/tmp"

# ----------------------------- VERIFY_CHKSUM -----------------

---------------

# | set to "Y" if you want to verify in-file delta file checksum

during restore|

# | set to "N" if you do NOT want to verify in-file delta file

checksum during |

# | restore

|

# ---------------------------------------------------------------

---------------

VERIFY_CHKSUM="N"

################# END: User Defined Section ###################

2. After the Restore.sh script is configured the files can be restored by running the

Restore.sh script.

# cd /usr/local/obm/bin

# sh Restore.sh

Using APP_HOME: : /usr/local/obm

Using BACKUP_SET : b1

Using RESTORE_FROM : /root/Documents

Using RESTORE_TO : /root/restored

Using POINT_IN_TIME : Current

Using RESTORE_PERMISSION : N

Using TEMP_DIR : /root/tmp

www.bobcloud.net 35

Filter Pattern not set, filter would not apply to restore

log4j:WARN No appenders could be found for logger

(org.apache.http.impl.conn.PoolingClientConnectionManager).

log4j:WARN Please initialize the log4j system properly.

log4j:WARN See

http://logging.apache.org/log4j/1.2/faq.html#noconfig for more

info.

[2019-01-15 10:51:51] Start [ Linux 3.10.0-514.10.2.el7.x86_64

(centos7), AhsayOBM v8.1.0.10 ]

[2019-01-15 10:51:51] start,"Start [ Linux 3.10.0-

514.10.2.el7.x86_64 (centos7), AhsayOBM v8.1.0.10 ]",0,0,0,,0,0

[2019-01-15 10:51:51] Initializing decrypt action...

[2019-01-15 10:51:51] Initializing decrypt action... Completed

[2019-01-15 10:51:52] Creating new directory...

"/root/restored/root"

[2019-01-15 10:51:52] Creating new directory...

"/root/restored/root/Documents"

[2019-01-15 10:51:52] Downloading...

"/root/restored/root/Documents/File snapshot testing.txt" (Total

7k bytes)

[2019-01-15 10:51:52] Downloading...

"/root/restored/root/Documents/File snapshot testing1.txt" (Total

7k bytes)

[2019-01-15 10:51:52] Downloading...

"/root/restored/root/Documents/File snapshot testing2.txt" (Total

7k bytes)

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing1.txt,254,7282,1547518334000,,1547520713756,1547520713759

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing.txt,254,7282,1545028063000,,1547520713756,1547520713758

[2019-01-15 10:51:53] Downloading...

"/root/restored/root/Documents/File snapshot testing3.txt" (Total

7k bytes)

[2019-01-15 10:51:53] Downloading...

"/root/restored/root/Documents/File snapshot testing4.txt" (Total

7k bytes)

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing2.txt,254,7282,1547518346000,,1547520713813,1547520713813

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing3.txt,254,7282,1547518351000,,1547520713816,1547520713817

[2019-01-15 10:51:53] Downloading...

"/root/restored/root/Documents/File snapshot testing5.txt" (Total

7k bytes)

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing4.txt,254,7282,1547518363000,,1547520713855,1547520713856

[2019-01-15 10:51:53] file,/root/restored/root/Documents/File

snapshot

testing5.txt,254,7282,1547518367000,,1547520713866,1547520713866

[2019-01-15 10:51:54] Restore Completed Successfully

www.bobcloud.net 36

[2019-01-15 10:51:54] end,RESTORE_STOP_SUCCESS,0,0,0,,0,0

3. Verify the files are restored on the machine.

# ls -la /root/restored/root/Documents/

total 48

drwxr-xr-x. 2 root root 209 Jan 15 10:51 .

drwxr-xr-x. 3 root root 23 Jan 15 10:51 ..

-rwxr-xr-x. 1 root root 7282 Jan 15 10:12 File snapshot

testing1.txt

-rwxr-xr-x. 1 root root 7282 Jan 15 10:12 File snapshot

testing2.txt

-rwxr-xr-x. 1 root root 7282 Jan 15 10:12 File snapshot

testing3.txt

-rwxr-xr-x. 1 root root 7282 Jan 15 10:12 File snapshot

testing4.txt

-rwxr-xr-x. 1 root root 7282 Jan 15 10:12 File snapshot

testing5.txt

-rwxr-xr-x. 1 root root 7282 Dec 17 14:27 File snapshot

testing.txt

www.bobcloud.net 37

9 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

www.bobcloud.net 38

10 Documentation

Documentations for all Ahsay products are available at:

https://www.ahsay.com/jsp/en/home/index.jsp?pageContentKey=ahsay_downloads_document

ation_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 39

Appendix

Appendix A File Backup Set XML Template (Raw)

<?xml version="1.0" encoding="UTF-8"?>

<Value data="" name="Temporary Working Directory"

type="string" />

<Value data="Y" name="Delete temporary files after backup"

type="boolean" />

<!-- GzipBestSpeedCompression: Fast (Compressed size larger

than normal) -->

<!-- Copy and paste the whole <Key> to add more selected

sources -->

</Key>

<!-- Copy and paste the whole <Key> to add more deselected

sources -->

</Key>

<!-- Copy and paste the whole <Key> to add more daily

schedules -->

www.bobcloud.net 40

<Value data="Daily-Schedule" name="Name" type="string"

/>

</Key>

<!-- Copy and paste the whole <Key> to add more weekly

schedules -->

<Value data="Weekly-Schedule" name="Name" type="string"

/>

</Key>

<!-- Copy and paste the whole <Key> to add more monthly

schedules -->

<Value data="Monthly-Schedule" name="Name"

type="string" />

www.bobcloud.net 41

<!-- Set to 0 if you want to use the format of

occurrence + criteria, e.g. Third Wednesday, instead --

>

<!-- If "Schedule Date" is not zero, this value will be

ignored -->

<!-- Sunday / Monday / Tuesday / Wednesday / Thursday /

Friday / Saturday / Weekday / Weekend -->

<!-- If "Schedule Date" is not zero, this value will be

ignored -->

</Key>

<!-- Copy and paste the whole <Key> to add more custom

schedules -->

<Value data="2016-4-30" name="Schedule Date"

type="string" />

</Key>

<!-- Concurrency level is the number of destinations to run

backup concurrently -->

<!-- AhsayCBS destination is where the files are backup to

server -->

</Key>

<!-- Local destination means backup files are stored in

your computer -->

<!-- Copy and paste the whole <Key> to add more local

destinations -->

</Key>

www.bobcloud.net 42

<!-- Copy and paste the whole <Key> to add more Aliyun

destinations -->

<Value data="" name="Access Key Secret" type="string"

/>

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more CTYun

destinations -->

<Value data="" name="Access Secret Key" type="string"

/>

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more AmazonS3

destinations -->

<Value data="" name="Secret Access Key" type="string"

/>

www.bobcloud.net 43

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more

AWSCompatible destinations -->

<Value data="" name="Secret Access Key" type="string"

/>

<!-- Bucket to store backup data (please create this

bucket manually first) -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more

GoogleCloudStorage destinations -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

www.bobcloud.net 44

</Key>

<!-- Copy and paste the whole <Key> to add more Windows

Azure destinations -->

<Value data="" name="Storage Account Name"

type="string" />

</Key>

<!-- Copy and paste the whole <Key> to add more Rackspace

destinations -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more OpenStack

destinations -->

<Value data="5000" name="Keystone Public Port"

type="integer" />

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

<!-- Copy and paste the whole <Key> to add more FTP

destinations -->

www.bobcloud.net 45

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

</Key>

</Setting>

www.bobcloud.net 46

Appendix B File Backup Set XML Template (with

explanation)

This appendix explains all configurable items with their available options, highlighted in red, in this file

backup set XML scripts.

Backup Set Setting

The following items define the basic configurations of the file backup set.

Backup set type – enter the backup set type, for instance, File, MySQL etc.

Backup set name – name your backup set.

Temporary directory for storing backup files – Enter the directory path where you would

like to have the backup files stored temporarily. The temporary directory is used for various

purposes, such as storage of temporary spooled file (for database specific backup type in

AhsayOBM), remote file list, local file list, temporary delta file and other files of temporary

nature.

Remove temporary files after backup – choose whether to remove temporary files after

you finish backup.

Select compression type – choose the backup compression mode among Normal, Fast or

No compression.

Backup files’ permissions – choose whether to backup operating system file permission of

the data selected as backup source.

Follow link of the backup files – choose whether to follow an NTFS junction point or

NTFS symbolic link during backup. When the follow link option is enabled, not only is the

symbolic link or junction point backed up, but directories and files that the junction point links

to will also be backed up.

<?xml version="1.0" encoding="UTF-8"?>

<Value data="" name="Temporary Working Directory"

type="string" />

<Value data="Y" name="Delete temporary files after backup"

type="boolean" />

<!-- GzipBestSpeedCompression: Fast (Compressed size larger

than normal) -->

www.bobcloud.net 47

Selected Source

Enter the file path where the files you would like to backup are located.

<!-- Copy and paste the whole <Key> to add more selected

sources -->

</Key>

Deselected Source

Enter the file path where files you would like to exclude from the backup.

<!-- Copy and paste the whole <Key> to add more deselected

sources -->

</Key>

Schedule Settings

Choose whether you would like backup jobs to be run at the scheduled time you set.

Daily Schedule Settings

Set backup jobs to run daily at the time you specified.

Start hour – the starting hour of the backup, from 0-23.

Start minute – the starting minute of the backup, from 0-59.

Duration of this backup in hours – for how long, in hours, you would like this backup to

run. Set to -1 if you would like the backup job to run until it finishes.

<!-- Copy and paste the whole <Key> to add more daily

schedules -->

<Value data="Daily-Schedule" name="Name" type="string"

/>

www.bobcloud.net 48

</Key>

Weekly Schedule Settings

Set backup jobs to run weekly at the time you specified.

Start hour – the starting hour of the backup, from 0-23.

Start minute – the starting minute of the backup, from 0-59.

Duration of this backup in hours – the duration you would like this backup to perform, in

hours. Set to -1 if you would like the backup job to run until it finishes.

Backup on these days of the week – choose to enable or disable backup on each day in

week.

<!-- Copy and paste the whole <Key> to add more weekly

schedules -->

<Value data="Weekly-Schedule" name="Name" type="string"

/>

</Key>

Monthly Schedule Settings

Set backup jobs to run monthly at the time you specified.

Start hour – the starting hour of the backup, from 0-23.

Start minute – the starting minute of the backup, from 0-59.

Duration of this backup in hours – the duration you would like this backup to perform, in

hours. Set to -1 if you would like the backup job to run until it finishes.

www.bobcloud.net 49

Schedule date of month – set exact date in a month when you would like the backup to

perform. Set to 0 if you would like the backup performed in a specified occurrence + criteria

format, e.g. the third Wednesday in month.

Backup [Occurrence + Criteria] format

You can set the backup to perform on a specified week (Occurrence, First / Second /

Third / Last) and on a specified day of the week (Criteria, Sun thru Sat), for instance, the

third Wednesday in a month.

Backup occurrence – set the week, i.e., First / Second / Third / Last. If you have set

an exact date in the previous “Schedule date of month” configuration, this setting will

be ignored.

Backup criteria – set a day of the week, i.e., Sunday thru Saturday. If you have set an

exact date in the previous “Schedule date of month” configuration, this setting will be

ignored.

<!-- Copy and paste the whole <Key> to add more monthly

schedules -->

<Value data="Monthly-Schedule" name="Name"

type="string" />

<!-- Set to 0 if you want to use the format of

occurrence + criteria, e.g. Third Wednesday, instead --

>

<!-- If "Schedule Date" is not zero, this value will be

ignored -->

<!-- Sunday / Monday / Tuesday / Wednesday / Thursday /

Friday / Saturday / Weekday / Weekend -->

<!-- If "Schedule Date" is not zero, this value will be

ignored -->

</Key>

Custom Schedule Settings

Set backup jobs to run at the date and time you specified.

Start hour – the starting hour of the backup, from 0-23.

Start minute – the starting minute of the backup, from 0-59.

www.bobcloud.net 50

Duration of this backup in hours – the duration you would like this backup to perform, in

hours. Set to -1 if you would like the backup job to run until it finishes.

Date for performing custom schedule backup - enter a specific date when you would like

the backup to perform. The date format should be in YYYY-MM-DD.

<!-- Copy and paste the whole <Key> to add more custom

schedules -->

<Value data="2016-4-30" name="Schedule Date"

type="string" />

</Key>

Destination Settings

Concurrency level – set the number of destinations to run backup job concurrently

AhsayCBS Destination Settings – this option allows backup files to be stored on the

server

Local Destination Settings – this option allows backup files to be stored in your local

computer. Enter the directory path where you would like the backup files to be stored.

<!-- Concurrency level is the number of destinations to run

backup concurrently -->

<!-- AhsayCBS destination is where the files are backup to

server -->

</Key>

<!-- Local destination means backup files are stored in

your computer -->

<!-- Copy and paste the whole <Key> to add more local

destinations -->

www.bobcloud.net 51

</Key>

Aliyun Destination Settings – if you are using Aliyun as your backup destination, configure

the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more Aliyun

destinations -->

<Value data="" name="Access Key Secret" type="string"

/>

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

CTYun Destination Settings – if you are using CTYun as your backup destination,

configure the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more CTYun

destinations -->

<Value data="" name="Access Secret Key" type="string"

/>

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

AmazonS3 Destination Settings – if you are using AmazonS3 as your backup destination,

configure the login and network settings in this section.

www.bobcloud.net 52

<!-- Copy and paste the whole <Key> to add more AmazonS3

destinations -->

<Value data="" name="Secret Access Key" type="string"

/>

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

AWSCompatible Destination Settings – if you are using AWSCompatible as your backup

destination, configure the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more

AWSCompatible destinations -->

<Value data="" name="Secret Access Key" type="string"

/>

<!-- Bucket to store backup data (please create this

bucket manually first) -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

www.bobcloud.net 53

GoogleCloudStorage Destination Settings – if you are using GoogleCloudStorage as

your backup destination, configure the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more

GoogleCloudStorage destinations -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

Windows Azure Destination Settings – if you are using Windows Azure as your backup

destination, configure the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more Windows

Azure destinations -->

<Value data="" name="Storage Account Name"

type="string" />

</Key>

<!-- Copy and paste the whole <Key> to add more Rackspace

destinations -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

www.bobcloud.net 54

OpenStack Destination Settings – if you are using OpenStack as your backup destination,

configure the login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more OpenStack

destinations -->

<Value data="5000" name="Keystone Public Port"

type="integer" />

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

FTP Destination Settings – if you are using FTP as your backup destination, configure the

login and network settings in this section.

<!-- Copy and paste the whole <Key> to add more FTP

destinations -->

<Value data="N" name="Enable proxy during backup"

type="boolean" />

</Key>

In-file delta setting

In-File delta technology is an advanced data block matching algorithm with the intelligence to pick up

changes (delta) of file content between two files. You can choose between Differential and

Incremental in this setting.

www.bobcloud.net 55

Differential - The delta is generated by comparing with the last uploaded full file only. Delta

generated with this method will grow daily and uses more bandwidth. However, for

restoration, the full file and a single delta is required to be restored and merged.

Incremental - The delta is generated by comparing with the last uploaded full or delta file.

Delta generated with this method is smaller and uses the least bandwidth. However, for

restoration, the full file and all deltas chain up to the required point-in-time are required to be

restored and merged. This is prone to data lost (e.g. broken delta chain).

</Key>

</Setting>

www.bobcloud.net 56

Appendix C Example File Backup Set Setting

Below are the configuration parameters of the file backup set sample.

Backup Set Name

b4

Temporary Working Directory

/tmp

Remove temporary files after backup

Yes

Compress Type

Fast

Backup file permissions

Yes

Follow Sym link

Yes

Daily schedule

10:00 PM run until completed

Destination

CBS

Backup Source

/Templates

Exclude

/root/.obm, /usr/local/obm, /tmp

*Configurable items are highlighted in red.

<?xml version="1.0" encoding="UTF-8"?>

<Value data="/tmp" name="Temporary Working Directory" type="string"

/>

<Value data="Y" name="Delete temporary files after backup"

type="boolean" />

<!-- GzipBestSpeedCompression: Fast (Compressed size larger than

normal) -->

<Value data=" GzipBestSpeedCompression" name="Compression Type"

type="string" />

<!-- Copy and paste the whole <Key> to add more selected sources--

>

</Key>

<!-- Copy and paste the whole <Key> to add more deselected sources

-->

www.bobcloud.net 57

</Key>

</Key>

</Key>

<!-- Copy and paste the whole <Key> to add more daily schedules

-->

<Value data="Daily-Schedule" name="Daily Linux File Backup"

type="string" />

</Key>

<!-- Concurrency level is the number of destinations to run

backup concurrently -->

<!-- AhsayCBS destination is where the files are backup to

server -- >

</Key>

</Key>

</Setting>

www.bobcloud.net 58

Appendix D Uninstall AhsayOBM (rpm)

To uninstall AhsayOBM use the rpm –e command and and then use the rm command to remove the

remaining AhsayOBM files from the machine.

# rpm -e obm

Log Time: Mon Jan 14 18:39:54 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

Remove files in /usr/local/obm

# rm -fr /usr/local/obm

www.bobcloud.net 59

Appendix E Uninstall AhsayOBM (sh)

To uninstall AhsayOBM use the uninstall.sh script and then use the rm command to remove the

remaining AhsayOBM files from the machine.

# /usr/local/obm/bin

# sh uninstall.sh

Log Time: Mon Jan 15 10:19:52 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

# cd /usr/local

# rm -fr /usr/local/obm

www.bobcloud.net 60

Appendix F Uninstall AhsayOBM (dpkg)

To uninstall AhsayOBM on Ubuntu use the dpkg –r obm command to uninstall and the remaining

AhsayOBM machine.

# dpkg -r obm

(Reading database ... 210410 files and directories currently installed.)

Removing obm (8.0.5.0) ...

Log Time: Thu Jan 14 11:06:50 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

Removing symbolic link from run levels

Removing script file obmscheduler from /etc/init.d

Remove shortcut /usr/share/applications/obm.desktop

Ahsay Online Backup Manager uninstall procedure is complete!

It is now safe to remove files from /usr/local/obm

Remove files in /usr/local/obm

# cd /usr/local

# rm -fr /usr/local/obm

www.bobcloud.net 61

Appendix G 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.

www.bobcloud.net 62

Appendix H How to Create a File Backup Set in

Predefined Destination

File backup set in predefined destination can only be created by the user once the service provider

has set up the predefined destination beforehand. This can be created through AhsayCBS and ssh.

Using AhsayCBS

Follow the steps in Chapter 5.1 from 1 – 6.

In Step 7, add the predefined destination. Click [+] to add the predefined destination.

Check the box of the predefined destination and click the Add button.

Continue with steps 8 – 10.

www.bobcloud.net 63

Once the backup set is saved you can check it in AhsayOBM by selecting to List Backup Sets.

Main Menu

---------

(1). List Backup Sets

(2). Delete Backup Set

(3). Export Backup Set Settings to XML

(4). Import Backup Set Settings from XML

(5). Generate new Backup Set Settings Template

(6). Change Language [English]

(7). Update Profile Settings

(8). Quit

---------

Your Choice: 1

Select a Backup Set to show more details

----------------------------------------

(1). predefined

----------------------------------------

Your Choice: 1

Name : predefined

Owner : centos7

Type : FILE

Selected Source : /root/Documents

Deselected Source : /root/.obm

Deselected Source : /usr/local/obm

Deselected Source : /root/tmp

Destination Name : GoogleDrive-1, Type: GDrive

Encryption Key : abc123$%

Encryption Algorithm : AES

Encryption Mode : CBC

Encryption Key Length: 256

Press Enter to continue...

Using ssh

Please refer to the steps in Chapter 5.2 on how to create a backup set using ssh.