Ahsay Cloud Backup Suiteahsay-dn.ahsay.com/document/v7/7500/customer/pdf/guide_cbs_quick... · $ Filepath in Linux/Unix/BSD format ... For cloud setup, please refer to Ahsay Cloud

Ahsay Cloud Backup Suite

V7

Quick Start Guide

Ahsay Systems Corporation Limited

3 December 2015

Ahsay Cloud Backup Suite Quick Start Guide

Ahsay Systems Corporation Limited V7.5.0

Ahsay Cloud Backup Suite

Quick Start Guide

Copyright Notice

© 2015 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 priori 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. Microsoft, Windows, Microsoft Exchange Server and Microsoft SQL Server 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 8i, Oracle 9i, Oracle 10g, Oracle 11g are registered trademarks of Oracle Corporation. Lotus, Domino, Notes are registered trademark of IBM Corporation. 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. Apple and Mac OS X are registered trademarks of Apple Computer, 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.

http://www.apache.org/


Ahsay Systems Corporation Limited V7.5.0

Revision History

Date Description Type of modification

31 Aug 2015 First revision for AhsayCBS Quick Start Guide

New

01 Dec 2015 Update AhsayCBS web console images Update


[Ahsay Systems Corporation Limited i

Table of Contents 1 Overview ............................................................................................................................ 1

1.1 Conventions ............................................................................................................... 1 1.2 Definitions, Acronyms and Abbreviation .................................................................. 1

1.3 System Requirements................................................................................................. 2 2 Quick Start ......................................................................................................................... 3

2.1 Basic setup requirement ............................................................................................. 3 2.2 Install AhsayCBS ....................................................................................................... 3

2.2.1 Windows ................................................................................................................ 3

2.2.2 Linux ...................................................................................................................... 7 2.3 Basic setup and configuration .................................................................................... 9

2.3.1 Activate License..................................................................................................... 9

2.3.2 Setup User Home ................................................................................................. 11 2.3.3 Setup SMTP ......................................................................................................... 12 2.3.4 Create user account .............................................................................................. 15

2.4 Install AhsayOBM/AhsayACB ................................................................................ 20

2.4.1 Install AhsayOBM ............................................................................................... 20 2.4.2 Install AhsayACB ................................................................................................ 28

2.5 Create your first backup set ..................................................................................... 35 2.5.1 Login your AhsayOBM/AhsayACB .................................................................... 35 2.5.2 Create backup set with AhsayOBM ..................................................................... 39

2.5.3 Create backup with AhsayOBM installed on Linux console. .............................. 46 2.5.4 Create backup set with AhsayACB...................................................................... 47

3 Further Information .......................................................................................................... 53


Ahsay Systems Corporation Limited 1

1 Overview

1.1 Conventions

A list of notations that are used throughout this document.

Convention Descriptions Example

Bold Important Information WARNING: You must

check the timestamp of obrA.jar before proceeding

to step2.

Italic Folder Path or File Path /usr/local/obs/conf

[] Graphical Interface Elements [Manage Log]

%% Filepath in Windows format %CBS_HOME%

$ Filepath in Linux/Unix/BSD format

$CBS_HOME

italic Command mkdir /usr/local/cbs

Notation that are used specificially for API section:

Convention Descriptions

<Text Inside angle

brackets>

Placeholder for which you must supply a value.

[Text inside square

brackets]

Optional items.

{Text insides braces} Set of required items; choose one.

Vertical bar (|) Separator for mutually exclusive items; choose one.

Ellipsis (…) Items that can be repeated.

1.2 Definitions, Acronyms and Abbreviation

Term/Abbreviation Definition

AhsayCBS Ahsay™ Cloud Backup Suite

AhsayOBM Ahsay™ Online Backup Manager

AhsayACB Ahsay™ A-Click Backup

CBS_HOME The install location of AhsayCBS.

Windows C:\Program Files\AhsayCBS

Linux/FreeBSD/Solaris /usr/local/cbs/



USER_HOMES The directories where AhsayCBS store the AhsayOBM & AhsayACB users accounts.

The default location is: %CBS_HOME%\users

JAVA_HOME The location where JAVA is installed

1.3 System Requirements

Please refer to the FAQ: Ahsay Software Compatibility List (SCL) for version

7.3 or above (5001) for system requirements of AhsayCBS.

It is recommended to install AhsayCBS on server grade O/S and

hardware platform. For evaluation purposes, the installation on Windows 7 or Windows 8 platforms would be fine.

https://forum.ahsay.com/viewtopic.php?f=169&t=13492

https://forum.ahsay.com/viewtopic.php?f=169&t=13492



2 Quick Start

2.1 Basic setup requirement

Prepare a machine for the Ahsay Cloud Backup Suite (AhsayCBS) with the following specifications:

- Intel® CoreTM i3 or above, Xeon grade CPU preferred

- A 64-bit server grade operating system is preferred, 32-bit operating system could decrease the performance which is not recommended. For example:

o Windows 2008 R2 SP1 or above o CentOS 6 or above

o Red Hat Enterprise Linux 6 or above - 4GB of RAM or above - Disk with redundant setup such as RAID 5 with sufficient hard disk for

your local backup storage. (For cloud storage setup, please refer to Ahsay Cloud Backup Suite Administrator’s guide.)

- The AhsayCBS server is required to access internet and connect our license server lic.ahsay.com using the https protocol. Please ensure the firewall outbound connection settings are enabled and the TLSv1 setting is

allowed.

2.2 Install AhsayCBS

2.2.1 Windows

1. Download the cbs-win.exe from our website.

2. Run the downloaded installer.

3. Choose the language, and then click [OK] to continue.

http://www.ahsay.com/jsp/en/home/index.jsp?pageContentKey=ahsay_downloads_ahsaycbs_v7-download



4. Click [Next] to continue.

5. Read the license agreement. Select “I agree the agreement” if you agree, then click on [Next] to continue the installation.

6. Choose the installation directory, then click [Next] to continue.




8. Enter the ports to be used by AhsayCBS. By default, the ports are 80

and 443 (Http and Https respectively). If these ports have been used by other applications, eg. Microsoft IIS, Apache or other applications. Please use alternative ports such as 8080, 8443, then click [Next] to

continue.



9. Click [Install] to start the installation.

10. Click [Finish] to complete the installation.



2.2.2 Linux

Assumption: ifconfig is already configured on the Linux server.

1. Download the installation file (cbs-nix.tar.gz) from our website.

2. Logon as root user in the Linux machine.

3. Define the directory you would like to install the software by setting

CBS_HOME environment variable. For example, to install AhsayCBS to /usr/local/cbs , please do the followings:

# CBS_HOME=/usr/local/cbs;export CBS_HOME

4. Copy the installation file (cbs-nix.tar.gz) to %CBS_HOME% and untar it.

# mkdir $CBS_HOME

# cp cbs-nix-tar.gz $CBS_HOME

# cd $CBS_HOME

# gunzip cbs-nix.tar.gz

# tar -xf cbs-nix.tar

Once the untar process has completed, please check that the directory

listing is similar to the image below.

5. Install and startup the AhsayCBS service by the following command:

# /usr/local/cbs/bin/install.sh

After executing the command, you should see the following output.

http://www.ahsay.com/jsp/en/home/index.jsp?pageContentKey=ahsay_downloads_ahsaycbs_v7-download



Note: It has been found on some systems, the installation may appear to pause after displaying “Starting AhsayCBS service”. If this occurs,

please press the space bar to complete the installation.

6. AhsayCBS should be started automatically. To verify that, please point your web browser to http://<your-backup-server>/ . For more

information, please refer to the deployment section in our administrator’s guide (will be available soon).



2.3 Basic setup and configuration

2.3.1 Activate License

1. Open the AhsayCBS from your browser eg: http://<your-backup-server>

2. Login the AhsayCBS with the default password, i.e. “system”

3. To activate the license, click on the “License” icon.

4. Applying the license key

i. If you are evaluating the AhsayCBS, you can use the evaluation

license key provided in the page by default and click on [Update] button.

ii. If you have a purchased license, copy and paste the licensee name,

license key into the relavent field, then click on [Update] button.



5. Click [Save] to save the settings on the AhsayCBS.

Note:

If you are using the evaluation license, you will be able to evaluate the AhsayCBS for 60 days. If you need to purchase the license CAL, you can contact our sales for more information.

https://help.ahsay.com/



2.3.2 Setup User Home

Setup a user home in your AhsayCBS to store the user’s information and

backup files in your local location.

1. Click on the blue “Basic” icon on the AhsayCBS main page.

2. In the “User Home” tab, locate the “User Homes” section & click on the

[+] button.

3. Enter the field “Home Directory” and click on the [+] on the bottom right corner when done.

Eg: D:\my_user_home



Note: It is not suggested to store your user home in your system

partition, eg: C:\

4. Click on the [Save] button to save the new user home settings.

Note:

For cloud setup, please refer to Ahsay Cloud Backup Suite Administrator’s

guide.

2.3.3 Setup SMTP

Configure the SMTP so that you can receive reports from the AhsayCBS.

1. Click on the orange “Basic” icon under “System Settings” on AhsayCBS main page.



2. In the “Email Server” tab, locate the “SMTP Server” section.

3. Click on the [+] button.

4. Type in the SMTP mail server settings in the “Host Name” and “Port”.



5. If authenitication is required, check the checkbox next to the “Enable SMTP Authentication” and type in the “Login Name” and “Password”.

6. Option: Check the checkbox “Use secure connection” if required. Select

the type of “Protocol” from the drop down box.

7. Type in the report sender’s name and email address.

8. Click on the [Save] button to save the SMTP settings.

9. Click on the [Save] button to save the settings.

Note: if you don’t have an SMTP server, you can consider using a free SMTP such as gmail.



2.3.4 Create user account

Create a user account for the backup machine.

1. Click on the “User & User Group” under the “Backup/Restore” on AhsayCBS main page.

2. Click on the [+] button to create a new user account.

3. Type in “Login Name” and “Password” in the relavent field.

Optional: Click on the check box in front of the user group if you need to assign a user group for this user. (You can assign this user to the user

group later.)



4. Click [→] to continue. (Minimum password length is 6 alphanumeric

characters.)

5. If you need to assign a dedicated storage location for the backup account. Select the radio button “Manually assigned” and choose the

storage location under the “Home Directory”. If you use “Auto assigned” you can skip this step.

Optional: “Host Name” & “Alias” can be left empty if you do not know or do not want to enter the details at this stage.

6. Select “Subscription Type”. Select the radio button next to the “Paid User” if you are settings a user with no expiration period. If you select the user type as “Trial User” which means this user will be suspended at

the suspension date listed in the “Suspend At” box.



7. Select the status of this user account by the radio button next to the status type.

8. By default the “Upload Encryption Key” option is enabled. If you have this option turned on, a hashed encrypted will be uploaded to the

Backup Server. When your users lost the encryption key, Ahsay can unhash the hashed encryption key and send the unhashed encryption to your user’s registered email account.

9. Select the correct timezone for this user in the drop down selection box

& click on [→] to continue.

10. Select the backup user type by clicking on the radio button next to the

“AhsayOBM user” or “AhsayACB user”

11. Click on the check box(es) to select the “Add-on Modules” for this user.



12. Enter the backup quota value, and select the unit of this value from the

drop down box & click on [→] to continue.

13. Click [+] to add user’s contact information.

14. Fill in the contact details and click green [+] button at bottom right

corner to bring you back to the previous “Add New User” page. Click green [+] on the bottom of the page again to continue.

15. Click on the [Save] button to save the user information.





2.4 Install AhsayOBM/AhsayACB

2.4.1 Install AhsayOBM

General requirements: - Windows 7 or above. - CentOS 6 or above.

- Red Hat Enterprise Linux 6 or above. - Mac OSX 10.7.3 or above

- 2GB of RAM or above Downloading of AhsayOBM installers can be done from AhsayCBS web

interface by clicking on the blue download button on the top right corner of the page.

Taking to the installer download page, which you can click on download

button for the OS platform you are running on.

2.4.1.1 Windows

1. Download the AhsayOBM installer (obm-win.exe) from the AhsayOBS web interface. Run the downloaded installer.



2. Choose the language, and then click [OK] to continue.


4. Read the license agreement. Select “I agree the agreement” if you agree, then click on [Next] to continue the installation.




6. Select the option “Anyone who uses this computer” or “Me Only”, then

click [Next] to continue.

7. Click [Install] to continue.

8. Click [Finish] to finish the installation.



2.4.2.1 Linux

1. Download the AhsayOBM installer “obm-linux-x86_64.rpm” or “obm-linux-x86_64.tar.gz” from the AhsayOBS web interface. For 32-bit

machines, please download “obm-linux-i386.rpm” or “obm-linux-i386.tar.gz”.

2. Login as root user on the machine.

3. Install the downloaded package.

For the rpm package:

i. Install the package by the following command.

For 64-bit machines:

rpm -i obm-linux-x86_64.rpm

For 32-bit machines:

rpm -i obm-linux-i386.rpm



2.4.3.1 Mac

1. Download the AhsayOBM installer (obm.dmg) from the AhsayCBS web interface. Open the obm.dmg disk image file.



2. After you opened the disk image, run the obm.pkg .

3. Click [Continue] to the next screen.




5. Click [Continue] and then click [Agree] to accept the license agreement.

6. Option: Click on the “Change Install Location” to change the instatllation path.

7. Click [Install] to install AhsayOBM.



8. Enter the password to allow the installer to make changes on the machine. Click [Install Software] to continue.

9. Click [Close] to finish the installation.



2.4.2 Install AhsayACB

General requirements:

- Windows Vista/Windows 7/8/8.1 or above. - Mac OSX 10.7.3 or above - 2GB of RAM or above

2.4.1.2 Windows

1. Download the AhsayACB installer (acb-win.exe) from the AhsayCBS web interface. Run the downloaded installer.

2. Choose the language, then click [OK] to continue.




4. Read the license agreement. Select “I agree the agreement” if you

agree, then click on [Next] to continue the installation.




6. Select the option “Anyone who uses this computer” or “Me Only”, then click [Next] to continue.

7. Click <Install> to continue.

8. Click [Finish] to finish the installation.



2.4.2.2 Mac

1. Download the AhsayACB installer (acb.dmg) from the AhsayOBS web interface.

2. Open the acb.dmg disk image file.

3. After you opened the disk image, run the acb.pkg .







6. Click [Continue] and then click [Agree] to accept the license agreement.

7. Option: Click on the “Change Install Location” to change the instatllation path.

8. Click [Install] to install AhsayACB.



9. Enter the password to allow the installer to make changes on the machine.

10. Click [Close] to finish the installation.



2.5 Create your first backup set

2.5.1 Login your AhsayOBM/AhsayACB

As the login interface on both AhsayOBM and AhsayACB are the same on different OS platform, except on the colour of the interface. The following screens are captured from a Windows version of AhsayOBM.

1. Open your AhsayOBM/AhsayACB from the desktop icon or

Windows:

Start menu

System icon tray



Mac OSX:

Applications folder

Linux (for some dististribution):

Application menu

Note:

Please refer to the next section if you need to run AhsayOBM from a Linux console.

2. Since you have created an user name called “David” in previous step,

you can click on “Login” to login with the user “David”.



3. Enter the login name and password.

4. Option: If you don’t want the application to prompt the password every

time when you enter the application interface, check on the “Save password” check box.

5. Click on the “Show advanced option” link, the Backup Server and Proxy option will be shown.



6. Select the connection protocol “http” or “https” from the drop down box.

7. Select the backup server from the drop down list or type in the backup

server IP/DNS entry.

8. Option: Slide the “Use proxy to access the Internet” switch from left to right to turn on the proxy setting.

i. Enter the “IP address” of your proxy server.

ii. Enter the connecting “Port” of your proxy server.

iii. Enter the “Login ID” to your proxy server.

iv. Enter the login “Password” of your proxy login account.

v. Click on the “Test connection” button to test on the connection.



9. Click [OK] to continue.

2.5.2 Create backup set with AhsayOBM

The backup set creation is similar on Windows, Linux with GUI and Mac OSX. The following steps will guide you to finish the setup of a file backup set, and backup files to the AhsayCBS storage.

1. Click the [Backup Sets] button.

2. Click the [+] button to add a new backup set.



3. Enter a meaningful name for the backup set in the “Name” field, and select the “File Backup” from the drop down box and click [Next] to

continue.

4. Click on the check box next to the default backup folder that you want

to backup.



5. Option: Slide the backup filter switch from left to right if you need to apply backup filter for your backup set.

6. Option: Click on the “I would like to choose the files to backup” if you want to select other drives or folders in your computer.


8. To enable a schedule backup of this backup set, slide the run schedule

backup switch from right to left.




10. Enter the backup schedule details.

i. Enter a meaningful name for the backup schedule in the “Name” field.

ii. Select the type of the schedule from the drop down box, eg: “Daily”.

iii. Select the backup start time from the drop down box, eg: 14:00 .

iv. Select the criteria of the stop backup from the drop down box , eg:

“until full backup completed”.

v. Option: Check the box next to “Run Retention Policy after backup”

if you need to remove retention data after the backup.

11. Click [OK] and then click on [Next] to continue.



12. Select the mode of the backup in the drop down box, eg: “Sequential”.

13. Click on the [+] to add a new storage destination on the AhsayCBS.

14. Select the radio button next to the storage type, eg: “Single storage destination”, and select the “Destination storage” from the drop down box, eg: “CBS”.




16. Click on the [Next] button if you select the default encryption key, the following settings will be used.

Encryption Key: A randomly generated key of 44 alpha numeric

characters

Encryption Key length: 256 bits

Encryption Algorithm: AES

Encryption Method: CBC

17. Option: Select “Custom” from the drop down box if you want to modify the encryption setting.




19. Enter the password for this Windows account so that AhsayOBM can access to the files that you selected.

20. Click [Backup Now] to start the backup.

Important:

Encryption settings are set at the backup set’s creation time, even if the password is changed afterwards, the encryption key remains the same and

cannot be modified afterwards. Please make sure you have written down the encryption key and keep it in a safe place. If the backup computer is crashed, you will not be able to restore the encryption key, and the data that you

backup is irretrievable.



2.5.3 Create backup with AhsayOBM installed on Linux console.

This section will be available in future release.



2.5.4 Create backup set with AhsayACB

The backup set creation is similar on Windows and Mac OSX. The following

steps will guide you to finish the setup of a file backup set, and backup files to the AhsayCBS storage.

1. Click the [Backup Sets] button.

2. Click the [+] button to add a new backup set.

3. Enter a meaningful name for the backup set in the “Name” field, and select the “File Backup” from the drop down box and click [Next] to

continue.



4. Click on the check box next to the default backup folder that you want to backup.

5. Option: Click on the “I would like to choose the files to backup” if you want to select other drives or folders in your computer.


7. To enable a schedule backup of this backup set, slide the run schedule backup switch from left to right.




9. Enter the backup schedule details.

i. Enter a meaningful name for the backup schedule in the “Name” field.

ii. Select the type of the schedule from the drop down box, eg: “Daily”.

iii. Select the backup start time from the drop down box, eg: 14:00 .

iv. Select the criteria of the stop backup from the drop down box , eg:

“until full backup completed”.

v. Option: Check the box next to “Run Retention Policy after backup”

if you need to remove retention data after the backup.




11. Select the mode of the backup in the drop down box, eg: “Sequential”.

12. Click on the [+] to add a new storage destination on the AhsayCBS.

13. Select the radio button next to the storage type, eg: “Single storage

destination”, and select the “Destination storage” from the drop down box, eg: “CBS”.




15. Click on the [Next] button if you select the default encryption key, the following settings will be used.

Encryption Key: A randomly generated key of 44 alpha numeric

characters

Encryption Key length: 256 bits

Encryption Algorithm: AES

Encryption Method: CBC

16. Option: Select “Custom” from the drop down box if you want to modify the encryption setting.




18. Enter the password for this Windows account so that AhsayACB can access to the files that you selected.

19. Click [Backup Now] to start the backup.

Important:

Encryption settings are set at the backup set’s creation time, even if the password is changed afterwards, the encryption key remains the same and

cannot be modified afterwards. Please make sure you have written down the encryption key and keep it in a safe place. If the backup computer is crashed,

you will not be able to restore the encryption key, and the data that you backup is irretrievable.



3 Further Information

If you have any question or suggestion about this document, please send an email to our support team via our forum.

http://forum.ahsay.com/

Documents

Ahsay Cloud Backup Suiteahsay-dn.ahsay.com/document/v7/7500/customer/pdf/guide_cbs_quick... · $ Filepath in Linux/Unix/BSD format ... For cloud setup, please refer to Ahsay Cloud