V7 Ahsay Systems Corporation Limited 8 September 2015
Ahsay Cloud Backup Suite 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. Ahsay Systems Corporation Limited V7.3.0
Revision History Date Description Type of modification 31 Aug 2015 First revision for AhsayCBS Quick Start New Guide Ahsay Systems Corporation Limited V7.3.0
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... 14 2.3.4 Create user account... 16 2.4 Install AhsayOBM/AhsayACB... 21 2.4.1 Install AhsayOBM... 21 2.4.2 Install AhsayACB... 29 2.5 Create your first backup set... 36 2.5.1 Login your AhsayOBM/AhsayACB... 36 2.5.2 Create backup set with AhsayOBM... 40 2.5.3 Create backup with AhsayOBM installed on Linux console.... 47 2.5.4 Create backup set with AhsayACB... 48 3 Further Information... 54 Appendix... 55 Appendix A Product Documentations... 55 [Ahsay Systems Corporation Limited i
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 $CBS_HOME format italic Command mkdir /usr/local/cbs Notation that are used specificially for API section: Convention <Text Inside angle brackets> [Text inside square brackets] {Text insides braces} Vertical bar ( ) Ellipsis ( ) Descriptions Placeholder for which you must supply a value. Optional items. Set of required items; choose one. Separator for mutually exclusive items; choose one. Items that can be repeated. 1.2 Definitions, Acronyms and Abbreviation Term/Abbreviation AhsayCBS AhsayOBM Definition Ahsay Cloud Backup Suite Ahsay Online Backup Manager AhsayACB CBS_HOME Ahsay A-Click Backup The install location of AhsayCBS. Windows C:\Program Files\AhsayCBS Linux/FreeBSD/Solaris /usr/local/cbs/ Ahsay Systems Corporation Limited 1
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. Ahsay Systems Corporation Limited 2
2 Quick Start 2.1 Basic setup requirement Prepare a machine for the Ahsay Cloud Backup Suite (AhsayCBS) with the following specifications: - Intel Core TM 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, then click [OK] to continue. Ahsay Systems Corporation Limited 3
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. Ahsay Systems Corporation Limited 4
7. 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. Ahsay Systems Corporation Limited 5
9. Click [Install] to start the installation. 10. Click [Finish] to complete the installation. Ahsay Systems Corporation Limited 6
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. Ahsay Systems Corporation Limited 7
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). Ahsay Systems Corporation Limited 8
2.3 Basic setup and configuration 2.3.1 Activate License 1. Open the AhsayCBS from your browser eg: http://<your-backupserver> 2. Login the AhsayCBS with the default password, i.e. system 3. To activate the license, click on the Backup Server tab. 4. Click on the License tab. 5. If you are evaluating the AhsayCBS, you can use the evaluation license provided in the page. Go to step 7. 6. If you have a purchased license, copy and paste the licensee name, license key into the relavent field. Ahsay Systems Corporation Limited 9
7. Click on [Update] button. 8. 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. Ahsay Systems Corporation Limited 10
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 Backup Server tab on the right hand side. 2. In the Basic tab, locate the User Homes section. 3. Click on the [+] button. 4. Enter the field Home Directory Eg: D:\my_user_home Ahsay Systems Corporation Limited 11
Note: It is not suggested to store your user home in your system partition, eg: C:\ 5. Click on the [Add] button. 6. Before you click on the [Save] button, it is recommended to remove the default user home in the C:\ drive or any system partition. Click on the check box in front of the C:\ drive or any system partition. Ahsay Systems Corporation Limited 12
7. Click on the [Trash] icon to remove the user home. Ahsay Cloud Backup Suite 8. Click [OK] to confirm the deletion. 9. Click on the [Save] button to save the new user home settings. Ahsay Systems Corporation Limited 13
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 System Panel tab on the right hand side. 2. In the Email Server tab, locate the SMTP Server section. 3. Click on the [+] button. Ahsay Systems Corporation Limited 14
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 to use a free SMTP such as gmail. Ahsay Systems Corporation Limited 15
2.3.4 Create user account Create a user account for the backup machine. 1. Click on the User & User Group under the User Management on the right hand side. 2. Click on the [+] button to create a new user account. 3. Type in Login Name and Password in the relavent field. 4. Option: 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.) 5. Click [Next] to continue. (Minimum password length is 6 alphanumeric characters.) Ahsay Systems Corporation Limited 16
6. Option: Enter the Host Name 7. Option: Enter the Alias 8. 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. 9. 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. 10. Select the status of this user account by the radio button next to the status type. Ahsay Systems Corporation Limited 17
11. 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. 12. Select the language for this user account. (This is the language setup for this user, eg: the language of the backup report) 13. Select the correct timezone for this user in the drop down selection box. 14. Option: Enter your notes in the Notes field if any. 15. Click [Next] to continue. 16. Select the backup user type by clicking on the radio button next to the AhsayOBM user or AhsayACB user Ahsay Systems Corporation Limited 18
17. Click on the check box(es) to select the Add-on Modules for this user. 18. Enter the backup quota value, and select the unit of this value from the drop down box. 19. Click [Next] to continue. 20. Click [+] to add user s contact information. 21. Fill in the contact details and click [Add] to continue. Ahsay Systems Corporation Limited 19
22. Click [Add] to continue. 23. Click on the [Save] button to save the user information. Ahsay Systems Corporation Limited 20
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 2.4.1.1 Windows 1. Download the AhsayOBM installer (obm-win.exe) from the AhsayOBS web interface. 2. Run the downloaded installer. 3. Choose the language, then click [OK] to continue. 4. Click [Next] to continue. Ahsay Systems Corporation Limited 21
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. Ahsay Systems Corporation Limited 22
7. Select the option Anyone who uses this computer or Me Only, then click [Next] to continue. 8. Click [Install] to continue. 9. Click [Finish] to finish the installation. Ahsay Systems Corporation Limited 23
2.4.2.1 Linux 1. Download the AhsayOBM installer obm-linux-x86_64.rpm or obmlinux-x86_64.tar.gz from the AhsayOBS web interface. For 32-bit machines, please download obm-linux-i386.rpm or obm-linuxi386.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 Ahsay Systems Corporation Limited 24
2.4.3.1 Mac 1. Download the AhsayOBM installer (obm.dmg) from the AhsayCBS web interface. 2. Open the obm.dmg disk image file. Ahsay Systems Corporation Limited 25
3. After you opened the disk image, run the obm.pkg. Ahsay Cloud Backup Suite 4. Click [Continue] to the next screen. 5. Click [Continue] to the next screen. Ahsay Systems Corporation Limited 26
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 AhsayOBM. Ahsay Systems Corporation Limited 27
9. Enter the password to allow the installer to make changes on the machine. Click [Install Software] to continue. 10. Click [Close] to finish the installation. Ahsay Systems Corporation Limited 28
2.4.2 Install AhsayACB General requirements: - Windows Windows 7 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. 2. Run the downloaded installer. 3. Choose the language, then click [OK] to continue. Ahsay Systems Corporation Limited 29
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. Ahsay Systems Corporation Limited 30
7. Select the option Anyone who uses this computer or Me Only, then click [Next] to continue. 8. Click <Install> to continue. 9. Click [Finish] to finish the installation. Ahsay Systems Corporation Limited 31
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. Ahsay Systems Corporation Limited 32
3. After you opened the disk image, run the acb.pkg. Ahsay Cloud Backup Suite 4. Click [Continue] to the next screen. 5. Click [Continue] to the next screen. Ahsay Systems Corporation Limited 33
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. Ahsay Systems Corporation Limited 34
9. Enter the password to allow the installer to make changes on the machine. 10. Click [Close] to finish the installation. Ahsay Systems Corporation Limited 35
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 Ahsay Systems Corporation Limited 36
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. Ahsay Systems Corporation Limited 37
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. Ahsay Systems Corporation Limited 38
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. Ahsay Systems Corporation Limited 39
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. Ahsay Systems Corporation Limited 40
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. Ahsay Systems Corporation Limited 41
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. 7. Click [Next] to continue. 8. To enable a schedule backup of this backup set, slide the run schedule backup switch from right to left. Ahsay Systems Corporation Limited 42
9. Click on the [+] button. 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. Ahsay Systems Corporation Limited 43
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. 15. Click [OK] and then click on [Next] to continue. Ahsay Systems Corporation Limited 44
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. 18. Click [Next] to continue. Ahsay Systems Corporation Limited 45
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. Ahsay Systems Corporation Limited 46
2.5.3 Create backup with AhsayOBM installed on Linux console. This section will be available in future release. Ahsay Systems Corporation Limited 47
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. Ahsay Systems Corporation Limited 48
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. 6. Click [Next] to continue. 7. To enable a schedule backup of this backup set, slide the run schedule backup switch from left to right. Ahsay Systems Corporation Limited 49
8. Click on the [+] button. 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. 10. Click [OK] and then click on [Next] to continue. Ahsay Systems Corporation Limited 50
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. 14. Click [OK] and then click on [Next] to continue. Ahsay Systems Corporation Limited 51
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. 17. Click [Next] to continue. Ahsay Systems Corporation Limited 52
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. Ahsay Systems Corporation Limited 53
3 Further Information If you have any question or suggestion about this document, please send an email to our support team via our forum. Ahsay Systems Corporation Limited 54
Appendix Appendix A Product Documentations Please visit this link for the documentations of Ahsay Products. Ahsay Cloud Backup Suite Ahsay Systems Corporation Limited 55