www.bobcloud.net
README FIRST
Windows Server Backup v8
Quick Start Guide for Windows
17
th
February 2020
We use Ahsay’s software for our online backup service and this is the original Ahsay manual.
99% of the time you won’t need to use these manuals. If you do, please read the following notes.
Email us on support@bobcloud.net anytime if you require assistance.
---------------------------------------------------------------------------------------------------------------------------------
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 on our shared platform. These are only provided on our
System Provider service.
Open direct, Run Direct, or Run on Server.
---------------------------------------------------------------------------------------------------------------------------------
All accounts must be created on our reseller portal https://portal.data-stor.net
---------------------------------------------------------------------------------------------------------------------------------
Definitions:
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
File name and path substitutes
%system_path%/ahsayobm >>> %system_path%/server
Service and process substitutes
ahsayobm >>> server
www.ahsay.com
Copyright Notice
© 2020 Ahsay Systems Corporation Limited. All rights reserved.
The use and copying of this product is subject to a license agreement. Any other use is prohibited. No part of this publication
may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any
means without prior written consent of Ahsay Systems Corporation Limited. Information in this manual is subject to change
without notice and does not represent a commitment on the part of the vendor. Ahsay Systems Corporation Limited does not
warrant that this document is error free. If you find any errors in this document, please report to Ahsay Systems Corporation
Limited in writing.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
Trademarks
Ahsay, Ahsay Cloud Backup Suite, Ahsay Online Backup Suite, Ahsay Offsite Backup Server, Ahsay Online Backup Manager,
Ahsay A-Click Backup, Ahsay Replication Server, Ahsay BackupBox Firmware, Ahsay Universal Backup System and Ahsay
NAS Client Utility are trademarks of Ahsay Systems Corporation Limited.
Amazon S3 is registered trademark of Amazon Web Services, Inc. or its affiliates.
Apple and Mac OS X are registered trademarks of Apple Computer, Inc.
Dropbox is registered trademark of Dropbox Inc.
Google Cloud Storage and Google Drive are registered trademarks of Google Inc.
Lotus, Domino and Notes are registered trademark of IBM Corporation.
Microsoft, Windows, Microsoft Exchange Server, Microsoft SQL Server, Microsoft Hyper-V, Microsoft Azure, One Drive and
One Drive for Business are registered trademarks of Microsoft Corporation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
owners.
Oracle, Oracle 10g, Oracle 11g and MySQL are registered trademarks of Oracle Corporation.
Rackspace and OpenStack are registered trademarks of Rackspace US, Inc.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo and JBoss are registered trademarks of Red Hat, Inc.
www.redhat.com in the U.S. and other countries. Linux is a registered trademark of Linus Torvalds.
ShadowProtect is registered trademark of StorageCraft Technology Corporation.
VMware, ESX, ESXi and vCenter are registered trademarks of VMware, Inc.
All other product names are registered trademarks of their respective owners.
Disclaimer
Ahsay Systems Corporation Limited will not have or accept any liability, obligation or responsibility whatsoever for any loss,
destruction or damage (including without limitation consequential loss, destruction or damage) however arising from or in
respect of any use or misuse of reliance on this document. By reading and following the instructions in this document, you
agree to accept unconditionally the terms of this Disclaimer and as they may be revised and/or amended from time to time by
Ahsay Systems Corporation Limited without prior notice to you.
www.ahsay.com
Revision History
Date
Descriptions
Type of modification
11 October 2019
Added Multi-Factor Authentication login in Ch. 6;
Added Security Setting in Ch. 7; Added how to
create a Free Trial account in Appendix E;
Updated screenshots in Ch. 9, 10 and 11;
Updated link in Ch. 12;
New / Modification
3 January 2020
Modified the diagram for the Overview on the
Backup Process and added a diagram for the
Detailed Process of Periodic Data Integrity
Check in Ch. 9
New / Modification
6 February 2020
Modified the Data Integrity Check in Ch. 7
Modification
www.ahsay.com
Table of Contents
1 Overview ........................................................................................................................................1
What is this software?................................................................................................................1
System Architecture...................................................................................................................1
2 Requirements for AhsayOBM on Windows................................................................................2
Hardware Requirements............................................................................................................2
Software Requirements .............................................................................................................2
Antivirus Exclusion Requirement ...............................................................................................2
Upgrade VMware Tools Requirement .......................................................................................2
3 Get Started with AhsayOBM ........................................................................................................3
4 Install AhsayOBM .........................................................................................................................4
Option 1: Online Installation Option......................................................................................4
Option 2: Offline Installation Option......................................................................................9
AhsayOBM Scheduler Service Check .....................................................................................14
5 Start AhsayOBM..........................................................................................................................15
Login to AhsayOBM.................................................................................................................15
6 AhsayOBM Overview..................................................................................................................17
Profile.......................................................................................................................................18
General...............................................................................................................................18
Contacts .............................................................................................................................19
Time Zone ..........................................................................................................................21
Encryption Recovery ..........................................................................................................22
Password............................................................................................................................23
Security Settings.................................................................................................................25
Language.................................................................................................................................26
Information...............................................................................................................................26
Backup.....................................................................................................................................27
Backup Sets.............................................................................................................................27
Backup Set Settings ...........................................................................................................27
General ..........................................................................................................................28
Backup Set Name.....................................................................................................28
Windows User Authentication...................................................................................30
Source ...........................................................................................................................31
Option 1: Quick or Shortcut ......................................................................................32
Option 2: Filter ..........................................................................................................35
Option 3: Advanced Backup Source.........................................................................37
Backup Schedule...........................................................................................................42
Continuous Backup........................................................................................................46
www.ahsay.com
Destination.....................................................................................................................48
In-File Delta ...................................................................................................................51
Retention Policy.............................................................................................................54
Backup Scheduler (Recommended) .....................................................................59
Manual Backup .......................................................................................................61
Space Freeing Up ...................................................................................................63
Command Line Tool ......................................................................................................65
Requirements and Best Practices ............................................................................65
Pre-backup Command..............................................................................................68
Post-backup Command ............................................................................................69
Reminder .......................................................................................................................71
Bandwidth Control .........................................................................................................72
Others ............................................................................................................................74
Temporary Directory.................................................................................................75
Follow Link................................................................................................................76
Volume Shadow Copy ..............................................................................................76
File Permissions .......................................................................................................76
Compressions...........................................................................................................77
Encryption.................................................................................................................78
Report ......................................................................................................................................79
Backup................................................................................................................................79
Restore ...............................................................................................................................83
Usage .................................................................................................................................87
Restore ....................................................................................................................................88
Settings....................................................................................................................................88
Proxy ..................................................................................................................................89
Windows Event Log............................................................................................................90
Utilities .....................................................................................................................................91
Data Integrity Check ...........................................................................................................91
Data Integrity Check Result ...........................................................................................99
Test Mode confirmation ...............................................................................................100
Space Freeing Up.............................................................................................................102
Delete Backup Data..........................................................................................................105
Decrypt Backup Data........................................................................................................111
Online Help ............................................................................................................................114
System Tray...........................................................................................................................115
Open.................................................................................................................................116
Backup..............................................................................................................................117
Backup and Logoff............................................................................................................117
www.ahsay.com
Backup and Restart ..........................................................................................................117
Backup and Shutdown......................................................................................................118
Backup and Standby ........................................................................................................118
Backup and Hibernate ......................................................................................................118
Help ..................................................................................................................................119
Stop Running Backup.......................................................................................................119
Exit....................................................................................................................................120
7 Create a Backup Set .................................................................................................................121
8 Overview on the Backup Process ...........................................................................................129
9 Run Backup Jobs......................................................................................................................133
Login to AhsayOBM...............................................................................................................133
Start a Manual Backup ..........................................................................................................133
10 Restore Data..............................................................................................................................136
Traditional Restore ................................................................................................................136
Restore Filter .........................................................................................................................142
Appendix ...........................................................................................................................................147
Appendix A: Uninstall AhsayOBM ......................................................................................147
Appendix B: Example Scenarios for Restore Filter.............................................................150
Appendix C: Batch Files .....................................................................................................162
RunCB.bat ........................................................................................................................162
RunConfigurator.bat .........................................................................................................168
ListBackupSet.bat.............................................................................................................172
RunBackupSet.bat............................................................................................................173
ListBackupJob.bat ............................................................................................................179
Restore.bat .......................................................................................................................182
Decrypt.bat .......................................................................................................................188
RunDataIntegrityCheck.bat ..............................................................................................194
Appendix D: Example Scenarios for the Reminder ............................................................199
Windows Log Off ..............................................................................................................199
Windows Restart ..............................................................................................................200
Windows Shutdown ..........................................................................................................201
Scenario 1 (Windows Log Off + Enabled Locking Workstation) .......................................202
Scenario 2 (Windows Log Off + Unselected Locking Workstation) ..................................203
Scenario 3 (Windows Restart + Enabled Locking Workstation) .......................................204
Scenario 4 (Windows Restart + Unselected Locking Workstation) ..................................205
Scenario 5 (Windows Shutdown + Enabled Locking Workstation)...................................206
Scenario 6 (Windows Shutdown + Unselected Locking Workstation) ..............................207
www.bobcloud.net 1
1 Overview
What is this software?
Ahsay brings you specialized client backup software, namely AhsayOBM, to provide a
comprehensive backup solution for protecting file(s) / folder(s) on your machine, with a wide variety
of backup destinations (major cloud storage service providers, FTP/SFTP, local drive, etc.) of your
choice.
System Architecture
Below is the system architecture diagram illustrating the major elements involved in the backup
process among the backup machine, AhsayOBM and AhsayCBS.
In this user guide, we will focus on the software installation, as well as the end-to-end backup and
restore process using the AhsayOBM as a client backup software.
www.bobcloud.net 2
2 Requirements for AhsayOBM on Windows
Hardware Requirements
Refer to the link below for details of the minimum and recommended requirements for installing
AhsayOBM:
FAQ: Ahsay Hardware Requirement List (HRL) for version 8.1 or above
Software Requirements
Refer to the following article for the list of compatible operating systems and Hyper-V platforms:
FAQ: Ahsay Software Compatibility List (SCL) for version 8.1 or above
Antivirus Exclusion Requirement
To optimize performance of AhsayOBM on Windows, and to avoid conflict with your antivirus
software, refer to the following KB article the list of processes and directory paths that should be
added to all antivirus software white-list / exclusion list:
http://wiki.ahsay.com/doku.php?id=public:8014_suggestion_on_antivirus_exclusions
NOTE
The bJW.exe process is automatically added to Windows Defender exclusion list for Windows 10 and 2016,
during installation / upgrade via installer or upgrade via AUA.
Upgrade VMware Tools Requirement
To avoid unexpected java crash, if the Windows machine is a guest VM hosted on a VMware Host
then it is highly recommended that the VMware tools version installed on the guest VM must be
10.0.5 or above.
Below is the warning message that will be displayed if the version of the VMware Tools is less than
10.0.5.
www.bobcloud.net 3
3 Get Started with AhsayOBM
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 Windows
machine machine
Launch the App
Launch and log in to AhsayOBM
Create a Backup Set
Create a backup set according to
your preferences
Run Backup Jobs
Run the backup jobs to back up
data
Restore Data
Restore backed up data to your
system
www.bobcloud.net 4
4 Install AhsayOBM
Option 1: Online Installation Option
1. Launch the online installation package file you have downloaded from the download section
above.
2. Click Run when you see this message.
3. The following dialog box will appear only if User Account Control is enabled. Click Continue
to start the installation.
www.bobcloud.net 5
4. Click Next to continue.
5. Select I accept the agreement after reading the license agreement. Then, click Next to
proceed.
www.bobcloud.net 6
6. Choose the installation directory. Then, click Next to continue.
7. Select the program group to which the software will be installed. Then, click Next to proceed.
www.bobcloud.net 7
8. The installation will start after you click Install.
9. The component files will be downloaded first during installation.
www.bobcloud.net 8
10. Click Finish to complete the installation.
www.bobcloud.net 9
Option 2: Offline Installation Option
1. Extract the offline installation package file (obm-win.zip) you have downloaded from the
download section above.
2. Select a destination and extract files.
3. Launch the installer you have extracted from the zip format file.
www.bobcloud.net 10
4. Click Run when you see this message.
5. The following dialog box will appear only if User Account Control is enabled. Click Yes to start
the installation.
www.bobcloud.net 11
6. Click Next to continue.
7. Select I accept the agreement after reading the license agreement. Then, click Next to
proceed.
www.bobcloud.net 12
8. Choose the installation directory. Then, click Next to continue.
9. Select the program group to which the software will be installed. Then, click Next to proceed.
www.bobcloud.net 13
10. The installation will start after you click Install.
11. Click Finish to complete the installation.
www.bobcloud.net 14
AhsayOBM Scheduler Service Check
This option is used to kick automated or scheduled backup jobs.
To check if the AhsayOBM Scheduler Service is running properly on the local machine, go to start
menu and search for Services.
Look for the Ahsay Online Backup Manager Services on the list. The status should be “Running”,
and the Startup Type should be “Automatic”.
www.bobcloud.net 15
5 Start AhsayOBM
Login to AhsayOBM
1. A shortcut icon of AhsayOBM will be available on your desktop after installation. Double-click
the icon to launch the application.
2. Enter the login name and password of your AhsayOBM account provided by your backup
service provider. Then, click OK to login.
3. For succeeding login this will be the screen displayed. Select your phone number. After
successful login, the following screen will appear.
www.bobcloud.net 16
www.bobcloud.net 17
6 AhsayOBM Overview
AhsayOBM main interface has nine (9) icons that can be accessed by the user, namely:
Profile
Language
Information
Backup
Backup Sets
Report
Restore
Settings
Utilities
Profile
Language
Information
www.bobcloud.net 18
Profile
The Profile icon shows the settings that can be modified by the user.
There are six (6) available features:
General
Contacts
Time Zone
Encryption Recovery
Password
Security Settings
General
The General tab displays the user’s information.
Control
Description
Login name
Name of the backup account.
Display name
Display name of the backup account upon logging in to the
AhsayCBS User Web Console.
Time
The date and time the user last logged in.
IP address
The IP address used to login.
www.bobcloud.net 19
Phone number (MFA)
The phone number where sms authentication will be sent when
MFA is enabled.
Browser / App
The browser or app used to login in to AhsayCBS User Web
Console or AhsayOBM.
Contacts
This refers to the contact information of the user. You can also add multiple contacts or modify an
existing contact information. Having this filled in will help in sending backup and daily reports and
even recovered backup set encryption key in case it was forgotten or lost.
To add a new contact, follow the instructions below:
1. Click the [+] plus sign to add a new contact.
2. Complete the following fields then click the [OK] button to return to the main screen.
Name
Email
Address
Company
Website
Phone 1
Phone 2
www.bobcloud.net 20
3. Click the [Save] button to store the contact information.
www.bobcloud.net 21
Time Zone
The time zone indicated.
To modify the time zone, follow the instructions below:
1. Select from the dropdown list.
2. Click the [Save] button to save the updated time zone.
www.bobcloud.net 22
Encryption Recovery
Backup set encryption key can be recovered by turning this feature on.
Note: This option may not be available. Please contact your backup service provider for more
details.
www.bobcloud.net 23
Password
Login password can be modified anytime. Tick the [Save Password] box to bypass the password
entry upon opening the AhsayOBM.
To modify the password, follow the instructions below:
1. Click [Change Password].
www.bobcloud.net 24
2. Enter the current password, then click [Next].
3. Enter the New Password and re-enter, then click the [OK] button to return to the main
screen.
4. Click the [Save] button to store the updated password.
www.bobcloud.net 25
Security Settings
Security Settings will only be visible if multi-factor authentication is enabled. Phone numbers that
will be used for sending sms authentication will be listed here and will show the status if it is
verified or not. You can also add phone numbers here that can be used for sending the sms
authentication.
Select the country and enter the phone number, then click Add.
www.bobcloud.net 26
Language
The list of available languages depends on the backup service provider.
Information
The Information icon displays the product version and system information of the machine where the
AhsayOBM is installed.
www.bobcloud.net 27
Backup
This feature is used to run the backup set/s.
To start backing up, follow the instructions on Chapter 10 Run Backup Jobs
Backup Sets
A backup set is a place for files and/or folders of your backed-up data. This feature allows the user
to select files individually or an entire folder to backup. It is also used to delete backup set/s.
To create or modify a backup set, follow the instructions on Chapter 8 Create a Backup Set
Backup Set Settings
Below is the list of configurable settings under a Backup Set:
General
Source
Backup Schedule
Continuous Backup
Destination
(Advanced settings)
In-File Delta
Retention Policy
Command Line Tool
Reminder
Bandwidth Control
www.bobcloud.net 28
Others
General
This feature allows the user to modify the backup set name and manage the Windows User
Authentication login credentials in the backup set.
Backup Set Name
To modify the name of a backup set, follow the steps below:
1. In the Name field, enter a new backup set name.
www.bobcloud.net 29
2. Click the [Save] button to save the updated backup set name.
NOTE
In assigning a backup set name, make sure that it does not have an identical name.
www.bobcloud.net 30
Windows User Authentication
To successfully perform backup and restore operations, AhsayOBM requires both read and write
permission to all the files/folders selected in the backup source.
The Windows User Authentication login credentials are used by the AhsayOBM to ensure it has
sufficient permission to access files and/or folders selected in the Backup Source, the temporary
folder location, and the backup destination if it is a network drive accessible from backup machine via
LAN, especially when running scheduled backup jobs, as the default Windows account used by the
AhsayOBM scheduler service is a local system account which does not have access to network
resources.
If files and/or folders selected are located on network drive(s), the login credentials for the
Windows User Authentication must have permission to access network resources, (e.g. an
administrator account).
If the machine is a file server shared by multiple users, then the AhsayOBM will require login
credentials with read/write permissions to access all the selected files and/or folders in the backup
source (e.g. an administrator account).
Field
Description
Domain Name
The domain or host name of the machine.
Username
Login username used by the AhsayOBM to access files and/or
folders selected in the backup source.
Password
Login password used by the AhsayOBM to access files and/or
folders selected in the backup source.
www.bobcloud.net 31
Source
This feature allows the user to select files and/or folders in the backup source to back up.
There are three (3) different ways to select files and/or folders to back up:
Option
Description
Quick or Shortcut
This allows the user to back up files and/or folders in the selected
backup source entirely.
Filter
This allows the user to select or exclude files and/or folders from the
backup job.
Advanced Backup Source
This allows the user to select files and/or folders individually to back
up.
Quick or
Shortcut
Filter
Advanced
Backup
Source
www.bobcloud.net 32
Option 1: Quick or Shortcut
This option allows the user to quickly select a backup source to be backed up.
If any of the following backup source is selected and the Backup Schedule is enabled, the Windows
User Authentication will prompt the user to enter the login password. To select a backup source
without entering the login password, the backup schedule must be disabled.
Desktop
Documents
Favorites
Outlook
Windows Live Mail
NOTE
During the creation of backup set, if this type of backup source (Quick or Shortcut) is selected and the Schedule
is set to “on”, the Windows User Authentication screen will be displayed. You will need to enter the login
password, otherwise, the creation of backup set will not continue.
www.bobcloud.net 33
To know the locations of the folder(s) that will be backed up for each selected backup source, refer to
the following table:
To select files and/or folders to back up using the Quick or Shortcut option, follow the steps below:
1. Select a backup source.
Backup Source
Description
Desktop
If Desktop is selected, all files and/or folders in the following
location will be backed up:
%UserProfile%\Desktop
Documents
If Documents is selected, all files and/or folders located in the
following location will be backed up:
%UserProfile%\Documents
If the Follow Link is enabled, all files and/or folders located in the
following locations will also be backed up:
%UserProfile%\Music
%UserProfile%\Pictures
%UserProfile%\Videos
Note: The Follow link is enabled by default.
Favorites
If Favorites is selected, all files and/or folders located in the
following location will be backed up:
%UserProfile%\Favorites
Outlook
If Outlook is selected, all files and/or folders located in the
following location will be backed up:
%UserProfile%\AppData\Local\Microsoft\Outlook
Windows Live Mail
If Windows Live Mail is selected, all files and/or folders located in
the following location will be backed up:
%UserProfile%\AppData\Local\Microsoft\Windows Live Mail
www.bobcloud.net 34
2. The Outlook and Windows Live Mail will be disabled if they were not installed on the machine.
3. Click the [Save] button to store the selected backup source.
www.bobcloud.net 35
Option 2: Filter
The Filter Backup Source is an alternative way to select a backup source which does not require
Windows User Authentication login password even if the backup schedule is enabled, unless the filter
backup source is located on a network drive.
The following options in the filter backup source does not require Windows User Authentication login
password:
All hard disk drives
Specific folder
To select files and/or folders to back up using the Filter Backup Source, follow the steps below:
1. Swipe the lever to the right to turn on the filter setting.
2. Click the [Add] button to create filter.
3. Assign a desired name to the backup filter.
4. Select from the options below.
www.bobcloud.net 36
5. In this example, all files and/or folders that end with the letter ‘X’ will be included to the
backup job. You can add multiple patterns here.
6. Select whether you would like to apply the filter to all files and/or folders in all hard disk drives
or to a specific folder only. If ‘This folder only’ is selected, click the [Change] button to select
the specific folder that you would like to apply the filter to.
7. Click the [OK] button to save the created filter, then click the [Save] button to save the
settings. Once you run a backup, all files and/or folders that match the applied filter will be
backed up.
8. Multiple backup filters can be created by clicking the [Add] button.
NOTE
For more details about backup source file filtering, please refer to Chapter 4.1 Create a backup set
with filter in the Ahsay Online Backup Manager v8 Backup Source File Filter Guide.
www.bobcloud.net 37
Option 3: Advanced Backup Source
The Advanced Backup Source is another way to select a backup source which does not require
Windows User Authentication login password even if the backup schedule is enabled, unless the
advanced backup source is located on a network drive.
The following table shows the list of options in the Advanced Backup Source which require and does
not require Windows User Authentication login password:
Advanced Backup Source
Description
Local Disk
Does not require Windows User Authentication login password.
Network drive
Requires Windows User Authentication login password. For
network drive/s, you will need to enter the login credentials
which has permission to access network resources in order to
back up selected files and/or folders.
Libraries
Does not require Windows User Authentication login password.
Note: This type of backup source may not be supported on
other versions of Windows.
This feature is not supported on:
www.bobcloud.net 38
To select files and/or folders using the Advanced Backup Source, follow the steps below:
1. In the Source window, select ‘I would like to choose the files to backup’.
2. In the Advanced Backup Source window, select ‘Show files’ to display the files inside each
folder, then select the files and/or folders that you would like to back up.
3. Click the [OK] button to save the selection, then click the [Save] button to store settings.
Windows 10
Windows 8.1
Windows 8 and
Windows Server 2012 R2
Supported on:
Windows 7
Windows Server 2016 and
Windows Server 2008 R2
www.bobcloud.net 39
In selecting files and/or folders to back up, the three (3) options can be used simultaneously. For
more details, please refer to the example scenarios below:
Scenario 1 (Quick or Shortcut + Filter)
You can use the quick or shortcut option and apply filter to the selected backup source at the same
time. To use this type of combination, follow the steps below:
1. Choose a backup source.
2. Create a filter which will be applied to the backup source.
3. Click the [OK] button to save the created filter, then click the [Save] button to store settings.
www.bobcloud.net 40
Scenario 2 (Quick or Shortcut + Advanced Backup Source)
You can use the quick or shortcut option and select files and/or folders in the advanced backup
source at the same time. To use this type of combination, follow the steps below:
1. Choose a backup source.
2. In the source window, click ‘I would like to choose the files to backup’ and select the files
and/or folders that you would like to back up.
3. Click the [OK] button to save the selection, then click the [Save] button to save settings.
www.bobcloud.net 41
Scenario 3 (Filter + Advanced Backup Source)
You can use the filter backup source and select files and/or folders in the advanced backup source at
the same time. To use this type of combination, follow the steps below:
1. Create a filter.
2. In the source window, click ‘I would like to choose the files to backup’ and select the files
and/or folders that you would like to back up.
3. Click the [OK] button to save the selection, then click the [Save] button to store settings.
www.bobcloud.net 42
Backup Schedule
This feature allows the user to assign a backup schedule for the backup job to run automatically.
To configure a backup schedule, follow the steps below:
1. Swipe the lever to the right to turn on the backup schedule setting. The backup schedule is
configured as “Daily at 20:00” by default.
2. Select an existing backup schedule to modify or click the [Add] button to create a new one.
www.bobcloud.net 43
3. In the New Backup Schedule window, configure the following backup schedule settings.
Name the name of the backup schedule.
Type – the type of the backup schedule. There are four (4) different types of
backup schedule: Daily, Weekly, Monthly and Custom.
Daily – the time of the day which the backup job will run.
www.bobcloud.net 44
Weekly – the day of the week and the time of that day which the backup
job will run.
Monthly – the day of the month and the time of that day which the
backup job will run.
Custom – a specific date and the time of that date which the backup job
will run.
www.bobcloud.net 45
Start backup at – the start time of the backup job.
Stop – the stop time of the backup job.
until full backup completed – this option will stop a backup job once it
is complete. This is the configured stop time of the backup job by default.
after (defined no. of hrs.) – this option will stop a backup job after a
certain number of hours regardless of whether the backup job has
completed or not. This can range from 1 to 24 hrs.
The number of hours must be enough to complete a backup of all
files in the backup set. For small files in a backup, if the number of hours
is not enough to back up all files, then the outstanding files will be
backed up in the next backup job. However, if the backup set contains
large files, this may result in partially backed up files.
For example, if a backup has 100GB file size which will take
approximately 15 hours to complete on your environment, but you set the
“stop” after 10 hours, the file will be partially backed up and cannot be
restored. The next backup will upload the files from scratch again.
The partially backed up data will have to be removed by running the
Data Integrity Check.
As a general rule, it is recommended to review this setting regularly
as the data size on the backup machine may grow over time.
Run Retention Policy after backup – if enabled, the AhsayOBM will run a
retention policy job to remove files from the backup destination(s) which have
exceeded the retention policy after performing a backup job.
4. Click the [OK] button to save the configured backup schedule settings.
5. Click the [Save] button to save settings.
6. Multiple backup schedules can be created.
www.bobcloud.net 46
Continuous Backup
This feature provides backup for selective data whenever a change is made. This feature is disabled
by default.
To enable the continuous backup, follow the steps below:
1. Swipe the lever to the right to turn on the continuous backup setting.
2. It is recommended to select this option to avoid backing up files that are marked as system
files.
3. Define how often the continuous backup job will run. The backup time interval can be set
from 1 minute to 12 hours.
www.bobcloud.net 47
4. This applies the continuous backup on small regular update files. The file size can range
from 25MB to unlimited MB.
NOTE
For large file size, the continuous backup may not run with a short time interval. You may need to
adjust the continuous backup time interval (in step 3).
5. This allows the user to create an exclude filter to exclude files and/or folders from the
backup job. Click the [Add] button to create an exclude filter.
6. If an exclude filter is created, click the [OK] button to save the created exclude filter, then
click the [Save] button to save the configured continuous backup settings.
www.bobcloud.net 48
Destination
This feature allows the user to select a backup mode and add an additional storage destination.
There are two (2) different types of backup mode:
Backup mode
Description
Sequential
This is the configured backup mode by default. This backup mode will run
a backup job to each backup destination one by one.
Concurrent
This backup mode will run a backup job to all backup destinations
simultaneously.
Comparison between Sequential and Concurrent Backup mode
Backup mode
Pros
Cons
Sequential
Takes less resources in the
local machine (e.g. memory,
CPU, bandwidth, etc.) to
complete a backup job.
Backup job is slower than in
concurrent mode since the
backup job will upload the
backup data to the selected
backup destinations one at a
time.
www.bobcloud.net 49
Concurrent
Backup job is faster than in
Sequential mode.
Maximum number of
concurrent backup destinations
can be configured.
Requires more resources in
the local machine (e.g.
memory, CPU, bandwidth, etc.)
to complete a backup job.
To add a new storage destination, follow the steps below:
1. Click the [Add] button.
2. Click the drop-down button to select a backup destination.
3. If the Local / Mapped Drive / Removable Drive is selected, click the [Change] button to
select a new storage destination, then click the [Test] button to validate access to it.
4. If there is an added storage destination, click the [OK] button to save the added one. Then
click the [Save] button to save the updated backup mode and the added storage destination.
www.bobcloud.net 50
Select Show advanced settings to modify the In-File Delta, Retention Policy, Command Line Tool,
Reminder, Bandwidth Control and other configurable items.
www.bobcloud.net 51
In-File Delta
In-file delta technology is an advanced data block matching algorithm which is capable to pick up the
changes (delta) of file content between two files.
There are two (2) default types of In-File Delta:
In-File Delta Type
Description
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.
Incremental
This is the configured In-file delta by default. The delta is generated by
comparing with the last uploaded full of delta file. Delta generated with this
method is smaller and uses the least bandwidth.
www.bobcloud.net 52
Comparison between Incremental and Differential In-File Delta
In-File Delta Type
Pros
Cons
Differential
Backup speed is faster than
Full backup.
Restoration is faster than data
backup with Incremental In-File
Delta.
Less storage space is need than
a Full backup.
Backup process is slower than
Incremental In-File Delta backup.
Restoration is slower than data
backup with Full backup.
Incremental
Backup process is fastest
among all three (3) types; Full,
Differential and Incremental
Least storage space is
required.
Restoration is slowest among all
three (3) types; Full, Differential
and Incremental.
For restoration, the full file and all
deltas that does not chain up to the
required point-in-time may result to
broken delta chain.
To configure the In-File Delta settings, follow the steps below:
1. Swipe the lever to the right to enable the In-File Delta.
2. Click the drop-down button to choose an In-File Delta type, then click Show advanced
settings to display all configurable items.
3. Click the drop-down button to specify the In-File Delta block size. This is configured as
“Auto” by default.
4. Click the drop-down button to select how much of the file size (MB) the In-File Delta logic
will apply to. By default, the In-File Delta logic is configured to apply to files larger than 25
MB.
www.bobcloud.net 53
5. A full file will be uploaded when either of these conditions is met. This setting can also be
configured.
This allows the user to configure a different In-File Delta setting to override the default
In-File Delta.
Weekly variations – for example, you set Sunday to perform a full backup,
for the rest of the week, a backup based on the default In-File Delta will be
run.
Yearly variations – for example, you set a particular day in January to
perform a full backup, for the rest of the year, a backup based on the default
In-File Delta will be run.
This allows the user to specify which day of the selected months in yearly
variations the backup job will be run. (e.g. First of January, March, May...)
6. Click the [Save] button to save the modified In-File Delta settings.
www.bobcloud.net 54
Retention Policy
When the AhsayOBM identifies files and/or folders that are deleted, updated, or with updated
permission/attributes during a backup job, these files and/or folders will then be moved from the data
area to the Retention area.
Retention area is a place used as a temporary destination to store these files (deleted, updated, or
with updated permission/attributes during a backup job). Files and/or folders in the retention area can
still be restored.
The Retention Policy is used to control how long these files remain in the retention area when they
are removed which can be specified in the number of days, weeks, months, or backup jobs. Retained
data within all backup destinations (e.g. AhsayCBS, local drive, SFTP/FTP, and cloud storage) are
cleared by the retention policy job.
The default Retention Policy setting for a File Backup Set is 7 days, but the appropriate Retention
Policy setting depends on individual, contractual, or regulatory requirements.
NOTE
There is a trade-off between the retention policy and backup destination storage usage. The higher the retention
policy setting, the more storage is used, which translates into higher storage costs.
www.bobcloud.net 55
There are two (2) different types of Retention Policy:
Type
Description
Simple
A simple retention policy is a basic policy where the retained files (in the retention
area) are removed automatically after the user specifies the number of days or
backup jobs.
Advanced
An advanced retention policy defines a more advanced and flexible policy where the
retained files (in the retention area) are removed automatically after a combination of
user defined policy.
Comparison between Simple and Advanced Retention Policy
Control
Simple
Advanced
Backup Jobs
Can keep the deleted files within 1 to 365 backup
job(s)
Not applicable
Days
Can keep the deleted files within 1 to 365 day(s)
Can keep the deleted
files within 1 to 365
day(s)
Type
Not applicable
Daily
Weekly
Monthly
Quarterly
Yearly
Custom
User-defined name
Not applicable
Applicable
WARNING
When files and/or folders in the retention area exceed the Retention Policy setting, they are permanently
removed from the backup set and cannot be restored
To configure a Simple Retention Policy, follow the steps below:
1. Go to Backup Sets, then select a backup set.
2. Click the [Retention Policy] tab in the Backup Set Settings.
3. Select [Simple] from the options, then click the drop-down button to define the number of
day(s) or job(s) which the deleted files will be retained. This is configured as seven (7) days
by default.
4. Click the [Save] button to save the configured retention policy settings.
www.bobcloud.net 56
To configure an Advanced Retention Policy, follow the steps below:
1. Go to Backup Sets, then select a backup set.
2. Click the [Retention Policy] tab in the Backup Set Settings.
3. Select [Advanced] from the options, then click the [Add] button to create.
4. Assign a desired name to the retention policy.
5. Click the drop-down button to display the retention type, then select one.
6. Click the drop-down button to specify the period on which the deleted files will be kept in the
backup set.
7. Click the [OK] button to save the configured advanced retention policy, then click [Save] to
save the settings.
www.bobcloud.net 57
For further details about how to configure an advanced retention policy for each type (Daily, Weekly,
Monthly, Quarterly, Yearly), refer to the examples below:
Example no. 1: To keep the retention files for the last seven (7) days:
Example no. 2: To keep the retention files for the last four (4) Saturdays:
Example no. 3: To keep the retention files for the 1
st
day of each month for the last three (3)
months:
Example no. 4: To keep the retention files for the 1
st
day of each quarter for the last four (4)
quarters:
www.bobcloud.net 58
Example no. 5: To keep the retention files for the 1
st
day of each year for the last seven (7)
years:
NOTE
Multiple advanced retention policy can be created.
www.bobcloud.net 59
There are three (3) ways to run the Retention Policy:
Backup Scheduler
Manual Backup
Space Freeing Up
Backup Scheduler (Recommended)
To run a retention policy job after a scheduled backup job, follow the steps below:
1. Click the [Backup Schedule] tab in the backup set settings.
2. Select an existing backup schedule or add a new one.
www.bobcloud.net 60
3. In the Backup Schedule window, select ‘Run Retention Policy after backup’ to run a
retention policy job after a scheduled backup job.
www.bobcloud.net 61
Manual Backup
To run a retention policy job after a manual backup, follow the steps below:
1. Click the Backup icon in the AhsayOBM main interface.
2. Select the backup set that you would like to back up and run the retention policy job on.
www.bobcloud.net 62
3. Click Show advanced option to display other settings.
4. Select ‘Run Retention Policy after backup’ to run a retention policy job after a backup job.
www.bobcloud.net 63
Space Freeing Up
To run a retention policy job manually via backup client interface, follow the steps below:
1. Click the Utilities icon in the AhsayOBM interface.
2. Select the [Space Freeing Up] tab in the Utilities settings.
www.bobcloud.net 64
3. Select the corresponding backup set and destination (e.g. AhsayCBS, local drive, cloud
storage) where you want the retention policy job to run on.
4. Click the [Start] button to run the retention policy job.
NOTE
For more details about Space Freeing Up, please refer to Space Freeing Up in Chapter 7
AhsayOBM Overview.
www.bobcloud.net 65
Command Line Tool
This feature allows the user to configure a pre-backup or post backup command which can be; an
operating system level command, a script or batch file, or third-party utilities to run before and/or after
a backup job.
e.g. Connecting to a network drive and disconnecting a network drive, stopping a third-party database
(not officially supported by Ahsay) to perform a cold backup, and restarting a third-party database
after a backup.
Requirements and Best Practices
Error and Exception Handling
Each pre-backup command or batch file should have an error and exception handling. If a pre-backup
command contains an error, although an unhandled error may not hinder the backup job process, and
the backup job is successful, it will result to a status indicating completed backup with warning(s). For
more details about backup report status, please refer to Backup Reports in Chapter 7 AhsayOBM
Overview.
Command or Batch File Compatibility
Make sure that each command (pre-backup and post-backup) are tested thoroughly before including
them to the backup job.
Scheduled Backup
If the scheduled backup job is set to stop after x no. of hours, make sure that the duration of the
running backup job will not be affected. You may need to adjust the number of hours in the backup
schedule configuration. Please refer to Backup Schedule for more details.
www.bobcloud.net 66
Post-backup Command Recommendation
It is recommended to include a timeout for a post-backup command to shut down the machine. The
timeout must be adjusted until when the AhsayOBM sends the backup job status to the AhsayCBS.
In this example, the configured post-backup command is to shut down the machine that has a timeout
set to ninety (90) seconds. The machine will shut down automatically after the specified time.
This is to ensure that the AhsayOBM has enough time to complete the backup process in order to
send the backup job status to the AhsayCBS before the machine shuts down. See screenshot below:
NOTE
For more details about detailed backup report, please refer to Backup Reports in Chapter 7 AhsayOBM
Overview.
There are three (3) fields in the command line tool:
Field
Description
Name
The user-defined name of the pre-backup or post-backup
www.bobcloud.net 67
command.
Working Directory
The location in the local machine which the pre-backup or post-
backup command will run at, or the location of the command or
created batch file.
Command
The pre-backup or post-backup command which can be defined
as a native command or command to execute a batch file,
command or a VBScript (exclusively for Windows).
www.bobcloud.net 68
Pre-backup Command
A pre-backup command is used to execute an action or process before the start of a backup job. To
create a pre-backup command, follow the steps below:
1. Click the [Add] button.
2. Assign a desired name to the pre-backup command.
3. Click the [Change] button to locate the working directory of the command.
4. Input a command to be run before a backup job. In this example, the pre-backup command
will connect to a network drive before the backup process.
5. Click the [OK] button to save the created pre-backup command, then click the [Save] button
to save settings.
6. Once the backup job is complete, click the button to display the backup report log
where you can check if the pre-backup command has run successfully.
www.bobcloud.net 69
Post-backup Command
A post-backup command is used to execute an action or process after a backup job. To create a post-
backup command, follow the steps below:
1. Click the [Add] button.
2. Assign a desired name to the post-backup command.
3. Click the [Change] button to locate the working directory of the command.
4. Input a command to be run after a backup job. In this example, the post-backup command
will disconnect a network drive after the backup process.
5. Click the [OK] button to save the created post-backup command, then click the [Save]
button to save the settings.
www.bobcloud.net 70
6. Once the backup job is complete, click the button to display the backup report log
where you can check if the post-backup command has run successfully.
NOTE
Multiple commands (pre-backup and post-backup) can be created in the Command Line Tool
www.bobcloud.net 71
Reminder
This feature is enabled by default. When enabled, a backup confirmation dialog box will prompt the
user to run a backup job during Windows log off, restart or shut down.
To enable the Reminder setting, follow the steps below:
1. Go to Backup Sets, then select a backup set.
2. Choose the [Reminder] tab in the backup set settings.
3. Swipe the lever to the right to turn on the reminder.
4. Click the [Save] button to save settings.
www.bobcloud.net 72
Bandwidth Control
This option allows the user to limit the amount of bandwidth used by backup traffic between specified
times. This feature is configured as disabled by default.
There are two (2) different modes in assigning a bandwidth control:
Bandwidth Control Type
Description
Independent
Each backup and restore has its assigned bandwidth.
Share
All backup and restore operations are sharing the same assigned
bandwidth.
NOTE
Share mode does not support performing backup job on multiple destinations concurrently.
www.bobcloud.net 73
To enable the bandwidth control setting, follow the steps below:
1. Swipe the lever to the right to turn on the bandwidth control.
2. Select a bandwidth control mode.
3. If you want to add a modified bandwidth control, click the [Add] button.
4. Complete the following fields:
Name
Type
Maximum transfer rate
Field
Description
Name
The name of the bandwidth control set.
Type
The type of enforced bandwidth control period.
Maximum Transfer rate
The maximum bandwidth used.
5. Click the [OK] button to save the created bandwidth control set, then click the [Save] button
to save settings.
www.bobcloud.net 74
Others
Below is the list of other configurable options under the advanced backup set settings:
Temporary Directory
Follow Link
Volume Shadow Copy
File Permissions
Compressions
Encryption
www.bobcloud.net 75
Temporary Directory
The AhsayOBM uses the temporary directory for both backup and restore operations.
For a backup job, it is used to temporarily store:
Backup set index files. An updated set of index files is generated after each backup. The
index files are synchronized to each individual backup destination at the end of each backup
job.
Incremental/Differential delta files generated during backups.
For a restore job, it is used to temporarily store:
Full and Incremental/Differential delta files retrieved from the backup destination.
Merging of the Full and Incremental/Differential delta files as part of the restore process.
NOTES
1. For best practice, the temporary directory should be located on:
o A local drive for optimal backup and restore performance. And should not be located on:
o Windows System C:\ drive, as the C:\ drive is used by Windows and other applications. There
will be frequent disk I/O activity which may affect both backup and restore performance.
o A network drive, as it could affect both backup and restore performance.
2. It is recommended to select the ‘Remove temporary files after backup’ option on the backup set to
keep the temporary drive clear.
To change the temporary directory, follow the steps below:
1. Click the [Change] button to select a directory path for storing temporary data.
2. Click the [Save] button to save settings.
www.bobcloud.net 76
Follow Link
This feature allows the user to enable or disable the follow link which defines the NTFS junction or
symbolic link during a backup job. This option is enabled by default.
NOTE
Applicable for File Backup Sets only.
Volume Shadow Copy
This feature allows the AhsayOBM to use the Windows Volume Shadow Copy service to create a
snapshot of the selected files and/or folders on the local drive(s) of the machine, so that the
AhsayOBM can continue to back up files even if they are opened and/or have been updated by the
user. This feature is enabled by default.
WARNING
1. To use the Volume Shadow Copy, this license module must first be enabled on your backup user
account. Otherwise, just enabling this setting on the AhsayOBM will not activate this feature and can
result in possible backup errors if the backup job encounters an open file. Please contact your backup
service provider for more details.
2. Volume Shadow Copy does not support open file backups on network drives.
File Permissions
This option defines whether to back up operating system file permission of the data selected as
backup source. This option is enabled by default.
NOTE
Applicable for File Backup Sets only
www.bobcloud.net 77
Compressions
This feature is used to enable the compression of data during a backup job. When the compression is
enabled, the AhsayOBM will compress all files before it is backed up to the backup destination(s).
Newly created backup sets are configured to use Fast compression type by default.
There are three (3) different data compression types:
No Compression
Normal
Fast (Compressed size larger than normal)
NOTE
The compression type can be changed anytime even after a backup job. The modified compression type will be
applied on the next run of a backup.
www.bobcloud.net 78
Encryption
This feature allows the user to view the current encryption settings. The encryption settings can only
be enabled or disabled during the creation of backup set.
To view the encryption key of the backup set, follow the steps below:
1. Go to Backup Sets, then select a backup set.
2. Click the [Others] tab in the backup set settings.
3. In the Encryption, select ‘Unmask encryption key’ to display the encryption key of the backup
set.
NOTE
For more details about encryption settings, please refer to step no. 14. in Chapter 8 Create a Backup
Set.
www.bobcloud.net 79
Report
This feature allows the user to view the backup and restore reports.
There are three (3) functions available for this feature:
Backup
Restore
Usage
Backup
This shows the backup reports. There are four (4) filters that can be applied on this feature:
Date
Backup Set
Destination
Status
www.bobcloud.net 80
You can filter and view the backup report using the Date filter.
You can filter and view the backup report using the Backup set filter.
www.bobcloud.net 81
You can filter and view the backup report to your selected storage location using the Destination
filter.
You can filter and view the backup report with the same status using the Status filter.
www.bobcloud.net 82
To view the backup log, follow the instructions below:
1. Select and click the backup report.
2. Click the [View log] button.
Backup set, Destination, Log Date and Time, and Status can also be filtered as well as the
number of logs per page.
www.bobcloud.net 83
Restore
This shows the restore reports. There are four (4) filters that can be applied on this feature:
Date
Backup Set
Destination
Status
www.bobcloud.net 84
You can filter and view the restore report using the Date filter.
You can filter and view the restore report using the Backup set filter.
www.bobcloud.net 85
You can filter and view the restore report to your selected storage location using the Destination
filter.
You can filter and view the restore report with the same status using the Status filter.
www.bobcloud.net 86
To view the restore log, follow the instructions below:
1. Select and click the restore report.
2. Click the [View log] button.
Backup set, Log Date and Time, and Status can also be filtered as well as the number of
logs per page.
www.bobcloud.net 87
Usage
This allows the user to generate and view the backup usage in a graphical view.
www.bobcloud.net 88
Restore
This feature is used to restore backed-up files to its original or alternate location.
To restore backed-up files, follow the instructions on Chapter 11 Restore Data.
Settings
This feature allows the user to enable the Proxy Settings and Windows Event Log.
There are two (2) functions available for this feature:
Proxy
Windows Event Log
www.bobcloud.net 89
Proxy
When this feature is on, AhsayOBM will use a proxy to gain access to the internet.
To enable the Proxy Settings, follow the instructions below:
1. Slide the lever to the right to turn it on.
2. Complete the following fields:
IP address
Port
Login ID
Password
www.bobcloud.net 90
3. Click the [Test Connection] button to validate the connection.
4. Click the [Save] button to store the settings.
Windows Event Log
When this feature is on, all AhsayOBM system log information will be written under Applications
and Services Logs. User may access them through Windows event viewer in the local machine.
Note: This feature is only applicable for Windows OS.
www.bobcloud.net 91
Utilities
This allows the user to perform health check on the backed-up data, free up storage from obsolete
files, delete and decrypt backed-up data.
There are four (4) options available for this feature:
Data Integrity Check
Space Freeing Up
Delete Backup Data
Decrypt Backup Data
Data Integrity Check
This feature is used to identify data that has index-related issues, remove any corrupted file(s)
from the backup destination(s), and recalculate statistics to ensure the integrity of the backup data
and its restorability.
www.bobcloud.net 92
Notes
1. Data Integrity Check CANNOT fix or repair files that are already corrupted.
2. Data Integrity Check can only be started if there is NO active backup or restore job(s)
running on the backup set selected for the DIC job. As the backup, restore and data
Integrity check are using the same index for read and write operations. Otherwise, an error
message will be displayed in the post-DIC to indicate that the data integrity check is
completed with error(s) and had skipped a backup set with an active backup job.
The example below shows what happens when a Data Integrity Check is run on a backup set
when an active backup job is running, which will result to the Data Integrity Check stopping with
error(s). Clicking the View Log button will display the details of the cause of the Data Integrity
Check job error.
www.bobcloud.net 93
To perform a Data Integrity Check, follow the instructions below:
1. Go to the Data Integrity Check tab in the Utilities menu.
www.bobcloud.net 94
2. Click the drop-down button to select a backup set.
3. Click the drop-down button to select a backup destination.
www.bobcloud.net 95
4. Unchecked Run Cyclic Redundancy Check (CRC) option is the the default setting in
running a data integrity check.
Run Cyclic Redundancy Check (CRC)
When this option is enabled, the DIC will perform check on the integrity of the files on the
backup destination(s) against the checksum file generated at the time of the backup job. If
there is a discrepancy, this indicates that the files on the backup destination(s) are
corrupted. These corrupted files will be removed from the backup destination(s). If these
files still exist on the client machine on the next backup job, the AhsayOBM will upload the
latest copy. However, if the corrupted files are in retention area, they will not be backed up
again as the source file has already been deleted from the client machine.
The time required to complete a data integrity check depends on the number of factors
such as:
number of files and/or folders in the backup set(s)
bandwidth available on the client computer
hardware specifications of the client computer such as, the disk I/O and CPU
performance
NOTE
For user(s) with metered internet connection, additional data charges may be incurred if the
Cyclic Redundancy Check (CRC) is enabled. As the Cyclic Redundancy Check data involves
downloading the data from the backup destination(s) to the client machine in order to perform this
check.
5. Click the button to begin the Data Integrity Check.
www.bobcloud.net 96
6. Data Integrity Check will start running on the selected backup set(s) and backup
destination(s).
7. Once the DIC is complete, click the View log button to check the detailed process of the
data integrity check.
www.bobcloud.net 97
8. The detailed data integrity check log will be displayed.
For further viewing of the detailed DIC log, there are four options that can be used:
Log filter
Show filter
Logs per page
Page
www.bobcloud.net 98
Control
Screenshot
Description
Log filter
This option can be used to display logs
of the previous data integrity check
jobs.
Show filter
This option can be used to sort the data
integrity check log by its status (i.e. All,
Information, Warning, and Error).
With this filter, it will be easier to sort
the DIC logs by its status especially for
longer data integrity check logs.
www.bobcloud.net 99
Logs per page
This option allows user to control the
displayed number of logs per page.
Page
This option allows user to navigate the
logs to the next page(s).
Data Integrity Check Result
There are two possible outcomes after the completion of a data integrity check:
Data Integrity Check is completed successfully with no data corruption/issues detected;
Corrupted data (e.g. index files, checksum files and/or broken data blocks) has been detected
The screenshot below shows an example of a data integrity check log with NO data corruption/issues
detected.
www.bobcloud.net 100
If corrupted data is happened to be found, the (TEST MODE) confirmation screen will be displayed.
This is to inform user with the following details:
Items found in index
Data corrupted items
Index broken data blocks
Statistics
Test Mode confirmation
The (TEST MODE) confirmation will ONLY prompt if either of the criteria’s below matches the
backup data during the data integrity check operation:
deleted number of backup files is over 1,000
deleted number of backup file size is over 512 MB (in total)
deleted number of backup files is over 10% of total backup files
Otherwise, the Data Integrity Check job will automatically take corrective actions.
There are three options on the (TEST MODE) confirmation prompt:
Control
Screenshot
Description
Yes
Corrupted data (e.g. index files, checksum files and/or broken data
blocks) will be deleted and statistics will be recalculated.
No
No action will be taken and a prompt message will be displayed.
View log
The detailed process of the data integrity check will be displayed.
www.bobcloud.net 101
Clicking No will display the following screen:
If the Exit button is clicked, the data integrity check result will be discarded.
If the Back button is clicked, it will go back to the (TEST MODE) confirmation screen.
Notes
1. It is strongly recommended to apply corrective actions when the (TEST MODE) confirmation
screen pops up (clicking the Yes button). This is to ensure that the remaining corrupted
file(s) will be removed from the backup destination(s), so on the next backup job, these files
are backed up again if they are still present on the client machine. However, if the corrupted
files are in retention area, then they will not be backed up again as the source file has
already been deleted from the client machine.
2. If the DIC detects data blocks (.bak files) in the backup destination(s) that does not have
related index entries, then these physical data blocks will be automatically removed from
the backup destination(s) without the (TEST MODE) confirmation prompt.
Besides viewing the Data Integrity Check logs directly on the AhsayOBM client, they can be viewed
on the file system of the AhsayOBM client machine. For AhsayOBM Windows, the DIC logs are
located in:
%UserProfile%\.obm\system\IntegrityCheck
www.bobcloud.net 102
Space Freeing Up
This feature is used to remove obsolete file/s from your backup set and destination.
To perform Space Freeing Up, follow the instructions below:
1. Select a backup set from the drop-down list.
www.bobcloud.net 103
If you select a specific backup set, then you will also have to select a specific destination or all
destinations.
If you select All backup sets then there’s no need to select a destination.
www.bobcloud.net 104
2. Click the [Start] button to perform space free up.
3. The status will be shown once completed. Click the [View Log] to see the event log during the
space free up.
www.bobcloud.net 105
Delete Backup Data
This feature is used to delete backed-up files from a specific or all backup sets.
To perform deletion of backup data, follow the instructions below:
www.bobcloud.net 106
1. Select a backup set from the drop-down list.
If you select a specific backup set, then you will also have to select a specific destination or all
destinations.
www.bobcloud.net 107
If you select All backup sets then there’s no need to select a destination.
2. There are three (3) options for the type of files you wish to delete.
Delete all backed-up data
Choose from files as of job
Choose from ALL files
www.bobcloud.net 108
Delete all backup up data
Choose from files as of job
www.bobcloud.net 109
Choose from ALL files
3. Click the [Delete] button, then click [Yes] to perform deletion of files.
www.bobcloud.net 110
www.bobcloud.net 111
Decrypt Backup Data
This feature is used to restore raw data by using the data encryption key that was set for the
backup set.
To perform decryption of backup data, follow the instructions below:
1. Click the [Browse] button to locate the path of the backup set ID / blocks folder.
2. Click the [Browse] button to re-select the temporary folder for the decrypt process. Then click
the [Decrypt] button to begin
www.bobcloud.net 112
3. Select files to be decrypted.
4. Choose location where decrypted files will be restored to.
www.bobcloud.net 113
5. The status will be shown once completed.
www.bobcloud.net 114
Online Help
This allows the user to view the summary of information and instructions of each available features
in AhsayOBM.
www.bobcloud.net 115
System Tray
If AhsayOBM is installed in the computer, you will see an AhsayOBM icon in the taskbar at the lower
right corner of the screen.
When you right-click the AhsayOBM icon, a control menu will pop-up.
Ahsay OBM system tray has ten (10) controls:
Open
Backup
Backup and Logoff
Backup and Restart
Backup and Shutdown
Backup and Standby
Backup and Hibernate
Help
Stop Running Backup
Exit
www.bobcloud.net 116
Open
Select this option to open the AhsayOBM login screen.
www.bobcloud.net 117
Backup
If you want to perform a backup without going to the interface, hover the mouse to this option and
select the backup set you want to back up.
Backup and Logoff
Select this option if you want to logoff Windows after a manual backup job is done.
Backup and Restart
Choose this option if you want the machine to restart after a manual backup job is done.
www.bobcloud.net 118
Backup and Shutdown
Choose this option if you want the machine to shut down after a manual backup job is done.
Backup and Standby
Choose this option if you want the machine to go on standby after a manual backup job is done.
Backup and Hibernate
Choose this option if you want the machine to hibernate after a manual backup job is done. This
will be disabled if hibernate mode is not available on the Windows version you are using.
www.bobcloud.net 119
Help
This tab will show you the function of each backup option.
Stop Running Backup
Use this option if you wish to stop a running manual, continuous or scheduled backup.
This option will be disabled if there is no backup job running.
www.bobcloud.net 120
Exit
Select this option if you want to close the application including the AhsayOBM icon at the taskbar.
www.bobcloud.net 121
7 Create a Backup Set
1. Click the Backup Sets icon on the AhsayOBM main interface.
2. Create a new backup set by clicking the “+” icon next to Add new backup set.
3. When the Create Backup Set window appears, name your new backup set and select the
Backup set type. Then, click Next to proceed.
www.bobcloud.net 122
4. In the Backup Source window, select the files and folders for backup. Click I would like to
choose the files to backup to select individual files for backup.
5. In the Advanced Backup Source window, select folder(s) to back up all files in the folder(s).
www.bobcloud.net 123
6. Alternatively, if you want to back up only individual files instead of all files in your selected
folder(s), select the Show files checkbox at the bottom of the screen. A list of files will appear
on the right-hand side. Select the checkbox(es) next to the file(s) to back up. Then, click OK to
save your selections and close the Advanced Backup Source window.
7. In the Backup Source window, click Next to proceed.
8. When the Schedule window appears, you can configure a backup schedule to automatically run
a backup job at your specified time interval. In the Schedule window, the Run scheduled backup
for this backup set is On by default.
In the default backup schedule, there will be a scheduled backup that will be
performed daily at 8pm. You can leave it as is or you can modify it by clicking on
the existing backup schedule.
www.bobcloud.net 124
If you want to add another schedule, click . When the New Backup
Schedule window appears, specify your backup schedule. Then, click OK to save
your changes and close the New Backup Schedule window.
9. In case you have added a schedule, it will be shown in the Schedule window. Click Next to
proceed when you are done setting.
10. The Destination window will appear.
Select the appropriate option from the Backup mode dropdown menu.
Sequential (default value) – run backup jobs to each backup destination one by
one
Concurrent – run backup jobs to all backup destinations at the same time
To select a backup destination for the backup data storage, click next to Add new storage
destination / destination pool.
www.bobcloud.net 125
11. In the New Storage Destination / Destination Pool window, select the destination storage.
Then, click OK to confirm your selection.
12. In the Destination window, your selected storage destination will be shown. Click Next to
proceed.
13. In the Encryption window, the default Encrypt Backup Data option is enabled with an
encryption key preset by the system which provides the most secure protection.
You can choose from one of the following three Encryption Type options:
Default – an encryption key with 44 alpha numeric characters will be randomly
generated by the system
User password – the encryption key will be the same as the login password of your
AhsayOBM at the time when this backup set is created. Please be reminded that if you
change the AhsayOBM login password later, the encryption keys of the backup sets
previously created with this encryption type will remain unchanged.
www.bobcloud.net 126
Custom – you can customize your encryption key, where you can set your own
algorithm, encryption key, method and key length.
Note: For best practice on managing your encryption key, refer to the following Wiki article.
http://wiki.ahsay.com/doku.php?id=public:8015_faq:best_practices_for_managing_encryption_k
ey
Click Next when you are done setting.
14. If you have enabled the Encryption Key feature in the previous step, the following pop-up
window shows, no matter which encryption type you have selected.
www.bobcloud.net 127
The pop-up window has the following three options to choose from:
Unmask encryption key – The encryption key is masked by default. Click this option to
show the encryption key.
Copy to clipboard – Click to copy the encryption key, then you can paste it in another
location of your choice.
Confirm – Click to exit this pop-up window and proceed to the next step.
15. The following screen prompts you to enter the Windows login credentials for user authentication,
if you have enabled the Schedule Backup feature in step 8.
Note
If you have selected to back up individual folder(s) / file(s) on your local computer’s drive in step 5, the
Windows User Authentication request will be bypassed and therefore the screen shown above will not
display even though the Schedule Backup feature has been turned on.
It is recommended to enter the information of user with Administrator privilege to support backup of
network drives.
www.bobcloud.net 128
16. Upon successful creation of the backup set, the following screen will appear. You can click
Backup now to back up your data or click Close to exit.
www.bobcloud.net 129
8 Overview on the Backup Process
The following steps are performed during a backup job. For an overview of the detailed process for
Steps 3, 5 and 10, please refer to A, B and C.
B
A
C
www.bobcloud.net 130
www.bobcloud.net 131
www.bobcloud.net 132
www.bobcloud.net 133
9 Run Backup Jobs
Login to AhsayOBM
Login to the AhsayOBM application according to the instructions in section 6.1 Login to AhsayOBM.
Start a Manual Backup
1. Click the Backup icon on the main interface of AhsayOBM.
2. Select the backup set which you would like to start a backup for. In case you want to modify
the In-File Delta type, Destinations and Retention Policy settings, click Show advanced
option.
www.bobcloud.net 134
3. When advanced options are shown, it is recommended that you tick the checkbox next to
Run Retention Policy after backup in the Retention Policy section at the bottom. This will
help you save hard disk quota in the long run. In the In-File Delta type section, the following
three options are available:
Full – A full backup captures all the data that you want to protect. When you run
a backup job for the first time, AhsayOBM will run a full backup regardless of the
in-file delta setting.
Differential – A differential backup captures only the changes made as
compared with the last uploaded full file only (i.e. changes since the last full
backup, not since the last differential backup).
Incremental – An incremental backup captures only the changes made as
compared with the last uploaded full or delta file (i.e. changes since the last
incremental backup).
4. Click Backup to start the backup job. The status will be shown.
5. When the backup is completed, the progress bar will be green in color and the message
“Backup Completed Successfully” will appear.
www.bobcloud.net 135
6. You can click the View icon on the right hand side to check the log. A window will pop up
to show the log. Click Close to exit the pop-up window.
www.bobcloud.net 136
10 Restore Data
Traditional Restore
1. Log in to the AhsayOBM application according to the instructions in section Login to AhsayOBM.
2. Click the Restore icon on the AhsayOBM main interface.
3. All the available backup sets for restore will be listed. Select the backup set that you would like
to restore data from.
4. Select where you would like to restore your data from.
www.bobcloud.net 137
5. Select Normal restore.
6. Select to restore files from a specific backup job, or from all files available, then select the files
or folders that you would like to restore.
There are two options from the Select what to restore dropdown menu:
Choose from files as of job – This option allows you to select a backup version
from a specific date and time to restore.
Choose from ALL files – This option allows you to restore all the available
backup versions for this backup set. Among all the available backup versions,
www.bobcloud.net 138
you can even select only some of the backup versions of a file to restore.
The following is an example showing all the available backup versions of the file
Test files.rtf. The latest version is shown in solid black color and all the previous
versions are shown in grey color. You can identify the file version from the Date
modified column.
When the restore is done, you will see all the selected backup versions in the
restore destination. The latest backup version has the file name as the original
file, while the previous versions have the time stamps added to their file names
for easy identification.
7. Click the Show files checkbox to select individual files for restoration. Click Next to proceed
when you are done with the selections.
8. Select to restore the files to their Original location, or to an Alternate location. Then, click
Next to proceed.
www.bobcloud.net 139
Original location – The backed up data will be restored to the computer running
AhsayOBM under the same directory path as on the machine storing the backup
source. For example, if the backup source files are stored under Users/[User’s
Name]/Downloads folder, the data will be restored to Users/[User’s
Name]/Downloads as well on the computer running AhsayOBM.
Alternate location – You can choose to restore the data to a location of your
choice on the computer where AhsayOBM is running.
9. Click Show advanced option to configure other restore settings:
Restore file permissions
Restore file permissions are disabled by default. When you perform a file restore
on shared files or folders using a shared computer, it is recommended that you
enable Restore file permissions by ticking the checkbox so that the files restored
will not be fully accessible to everyone using the shared computer.
www.bobcloud.net 140
Follow Link (Enabled by default)
When this option is enabled, not only the symbolic link or junction point will be
restored, the directories and files that the symbolic link or junction point links to
will also be restored.
The table below summarizes the behaviors when a restore is performed with
different settings.
Follow Link
Restore to
Behavior
Original
location
Symbolic link or junction point is restored to the
original backup location.
Target directories or files are also restored to
the original backup location.
Enabled
Alternate
location
Symbolic link or junction point is restored to the
location specified.
Target directories or files are also restored to
the alternate location specified.
Original
location
Symbolic link or junction point is restored to the
original backup location.
Target directories or files are NOT restored to
the original backup location.
Disabled
Alternate
location
Symbolic link or junction point is restored to the
location specified.
Target directories or files are NOT restored to
the alternate location specified.
Resolve link (Only for restoring to Alternate Location)
This option must be used in conjunction with the Follow Link option. When this
option is enabled, the symbolic link, as well as the directories and files that the
symbolic link links to will also be restored in the alternate location you have
chosen. That means the symbolic link will point to the alternate location instead of
the original location.
The table below summarizes the behaviors when a restore is performed with this
option turned on and off.
Resolve Link
Behavior
Enabled
Symbolic link is restored to the alternate location specified,
with its target directories and files also restored to the same
location in their relative path.
Target of the link is updated to the new relative path. In
other word, the link now points to the new alternate location.
Disabled
Symbolic link is restored to the alternate location specified,
with its target directories and files also restored to the same
location in their relative path.
www.bobcloud.net 141
However, target of the link is NOT updated to the new
relative path. In other word, the link still points to the original
location.
Verify checksum of in-file delta files during restore
Verify checksum of in-file delta files during restore is disabled by default. When
you perform restore for non-RunDirect backup set, you can enable the feature by
ticking the checkbox so that the checksum of in-file delta files will be verified. As
the feature will make the restore process time longer, it is recommended to
enable the feature only if you want to verify if the merged file were correct.
10. Click Next to proceed when you are done with the settings.
11. Select the temporary directory for storing temporary files, such as delta files, when they are
being merged.
By default, the temporary files are stored under the temp directory of the user profile directory.
In case the same directory path does not exist in the computer you are running AhsayOBM, you
have to click Browse to define a new location for storing the temporary files. Otherwise, you will
not be able to perform a restore.
12. Click Restore to start the restore. The status will be shown.
13. When the restore is completed, the message “Restore Completed Successfully” will appear.
You can click the View icon on the right hand side to check the log. A window will pop up to
show the log. Click Close to exit the pop-up window.
14. In the Restore window, click Cancel to close the Restore window.
15. To exit AhsayOBM, click the “x” on the top right corner. A message will appear to ask for your
confirmation. Click Yes to close the application. If you wish to use AhsayOBM again, you will
then have to launch it again.
www.bobcloud.net 142
Restore Filter
This search feature allows you to search directories, files, and folders.
To make it more flexible, the search feature offers filtering. You can add additional pattern upon
searching. Pattern includes the following criteria:
Contains
These are Directories, Files, and Folders with the name containing the specific letter
or word.
Exact
These are Directories, Files, and Folders with the exact or accurate name.
Start With
These are Directories, Files, and Folders with the name starting with a specific letter or
word.
Ends With
These are Directories, Files, and Folders with the name ending with a specific letter or
word.
It also has the Match Case function, which serves as an additional accuracy when searching for any
specific directories, files, folders, and mails.
For more detailed examples using the restore filter on AhsayOBM, refer to Appendix B: Example
Scenarios for Restore Filter.
www.bobcloud.net 143
1. Login to AhsayOBM according to the instructions in Login to AhsayOBM.
2. Click the [Restore] icon on the main interface of AhsayOBM.
3. Select the backup set the you would like to restore.
4. Select the backup destination that you would like to restore backed-up items to.
www.bobcloud.net 144
5. Click the [Search] located on the lower left side of the screen.
6. Click the [Change] button to change the path of the restore items from other location.
www.bobcloud.net 145
www.bobcloud.net 146
7. Tick the [Search subfolders] to include available subfolders upon searching.
8. Select from the following Kind of files you want to search.
Files and Directories
Files only
Directories
9. Select from the following Type of filtering you want to search.
Contains
Exact
Starts With
Ends With
10. Enter a pattern you want and tick the [Match case] box if you want to accurately search for a
specific file.
11. Click the [Search] button and the result will be displayed.
12. Check all the items or check a specific item that you want and click the [OK] button to proceed
and you will return to the restore main screen.
www.bobcloud.net 147
Appendix
Appendix A: Uninstall AhsayOBM
Follow the steps below to uninstall AhsayOBM from your Windows.
1. Go to Control Panel > Programs and Features > Uninstall a program, then look for
AhsayOBM and double click on it.
2. The following dialog box will appear only if User Account Control is enabled. Click Continue
when you see the following message.
www.bobcloud.net 148
3. Click Yes to confirm and proceed with the uninstallation.
4. When you see the following screen:
Choose Yes to keep all user settings and the encryption keys associated with the
users. If you are likely to install AhsayOBM on the same machine in the future again,
the user settings, e.g. login details, backup sets and so forth will remain in
C:\Users\[username]\.obm by default. The screen capture below shows the folders
remain in the machine after uninstallation.
Choose No to delete all user settings and encryption keys with this uninstallation.
Please be reminded that the encryption keys are not retrievable once they have been
deleted unless the encryption keys have been uploaded to AhsayCBS server, and
therefore it will no longer be possible for backup user to recover their encryption key
in case they do not have a separate written record.
www.bobcloud.net 149
5. If there is a Run Direct restore running at the time of the AhsayOBM uninstallation, the
following screen prompts to alert you the NFS service is in use.
Select No if you do not wish to force uninstall the NFS service. AhsayOBM will be
uninstalled without affecting the NFS service, where the Run Direct restore will not
be interrupted.
Select Yes to force uninstall the NFS service. Both AhsayOBM and NFS service
will be uninstalled from the machine. The VM running Run Direct restore and the
datastore are both unmounted from the VMware server.
6. The following screen prompts when the uninstallation is completed.
7. (Optional) For a complete removal of all AhsayOBM-related files in your machine, please go
to C:\Program Files and manually remove the AhsayOBM folder.
www.bobcloud.net 150
Appendix B: Example Scenarios for Restore Filter
Example No.1: Restore filter setting from C:\Users\Administrator\Documents\TestFiles with filter type
Contains
Location:
C:\Users\Administrator\Documents\TestFiles
Search subfolders:
True
Kind:
Files and Directories
Type:
Contains
Pattern:
Set
Match Case:
True
Follow the step-by-step procedure indicated on Restore Filter.
www.bobcloud.net 151
Explanation:
All files and directories under C:\Users\Administrator\Documents\TestFiles that has the pattern that
contains with ‘Set’ with match case set to true will be included upon performing search.
As you can see on the screen shot above, the result panel contains the Name of the file or directory,
Directory which are indicated In-Folder column, Size, and Date Modified.
www.bobcloud.net 152
The restore filter setting includes the Search subfolder and Match case set to true. Meaning, the filter
will include all available subfolders in \TestFiles upon searching. And it will strictly search only the
specified pattern and case which starts with ‘Set’.
www.bobcloud.net 153
Example No.2: Restore filter setting from C:\Users\Administrator\Documents\TestFiles with filter type
Starts With
Location:
C:\Users\Administrator\Documents\TestFiles
Search subfolders:
True
Kind:
Files
Type:
Starts With
Pattern:
A
Match Case:
True
Follow the step-by-step procedure indicated on Restore Filter.
www.bobcloud.net 154
Explanation:
All files and directories under C:\Users\Administrator\Documents\TestFiles that has the pattern that
starts with ‘A’ with match case set to true will be included upon performing search.
As you can see on the screen shot above, the result panel contains the Name of the file, Directory
which are indicated In-Folder column, Size, and Date Modified.
www.bobcloud.net 155
The restore filter setting includes the Search subfolder and Match case set to true. Meaning, the filter
will include all available subfolders in \TestFiles upon searching. And it will strictly search only the
specified pattern and case which starts with ‘A’.
www.bobcloud.net 156
Example No.3: Restore filter setting from C:\Users\Administrator\Documents\TestFiles with filter type
Ends With
Location:
C:\Users\Administrator\Documents\TestFiles
Search subfolders:
True
Kind:
Files and Directories
Type:
Ends With
Pattern:
g
Match Case:
True
Follow the step-by-step procedure indicated on Restore Filter.
www.bobcloud.net 157
Explanation:
All files and directories under C:\Users\Administrator\Documents\TestFiles that has the pattern that
ends with ‘g’ with match case set to true will be included upon performing search.
As you can see on the screen shot above, the result panel contains the Name of the files and
directories, Directory which are indicated In-Folder column, Size, and Date Modified.
www.bobcloud.net 158
The restore filter setting includes the Search subfolder and Match case set to true. Meaning, the filter
will include all available subfolders in \TestFiles upon searching. And it will strictly search only the
specified pattern and case which starts with ‘g’.
www.bobcloud.net 159
Example No.4: Restore filter setting from C:\Users\Administrator\Documents\TestFiles with filter type
Exact
Location:
C:\Users\Administrator\Documents\TestFiles
Search subfolders:
True
Kind:
Files and Directories
Type:
Exact
Pattern:
SpreadSheet_05.xlsx
Match Case:
True
Follow the step-by-step procedure indicated on Restore Filter.
www.bobcloud.net 160
Explanation:
All files and directories under C:\Users\Administrator\Documents\TestFiles that has the pattern that
has the exact pattern ‘SpreadSheet_05.xlsx’ with match case set to true will be included upon
performing search.
www.bobcloud.net 161
As you can see on the screen shot above, the result panel contains the Name of the files and
directories, Directory which are indicated In-Folder column, Size, and Date Modified.
The restore filter setting includes the Search subfolder and Match case set to true. Meaning, the filter
will include all available subfolders in \TestFiles upon searching. And it will strictly search only the
specified pattern and case which starts with ‘SpreadSheet_05.xlsx’.
www.bobcloud.net 162
Appendix C: Batch Files
Below is the list of batch files which can be used as an alternative way to run the AhsayOBM.
RunCB.bat
RunConfigurator.bat
ListBackupSet.bat
RunBackupSet.bat
ListBackupJob.bat
Restore.bat
Decrypt.bat
RunDataIntegrityCheck.bat
RunCB.bat
This allows the user to open the AhsayOBM without clicking the AhsayOBM icon.
On the command prompt (cmd), export the batch file to a text editor using the following script.
C:\Program Files\AhsayOBM\bin>notepad RunCB.bat
C:\Program Files\AhsayOBM\bin>
Configure the following parameters:
SETTING_HOME – this is the directory to your setting home. If not set, the directory will be
"C:\Users\USER\.obm" by default.
e.g. SET SETTING_HOME="C:\Users\John\.obm"
DEBUG_MODE – this parameter is used to enable or disable the debug mode when opening
the AhsayOBM application.
e.g. SET DEBUG_MODE="--debug"
or SET DEBUG_MODE=""
@ECHO OFF
REM ############################# RunCB.bat ##########################
REM # You can use this batch to run the backup client application
REM ####################################################################
REM #################### Start: User Defined Section #################
REM ------------------------------ SETTING_HOME ----------------------
REM | Directory to your setting home. Default to
REM | "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME=""
REM ------------------------------- DEBUG_MODE -----------------------
REM | Enable/Disable debug mode
REM | e.g. SET DEBUG_MODE="--debug"
REM | or SET DEBUG_MODE=""
REM --------------------------------------------------------------------
SET DEBUG_MODE=""
www.bobcloud.net 163
REM #################### END: User Defined Section ###################
SET EXE_DIR=%CD%
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
SET JAVA_OPTS=-Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
) ELSE (
SET "DEP_LIB_PATH=X64"
SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
)
SET PATH=%APP_HOME%\bin\%DEP_LIB_PATH%;%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% Gui %DEBUG_MODE%
%APP_HOME% %SETTING_HOME%
@ECHO OFF
CD "%EXE_DIR%"
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
Once the parameters are configured, save the changes and close the text editor. Proceed back to
cmd and enter RunCB.bat.
C:\Program Files\AhsayOBM\bin>RunCB.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
www.bobcloud.net 164
JAVA_LIB_PATH=-Djava.library.path=..\bin
PATH=..\bin\X64;..\jvm\bin;..\jvm\bin;C:\Program Files (x86)\Common
Files\ Oracle\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\
System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program
Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program
Files (x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program
Files\Microsoft SQL Server\120\DTS\Binn\;C:\Program
Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp ..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m-Dsun.java 2d.noddraw -Dsun.nio. PageAlignDi
rectMemory=true Gui "" .. ""
If the debug mode is ENABLED, more technical information will be displayed for troubleshooting
purposes.
C:\Program Files\AhsayOBM\bin>RunCB.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -Dsun.java2d.
noddraw -Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=..\bin\X64;..\jvm\bin;..
\jvm\bin;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:
\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows
\System32\WindowsPowerShell\v1.0\;C:\Program Files\Microsoft SQL
Server\ClientSDK\ODBC\110\Tools\Binn\;C:\Program Files (x86)\Microsoft
SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\DTS\Binn\;C:\Program Files\PuTTY\CLASSPATH=..\bin;..
\bin\cb.jar
-
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true Gui "--debug" .. ""
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/asm-3.1.jar to
classpath ...OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/bcmail-jdk15on-
1.51.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/bcpkix-jdk15on-
1.51.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/bcprov-jdk15on-
151.jar to classpath ... OK
www.bobcloud.net 165
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/cab-parser-2.9.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/cab-parser-dorkbox-
util-1.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/cabinet-maker-
1.0.0.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/commons-codec-
1.6.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/commons-io-2.5.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/commons-logging-
1.1.3.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/commons-net-3.3.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/dom4j-1.6.1.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/dropbox-core-sdk-
1.7.5.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/dropbox-core-sdk-
3.0.3.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/dropbox-core-sdk-
3.0.3.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/fluent-hc-4.3.5.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/forms-1.3.0.jar to
classpath... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-api-client-
1.19.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-api-client-
jackson2-1.19.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-api-services-
drive-v2-rev158-1.19.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-http-client-
1.19.0.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-http-client-
jackson2-1.19.0.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/google-oauth-client-
1.19.0.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/httpclient-4.3.5.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/httpclient-cache-
4.3.5.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/httpcore-4.3.2.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/httpmime-4.3.5.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-annotations-
2.2.3.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-annotations-
2.7.4.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-core-
2.2.3.jar to classpath ... OK
www.bobcloud.net 166
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-core-
2.7.4.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-core-asl-
1.9.13.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-databind-
2.2.3.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-databind-
2.7.4.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-jaxrs-
1.9.2.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-mapper-asl-
1.9.13.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jackson-xc-1.9.2.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/java-xmlbuilder-
0.4.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/javax.mail.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jcifs-1.3.18.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jdokan-20170627.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jdom-1.1.3.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jersey-apache-
client4-1.18.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jersey-bundle-
1.18.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jersey-multipart-
1.18.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jettison-1.1.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jsch-0.1.50.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jsch-0.1.54.1.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/json_simple-1.1.jar
to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/jsr305-1.3.9.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/log4j-1.2.17.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/microsoft-
windowsazure-api-0.4.6.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/microsoft-
windowsazure-storage-sdk-1.0.0.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/microsoft-
windowsazure-storage-sdk-6.0.0.1.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/microsoft-
windowsazure-storage-sdk-6.0.0.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/mysql-connector-
java-5.0.8-bin.jar to classpath ... OK
www.bobcloud.net 167
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/mysql-connector-
java-5.1.46-bin.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/ojdbc6.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/org.json-
20150730.jar to classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/servlet-api.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/sinetfactory.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/bin/../bin/yavijava.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/charsets.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/jce.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/jfxswt.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/jsse.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/management-agent.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/resources.jar to
classpath ... OK
Adding file:/C:/Program%20Files/AhsayOBM/jvm/lib/rt.jar to classpath ...
OK
Eventually, the AhsayOBM login screen will be displayed.
www.bobcloud.net 168
RunConfigurator.bat
This allows the user to run the AhsayOBM through cmd. Export the batch file to a text editor using
the following script.
C:\Program Files\AhsayOBM\bin>notepad RunConfigurator.bat
C:\Program Files\AhsayOBM\bin>
Configure the following parameters:
SETTING_HOME – this is the directory to your setting home. If not set, the directory will be
"C:\Users\USER\.obm" by default.
e.g. SET SETTING_HOME="C:\Users\John\.obm"
DEBUG_MODE – this parameter is used to enable or disable the debug mode when opening
the AhsayOBM application.
e.g. SET DEBUG_MODE="--debug"
or SET DEBUG_MODE=""
@ECHO OFF
REM ############################# RunOBC.bat ##########################
REM # You can use this batch to run the backup client application
REM ####################################################################
#################### Start: User Defined Section #####################
REM ------------------------------ SETTING_HOME ----------------------
REM | Directory to your setting home. Default to
REM | "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME=""
REM ------------------------------- DEBUG_MODE -----------------------
REM | Enable/Disable debug mode
REM | e.g. SET DEBUG_MODE="--debug"
REM | or SET DEBUG_MODE=""
REM --------------------------------------------------------------------
SET DEBUG_MODE=""
REM #################### END: User Defined Section ###################
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_OPTS=-Xms128m -Xmx768m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
) ELSE (
SET "DEP_LIB_PATH=X64"
)
SET PATH=%APP_HOME%\bin\%DEP_LIB_PATH%;%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
REM ####################################################################
www.bobcloud.net 169
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% Gui --config
%DEBUG_MODE% %APP_HOME% %SETTING_HOME%
@ECHO OFF
CD "%APP_HOME%"
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
Save the changes and close the text editor. Proceed back to cmd and enter RunConfigurator.bat.
The AhsayOBM login menu will be displayed.
C:\Program Files\AhsayOBM\bin>RunConfigurator.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx768m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin
PATH=..\bin\X64;..\jvm\bin;..\jvm\bin;C:\Program Files (x86)\Common
Files\Oracle\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\Sys
tem32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program
Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program
Files (x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program
Files\Microsoft SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft
SQL Server\120\DTS\Binn\;C:\Program
Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp..\bin;..\bin\cb.jar -Xms128m -Xmx768m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true Gui --config
"" .. ""
Config file found
www.bobcloud.net 170
Login Menu
----------
(1). Login
(2). Change Network Settings
(3). Forgot Password
(4). Quit
----------
Your Choice:
If you want to modify the network settings before logging in, select option (2) from the login menu.
Login Menu
----------
(1). Login
(2). Change Network Settings
(3). Forgot Password
(4). Quit
----------
Your Choice: 2
Network Setting
---------------
(1). Backup Server URL [127.0.0.1]
(2). Port [-1]
(3). Protocol [http]
(4). Proxy Setting [Not in Use]
(5). Save and Return
(6). Discard and Return
---------------
Your Choice:
Otherwise, select option (1). Input your login name and password to log in. After a successful login,
the AhsayOBM main menu will be displayed.
Login Menu
----------
(1). Login
(2). Change Network Settings
(3). Forgot Password
(4). Quit
----------
Your Choice: 1
Login Name : Win_OBM
Password : *******************
Please wait while verifying user account with server...
www.bobcloud.net 171
Your profile has been downloaded and updated.
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:
If the password is forgotten, choose (3) on the login menu and input your login name. A link will be
sent to the email you provided in the AhsayCBS server to reset the user account password.
Login Menu
----------
(1). Login
(2). Change Network Settings
(3). Forgot Password
(4). Quit
----------
Your Choice: 3
Login Name : Win_OBM
Select option (4) to exit the AhsayOBM.
Login Menu
----------
(1). Login
(2). Change Network Settings
(3). Forgot Password
(4). Quit
----------
Your Choice: 4
Exit Configurator Utility
Press any key to continue . . .
www.bobcloud.net 172
ListBackupSet.bat
This allows the user to see the list of existing backup set/s under the backup account. Enter
ListBackupSet.bat to display the list of available backup sets with their backup set ID.
C:\Program Files\AhsayOBM\bin>ListBackupSet.bat
-
APP_HOME=..
SETTING_HOME=
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx768m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=..\jvm\bin;C:\Program
Files (x86)\Common Files\Oracle\Java\javapath;C:\Windows\system32;C:
\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell
\v1.0\;C:\Program Files\Microsoft SQL Server\Client
SDK\ODBC\110\Tools\Binn\;C:\Program Files (x86)\Microsoft SQL
Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL Server\120\
Tools\Binn\;C:\Program Files\Microsoft SQL Server\120\DTS
\Binn\;C:\Program Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
Listing all backup sets under this backup account ...
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp..\bin;..\bin\cb.jar -Xms128m -Xmx768m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
ListBackupSet ..
BackupSet Name= Data Backup, ID= 1562897045523
BackupSet Name= File Backup, ID= 1561974801639
C:\Program Files\AhsayOBM\bin>PAUSE
Press any key to continue . . .
www.bobcloud.net 173
RunBackupSet.bat
This allows the user to run a backup. Export the batch file to a text editor using the following script.
C:\Program Files\AhsayOBM\bin>notepad RunBackupSet.bat
C:\Program Files\AhsayOBM\bin>
Make sure that the following parameters are set accordingly:
BACKUP_SET – this is the backup set which you would like to run. There are two (2) options
to specify the backup set; using the backup set name or the backup set ID. If the backup set
name is not in English, use the backup set ID.
e.g. SET BACKUP_SET="FileBackupSet-1"
or SET BACKUP_SET="1119083740107"
You can leave this parameter blank if you only have one (1) backup set.
e.g. SET BACKUP_SET=""
If having multiple backup sets, you must specify which backup set you would like to be run.
BACKUP_DESTS – this is the destination(s) of the backup set which you will run. There are
two (2) options to specify the destination; using the destination name or the destination ID. If
the destination is not in English, use the destination ID.
e.g. SET BACKUP_DEST="Local-1”
or SET BACKUP_DEST="1119083740107"
Multiple destinations can be specified in a comma-separated format or you can indicate
"ALL" to run a backup for all destinations.
e.g. SET BACKUP_DESTS="Destination-1,Destination-2"
or SET BACKUP_DESTS="ALL"
BACKUP_TYPE – this is the backup set type. This does not need to be changed if backing
up a file backup set.
Options available: FILE/DATABASE/DIFFERENTIAL/LOG
e.g. SET BACKUP_TYPE="FILE" for file backup
or SET BACKUP_TYPE="DATABASE" for Full database backup
or SET BACKUP_TYPE="DIFFERENTIAL" for Differential database backup
or SET BACKUP_TYPE="LOG" for Log database backup
For MSExchange 2010 BackupSet:
e.g. SET BACKUP_TYPE="DATABASE" for Full database backup
or SET BACKUP_TYPE="DIFFERENTIAL" for Differential database backup
or SET BACKUP_TYPE="LOG" for Incremental database backup
or SET BACKUP_TYPE="COPY" for Copy database backup
SETTING_HOME – this is the directory to your setting home. If not set, the directory will be
"C:\Users\USER\.obm" by default.
e.g. SET SETTING_HOME="C:\Users\John\.obm"
www.bobcloud.net 174
DELTA_MODE – this is used to set the In-File Delta mode when running a backup.
e.g. SET DELTA_MODE="I" for Incremental In-file delta backup
or SET DELTA_MODE="D" for Differential In-file delta backup
or SET DELTA_MODE="F" for Full File backup
or SET DELTA_MODE="" for using backup set in-file delta setting
CLEANUP_MODE – same as the retention policy job and space freeing up, this parameter is
used to remove obsolete files from your backup destinations after a backup has been run.
Options available: ENABLE-CLEANUP/DISABLE-CLEANUP
e.g. SET CLEANUP_MODE="ENABLE-CLEANUP"
or SET CLEANUP_MODE="DISABLE-CLEANUP"
DEBUG_MODE – this parameter is used to enable or disable the debug mode when there is
a backup job running.
Options available: ENABLE-DEBUG/DISABLE-DEBUG
e.g. SET DEBUG_MODE="ENABLE-DEBUG"
or SET DEBUG_MODE="DISABLE-DEBUG"
@ECHO OFF
REM ################## RunBackupSet.bat ##############################
REM # You can use this batch to run any of your backup sets from the
REM # command line. Just customize the "User Defined Section" below with
REM # your values for your backup action.
REM ####################################################################
REM #################### START: User Defined Section ##################
REM ------------------------------- BACKUP_SET -----------------------
REM | The name or ID of the backup set that you want to run.
REM | If backup set name is not in English, please use ID instead.
REM | e.g. SET BACKUP_SET="1119083740107"
REM | or SET BACKUP_SET="FileBackupSet-1"
REM |
REM | You can leave this parameter blank if you have only 1 backup set.
REM --------------------------------------------------------------------
SET BACKUP_SET=""
REM ----------------------------- BACKUP_DESTS -----------------------
REM | The list of name or ID of the backup destinations that you want to
REM | run. If backup destination name is not in English, please use ID
REM | instead.
REM | e.g. SET BACKUP_DESTS="1740107119083"
REM | or SET BACKUP_DESTS="Destination-1,Destination-2"
REM | or SET BACKUP_DESTS="ALL"
REM |
REM | You can specify multiple destinations in comma-separated format,
REM | or use "ALL" to run backup for all destinations.
REM --------------------------------------------------------------------
SET BACKUP_DESTS="ALL"
REM ------------------------------- BACKUP_TYPE ----------------------
REM | Set backup type. You don't need to change this if you are backing
www.bobcloud.net 175
REM |up a file back set.
REM | Options available: FILE/DATABASE/DIFFERENTIAL/LOG
REM | e.g. SET BACKUP_TYPE="FILE" for file backup
REM | or SET BACKUP_TYPE="DATABASE" for Full database backup
REM | or SET BACKUP_TYPE="DIFFERENTIAL" for Differential database
REM |backup or SET BACKUP_TYPE="LOG" for Log database backup
REM |
REM | For MSExchange 2010 BackupSet
REM | e.g. SET BACKUP_TYPE="DATABASE" for Full database backup
REM | or SET BACKUP_TYPE="DIFFERENTIAL" for Differential database
REM |backup
REM | or SET BACKUP_TYPE="LOG" for Incremental database
REM |backup or SET BACKUP_TYPE="COPY" for Copy database
REM |backup
REM -------------------------------------------------------------------
SET BACKUP_TYPE="FILE"
REM ------------------------------ SETTING_HOME ----------------------
REM | Directory to your setting home. Default to
REM | "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME=""
REM ------------------------------- DELTA_MODE -----------------------
REM | Set In-File Delta mode.
REM | Options available: Incremental/Differential/Full (I/D/F)
REM | e.g. SET DELTA_MODE="I" for Incremental In-file delta backup
REM | or SET DELTA_MODE="D" for Differential In-file delta backup
REM | or SET DELTA_MODE="F" for Full File backup
REM | or SET DELTA_MODE="" for using backup set in-file delta
REM |setting
REM --------------------------------------------------------------------
SET DELTA_MODE=""
REM ------------------------------ CLEANUP_MODE ----------------------
REM | You can enable Cleanup mode to remove obsolete files from your
REM |backup destinations after backup.
REM | Options available: ENABLE-CLEANUP/DISABLE-CLEANUP
REM | e.g. SET CLEANUP_MODE="ENABLE-CLEANUP"
REM | or SET CLEANUP_MODE="DISABLE-CLEANUP"
REM --------------------------------------------------------------------
SET CLEANUP_MODE="DISABLE-CLEANUP"
REM ------------------------------- DEBUG_MODE -----------------------
REM | Set Debug mode.
REM | Options available: ENABLE-DEBUG/DISABLE-DEBUG
REM | e.g. SET DEBUG_MODE="ENABLE-DEBUG"
REM | or SET DEBUG_MODE="DISABLE-DEBUG"
REM --------------------------------------------------------------------
SET DEBUG_MODE="DISABLE-DEBUG"
REM #################### END: User Defined Section ####################
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
www.bobcloud.net 176
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
SET JAVA_OPTS=-Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
) ELSE (
SET "DEP_LIB_PATH=X64"
SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
)
SET PATH=%CD%\%APP_HOME%\bin\%DEP_LIB_PATH%;%PATH%
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
ECHO Running Backup Set - '%BACKUP_SET%' ...
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% RunBackupSet
%APP_HOME% %BACKUP_SET% %BACKUP_DESTS% %BACKUP_TYPE% %SETTING_HOME%
%DELTA_MODE% %CLEANUP_MODE% %DEBUG_MODE%
@ECHO OFF
CD %APP_HOME%
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
NOTE
If some parameters are not configured, the backup job will run with the default backup settings.
Save the changes and close the text editor. Proceed back to cmd and enter RunBackupSet.bat.
C:\Program Files\AhsayOBM\bin>RunBackupSet.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=C:\Program
Files\AhsayOBM\bin\..\bin\X64;..\jvm\bin;C:\Program Files (x86)\Common
Files\Oracle\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\
System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program
Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program
Files (x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program
www.bobcloud.net 177
Files\Microsoft SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft
SQL Server\120\DTS\Binn\;C:\Program
Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
Running Backup Set - '""' ...
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp ..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true RunBackupSet .. "" "ALL" "FILE" ""
"" "DISABLE-CLEANUP" "DISABLE-DEBUG"
[2019/07/12 12:50:20] [info] [-] Start [ AhsayOBM v8.2.1.18 ]
[2019/07/12 12:50:20] [info] [-] Saving encrypted backup set encryption
keys to server...
[2019/07/12 12:50:22] [info] [1562897364604] Start Backup ... [In-File
Delta: Incremental]
[2019/07/12 12:50:22] [info] [1562897364604] Using Temporary Directory
C:\Users\Administrator\temp\1562897045523\OBS@1562897364604
[2019/07/12 12:50:22] [info] [-] Start running pre-commands
[2019/07/12 12:50:22] [info] [-] Finished running pre-commands
[2019/07/12 12:50:22] [info] [1562897364604] Downloading server file
list...
[2019/07/12 12:50:22] [info] [1562897364604] Downloading server file
list... Completed
[2019/07/12 12:50:23] [info] [1562897364604] Reading backup source from
hard disk...
[2019/07/12 12:50:25] [info] [1562897364604] Getting all files which
have been moved...
[2019/07/12 12:50:25] [info] [1562897364604] Getting all files which
have been moved... Completed
[2019/07/12 12:50:25] [info] [1562897364604] Reading backup source from
hard disk... Completed
[2019/07/12 12:50:25] [info] [1562897364604] Total New Files = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total New Directories = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total New Links = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total Updated Files = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total Attributes Changed
Files = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total Deleted Files = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total Deleted Directories =
0
[2019/07/12 12:50:25] [info] [1562897364604] Total Deleted Links = 0
[2019/07/12 12:50:25] [info] [1562897364604] Total Moved Files = 0
[2019/07/12 12:50:26] [info] [1562897364604] Saving encrypted backup
file index to 1562897045523/blocks at destination AhsayCBS...
[2019/07/12 12:50:26] [info] [1562897364604] Saving encrypted backup
file index to 1562897045523/blocks/2019-07-12-12-50-20 at destination
AhsayCBS...
[2019/07/12 12:50:27] [info] [-] Start running post-commands
[2019/07/12 12:50:27] [info] [-] Finished running post-commands
[2019/07/12 12:50:27] [info] [1562897364604] Deleting temporary file
C:\Users\Administrator\temp\1562897045523\OBS@1562897364604
www.bobcloud.net 178
[2019/07/12 12:50:27] [info] [1562897364604] Backup Completed
Successfully
Press any key to continue . . .
www.bobcloud.net 179
ListBackupJob.bat
This allows the user to display the list of backup jobs under a specific backup set. Enter the
following script to export the batch file to a text editor.
C:\Program Files\AhsayOBM\bin>notepad ListBackupJob.bat
C:\Program Files\AhsayOBM\bin>
Configure the following parameters:
BACKUP_SET – this is the backup set which you would like to be displayed. There are two (2)
ways to specify the backup set; using the backup set name or the backup set ID. If the
backup set name is not in English, use the backup set ID.
e.g. SET BACKUP_SET="FileBackupSet-1"
or SET BACKUP_SET="1119083740107"
You can leave this parameter blank if you only have one (1) backup set.
e.g. SET BACKUP_SET=""
BACKUP_DEST – this is the destination of the backup set which you would like to be
displayed. There are two (2) ways to specify the backup destination; using the destination
name or the destination ID. If the destination is not in English, use the destination ID.
e.g. SET BACKUP_DEST="Local-1"
or SET BACKUP_DEST="1119083740107"
You can leave this parameter blank if you only have one (1) backup destination.
e.g. SET BACKUP_DEST=""
@ECHO OFF
REM ################## ListBackupJob.bat #############################
REM # You can use this batch to list all backup jobs which ran under #
REM # this backup set. #
REM ####################################################################
REM #################### Start: User Defined Section #################
REM ------------------------------- BACKUP_SET ----------------------
REM | The name or ID of the backup set that you want to run
REM | If backup set name is not in English, please use BackupSetID
REM | e.g. SET BACKUP_SET="1119083740107"
REM | or SET BACKUP_SET="FileBackupSet-1"
REM |
REM | You can leave this parameter blank if you have only 1 backup set.
REM --------------------------------------------------------------------
SET BACKUP_SET="File Backup"
REM ------------------------------ BACKUP_DEST -----------------------
REM | The name or ID of the destination that you want to list
REM | If destination name is not in English, please use DestinationID
REM | e.g. SET BACKUP_DEST="1119083740107"
REM | or SET BACKUP_DEST="CBS"
REM |
www.bobcloud.net 180
REM | You can leave this parameter blank if you have only 1 destination.
REM --------------------------------------------------------------------
SET BACKUP_DEST=""
REM #################### END: User Defined Section ####################
REM ####################################################################
REM # SCRIPT USAGE
REM ####################################################################
REM # Input Arguments will overwrite the above settings
REM # defined in 'User Defined Section'.
IF NOT %1.==. SET BACKUP_SET=%1
IF NOT %2.==. SET BACKUP_DEST=%2
REM ####################################################################
SET APP_HOME=..
SET SETTING_HOME=
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_OPTS=-Xms128m -Xmx768m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDire
ctMemory=true
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
ECHO Listing all backup jobs for Backup Set - '%BACKUP_SET%' ...
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% ListBackupJob --
app-home=%APP_HOME% --backup-set=%BACKUP_SET% --backup-
dest=%BACKUP_DEST% --setting-home=%SETTING_HOME%
PAUSE
NOTE
You can only select one (1) backup set and one (1) destination at a time.
Save the changes and close the text editor. Proceed back to cmd and enter ListBackupJob.bat.
The list of backup jobs under the specified backup set will be displayed.
C:\Program Files\AhsayOBM\bin>ListBackupJob.bat
-
APP_HOME=..
www.bobcloud.net 181
SETTING_HOME=
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx768m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=..\jvm\bin;C:\Program
Files (x86)\Common Files\Oracle\Java\javapath;C:\Windows\system32;C:
\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell
\v1.0\;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools
\Binn\;C:\Program Files (x86)\Microsoft SQL
Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\DTS\Binn\;C:\Program
Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
Listing all backup jobs for Backup Set - '"File Backup"' ...
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp..\bin;..\bin\cb.jar -Xms128m -Xmx768m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true ListBackupJob -
-app-home=.. --backup-set="File Backup" --backup-dest="" --setting-home=
File Backup [1562220462692]
2019-07-05-11-31-41
2019-07-04-20-00-00
2019-07-04-14-08-13
C:\Program Files\AhsayOBM\bin>PAUSE
Press any key to continue . . .
www.bobcloud.net 182
Restore.bat
This allows the user to restore backed-up data. Enter the following script to export the batch file to
a text editor.
C:\Program Files\AhsayOBM\bin>notepad Restore.bat
C:\Program Files\AhsayOBM\bin>
Configure the following parameters:
BACKUP_SET – this is the backup set which you would like to restore. If the backup set
name is not in English, use the backup set ID.
e.g. SET BACKUP_SET="FileBackupSet-1"
or SET BACKUP_SET="1119083740107"
DESTINATION – this is the destination where you want to restore the backed-up data from. If
the destination is not in English, use the destination ID.
e.g. SET DESTINATION="Local-1"
or SET DESTINATION="1119083740107"
You can leave this parameter blank if you only have one (1) backup destination.
e.g. SET DESTINATION=""
RESTORE_TO – this is the location where the files will be restored.
e.g. SET RESTORE_TO=" C:\Temp"
RESTORE_FROM – this is the selected file or directory on the backup server which you
would like to restore.
e.g. SET RESTORE_FROM=" C:\Users"
POINT_IN_TIME – this is the point-in-time snapshot (of a successful backup) that you want to
restore from the backup server. Use "Current" for the latest backup snapshot. You can
retrieve the point in time by using the ListBackupJob.bat.
e.g. SET POINT_IN_TIME="2006-10-04-12-57-13"
or SET POINT_IN_TIME="Current"
RESTORE_PERMISSION – set this to “Y” if you want to restore file permissions. Otherwise,
indicate “N” if you do NOT want to restore file permissions.
e.g. SET RESTORE_PERMISSION="N"
SKIP_INVALID_KEY – set this to “Y” if you want to skip restore file with an invalid key. Set
this to "N" if you want to prompt user to input the correct key.
e.g. SET SKIP_INVALID_KEY="N"
SYNC_OPTION – set this to "Y" if you want to enable the sync option. Set this to "N" if you do
NOT want to enable sync option. Leave this blank if you want to prompt user for a selection.
www.bobcloud.net 183
e.g. SET SYNC_OPTION="N"
REPLACE_EXISTING_FILE – set to "--all" to replace all existing file(s) of the same filename.
Set this to "--none" to skip all existing file(s) with the same filename. Leave this blank if you
want to prompt user for a selection.
e.g. SET REPLACE_EXISTING_FILE="--all"
SETTING_HOME – this is the directory to your setting home. If not set, the directory will be
"C:\Users\USER\.obm" by default.
e.g. SET SETTING_HOME="C:\Users\John\.obm"
FILTER – this parameter is used to filter the files that you want to restore.
e.g. SET FILTER="-Pattern=.txt-Type=exact-Target=toFile"
TEMP_DIR – this is the directory where you would like to store the restore files temporarily.
e.g. SET TEMP_DIR="C:\Temp"
VERIFY_CHKSUM – set this to "Y" if you want to verify the in-file delta file checksum during
restore. Otherwise, set this to "N" if you do NOT want to verify the in-file delta file checksum
during restore.
e.g. SET VERIFY_CHKSUM="N"
@ECHO OFF
REM ############################## Restore.bat #######################
REM # You can use this batch file to restore backup files using command-
REM # line. Just customize the "User Define Section" below with values
REM # for your restore action.
REM ####################################################################
REM #################### Start: User Defined Section #################
REM ------------------------------- BACKUP_SET -----------------------
REM | The name or ID of the backup set that you want to restore.
REM | If backup set name is not in English, please use ID instead.
REM | e.g. SET BACKUP_SET="1119083740107"
REM | or SET BACKUP_SET="FileBackupSet-1"
REM |
REM | You can leave this parameter blank if you have only 1 backup set.
REM --------------------------------------------------------------------
SET BACKUP_SET=""
REM ------------------------------ DESTINATION -----------------------
REM | The name or ID of the backup destination that you want to restore
REM | from.
REM | If backup destination name is not in English, please use ID
REM | instead.
REM | e.g. SET DESTINATION="1740107119083"
REM | or SET DESTINATION="Destination-1"
REM |
REM | You can leave this parameter blank if you have only 1 destination.
REM --------------------------------------------------------------------
SET DESTINATION=""
www.bobcloud.net 184
REM ------------------------------- RESTORE_TO -----------------------
REM | Directory to where you want files to be restored
REM | Use "\\\\" instead of "\\" when you specify a UNC path
REM | set to "" to restore files to original location
REM | e.g. SET RESTORE_TO="C:\Temp"
REM ------------------------------------------------------------------
SET RESTORE_TO="C:\Temp"
REM ------------------------------ RESTORE_FROM ----------------------
REM | File/Directory on the backup server that you would like to restore
REM | e.g. SET RESTORE_FROM="C:\Data"
REM --------------------------------------------------------------------
SET RESTORE_FROM=" C:\Users\Administrator\Desktop\Data backup"
REM ----------------------------- POINT_IN_TIME ----------------------
REM | The point-in-time snapshot (successful backup) that you want to
REM | restore from the backup server.
REM | Use "Current" for the latest backup
REM | snapshot e.g. SET POINT_IN_TIME="2006-10-04-12-57-13"
REM | or SET POINT_IN_TIME="Current"
REM |
REM | You can retrieve the point in time by using the ListBackupJob.bat
REM --------------------------------------------------------------------
SET POINT_IN_TIME="Current"
REM --------------------------- RESTORE_PERMISSION -------------------
REM | set to "Y" if you want to restore file permissions
REM | set to "N" if you do NOT want to restore file permissions
REM --------------------------------------------------------------------
SET RESTORE_PERMISSION="N"
REM ---------------------------- SKIP_INVALID_KEY --------------------
REM | set to "Y" if you want to skip restore file with invalid key
REM | set to "N" if you want to prompt user to input a correct key
REM --------------------------------------------------------------------
SET SKIP_INVALID_KEY="N"
REM ------------------------------ SYNC_OPTION -----------------------
REM | Delete extra files
REM | set to "Y" if you want to enable sync option
REM | set to "N" if you do NOT want to enable sync option
REM | set to "" to prompt for selection
REM --------------------------------------------------------------------
SET SYNC_OPTION="N"
REM ------------------------- REPLACE_EXISTING_FILE ------------------
REM | set to "--all" to replace all existing file(s) of the same
REM |filename set to "--none" to skip all existing file(s) with the same
REM |filename set to "" to prompt for selection
REM --------------------------------------------------------------------
SET REPLACE_EXISTING_FILE="--all"
REM ------------------------------ SETTING_HOME ----------------------
REM | Directory to your setting home. Default to
REM | "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME=""
REM OPTION:
REM --------------------------------- FILTER -------------------------
www.bobcloud.net 185
REM | Filter out what files you want to restore
REM | -Pattern=xxx-Type=yyy-Target=zzz
REM | where xxx is the filter pattern,
REM | yyy is the filter type, whice can be one of the following:
REM | [exact | exactMatchCase | contains | containsMatchCase|
REM | startWith | startWithMatchCase | endWith |
REM |endWithMatchCase] |
REM | zzz is the filter target, which can be one of the following:
REM | [toFile | toFileDir | toDir]
REM |
REM | e.g. SET FILTER="-Pattern=.txt-Type=exact-Target=toFile"
REM --------------------------------------------------------------------
SET FILTER=""
REM -------------------------------- TEMP_DIR ------------------------
REM | Directory to where you want to store restore files temporarily
REM | Use "\\\\" instead of "\\" when you specify a UNC path
REM | set to "" to use the temporary directory in the backup set
REM | e.g. SET TEMP_DIR="C:\Temp"
REM --------------------------------------------------------------------
SET TEMP_DIR=""
REM ----------------------------- VERIFY_CHKSUM ----------------------
REM | set to "Y" if you want to verify in-file delta file checksum
REM | during restore
REM | set to "N" if you do NOT want to verify in-file delta file
REM | checksum during restore
REM -------------------------------------------------------------------
SET VERIFY_CHKSUM="N"
REM #################### END: User Defined Section ###################
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
SET JAVA_OPTS=-Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
) ELSE (
SET "DEP_LIB_PATH=X64"
SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
)
SET PATH=%CD%\%APP_HOME%\bin\%DEP_LIB_PATH%;%PATH%
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
www.bobcloud.net 186
ECHO CLASSPATH=%CLASSPATH%
ECHO -
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% Restore --
to=%RESTORE_TO% --from=%RESTORE_FROM% --backup-set=%BACKUP_SET% --
backup-dest=%DESTINATION% %REPLACE_EXISTING_FILE% --date=%POINT_IN_TIME%
--set-permission=%RESTORE_PERMISSION% --skip-invalid-
key=%SKIP_INVALID_KEY% --sync=%SYNC_OPTION% --filter=%FILTER% --temp-
dir=%TEMP_DIR% --verify-delta-file-chksum=%VERIFY_CHKSUM% --app-
home=%APP_HOME% --setting-home=%SETTING_HOME%
@ECHO OFF
CD %APP_HOME%
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
NOTE
If some parameters are not set, the restore job will run with the default restore settings.
Save the changes and close the text editor. Proceed back to cmd and enter Restore.bat.
C:\Program Files\AhsayOBM\bin>Restore.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\binPATH=C:\Program Files\AhsayOBM
\bin\..\bin\X64;..\jvm\bin;C:\Program Files (x86)\Common Files\Oracle\
Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;
C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program Files\Microsoft
SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program Files
(x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft
SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\DTS\Binn\;C:\Program Files\PuTTY\CLASSPATH=..
\bin;..\bin\cb.jar
-
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp ..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true Restore --to="C:\Temp" --
from="C:\Users\Administrator\Desktop\Data backup" --backup-set="" --
backup-dest="" "--all" --date="Current"--set-permission="N" --skip-
www.bobcloud.net 187
invalid-key="N" --sync="N" --filter="" --temp-dir="" --verify-delta-
file-chksum="N" --app-home=.. --setting-home=""
Filter Pattern not set, filter would not apply to restore
Temporary directory not set, use the temporary directory in the backup
set
[2019-07-12 11:52:03] Start [ AhsayOBM v8.2.1.18 ]
[2019-07-12 11:52:03] OS: Windows Server 2012 R2 (w2k16R2-std); CPU
Model: VMware-Intel(R) Xeon(R) CPU E5520 @ 2.27GHz,Intel(R) Xeon(R) CPU
E5520 @2.27GHz; Number of Processors: 4; Heap Size: 32.3MB (Current) /
1.8GB (Maximum); Physical Memory: 726.9MB (Free) / 4GB (Total)
[2019-07-12 11:52:03] start,Start [ AhsayOBM v8.2.1.18 ],0,0,0,,0,0
[2019-07-12 11:52:03] Initializing decrypt action...
[2019-07-12 11:52:03] Initializing decrypt action... Completed
[2019-07-12 11:52:04] Creating new directory... "C:\Temp\C_"
[2019-07-12 11:52:04] Creating new directory... "C:\Temp\C_\Users"
[2019-07-12 11:52:04] Creating new directory...
"C:\Temp\C_\Users\Administrator"
[2019-07-12 11:52:04] Creating new directory...
"C:\Temp\C_\Users\Administrator\Desktop"
[2019-07-12 11:52:04] Creating new directory...
"C:\Temp\C_\Users\Administrator\Desktop\Data backup"
[2019-07-12 11:52:04] Downloading...
"C:\Temp\C_\Users\Administrator\Desktop\Data backup\Sample file.txt"
(Total 0 bytes)
[2019-07-12 11:52:04] Downloading...
"C:\Temp\C_\Users\Administrator\Desktop\Data backup\Text File.txt"
(Total 0 bytes)
[2019-07-12 11:52:05] file,C:\Temp\C_\Users\Administrator\Desktop\Data
backup\Sample file.txt,0,0,1562897245044,,1562903525530,1562903525531
[2019-07-12 11:52:05] file,C:\Temp\C_\Users\Administrator\Desktop\Data
backup\Text File.txt,0,0,1562897254708,,1562903525531,1562903525531
[2019-07-12 11:52:06] Restore Completed Successfully
[2019-07-12 11:52:06] end,RESTORE_STOP_SUCCESS,0,0,0,,0,0
Press any key to continue . . .
www.bobcloud.net 188
Decrypt.bat
This allows the user to restore raw data. Enter the following script to export the batch file to a text
editor.
C:\Program Files\AhsayOBM\bin>notepad Decrypt.bat
C:\Program Files\AhsayOBM\bin>
Configure the following parameters:
SOURCE_DIR – this is the path of the folder which contains the backed-up files that you want
to decrypt.
e.g. SOURCE_DIR="C:\john\backupdata\1498444438340\blocks”
ENCRYPT_KEY – this is the encryption key that was set for the backup set. You can leave
this parameter blank if the backed-up data is not encrypted.
e.g. ENCRYPT_KEY="NjQAtHhBSyAVgfFkaFI="
e.g. ENCRYPT_KEY=""
DECRYPT_TO – this is the specified directory where the decrypted files will be stored.
e.g. SET DECRYPT_TO=" C:\Temp"
DECRYPT_FROM – this is the file or directory on the backup data that you would like to
decrypt.
e.g. SET DECRYPT_TO="C:\Data"
POINT_IN_TIME – this is the point-in-time snapshot (of a successful backup) that you want to
decrypt from the backed-up data. Use "Current" for the latest backup snapshot. The point-
in- time should be one of the directory names under SOURCE_DIR.
e.g. SET POINT_IN_TIME="2006-10-04-12-57-13"
or SET POINT_IN_TIME="Current"
RESTORE_PERMISSION – set this to "Y" if you want to restore file permissions. Otherwise,
indicate “N” if you do NOT want to restore file permissions.
e.g. SET RESTORE_PERMISSION="N"
SKIP_INVALID_KEY – set this to "Y" if you want to skip decrypt file with invalid key. Set this
set to "N" if you want to prompt user to input a correct key.
e.g. SKIP_INVALID_KEY="Y"
SYNC_OPTION – set this to "Y" if you want to enable sync option. Set this to "N" if you do
NOT want to enable sync option. Leave this parameter blank if you want to prompt user for
selection.
e.g. SET SYNC_OPTION="N"
e.g. SET SYNC_OPTION=""
www.bobcloud.net 189
REPLACE_EXISTING_FILE – set this to "--all" if you want to replace all existing file(s) of the
same filename. Set this to "--none" if you want to skip all existing file(s) with the same
filename. Leave this parameter blank if you want to prompt user for selection.
e.g. SET REPLACE_EXISTING_FILE="--all"
e.g. SET REPLACE_EXISTING_FILE="--none"
e.g. SET REPLACE_EXISTING_FILE=""
SETTING_HOME – this is the directory to your setting home. This is where the log files will be
placed. If not set, the directory will be "C:\Users\USER\.obm" by default.
e.g. SET SETTING_HOME="C:\Users\John\.obm"
FILTER – this parameter is used to filter the files that you want to decrypt.
e.g. SET FILTER="-Pattern=.txt-Type=exact-Target=toFile"
TEMP_DIR – this is the directory where you would like to store the decrypt files temporarily.
e.g. SET TEMP_DIR="C:\Temp"
VERIFY_CHKSUM – set this to "Y" if you want to verify the in-file delta file checksum during
decrypt. Set this to "N" if you do NOT want to verify the in-file delta file checksum during
decrypt.
file
e.g. SET VERIFY_CHKSUM="N"
@ECHO OFF
REM ############################## Decrypt.bat #######################
REM # You can use this batch file to decrypt backup files using command-
REM # line. Just customize the "User Define Section" below with values
REM # for your decrypt action.
REM ###################################################################
REM #################### Start: User Defined Section ################
REM ------------------------------- SOURCE_DIR -----------------------
REM | The path to the [<backup set ID>/blocks] folder which contains |
REM | the backup files that you want to decrypt.
REM | This folder should be located under backup destination physically.
REM | e.g. SET SOURCE_DIR="C:\john\backupdata\1498444438340\blocks"
REM | where directory "C:\john\backupdata" is path of local destination
REM --------------------------------------------------------------------
SET SOURCE_DIR="C:\Program
Files\AhsayCBS\user\Win_OBM\1562897045523\blocks"
REM ------------------------------ ENCRYPT_KEY -----------------------
REM | The encrypting key of the backup data.
REM | e.g. SET ENCRYPT_KEY="RU5DUllQVF9LRVk="
REM |
REM | You can leave this parameter blank if backup data is not
REM | encrypted.
REM --------------------------------------------------------------------
SET ENCRYPT_KEY=""
REM ------------------------------- DECRYPT_TO -----------------------
REM | Directory to where you want files to be decrypted
REM | Use "\\\\" instead of "\\" when you specify a UNC path
REM | e.g. SET DECRYPT_TO="C:\Temp"
www.bobcloud.net 190
REM --------------------------------------------------------------------
SET DECRYPT_TO="C:\Data"
REM ------------------------------ DECRYPT_FROM ----------------------
REM | File/Directory on the backup data that you would like to decrypt
REM | e.g. SET DECRYPT_FROM="C:\Data"
REM --------------------------------------------------------------------
SET DECRYPT_FROM="C:\Users\Administrator\Desktop\Data backup"
REM ----------------------------- POINT_IN_TIME ----------------------
REM | The point-in-time snapshot (successful backup) that you want to
REM | decrypt from the backup data. Use "Current" for the latest backup
REM | snapshot
REM | e.g. SET POINT_IN_TIME="2006-10-04-12-57-13"
REM | or SET POINT_IN_TIME="Current"
REM |
REM | The point in time should be one of the directory name under
REM | SOURCE_DIR unless you want to decrypt latest backup snapshot.
REM --------------------------------------------------------------------
SET POINT_IN_TIME="Current"
REM --------------------------- RESTORE_PERMISSION -------------------
REM | set to "Y" if you want to restore file permissions
REM | set to "N" if you do NOT want to restore file permissions
REM --------------------------------------------------------------------
SET RESTORE_PERMISSION="N"
REM ---------------------------- SKIP_INVALID_KEY --------------------
REM | set to "Y" if you want to skip decrypt file with invalid key
REM | set to "N" if you want to prompt to input a correct key
REM --------------------------------------------------------------------
SET SKIP_INVALID_KEY="Y"
REM ------------------------------ SYNC_OPTION -----------------------
REM | Delete extra files
REM | set to "Y" if you want to enable sync option
REM | set to "N" if you do NOT want to enable sync option
REM | set to "" to prompt for selection
REM --------------------------------------------------------------------
SET SYNC_OPTION="N"
REM ------------------------- REPLACE_EXISTING_FILE ------------------
REM | set to "--all" to replace all existing file(s) of the same
REM | filename set to "--none" to skip all existing file(s) with the
REM | same filename set to "" to prompt for selection
REM --------------------------------------------------------------------
SET REPLACE_EXISTING_FILE="--all"
REM ----------------------------- SETTING_HOME -----------------------
REM | Directory to your setting home. Log files will be located inside.
REM | Default to "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME="C:\Users\Administrator\.obm"
REM OPTION:
REM --------------------------------- FILTER -------------------------
REM | Filter out what files you want to decrypt
REM | -Pattern=xxx-Type=yyy-Target=zzz
REM | where xxx is the filter pattern,
REM | yyy is the filter type, whice can be one of the following:
www.bobcloud.net 191
REM | [exact | exactMatchCase | contains | containsMatchCase|
REM | startWith | startWithMatchCase | endWith |
REM | endWithMatchCase]
REM | zzz is the filter target, which can be one of the following:
REM | [toFile | toFileDir | toDir]
REM |
REM | e.g. SET FILTER="-Pattern=.txt-Type=exact-Target=toFile"
REM --------------------------------------------------------------------
SET FILTER=""
REM -------------------------------- TEMP_DIR ------------------------
REM | Directory to where you want to store decrypt files temporarily
REM | Use "\\\\" instead of "\\" when you specify a UNC path
REM | e.g. SET TEMP_DIR="C:\Temp"
REM --------------------------------------------------------------------
SET TEMP_DIR="C:\Temp"
REM ----------------------------- VERIFY_CHKSUM ----------------------
REM | set to "Y" if you want to verify in-file delta file checksum
REM | during decrypt
REM | set to "N" if you do NOT want to verify in-file delta file
REM | checksum during decrypt
REM --------------------------------------------------------------------
SET VERIFY_CHKSUM="N"
REM #################### END: User Defined Section ###################
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
SET JAVA_OPTS=-Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
) ELSE (
SET "DEP_LIB_PATH=X64"
SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
)
SET PATH=%CD%\%APP_HOME%\bin\%DEP_LIB_PATH%;%PATH%
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS% Decrypt --
to=%DECRYPT_TO% --from=%DECRYPT_FROM% --source-dir=%SOURCE_DIR% --
www.bobcloud.net 192
key=%ENCRYPT_KEY% %REPLACE_EXISTING_FILE% --date=%POINT_IN_TIME% --set-
permission=%RESTORE_PERMISSION% --skip-invalid-key=%SKIP_INVALID_KEY% --
sync=%SYNC_OPTION% --filter=%FILTER% --temp-dir=%TEMP_DIR% --verify-
delta-file-chksum=%VERIFY_CHKSUM% --app-home=%APP_HOME% --setting-
home=%SETTING_HOME%
@ECHO OFF
CD %APP_HOME%
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
Save the changes and close the text editor. On the cmd, enter Decrypt.bat. When asked if you
want to input the encrypting key, select ‘1(Yes). Enter the correct encryption key to continue.
C:\Program Files\AhsayOBM\bin>Decrypt.bat
-
APP_HOME=..
SETTING_HOME="C:\Users\Administrator\.obm"
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=C:\Program
Files\AhsayOBM\bin
\..\bin\X64;..\jvm\bin;C:\Program Files (x86)\Common
Files\Oracle\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\
System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program
Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program
Files (x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program
Files\Microsoft SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft
SQL Server\120\DTS\
Binn\;C:\Program Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp ..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true Decrypt --to="C:\Data" --
from="C:\Users\Administrator\Desktop\Data backup" --source-
dir="C:\Program Files\AhsayCBS\user\Win_OBM\1562897045523\blocks" --
key="" "--all" --date="Current" --set-permission="N" --skip-invalid-
key="Y" --sync="N" --filter="" --temp-dir="C:\Temp" --verify-delta-file-
chksum="N" --app-home=.. --setting-home="C:\Users\Administrator\.obm"
Filter Pattern not set, filter would not apply to decrypt
(C:\Program Files\Ahsay CBS\user\Win_OBM\1562897045523\blocks\index-
s0.j00.100.16be3f1a078.cgz)
Please input the Encrypting Key.
Want to input encrypting key?
1.YES 2.CANCEL >>1
Enter Correct Encrypting Key:*******************
[2019-07-12 10:27:23] Start [ AhsayOBM v8.2.1.18 ]
www.bobcloud.net 193
[2019-07-12 10:27:25] OS: Windows Server 2012 R2 (w2k16R2-std); CPU
Model: VMware-Intel(R) Xeon(R) CPU E5520 @ 2.27GHz,Intel(R) Xeon(R) CPU
E5520 @ 2.27GHz; Number of Processors: 4; Heap Size: 35.6MB (Current)
/ 1.8GB (Maximum); Physical Memory: 722.2MB (Free) / 4GB (Total)
[2019-07-12 10:27:25] start,Start [ AhsayOBM v8.2.1.18 ],0,0,0,,0,0
[2019-07-12 10:27:25] Initializing decrypt action...
[2019-07-12 10:27:25] Initializing decrypt action... Completed
[2019-07-12 10:27:26] Creating new directory... "C:\Data\C_"
[2019-07-12 10:27:26] Creating new directory... "C:\Data\C_\Users"
[2019-07-12 10:27:26] Creating new directory...
"C:\Data\C_\Users\Administrator"
[2019-07-12 10:27:26] Creating new directory...
"C:\Data\C_\Users\Administrator\Desktop"
[2019-07-12 10:27:26] Creating new directory...
"C:\Data\C_\Users\Administrator\Desktop\Data backup"
[2019-07-12 10:27:26] Downloading...
"C:\Data\C_\Users\Administrator\Desktop\Data backup\Sample file.txt"
(Total 0 bytes)
[2019-07-12 10:27:26] Downloading...
"C:\Data\C_\Users\Administrator\Desktop\Data backup\Text File.txt"
(Total 0 bytes)
[2019-07-12 10:27:27] file,C:\Data\C_\Users\Administrator\Desktop\Data
backup\Sample file.txt,0,0,1562897245044,,1562898447522,1562898447522
[2019-07-12 10:27:27] file,C:\Data\C_\Users\Administrator\Desktop\Data
backup\Text File.txt,0,0,1562897254708,,1562898447522,1562898447522
[2019-07-12 10:27:28] Restore Completed Successfully
[2019-07-12 10:27:28] end,RESTORE_STOP_SUCCESS,0,0,0,,0,0
Press any key to continue . . .
www.bobcloud.net 194
RunDataIntegrityCheck.bat
This allows the user to perform data integrity check to all available backup sets. Enter the following
script to export the batch file to a text editor.
C:\Program Files\AhsayOBM\bin>notepad RunDataIntegrityCheck.bat
C:\Program Files\AhsayOBM\bin>
To perform a data integrity check, the following parameters must be set first:
SETTING_HOME (Optional)– this is the directory to your setting home. This is where the log
files will be located. If not set, the directory will be "C:\Users\USER\.obm" by default
e.g. SET SETTING_HOME="C:\Users\John\.obm"
BACKUP_SET – this is the backup set which you would like to run a data integrity check on.
If the backup set name is not in English, use the backup set ID.
e.g. SET BACKUP_SET="FileBackupSet-1"
or SET BACKUP_SET="1119083740107"
You can leave this parameter blank if you only have one (1) backup set.
e.g. SET BACKUP_SET=""
BACKUP_DEST – this is the destination of the backup set which you will run a data integrity
check on. If the destination is not in English, use the destination ID.
e.g. SET BACKUP_DEST="Destination-1"
or SET BACKUP_DEST="1740107119083"
This parameter can be left blank if you have a single destination.
e.g. SET BACKUP_DEST=""
This parameter will be ignored if the BACKUP_SET is set to "ALL".
e.g. SET BACKUP_SET="ALL"
CRC_MODE – when enabled, a Cyclic Redundancy Check (CRC) will run during the data
integrity check.
e.g. SET CRC_MODE="ENABLE-CRC"
SET CRC_MODE="DISABLE-CRC"
@ECHO OFF
REM ####################### RunDataIntegrityCheck.bat #################
REM # You can use this batch to run any of your backup sets from the
REM # command line. Just customize the "User Defined Section" below with
REM # your values for your backup action.
REM ###################################################################
REM ###################### START: User Defined Section ##############
REM ------------------------ SETTING_HOME (Optional) -----------------
www.bobcloud.net 195
REM | Directory to your setting home. Default to
REM | "C:\Users\USER\.obm" when not set.
REM | e.g. SET SETTING_HOME="C:\Users\John\.obm"
REM --------------------------------------------------------------------
SET SETTING_HOME=""
REM ------------------------------- BACKUP_SET -----------------------
REM | The name or ID of the backup set that you want to run.
REM | If backup set name is not in English, please use ID instead.
REM | e.g. SET BACKUP_SET="1119083740107"
REM | or SET BACKUP_SET="FileBackupSet-1"
REM | You can use "ALL" to run data integrity check for all backup sets.
REM | i.e. SET BACKUP_SET="ALL"
REM |
REM | You can leave this parameter blank if you have only 1 backup set.
REM --------------------------------------------------------------------
SET BACKUP_SET="Data Backup"
REM ----------------------------- BACKUP_DEST ------------------------
REM | The name or ID of the backup destination that you want to run.
REM | If backup destination name is not in English, please use ID
REM | instead. e.g. SET BACKUP_DEST="1740107119083"
REM | or SET BACKUP_DEST="Destination-1"
REM | You can use "ALL" to run data integrity check for all
REM | destinations. i.e. SET BACKUP_DEST="ALL"
REM |
REM | You can leave this parameter blank if you have only 1 destination.
REM | Remark: This option is ignored if BACKUP_SET="ALL"
REM --------------------------------------------------------------------
SET BACKUP_DEST=""
REM -------------------------------- CRC_MODE ------------------------
REM | You can run Cyclic Redundancy Check (CRC) during data integrity
REM | check
REM | Options available: ENABLE-CRC/DISABLE-CRC
REM | i.e. SET CRC_MODE="ENABLE-CRC"
REM | or SET CRC_MODE="DISABLE-CRC"
REM --------------------------------------------------------------------
SET CRC_MODE="DISABLE-CRC"
REM ####################### END: User Defined Section #################
SET APP_HOME=..
SET JAVA_HOME=%APP_HOME%\jvm
SET JAVA_EXE=%JAVA_HOME%\bin\bJW.exe
SET JAVA_LIB_PATH=-Djava.library.path=%APP_HOME%\bin
SET PATH=%JAVA_HOME%\bin;%PATH%
SET CLASSPATH=%APP_HOME%\bin;%APP_HOME%\bin\cb.jar
IF "%PROCESSOR_ARCHITECTURE%"=="x86" (
SET "DEP_LIB_PATH=X86"
SET JAVA_OPTS=-Xms128m -Xmx768m -XX:MaxDirectMemorySize=512m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
) ELSE (
SET "DEP_LIB_PATH=X64"
SET JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
)
www.bobcloud.net 196
SET PATH=%CD%\%APP_HOME%\bin\%DEP_LIB_PATH%;%PATH%
REM ####################################################################
ECHO -
ECHO APP_HOME=%APP_HOME%
ECHO SETTING_HOME=%SETTING_HOME%
ECHO JAVA_HOME=%JAVA_HOME%
ECHO JAVA_EXE=%JAVA_EXE%
ECHO JAVA_OPTS=%JAVA_OPTS%
ECHO JAVA_LIB_PATH=%JAVA_LIB_PATH%
ECHO PATH=%PATH%
ECHO CLASSPATH=%CLASSPATH%
ECHO -
ECHO Running data integrity check for backup set - '%BACKUP_SET%',
destination - '%BACKUP_DEST%' ...
@ECHO ON
%JAVA_EXE% %JAVA_LIB_PATH% -cp %CLASSPATH% %JAVA_OPTS%
RunDataIntegrityCheck %APP_HOME% %SETTING_HOME% %BACKUP_SET%
%BACKUP_DEST% %CRC_MODE% %REBUILD_MODE%
@ECHO OFF
CD %APP_HOME%
IF "%APP_HOME%"==".." PAUSE
@ECHO ON
Save the changes and close the text editor. Proceed back to cmd and enter the following script.
C:\Program Files\AhsayOBM\bin>RunDataIntegrityCheck.bat
-
APP_HOME=..
SETTING_HOME=""
JAVA_HOME=..\jvm
JAVA_EXE=..\jvm\bin\bJW.exe
JAVA_OPTS=-Xms128m -Xmx2048m -XX:MaxDirectMemorySize=1024m -
Dsun.java2d.noddraw -Dsun.nio.PageAlignDirectMemory=true
JAVA_LIB_PATH=-Djava.library.path=..\bin PATH=C:\Program Files\AhsayOBM
\bin\..\bin\X64;..\jvm\bin;C:\Program Files (x86)\Common Files\Oracle
\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C
:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program Files\Microsoft
SQL Server\Client SDK\ODBC\110\Tools\Binn\;C:\Program Files
(x86)\Microsoft SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft
SQL Server\120\Tools\Binn\;C:\Program Files\Microsoft SQL
Server\120\DTS\Binn\;C:\Program
Files\PuTTY\CLASSPATH=..\bin;..\bin\cb.jar
-
www.bobcloud.net 197
Running data integrity check for backup set - '"Data Backup"',
destination - '""' ...
C:\Program Files\AhsayOBM\bin>..\jvm\bin\bJW.exe -
Djava.library.path=..\bin -cp ..\bin;..\bin\cb.jar -Xms128m -Xmx2048m -
XX:MaxDirectMemorySize=1024m -Dsun.java2d.noddraw -
Dsun.nio.PageAlignDirectMemory=true RunDataIntegrityCheck .. "" "Data
Backup" "" "DISABLE-CRC" "DISABLE-REBUILD"
[doInfo] Start [ AhsayOBM v8.2.1.18 ]
[doStart] Start data integrity check on backup set "Data
Backup(1562897045523)", "AhsayCBS(1562897364604)", crc disabled, rebuild
index disabled
[doDetail] Start processing data integrity check on backup set= "Data
Backup" destination= "AhsayCBS"
[doLogProgress] Start processing data integrity check on backup set=
"Data Backup" destination= "AhsayCBS"
[doLogProgress] Browsing "/files/1562897045523"
[doLogProgress] Browsing "1562897045523/blocks/2019-07-12-10-09-33"
[doLogProgress] Browsing "1562897045523/blocks/2019-07-12-10-09-33/0"
[doLogProgress] Processing Job "2019-07-12-10-09-33", ""
[doLogProgress] Processing Job "Current", ""
[doLogProgress] Processing Job "Current", "C:"
[doLogProgress] Processing Job "Current", "C:/Users"
[doLogProgress] Processing Job "Current", "C:/Users/Administrator"
[doLogProgress] Processing Job "Current",
"C:/Users/Administrator/Desktop"
[doLogProgress] Processing Job "Current",
"C:/Users/Administrator/Desktop/Data backup"
[doLogProgress] Checking dangling backup file index entries...
[doInfo] Existing statistics of backup set= "Data Backup" destination=
"AhsayCBS": Data area compressed size: 32B, Data area uncompressed size:
0B, Data area file count: 2, Retention area compressed size: 0B,
Retention area uncompressed size: 0B, Retention area file count: 0
[doInfo] Recalculated statistics of backup set= "Data Backup"
destination= "AhsayCBS": Data area compressed size: 32B, Data area
uncompressed size: 0B, Data area file count: 2, Retention area
www.bobcloud.net 198
compressed size: 0B, Retention area uncompressed size: 0B, Retention
area file count: 0
[doInfo] The statistics of backup set= "Data Backup" destination=
"AhsayCBS" is correct.
[doLogProgress] Saving encrypted backup file index to
1562897045523/blocks at destination AhsayCBS...
[doInfo] Saving encrypted backup file index to 1562897045523/blocks at
destination AhsayCBS...
[doDetail] Data integrity check on backup set= "Data Backup"
destination= "AhsayCBS" is completed
[doLogProgress] Data integrity check on backup set= "Data Backup"
destination= "AhsayCBS" is completed
[doEnd][INFO] Finished data integrity check on backup set "Data
Backup(1562897045523)", "AhsayCBS(1562897364604)", crc disabled, rebuild
index disabled
[doInfo] Completed data integrity check on backup set "Data
Backup(1562897045523)", "AhsayCBS(1562897364604)", crc disabled, rebuild
index disabled
Press any key to continue . . .
www.bobcloud.net 199
Appendix D: Example Scenarios for the Reminder
Windows Log Off
The following example shows when the user performs Windows Log off with the Reminder setting
turned on.
1. Turn on the Reminder setting, then click the [Save] button.
2. Perform Windows logoff.
3. A dialog box will prompt the user to back up all the backup sets with enabled ‘Reminder’
setting.
www.bobcloud.net 200
Windows Restart
The following example shows when the user performs Windows restart with the Reminder setting
turned on.
1. Turn on the Reminder setting, then click the [Save] button.
2. Perform Windows restart.
3. A dialog box will prompt the user to back up all the backup sets with enabled ‘Reminder’
setting.
www.bobcloud.net 201
Windows Shutdown
The following example shows when the user performs Windows shutdown with the Reminder setting
turned on.
1. Turn on the Reminder setting, then click the [Save] button.
2. Perform Windows shutdown.
3. A dialog box will prompt the user to back up all the backup sets with enabled ‘Reminder’
setting.
www.bobcloud.net 202
Below is the list of example scenarios with complex settings:
Scenario 1 (Windows Log Off + Enabled Locking Workstation)
The following scenario shows when the user performs Windows logoff with the Reminder setting
turned on, and Locking Workstation enabled.
[Yes] – If Yes is selected, then the
Windows will be locked, and the
displayed backup sets will start
backing up in the background. Once
all the backup jobs are completed,
the machine will log off automatically
even if Windows is still on lock.
[No] – If No is selected, then no
backup job will run, and the machine
will proceed to log off.
NOTE
The machine will log off after four (4) seconds if no action is selected.
www.bobcloud.net 203
Scenario 2 (Windows Log Off + Unselected Locking Workstation)
The following scenario shows when the user performs Windows logoff with the Reminder setting
turned on, and Locking Workstation unselected.
[Yes] – If Yes is selected, an alert
message will be displayed to inform
the user that a backup job is still
running which prevents Windows
from logging off.
[No] – If No is selected, then no
backup job will run, and the machine
will proceed logging off.
Clicking the [Yes] button will result to the following screen:
[Force log off] – If you choose to
force log off the machine, the backup
job will not push through, then the
machine will log off immediately.
[Cancel] – If Cancel is selected, the
backup job will run in the background.
Once all the backup jobs are
completed, the machine will log off
automatically.
www.bobcloud.net 204
Scenario 3 (Windows Restart + Enabled Locking Workstation)
The following scenario shows when the user performs Windows restart with the Reminder setting
turned on, and Locking Workstation enabled.
[Yes] – If Yes is selected, then the
Windows will be locked, and the
displayed backup sets will start
backing up in the background. Once
all the backup jobs are completed, the
machine will restart automatically
even if the Windows is still on lock.
[No] – If No is selected, then no
backup job will run, and the machine
will restart immediately.
NOTE
1. You can select the ‘Shutdown Computer’ from the options in the dialog box, but the machine will still follow
the action that you perform from the Windows, which is ‘restart’. The machine will reboot once all the
backup jobs are completed.
2. The machine will restart after four (4) seconds if no action is selected.
www.bobcloud.net 205
Scenario 4 (Windows Restart + Unselected Locking Workstation)
The following scenario shows when the user performs Windows restart with the Reminder setting
turned on, and Locking Workstation unselected.
[Yes] – If Yes is selected, an alert
message will be displayed to
inform the user that a backup job
is still running which prevents
Windows from restarting.
[No] – If No is selected, then no
backup job will run, and the
machine will restart immediately.
Clicking the [Yes] button will result to the following screen:
[Force restart] – If you choose to
force restart the machine, the
backup job will not push through,
then the machine will restart
immediately.
[Cancel] – If Cancel is selected,
the backup job will run in the
background. Once all the backup
jobs are completed, the machine
will restart automatically.
www.bobcloud.net 206
Scenario 5 (Windows Shutdown + Enabled Locking Workstation)
The following scenario shows when the user performs Windows shutdown with the Reminder setting
turned on, and Locking Workstation enabled.
[Yes] – If Yes is selected, then the
Windows will be locked, and the
displayed backup sets will start
backing up in the background. Once
all the backup jobs are completed, the
machine will shut down automatically
even if the Windows is still on lock.
[No] – If No is selected, then no
backup job will run, and the machine
will shut down immediately.
NOTE
1. You can select the ‘Restart Computer’ from the options in the dialog box, but the machine will still follow the
action that you perform from the Windows, which is ‘shutdown’. The machine will shut down once all the
backup jobs are completed.
2. The machine will shut down after four (4) seconds if no action is selected.
www.bobcloud.net 207
Scenario 6 (Windows Shutdown + Unselected Locking Workstation)
The following scenario shows when the user performs Windows shut down with the Reminder setting
turned on, and Locking Workstation unselected.
[Yes] – If Yes is selected, an alert
message will be displayed to inform
the user that a backup job is still
running which prevents Windows from
shutting down.
[No] – If No is selected, then no
backup job will run, and the machine
will shut down immediately.
Clicking the [Yes] button will result to the following screen:
[Force shut down] – If you choose to
force shutdown the machine, the
backup job will not push through, then
the machine will shut down
immediately.
[Cancel] – If Cancel is selected, the
backup job will run in the background.
Once all the backup jobs are
completed, the machine will shut
down automatically.