DS-Client User Guide

Transcription

DS-Client User Guide
DS-Client User Guide
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 1
Confidential.
Assumptions
The following assumptions are made about the audience for this document:
Familiarity: User is familiar with the Operating System platform. User is familiar with basic Internet
browsing.
Correct Input: User enters the correct data (e.g. user names, passwords, etc.) when asked or
required. If invalid data is entered, an error message will appear, and you will be forced to correct
the error before you may proceed.
Canceling activities: The option to cancel the current activity (in some cases the option is “No”) will
exit the activity.
Disclaimer
Information in this document is subject to change without notice and does not represent a
commitment on the part of ASIGRA Inc.
ASIGRA Inc. makes no representation or warranty, express, implied, or statutory, with respect to,
and assumes no responsibility for the accuracy, completeness, sufficiency or usefulness of the
information contained herein.
This document may contain sample screen shots, used to demonstrate ASIGRA Televaulting
procedures. All information appearing in this document is used for illustration purposes only, and it
should be considered fictitious.
Copyright
The software described in this document is furnished under a license agreement. It is against the
law to copy the software on any medium except as specifically allowed in the license agreement.
DS-System™, DS-Client™, and DS-Client SLA™ are trademarks of ASIGRA Inc. All other product
names are believed to be trademarks of their respective companies.
About ASIGRA Televaulting
ASIGRA Televaulting is a unique alternative to traditional backup methods, replacing conventional
tape based systems with a fully automated On-line solution. It provides centralized and automated
backups of PCs, file servers and application/database servers with secure offsite storage and
immediate On-line restoration.
The system uses a DS-Client, installed onto the customer network, which hosts the ASIGRA
Televaulting client application software that performs the backup and restore activity.
Document Prepared by:
Asigra Inc.
1120 Finch Avenue West, Suite 400
Toronto, Ontario, CANADA M3J 3H7
[email protected]
www.asigra.com
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 2
Confidential.
DS-Client User Guide Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1 - Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Document Revision History Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How It Works: Major ASIGRA Televaulting Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Main DS-Client Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup/Restore Data Transfer Rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DS-User Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
19
20
20
21
Running DS-User and Connecting to a DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2 - Setup and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Change the DS-Client Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View the DS-Client Setup Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Re-register the DS-Client with the DS-System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Encryption Key Safeguarding at the DS-System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Default Options (for Backup Sets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the E-Mail Notification Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the SNMP Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the DS-Client Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Edit the Settings for DS-System Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure DS-Client User and Group Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DS-Client Advanced Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25
26
27
27
28
30
32
33
35
37
40
Export DS-Client configuration to XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
To export DS-Client configuration to XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
To update a DS-Client using ‘config-update.xml’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Set a User/Group Maximum On-line Storage Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
View Storage Quotas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Modify the DS-Client Setup (Windows DS-Clients) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
DS-User Initialization (Win32 Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
DS-User Initialization (Optional - JAVA Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Regional Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keep Alive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look & Feel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
48
48
49
50
51
51
51
Grid DS-Client (Windows DS-Clients) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Monitor Grid Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Stop a DS-Client Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Export the Grid DS-Client Addresses (to text file) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View DS-Client Grid Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
52
53
54
55
56
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 3
Confidential.
3 - Schedules and Retention Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
About Schedules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create or Modify a Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Add a Detail to a Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deleting Schedules and Schedule Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Schedule Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Assign Backup Sets to a Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change Backup Set Priority in a Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change Number of Simultaneous Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58
59
60
63
64
65
65
65
About Retention Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create or Edit a Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Assign Retention Rule to a Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enforce Retention Rule (on demand) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
67
67
73
73
4 - Creating and Modifying Backup Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Introduction & Common Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Backup Sets (New Backup Set Wizard). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying Backup Sets (Backup Set Properties) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Set Options - Pre/Post . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Set Options - Exclude Old Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Set Options - Continuous Data Protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
75
76
77
78
79
79
File System Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify Backup Set Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 7. Specify Advanced Options (Windows DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 8. Specify Notification Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 9. Specify the Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 10. Name the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
80
80
80
81
83
84
85
86
87
88
89
Local File System, NFS, Samba, UNIX-SSH Backup (LINUX DS-Client) . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the source for this backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
90
90
90
91
91
91
Novell NetWare Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
MS SQL Server Database Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Database Dump Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
93
93
93
94
95
96
96
MS Exchange Server Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 4
Confidential.
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Step 3. Specify the Database Dump Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Step 4. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Step 6. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Permissions Only Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Step 2. Select the Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Oracle Database Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specify the protocol for dumping the database (Linux DS-Client) . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Dump Device Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
102
102
102
102
103
104
105
105
MySQL Database Backup (Windows DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Database Dump Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
106
106
106
106
106
106
106
MySQL Database Backup (LINUX DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
108
108
108
108
108
108
DB2 Database Backup (LINUX DS-Client). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the protocol for dumping the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Dump Device Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 7. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 8. Specify Backup Set Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 9. DB2 ‘userexit’ log path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 10. Specify Notification Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
109
109
109
110
110
110
110
110
111
112
112
PostgreSQL Database Backup (LINUX DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
113
113
113
113
113
113
E-Mail Messages (DS-Recovery Tools) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 5
Confidential.
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the E-Mail Server Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Select the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Select Directories / E-Mails for Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
114
114
115
116
117
118
System i Server Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the share & path for the data dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 6. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
119
119
119
119
120
122
122
MS SharePoint Server (DS-Recovery Tools) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Select Items for Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
123
123
123
123
VMWare Backup (LINUX DS-Client). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
124
124
124
125
125
125
XenSource Backup (LINUX DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Choose the kind of backup set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Backup Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Backup Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 5. Specify the Retention Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
126
126
126
126
126
126
5 - Backup Set Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Overview of Backup Set Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Statistical Backups (DS-Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Self-Contained Backup Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
6 - Working with Backup Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
View Backup Set Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Modify Share Access Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Exclude files that failed to backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Modify Database Information (MS SQL Servers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Modify Connection Information (MS Exchange Server and System i Server). . . . . . . . . . . . . . 137
Modify Connection Information (E-Mail backup sets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Modify Connection Options (Linux DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Re-name a Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 6
Confidential.
Suspend and Activate a Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Synchronize a Backup Set's Backup Logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Migrate a Backup Set from one computer to another . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Clone a Backup Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Change Backup Set Ownership. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Backup Set Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
7 - Deleting Backup Sets and On-line Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Overview of Delete Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Selective Delete from On-line Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Delete Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Delete Individual Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Assisted Delete from all On-line File System & DS-MLR backup sets. . . . . . . . . . . . . . . . . . . . 155
Remove Backup Set from On-line Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
8 - Demand Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Perform a Demand Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Initial Backup (Premium Service) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
9 - Restoring Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Introduction & Common Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Advanced Restore Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore a Specific File or Files of a Specific Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore only files that differ from those on the backup source volume . . . . . . . . . . . . . . . . . . .
Restore an Older Generation of a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pre/Post Restore Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
163
164
166
168
169
170
Restore File System Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Restore Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore Windows System State (Registry) and Services Database. . . . . . . . . . . . . . . . . . . . . .
Restore NetWare Servers (Files and NDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore Continuous Data Protection Backup Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
172
172
172
174
175
176
178
179
Restore MS SQL Server Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Database(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
180
180
180
181
181
Restore MS Exchange Server Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Database(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location and Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
182
182
182
183
183
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 7
Confidential.
Restore Permissions Only Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Restore Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
184
184
184
184
184
Restore Oracle Server Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Restore MySQL Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Database(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
186
186
186
186
186
Restore DB2 Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Database(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
187
187
187
187
187
Restore PostgreSQL Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Database(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
188
188
188
188
188
Restore E-Mail Backups (via DS-Recovery Tools) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Restore Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
189
189
189
190
190
Restore System i Server Backups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Restore Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
191
191
191
192
192
Restore MS SharePoint Backups (via DS-Recovery Tools) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Select the Restore Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Specify the Restore Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
193
193
193
193
193
Restore to an Alternate Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Select the backup set items for restore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Choose the destination computer (optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Select the destination share . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Specify the path on the destination share . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MS SQL Server Backup Sets (Alternate Location Restore) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MS Exchange Server Backup Sets (Alternate Location Restore). . . . . . . . . . . . . . . . . . . . . . . .
Oracle Database Backup Sets (Alternate Location Restore) . . . . . . . . . . . . . . . . . . . . . . . . . . .
194
194
195
196
197
200
202
204
Restore from Disc / Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Restore from BLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 8
Confidential.
Validation of On-line Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Perform Validation on Demand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
10 - Premium Backup and Recovery Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Initial Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Initial Backup Path (Buffer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create Initial Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Monitor Initial Backup Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
209
210
211
212
Disc/Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Request Disc/Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2: View Orders for Disc/Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Restore from Disc/Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
213
213
215
216
Backup Lifecycle Management (BLM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure BLM (per backup set). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create BLM Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Schedule Backup Set for BLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Perform BLM Request on Demand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore from BLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
219
220
221
221
222
223
Tape Conversion to BLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Conversion Wizard - Tape to BLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Service Level Agreement – SLA Availability Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
View SLA Credit Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Local Storage Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set the Local Storage Path. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Apply the Local Storage Option (per Backup Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore from Local Storage Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
230
230
231
231
11 - Logs and System Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Activity Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
File Log Information (Detailed Log) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Audit Trail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Current Activity Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Budget Allocation Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Establish Budget User Credentials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Estimation Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Budget Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. Users & Groups (Enforce Budget limits). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
239
239
240
241
241
LAN Storage Discovery Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Share Discovery (Windows DS-Client) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Share Discovery (Linux DS-Client). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Scan Shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 3. Scan Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 4. File Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Summary Filtered View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
243
244
246
247
249
250
251
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 9
Confidential.
LAN Storage Discovery Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Large Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Growth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Share Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Generate Reports (one-click reports) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
253
253
254
256
257
258
259
On-line File Summary Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
DS-Client Load Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
DS-Client Storage Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
System Administration Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Update DS-Client Statistics immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Run a Daily Admin immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Run a Weekly Admin immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Monitor current connections and processes on the DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . .
Send messages to users connected to the DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Disconnect Network Connections to the DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shutdown the DS-Client Computer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Repair the DS-Client Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
265
266
266
266
267
267
268
268
268
Recover 'Orphaned' backup sets to the DS-Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Recover a Specific Backup Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Recover the DS-Client Database (Disaster Recovery of DS-Client Computer) . . . . . . . . . . . . . 271
12 - Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Print Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Sets Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restorable Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Users Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Trends Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup/Restore Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Groups Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Statistical Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backup Items Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
273
273
274
275
276
277
279
280
282
Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Backup Sets Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Global Reports (Java DS-User) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting DS-Client(s) for a Global Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Export Backup Sets Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup Sets Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Restorable Volume Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup Users Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup / Restore Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup Trends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup Groups Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Backup Items Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Global Report - Statistical Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
284
285
287
287
287
287
288
288
288
288
289
Generated on: 3/28/08
Page: 10
Confidential.
Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1. Create Customized Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 2. Create Customized Report (with Third-Party application) . . . . . . . . . . . . . . . . . . . . . . .
Step 3. View Customized Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
290
290
293
294
Glossary of Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
DS-Client Knowledge Base Contents . . . . . . . . . . . . . . . . . . . . . . . . . 301
Knowledge Base: SETUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Ports used in ASIGRA Televaulting applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Resolving port conflicts for the DS-Client software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Running DS-Client using PostgreSQL database on Mac OS X with Apple Remote Desktop
(ARD) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Configuring DS-Client with Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Windows XP Service Pack 2 changes that affect the ASIGRA Televaulting Product . . . . . . . . 308
DS-Client Database (Maintenance) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
DS-Client Database Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
DS-Client Database Migration (from MS Access to MS SQL Server) . . . . . . . . . . . . . . . . . . . . . 312
DS-Client Database Migration (from MSDE to MS SQL 2000) . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
DS-Client Database Migration (from MSDE to SQL Server 2005 Express) . . . . . . . . . . . . . . . . 314
DS-Client Database Migration (from SQL Server 2005 Express to MS SQL Server 2005) . . . . 316
DS-Client Service Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
DS-Client under heavy processing loads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Grid DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
DS-MLR Installation & Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Setting up DS-Client Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
SNMP Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Setting up the Novell NetWare Client on the DS-Client computer . . . . . . . . . . . . . . . . . . . . . . . 335
Knowledge Base: SECURITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Digital Signature Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
DS-Client Encryption Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
DS-Client to DS-System Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
Logon Impersonation and Integrated Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
User Rights and Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Encrypting your Network Credentials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Knowledge Base: ADMINISTRATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
DS-Client Advanced Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
Access to DS-Client & Remote Management of DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 11
Confidential.
Activity, Event and Audit Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Customized Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Administrative Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Weekly Admin and Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Admin Processes with Grid DS-Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
Backup Set Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
When to Migrate a Backup Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
DS-Client Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
DS-Client performance considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
LAN Storage Discovery Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
Load and Storage Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Simple and Advanced mode interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Retention Rules vs. Maximum # of On-line Generations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
Retention Rule Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Scheduled Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Validation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Knowledge Base: BACKUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Backup Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Best Practices: Initial Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Backing up Windows for Bare Metal Restore (BMR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Backup of Windows Encrypted Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Backup of Microsoft SQL Server 2000 Desktop Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Backup of Microsoft SQL Server 2005 and SQL Server 2005 Express . . . . . . . . . . . . . . . . . . . 404
Backup of NetWare Servers (DOS Partition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
Backup / Restore of Novell NetWare files from a Windows DS-Client . . . . . . . . . . . . . . . . . . . . 407
Backup / Restore of Novell NetWare files from a Linux DS-Client . . . . . . . . . . . . . . . . . . . . . . . 408
Backup of Open Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Backup using Microsoft VSS (Volume Shadow Copies) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Backup of UNIX Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Backup of VMWare (host-side backup). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Backup / Restore of Windows XP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Backup / Restore of Microsoft Exchange Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Microsoft Exchange Server Backup Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Backup / Restore of Microsoft SQL Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Backup / Restore using UNIX-SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Backup / Restore of NFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
Backup / Restore of Oracle Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 12
Confidential.
Backup / Restore of MySQL Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Backup / Restore of DB2 Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Backup / Restore of PostgreSQL Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
Backup / Restore of Windows 2000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
Backup / Restore of E-Mails (using DS-MLR). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
Backup Comparison: Microsoft Exchange Server vs. Message Level Restore . . . . . . . . . . . . 459
Backup / Restore of System i Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
Backup / Restore of Virtual Machines using Windows DS-Client and VCB . . . . . . . . . . . . . . . 464
Backup / Restore of VMWare (at Virtual Machine-level) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
VMWare Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Backup / Restore of XenSource (at Virtual Machine-level) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Backup / Restore of SharePoint Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Block-Level Resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Continuous Data Protection (Backup Set Option) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
Memory Requirements for DS-Client During Incremental Backup Using Delta Algorithm . . . 479
Stop Backup (DS-User Initiated) DS-Client Registry Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 480
Tape Converter - Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Knowledge Base: RESTORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox recovery) . . 483
Alternate Location Restore of Microsoft Exchange Server 2007 (mailbox recovery) . . . . . . . 485
Restoring Microsoft Exchange 2007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
Bare Metal Restore of Windows 2000 / 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
Bare Metal Restore of Windows XP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Important Notes for Bare Metal Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Restoring Files from a specific time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
Restoring Locked Files on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Restoring NetWare Servers (4.x and 5.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
Restoring NetWare Servers (5.1 and higher with NDS 8) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
Troubleshooting Full Server (file system and registry) restores . . . . . . . . . . . . . . . . . . . . . . . . 505
Knowledge Base: RECOVERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
Disaster Restores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
Recovering the DS-Client Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
Recovering 'Orphaned' Backup Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
Restoring the MS SQL Database Server MASTER Database (MS SQL 7.0 and up) . . . . . . . . . 512
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 13
Confidential.
1 - Introduction
1 - Introduction
This section provides an overview of ASIGRA Televaulting, and a general introduction to the
DS-User interface.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 14
Confidential.
1 - Introduction
Document Revision History Table
This shows the major changes made to this document from version to version.
Version/Date
v.8.0
Notes
[Revision Date: March 28, 2008]
1 - Introduction
• How It Works: Major ASIGRA Televaulting Components
2 - Setup and Configuration
• View the DS-Client Setup Information
• Configure the Default Options (for Backup Sets)
• Configure the DS-Client Parameters
• Configure DS-Client User and Group Roles
• DS-Client Advanced Configurations
• DS-User Initialization (Win32 Only)
• Grid DS-Client (Windows DS-Clients)
3 - Schedules and Retention Rules
• Change Number of Simultaneous Backups
• About Retention Rules
• Create or Edit a Retention Rule
4 - Creating and Modifying Backup Sets
• Introduction & Common Functions
• File System Backups
• Novell NetWare Backups
• MS SQL Server Database Backups
• PostgreSQL Database Backup (LINUX DS-Client)
• System i Server Backup
• VMWare Backup (LINUX DS-Client)
• XenSource Backup (LINUX DS-Client)
6 - Working with Backup Sets
• Modify Connection Information (MS Exchange Server and Series i Server)
• Modify Connection Information (E-Mail backup sets)
7 - Deleting Backup Sets and Online Files
• Delete Directories
• Assisted Delete from all On-line File System & DS-MLR backup sets
9 - Restoring Backups
• Restore File System Backups
• Restore System i Server Backups
10 - Premium Backup and Recovery Services
• Configure Initial Backup Path (Buffer)
11
•
•
•
•
•
•
- Logs and System Tools
File Log Information (Detailed Log)
System Administration Tools
Update DS-Client Statistics immediately
Run a Daily Admin immediately
Run a Weekly Admin immediately
Recover the DS-Client Database (Disaster Recovery of DS-Client Computer)
12
•
•
•
- Reports
Backup Items Report
Global Reports (Java DS-User)
Custom Reports
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 15
Confidential.
1 - Introduction
Knowledge Base: SETUP
• Ports used in ASIGRA Televaulting applications
• Configuring DS-Client with Firewalls
• DS-Client Database (Maintenance)
• DS-Client Database Migration (from MSDE to SQL Server 2005 Express)
• DS-Client Database Migration (from SQL Server 2005 Express to MS SQL Server
2005)
• DS-Client Service Account
• Grid DS-Client
• DS-MLR Installation & Setup
• Setting up the Novell NetWare Client on the DS-Client computer
Knowledge Base: SECURITY
• Digital Signature Verification
• DS-Client Encryption Keys
• Logon Impersonation and Integrated Security
Knowledge Base: ADMINISTRATION
• DS-Client Advanced Configurations
• Access to DS-Client & Remote Management of DS-Client
• Activity, Event and Audit Logs
• Customized Reports
• Weekly Admin and Synchronization
• Admin Processes with Grid DS-Client
• When to Migrate a Backup Set
• DS-Client Buffer
• Retention Rules vs. Maximum # of On-line Generations
• Retention Rule Examples
Knowledge Base: BACKUP
• Backup Limitations
• Best Practices: Initial Backup
• Backing up Windows for Bare Metal Restore (BMR)
• Backup of Windows Encrypted Files
• Backup of Microsoft SQL Server 2005 and SQL Server 2005 Express
• Backup / Restore of Novell NetWare files from a Windows DS-Client
• Backup / Restore of Novell NetWare files from a Linux DS-Client
• Backup of Open Files
• Backup using Microsoft VSS (Volume Shadow Copies)
• Backup / Restore of Microsoft Exchange Server
• Microsoft Exchange Server Backup Troubleshooting
• Backup / Restore of Microsoft SQL Server
• Backup / Restore of NFS
• Backup / Restore of MySQL Database Servers
• Backup / Restore of Oracle Database Servers
• Backup / Restore of DB2 Database Servers
• Backup / Restore of PostgreSQL Database Servers
• Backup / Restore of E-Mails (using DS-MLR)
• Backup Comparison: Microsoft Exchange Server vs. Message Level Restore
• Backup / Restore of System i Server
• Backup / Restore of Virtual Machines using Windows DS-Client and VCB
• Backup / Restore of VMWare (at Virtual Machine-level)
• Backup / Restore of XenSource (at Virtual Machine-level)
• Backup / Restore of SharePoint Servers
• Block-Level Resume
• Continuous Data Protection (Backup Set Option)
• Memory Requirements for DS-Client During Incremental Backup Using Delta
Algorithm
• Tape Converter - Troubleshooting
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 16
Confidential.
1 - Introduction
Knowledge Base: RESTORE
• Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox
recovery)
• Restoring Microsoft Exchange 2007
• Bare Metal Restore of Windows 2000 / 2003
• Bare Metal Restore of Windows XP
• Important Notes for Bare Metal Restore
• Restoring Locked Files on Windows
Knowledge Base: RECOVERY
• Recovering the DS-Client Database
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 17
Confidential.
1 - Introduction
Overview
What Is ASIGRA Televaulting?
ASIGRA Televaulting is an e-Vaulting service that gives you state-of-the-art data protection at an
affordable price. Data from your server(s) is backed up through the DS-Client, and sent through a
telecommunications line to an off-site data vault.
Ease of use comes from the 'agentless' architecture: you only need to install the DS-Client on one
LAN computer (thereby eliminating the need to install software on each target backup/restore
computer). As long as that computer is networked with the target backup/restore computers, you
will be able to browse data, back it up, and restore it as required.
As an e-Vaulting service: you only pay for the data you store On-line at the off-site data vault
(DS-System). ASIGRA Televaulting offers users the advantage of automatic and unattended
backups for data environments ranging from single-user standalone PCs through to
enterprise-wide Local/Wide Area Networks.
During backups, the DS-Client extracts, compresses, and encrypts the items you specify for
backup. Only new or modified data is backed up, thereby accelerating the backup transmission
time. The backup data is sent via the Internet, Intranet, or direct dial-up to the secure, off-site Data
Center that hosts the DS-System Vault.
Restores are performed on demand, via the same DS-Client installation, once the DS-Client's
security measures have been cleared.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 18
Confidential.
1 - Introduction
How It Works: Major ASIGRA Televaulting Components
This is an overview of the major components of ASIGRA Televaulting.
DS-User
Application
Description
dsuser.jar
DSUser.exe (Win32 only)
This is the user interface to the DS-Client service/daemon program referred to as
‘DS-User’. The JAVA version is ‘dsuser.jar’ and the Win32 version is
‘DSUser.exe’. You must run DS-User, in order to configure DS-Client (e.g. create
backup sets, perform backups or restores, view logs, etc.).
userhelp.jar (Java only)
Online help.
dsuser.chm (Win32 only)
Online help.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 19
Confidential.
1 - Introduction
DS-Client
Application
Description (Windows)
dsclient.exe
This is the service program.
DSConfig.exe
This program runs the portions of the installation that require you to specify Registry settings (e.g. DS-System IP address, Encryption Keys, etc.)
dsstatus.exe
The DS-Client Service Manager Program allows you to stop and start the DS-Client service
(without having to open the Control Panel > Services folder).
In the DS-Client program files directory, there is a sub-folder called db, which includes the
database patches that were applied during installation / upgrade of the DS-Client software.
The DS-Client databases contain the backup set specifications, backup schedule settings,
data usage statistics, logs, information about files and directories, generations that have
dsclient databases
been backed up, retention rules, data expiration rules, etc. They can be backed up during
the daily or weekly admin processes to ensure quick recovery of the DS-Client computer,
in case of disaster.
• MS SQL Server, MSDE, or SQL Server 2005 Express database: db folder contains the SQL
scripts run by the DS-Client Setup application.
Application
Description (Linux / Mac)
unixdsclient
This is the daemon program.
dsclient.sh
This is the startup / shutdown script for the DS-Client daemon.
The DS-Client databases contain the backup set specifications, backup schedules settings,
data usage statistics, logs, information about files and directories, generations that have
been backed up, retention rules, data expiration rules, etc. They can be backed up during
dsclient databases
the daily or weekly admin processes to ensure quick recovery of the DS-Client computer,
in case of disaster.
• DS-Client databases may reside on PostgreSQL database instances.
dsclient DB scripts
In the DS-Client installation directory, there are *.sql files which represent the database
patches that were applied during the installation / upgrade of the DS-Client software.
userhelp.jar
Online help.
Main DS-Client Features
Refer to your Service Provider's list of features. These are subject to change without notice.
Backup/Restore Data Transfer Rate
The data transfer rate is dependent on the User's communications infrastructure. Communication
may be over a public network, or through a direct LAN connection with the DS-System. Examples
of connections include LAN (100 or 10 Base-T), ATM, FDDI, ISDN (PRI, T1, or BRI), Modem,
DSL, Frame Relay, etc.
Check with your ASIGRA Televaulting Service Provider to find out which connections are
supported in your service area. Please note that the data transfer rate also depends on the file
type and the compression ratio achieved on the file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 20
Confidential.
1 - Introduction
DS-User Screen
To access functions, you can select from the menu options found directly below the title bar, in the
DS-User screen:
List of DS-Clients
to which you can
connect
Backup
Schedules
Tab
Backup Sets
Tab
Retention
Rules Tab
Menus
Connected
DS-Client
The Monitor section
shows current activities
on the DS-Client
•
•
•
•
•
DS-Client Connection List: Shows a list of the available DS-Clients you can
connect with on the LAN. You can connect to more than one DS-Client,
however you may view only one at a time (by highlighting it from this list).
Title Bar: Shows the name of the DS-Client computer that you are using. You
can connect to more than one DS-Client from the Connection List at left (if
available on the network).
Menu Bar Items: Items here allow you to perform the various tasks
necessary to backup and restore files, as well as manage and administer the
DS-Client. The menu bar consists of the Sets, Backup, Restore, Schedule,
Logs, Reports, Setup, and Help menus.
Backup Set Tab: Shows a Windows Explorer-like tree structure, containing
all of the backup sets that have been defined on the DS-Client. You can
browse the tree to select the backup set that you want to work with, then
Right-click to open the available options menu.
Backup Schedules Tab: Shows a tree view of all the schedules defined on
the DS-Client. You can browse the tree to select the schedule that you want
to work with, then Right-click to open the available options menu. You can
reassign backup sets to different schedules using the "drag-and-drop"
functionality.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 21
Confidential.
1 - Introduction
•
•
•
•
Retention Rules Tab: Shows a tree view of all the Retention Rules defined
on the DS-Client. You can browse the tree to select the Retention Rule that
you want to work with, then Right-click to open the available options menu.
You can reassign backup sets to different Retention Rules using the
"drag-and-drop" functionality.
Status Bar: This section may display basic instructions about the highlighted/
active option.
Monitor: Shows the current activities running on the DS-Client (backup,
restore, admin, etc.).
Tool Bar Icons: Icons allow quick access to the most commonly used
features
Icon
Function
Create new backup sets with the New Backup Set Wizard.
Perform a Demand Backup.
Restore files with the Restore Now Wizard.
Opens the Schedule.
Opens the Activity Log.
Help
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 22
Confidential.
1 - Introduction
Running DS-User and Connecting to a DS-Client
1. Start > Programs > ASIGRA Televaulting > DS-User. From the DS-Client List, select a
DS-Client by checking the box.
•
To configure refresh duration: Setup menu > Initialization > Connection Tab >
LAN Search Time
2. The Connect to DS-Client Service screen appears.
3. Select the Protocol and enter your Credentials
• Encrypted: All the data between the GUI and the Service will be encrypted
with a random encryption key at every connection.
• Standard: This option is only offered for backwards compatibility with old
service/daemon versions that do not have this feature.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 23
Confidential.
2 - Setup and Configuration
2 - Setup and Configuration
This section provides information about setup and configuration of the DS-Client and DS-User
software.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 24
Confidential.
2 - Setup and Configuration
Change the DS-Client Configuration
Administrators may need to edit some default configurations and settings for the DS-Client. Most
default configuration settings are established during Installation.
The following briefly describe the DS-Client Configuration screen tabs:
• Setup: View the DS-Client setup information.
•
•
•
•
- Re-register the DS-Client with the DS-System.
Defaults: Set and change Defaults that will apply to new Backup Sets.
Notification: Set and change the DS-Client Notification setup for E-Mail and
Pager notifications.
SNMP: Configure DS-Client to work with SNMP to send traps. (You need to
have SNMP management software installed if you wish to receive and handle
the trap information).
Parameters: Set and change the administrative Parameters for the DSClient. These include:
- setting the daily admin. start time.
- setting the weekly admin. start time.
- setting a database schedule.
- setting the duration of system logs.
- setting the duration of Detailed Log information.
- specifying the reconnection defaults for scheduled backups.
•
•
•
- specifying the Buffer directory path, where database dumps and Use Buffer (backup and
restore) dumps will be temporarily stored.
Connections: Edit the settings the DS-Client uses to connect to the DSSystem.
Roles: Specify User / Group access on DS-Client.
Advanced: Specify Advanced DS-Client options.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 25
Confidential.
2 - Setup and Configuration
View the DS-Client Setup Information
Use the Setup Tab to view the information input during the installation of the DS-Client. For
Windows, these settings are located in the DS-Client computer's Registry
(HKEY_LOCAL_MACHINE \ System \ CurrentControlSet \ Services \ DS-Client \ Parameters). For
Linux, these settings are located in the DS-Client computer's config file (default is /etc/
dsclient.cfg).
1. Setup menu > Configuration. The DS-Client Configuration screen appears on the
Setup tab.
2. Options available from this tab:
• “Re-register the DS-Client with the DS-System” on page 27
• “Encryption Key Safeguarding at the DS-System” on page 27
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 26
Confidential.
2 - Setup and Configuration
Re-register the DS-Client with the DS-System
In order to provide an extra level of security, the DS-Client is automatically registered with the DSSystem during the first activity that requires connection.
See the Registration Layer section of the DS-Client to DS-System Authentication Knowledge
Base Article (See “DS-Client to DS-System Authentication” on page 340.).
THE ONLY SITUATION where you must re-register the DS-Client is if:
• The DS-Client computer's hardware or operating system is replaced (or the
DS-Client has been installed on a new machine).
To re-register your DS-Client:
1. Your Service Provider must permit re-registration with the DS-System. Arrange a time
with your Service Provider when you will perform the Registration process. Your
Provider will open a registration window (approx. 5 minutes) for you to complete the
re-registration.
2. Setup menu > Configuration. The DS-Client Configuration screen appears on the DSClient Tab.
3. Click Register Now.
4. A confirmation screen appears.
5. Click Yes.
6. A message will appear informing you that registration was either successful, or that
some error occurred and the reason why.
Encryption Key Safeguarding at the DS-System
Encryption Key Safeguarding is an additional security provision that can be enabled from the DSSystem. Forwarding the key(s) will send an encrypted copy of the key(s) for storage in the DSSystem’s database.
Your service provider will not be able to read your Encryption Key(s), but will be able to create a
Customer Registration Information (.CRI) file with them embedded for distribution. This means
anyone who has the .CRI file can recreate a functioning DS-Client that will be able to perform
backups and restores to the corresponding account on the DS-System.
Therefore, you should determine your own policy on Encryption Key Safeguarding, and consult
your Service Provider if you have any questions. If your Service Provider enforces mandatory
safeguarding, the DS-Client will not be able to connect to DS-System until you enable the option.
To enable Safeguarding of your DS-Client’s encryption key(s):
1. Setup menu > Configuration. The DS-Client Configuration screen appears on the
Setup Tab.
2. Click “Enable encryption key forwarding to DS-System“.
3. Click Apply.
To forward or delete the encryption keys from the DS-System database:
1. Setup menu > Configuration. The DS-Client Configuration screen appears on the
Setup Tab.
2. In the Encryption key safeguard section:
• Click Forward Now or Request Deletion.
3. The screen will update to indicate if the key(s) are “Forwarded” or “Not Forwarded”.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 27
Confidential.
2 - Setup and Configuration
Configure the Default Options (for Backup Sets)
Use the Defaults Tab to configure the default settings that will appear in the New Backup Set
Wizard.
The Default Options affect all backup sets created after the defaults are set. The default selections
will appear for all new backup sets (however you may change the settings individually).
If you wish to change the settings of older backup sets, you must modify each older set's settings
individually (see the Backup Options Section).
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Defaults to bring it to the front.
3. In the Generations setup section, select the default number of generations for new
backup sets.
• Optional: You can select a default Retention Rule for new backup sets (See
“About Retention Rules” on page 67.)
• You can also specify that BLM Time-Push rules are enabled. See “About
Retention Rules” on page 67 for more information.
4. In the Backup options section, select the default options for new backup sets.
5. In the Open files section, specify the options for how the backup set handles open
files (in use by other applications) encountered during backup.
Note:
If the file(s) are locked by the other application, they will not be backed up. An error will
appear in the activity log. To backup locked files, you will need a 3rd party application like
Open File Manager® from St. Bernard® (See: Backup of Open Files Knowledge Base
article - “Backup of Open Files” on page 410).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 28
Confidential.
2 - Setup and Configuration
6. In the Backup schedule section, select the default options for new backup sets.
7. In the Notification section, select the default notification options for new backup sets
by clicking Add / Modify:
• In the Add / Edit Notification screen, you select the notification type, recipient,
and event that triggers notification.
•
Click OK to save the notification setting.
Note: The Email and Pager fields will be grayed out if the DS-Client has not been configured for
Email notification (For more information, see “Configure the E-Mail Notification Setup”
on page 30).
8. In the Data Compression section, select the default compression type for new backup
sets.
9. Click OK to save the changes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 29
Confidential.
2 - Setup and Configuration
Configure the E-Mail Notification Setup
Use the Notification Tab to configure the DS-Client to send notifications. For information on setting
up the DS-Client computer for email notifications, see the Setting up DS-Client Notifications
Knowledge Base article - “Setting up DS-Client Notifications” on page 331.
For MAPI Only: This requires Microsoft Outlook on the DS-Client computer. DS-Client notifications
(specified in backup set properties) are E-Mail reports or pager alerts that may be sent to the
Administrator at the end of a backup session or, on a regular basis during Admin processes. If the
DS-Client Messaging Profile section is empty, the E-Mail options will be hidden when creating new
Backup Sets or reviewing Backup Set Properties.
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Notification to bring it to the front.
3. In the Mail Outgoing Set section, select:
- None
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 30
Confidential.
2 - Setup and Configuration
- SMTP: In the SMTP Server Settings section that appears, click [...] to open the
SMTP Settings screen:
•
•
•
•
Enter the DNS name or IP address of the SMTP Server the DS-Client will use.
Select the Port
Enter any authentication information (if required)
In the Connection settings section, choose the type of connection the
DS-Client service will use:
LAN or Existing Connection
Dial Up
In the Dial-up settings section, specify the Phonebook entry to
dial, and any additional connection information required.
Dial Up settings
(Dial Up only)
Phonebook entry to dial, and any additional connection
information required.
•
•
4.
5.
6.
7.
Click OK to save the settings. The Notification Settings screen returns.
Enter the E-Mail address you want to appear in the E-Mail header’s “From”
field.
- MAPI: In the DS-Client messaging profile section that appears, select the MAPI
profile to use.
In the Administrator Notification Setup section, enter the information.
In the Daily / Weekly Admin setup section, select the settings you want.
Click OK to save the changes.
(MAPI only) After you change the profile, you must stop and restart the DS-Client
Service (Start > Programs > ASIGRA Televaulting > DS-Client Service Manager) for
the new setting to take effect.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 31
Confidential.
2 - Setup and Configuration
Configure the SNMP Settings
For more information on SNMP see the Windows Help.
Use the SNMP Tab to configure DS-Client to work with SNMP to send traps. (You need to have
SNMP management software installed if you wish to receive and handle the trap information).
Note:
Load the asigra.mib file (found in the DS-Client installation directory) with your SNMP
software to receive the traps sent by DS-Client. See the SNMP Knowledge Base article “SNMP Notification” on page 333.
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click SNMP.
3.
4.
5.
6.
7.
8.
In the Community field, enter a name and Click Add to list.
Under the Destination host list, click Add.
The Add host name or IP address screen appears.
Enter a host name or IP address from your network and click OK.
Continue to add as many destination host / IP addresses as are in the community.
Check the Send traps as heartbeats every […], to send traps as heartbeats. Select the
frequency of heartbeats from the dropdown list.
9. Click OK to save these settings.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 32
Confidential.
2 - Setup and Configuration
Configure the DS-Client Parameters
Use the Parameters Tab to view and change certain key processes and options for your DSClient.
The top two sections of this screen allow you set the retention period for various database logs,
and the frequency of DS-Client Database backups.
The Scheduled Backups section lets you configure how the DS-Client handles connection failures
between the DS-Client and DS-System.
The bottom sections of this screen deal with access groups and the local temporary storage
location (for Use Buffer data dumps and Registry/Database dumps) on the DS-Client computer.
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Parameters.
3. In the Admin Process section, you can specify when and how the daily and weekly
administrative tasks are performed.
4. In the Database options section, you can specify the frequency of DS-Client database
backups, how to handle the database dump file (if applicable), and how long to keep
logs.
5. In the Scheduled backups section, you may specify reconnection options. These are
used if the DS-Client loses connection with the DS-System during a scheduled
backup.
• NOTE: This does not apply to On-Demand backups.
• By default, DS-Client is configured to skip running a pre-scan on scheduled
backup sets (this makes the process faster). Disabling this option will force a
pre-scan for all scheduled backup sets, which allows the Process Window to
show an estimated completion time for each backup.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 33
Confidential.
2 - Setup and Configuration
6. In the DS-Client Buffer field, specify the local disk location that DS-Client will use to
save ‘Use Buffer’ dumps and its own Database dumps (from Daily/Weekly Admin
activities).
• The DS-Client’s database server (e.g. MS SQL) must have rights to dump to
this location. This is an important consideration if you are using a remote
database.
• For more information, see the Knowledge Base Article: “DS-Client Buffer” on
page 378.
7. (If you have Local Storage Tool enabled) In the Local Storage Path field, enter a path
where snapshots of the latest backup of each selected Backup Set will be stored.
When a path is entered, the Save on Local Storage checkbox appears in the Options
Tab of the Backup Set Properties screen.
8. Click OK to save the changes to this tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 34
Confidential.
2 - Setup and Configuration
Edit the Settings for DS-System Access
Use the Connections Tab to view and change the setup used by DS-Client to connect with the DSSystem. The initial settings are made during the DS-Client Installation. Your Service Provider will
supply you with the address(es) you must use.
There are two ways the DS-Client can access the DS-System:
• Via Dial-Up Access
• Via LAN (direct connection)
To add a new Connection entry:
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Connections.
Note:
There can only be one Primary Connection. All other entries in the DS-System connection
setup list are alternate methods to connect (like dial-up) in case the Primary Connection
fails.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 35
Confidential.
2 - Setup and Configuration
3. Click Add. The Add DS-System connection entry screen appears.
4. Specify if the connection is Dial-up or LAN:
• Dial-Up: This is for customers who will use MODEM, ISDN or other public
network to connect to the DS-System. You must specify the Dial-Up
Networking Phonebook entry or entries (configured on the DS-Client
computer) DS-Client will use to dial to connect to the DS-System.
• LAN: This is for customers whose DS-Clients have a direct LAN connection to
the DS-System. No Dial-Up information is necessary, as the DS-Client will
connect through the local network.
5. Click Add. A screen appears for you to enter one address (IP or DNS).
6. Repeat step 5 for as many IP addresses as you have been provided.
• Pre/Post: You can configure each DS-System connection entry to perform pre
and post commands. This can help in some network situations, like dealing
with firewalls.
7. When finished, Click OK to save the connection entry in the Connections Tab.
8. Click OK to save the DS-Client Configuration.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 36
Confidential.
2 - Setup and Configuration
Configure DS-Client User and Group Roles
Use the Roles Tab to view and change the DS-Client User / Group Roles. Each time a user
attempts to log in to DS-Client, the account will be checked against Roles. When more than one
role applies, the role with the greater rights will apply.
Standalone PC users should connect to their DS-Client as local Administrators (or a user
with administrator privileges).
Users and Groups can be assigned one of the following Roles:
• DS-Client Administrator: By default, this role includes the local Windows
Administrators group (you cannot remove this group from the Administrator
role). Users and groups assigned this Role will have Administrator rights (See
“Administrator Rights” on page 38.).
• DS-Client Backup Operator: By default, this role includes the local Windows
Backup Operators group (you can, however, remove this group). Users and
groups assigned this Role will have Backup Operator rights (See “Backup
Operator Rights” on page 37.).
• DS-Client Regular User: By default, this role is empty. Users and groups
assigned this Role will have Regular User rights (See “Regular User Rights”
on page 37.).
Each type of user has the permission to perform tasks, as outlined below.
Regular User Rights
Regular users have the following rights on the DS-Client:
• Create File System backup sets
• Create special backup sets (MS SQL Server, MS Exchange)
• Modify backup sets (Items, Options, Set Info, Schedule, Share)
• Backup a set on demand
• Restore backup sets
• Delete backup sets
• Delete backed up files from On-line storage
• Suspend/Activate backup sets
• View and print reports (Backup Sets, Backup Users, Backup Trends, Backup /
Restore, Statistical Summary)
• View the Activity Log
• View the Event Log (from Activity Log only)
• Use the Current Activity Monitor
• View the DS-Client Info (Help Menu)
Backup Operator Rights
Backup Operators have all the functions and access of Regular Users plus the following:
• Add/Remove permissions for your backup sets to other users and groups
• Perform a Demand Backup on all backup sets
• Synchronize all backup sets
• Migrate the backup share/path of your backup set to a different share/path
• Create Initial Backup Sets
• Use the Backup Schedule (change schedules of all backup sets)
• View the Load Summary and Load Summary Details
• View the Storage Summary
• Use System Activities Administration Tools
• Use the System Status utility:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 37
Confidential.
2 - Setup and Configuration
•
•
•
•
•
•
•
•
•
•
•
•
•
Send messages to connected users
Disconnect users from the DS-Client
Initiate Daily or Weekly Admin. Process runs on demand
Disable/Enable Scheduled Activities
Disable/Enable Demand Activities
View the Audit Trail
View the Event Log
View all DS-Client default configurations
DS-Client and Encryption Setup
Defaults (Generations On-line, Backup Options, Open File Backup, Backup
Schedule, Notification)
Notification Setup
Administrative Parameters
Connections (Dialup/IP address)
Administrator Rights
Administrators have all the functions and access of Backup Operators plus the following:
Administrators have full access to all of the DS-User tools and features. Administrators can view
all information on all activities recorded in the DS-Client logs.
• Full access (backup, restore, delete, migrate, permissions, etc.) to all backup
sets
• Order "Request Portable" Service (Disaster Recovery coordinated with your
ASIGRA Televaulting Service Provider)
• Set and change user and group access rights to backup sets:
• Set Maximum On-line Amount for Users and/or Groups
• View Users belonging to a Group and/or Groups to which a User belongs
• Change backup set owner
• Re-register the DS-Client with the DS-System (coordinated with your
ASIGRA Televaulting Service Provider)
• Repair the DS-Client Database (disaster recovery)
• Shut Down the DS-Client computer
• Change DS-Client default configurations
To add a new Role Setting:
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 38
Confidential.
2 - Setup and Configuration
2. Click Roles.
3. Click Add or highlight an entry and click Modify. The New / Edit User / Group Role
screen appears.
4. Specify User or Group
5. Edit the User or Group name.
6. Specify the computer or domain where the DS-Client will verify the User or Group
credentials.
7. Select the DS-Client Role for the User or Group.
8. Click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 39
Confidential.
2 - Setup and Configuration
DS-Client Advanced Configurations
By default, DS-Client is optimized for maximum performance under most conditions. For
customers who know their backup data very well, there are some further configurations available
that can improve performance.
Use the Advanced Tab to view and change Advanced Parameters for your DS-Client.
• Windows DS-Client: Parameters correspond entries in the DS-Client
database or DS-Client computer’s Registry.
• UNIX DS-Client (Linux / MAC): Parameters correspond to entries in the
dsclient.cfg file.
Knowledge Base Article “DS-Client Advanced Configurations” on page 346.
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Advanced.
3. Parameter names can be selected from the “Name” drop down list. The current
parameter value (or the default) will appear in the Value field, along with a brief
description underneath.
• The parameters that appear depend on if this is a Windows or Unix DS-Client.
4. Click OK to save the changes to this tab. Depending on the parameter, you may have
to restart the DS-Client service before the changes take effect.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 40
Confidential.
2 - Setup and Configuration
Export DS-Client configuration to XML
•
•
See “To export DS-Client configuration to XML” on page 41.
See “To update a DS-Client using ‘config-update.xml’” on page 42.
To export DS-Client configuration to XML
You can export the current DS-Client’s configuration, Backup Schedules, Retention Rules, and
Backup Sets to an XML file named “config-update.xml”.
• Windows DS-Clients: Use Win32 DS-User to export.
• Linux / Mac DS-Clients: Use Java DS-User to export.
1. Setup menu > Export to XML.
2. Select the options to export:
• DS-Client Configuration: exports all settings from the DS-Client Configuration
screen tabs (Setup, Defaults, Notification, SNMP, Parameters, Connections,
Roles).
• Backup Schedules: Exports all (or selective) Backup Schedules.
• Retention Rules: Exports all (or selective) Retention Rules.
• Backup Sets: Exports all (or selective) Backup Sets.
• Meta Symbol (Win32 DS-User): Check to use a Meta Symbol wherever
necessary in the “config-update.xml” file. This will allow the XML file to be
used for DS-Clients on different localized operating systems.
• Include Encryption Keys: Check to include the DS-Client and Account Keys in
the XML file (they will be encrypted).
3. Click Save As to save the XML file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 41
Confidential.
2 - Setup and Configuration
To update a DS-Client using ‘config-update.xml’
DS-Client will read any XML file named “config-update.xml” and will verify that its structure is
correct. If the file has not previously been applied, DS-Client applies its settings.
Note:
Depending on your requirements, you can use an exported XML file as is, edit the file, or
create your own. The XML file must be named “config-update.xml”, and it must conform
to the structure defined in the file “asigra_conf.dtd”.
1. Place the file “config-update.xml” in the program folder containing the DS-Client
service.
• DS-Client checks for an updated “config-update.xml” file every 10 seconds.
• If updated, DS-Client will read the XML file and apply its settings.
• After the XML file is applied, DS-Client renames the file to
“config-update-nnn.xml”, where nnn is an incremental number.
2. This will overwrite configuration settings, backup schedules, retention rules, and
backup sets (depending on the contents of the XML file).
Note:
The DS-Client Configuration elements <account-name>, <account-number>, <clientnumber>, and <encryption-keys> are only updated when DS-Client restarts.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 42
Confidential.
2 - Setup and Configuration
Set a User/Group Maximum On-line Storage Limit
The Users & Groups screen lists all users who have connected to the DS-Client. You can set a
maximum On-line limit either for specific users, or for an entire group (e.g. Regular Users). The
lowest group limit applies to individual users (Effective Limit).
Backups will fail, once the On-line limit has been reached (an error message will appear in the
Event Log). If more than one limit applies (e.g. User and Group limits overlap), the lower limit will
apply.
1. Setup menu > Users & Groups. The Users & Groups screen appears.
2. To set a maximum On-line amount, highlight the user/group and click the Max On-line
button. The Maximum On-line for ’...’ screen appears.
3. Uncheck the No Limit box.
4. Enter the maximum on line amount (in MB) in the On-line Storage Limit field.
5. Click OK. The Users & Groups screen reflects the change.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 43
Confidential.
2 - Setup and Configuration
View Storage Quotas
1. Setup menu > View Storage Quotas. The View Storage Quotas screen appears.
2. These settings are established on the DS-System by your Service Provider. (They can
only be viewed.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 44
Confidential.
2 - Setup and Configuration
Modify the DS-Client Setup (Windows DS-Clients)
The DS-Client Setup program (Filename: dsconfig.exe) is installed in the ASIGRA Televaulting
Program Group folder. It allows you to change the following DS-Client Registry Settings, which
were set during installation:
• DS-Client Registration Information
• Company Name
• Account #
• DS-Client #
• TCP / IP Parameters (to DS-System)
• DS-System Address
• Default # of Generations
• Logon Account for Windows
• Encryption Keys (Private Key, Account Key)
Note: Once set, you may not change the Encryption Keys.
• Backup Type (My Computer, My Computer & Network, Network Servers &
Databases)
1. On the DS-Client computer: Start > Programs > ASIGRA Televaulting > DS-Client
Setup
2. Most tabs in Setup are the same as those used in the DS-Client Installation program.
3. The Enter Registration Information screen appears. Edit if necessary and click Next >
4. The Select DS-System Connection Type screen appears. Edit if necessary and click
Next >
5. The Specify TCP/IP Parameters screen appears. Edit if necessary and click Next >
6. The Specify Default Number of Generations screen appears. Edit if necessary and
click Next >
7. The DS-Client Service Logon Account screen appears. Edit if necessary and click
Next >
8. The Encryption Keys Setup screen appears. Set key(s) if necessary and click Next >
• You may only set each Key once.
• You must set the Account Key, if you upgrade your LAN to have more than
one DS-Client.
9. Keep clicking Next > to finish the setup. Any changes to the DS-Client setup are
recorded.
Note:
For Linux DS-Clients, you can accomplish the above steps by running
setuplinuxclient.bin. Changes will be made to the corresponding config (.cfg) file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 45
Confidential.
2 - Setup and Configuration
DS-User Initialization (Win32 Only)
Settings only apply to this DS-User installation.
Language
(Win32 only) This screen controls the GUI language settings.
1. Setup menu > Initialization.
2. Select the GUI language. You must restart DS-User before the new settings take
effect.
Connection
(Win32 only) This screen allows you to configure the specific IP address(es) or subnet(s) where
this DS-User will look for additional DS-Clients (for remote management).
• By default (if this screen is left empty), Win32 DS-User automatically detects
the local DS-Client and all other DS-Clients on the same subnet as this Win32
DS-User installation.
Note:
This modifies the file “DSUSER.INI” located in the same folder as the DS-User
executable (DSUser.exe).
1. Setup menu > Initialization > Connection Tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 46
Confidential.
2 - Setup and Configuration
2. DS-User can search for a specific DS-Client, or for all DS-Clients on a subnet. Click
New or Modify in the corresponding section to add or edit entries.
• DS-Client level: Enter the specific IP Address or computer name. (It is easier
to specify by IP address.)
Note: Specifying a computer name requires a corresponding entry to exist in the local
computer's “%systemroot%\system32\drivers\etc\hosts” file (typically found in
“C:\WINNT\system32\drivers\etc\”). Each entry must be on a separate line, with the IP
separated from the HOSTNAME by at least one space (e.g. “10.20.30.111 C_Name”).
• Subnet: Enter the subnet, in the correct format (three sets of numbers
separated by two periods).
3. The Connection Configuration screen appears.
•
(If applicable) Select Single DS-Client or Grid DS-Client.
-
Grid DS-Client expands the screen to allow you to specify the IP address or hostname
of each node in the Grid.
• Enter the Host or Subnet.
• By default, the Port field is “4403”, and should not be changed unless you
have a specific requirement.
• Click OK.
4. In the Connection Tab, click Apply.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 47
Confidential.
2 - Setup and Configuration
DS-User Initialization (Optional - JAVA Only)
These optional settings can be configured from DS-User without logging in to a DS-Client. Settings
only apply to this DS-User installation.
Connection
(Optional - this screen can be left empty)
Use these settings to indicate a specific IP or DNS Address where the DS-User will look for a DSClient Service. This can speed up your login.
1. Setup menu > Initialization.
2. Click Add. The Add a DS-Client screen appears.
3. Specify the DS-Client IP or DNS Address (host name).
• For Grid DS-Client, the screen expands to allow you to specify the IP address
or hostname of each node in the Grid.
4. Click OK.
5. The entry appears in the Additional DS-Clients section.
6. Continue with steps 2-5 as required.
7. Click OK to save any changes.
Note:
DS-User will scan the LAN for all active DS-Clients, whether or not any entries are in the
Additional DS-Clients list. DS-Clients specified in the Additional DS-Clients list which
are not detected, will appear in Red. A DS-Client on the local computer appears in Blue.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 48
Confidential.
2 - Setup and Configuration
Regional Settings
(Java version only) This screen controls the GUI language settings and other regional formatting.
1. Setup menu > Initialization.
2. Click Regional.
3. Click OK to save any changes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 49
Confidential.
2 - Setup and Configuration
Keep Alive
(Optional - this screen can be left empty)
These settings limit the amount of idle time on DS-User, after which the connection with DS-Client
will be terminated.
1. Setup menu > Initialization.
2. Click Keep Alive.
3. Specify the Keep Alive settings.
4. Click OK to save any changes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 50
Confidential.
2 - Setup and Configuration
Plugins
Some plugins are automatically applied, depending on the DS-Client's configuration. Others can
be manually enabled / disabled, and configured.
1. Setup menu > Initialization.
2. Click Plugins.
3. Highlight a plugin and configure any options.
4. Click OK to save any changes.
Look & Feel
(Optional - this screen can be left empty)
To adjust the look and feel of the DS-User GUI:
1. Setup menu > Look & Feel.
2. Select:
• Metal
• CDE/Motif
• Windows
3. For the Metal theme only, you can customize the look further:
• Setup menu > Initialization.
• Click Look & Feel.
• Select the Metal theme and custom colors.
• Click OK to save any changes.
Fonts
(Optional - this screen can be left empty)
DS-User’s default fonts may not be enough to display some Unicode characters. In these cases,
you can add specific fonts that the DS-User will attempt to use (in order) to display such
characters.
1. Setup menu > Initialization.
2. Click Fonts.
3. Click Add.
4. Select a font to add to the DS-User Initialization list.
5. Click OK.
6. The entry appears in the Additional Fonts list.
7. Continue with steps 3-6 as required. The order that appears in the Additional Fonts list
is the order that DS-User will use if it attempts to display characters that its default font
cannot.
8. Click OK to save any changes.
9. Exit the DS-User program and restart in order to for the changes to take effect.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 51
Confidential.
2 - Setup and Configuration
Grid DS-Client (Windows DS-Clients)
In high-performance environments you can maximize DS-Client processing and distribute the load
across two or more computers in a configuration called “Grid DS-Client“. The DS-Client software is
installed on multiple computer (nodes) and configured to use the same database.
• See the section “Grid DS-Client Installation” in the Windows DS-Client
Installation Guide (Filename: installation_dsclient.pdf).
• The Grid DS-Client is composed of one Main Node and any number of Leaf
Node(s).
• The Main DS-Client is the one that accepts DS-User connections for
management. The Leaf Nodes perform activities, as instructed by the Main
Node.
Any DS-User that is going to connect to the Grid DS-Client must be able to see all of its nodes (IP
addresses). This is because DS-User can only connect to the Main Node, and that one is chosen
randomly among the running nodes. To do this, make sure DS-User is configured with the IP
address of each node in the Grid DS-Client:
• See “DS-User Initialization (Win32 Only)” on page 46.
• See “DS-User Initialization (Optional - JAVA Only)” on page 48.
Note:
This will not be necessary if DS-User and all DS-Client nodes are in the same subnet. By
default, a DS-User can see all running DS-Clients in the same subnet.
If you connect to a Grid DS-Client, an additional “Grid Menu” appears. From this menu, you can
access the following screens to manage the Grid:
• Grid Status: See “Monitor Grid Status” on page 53.
• Stop DS-Client Node: See “Stop a DS-Client Node” on page 54.
• Export Grid DS-Client Node Addresses: See “Export the Grid DS-Client
Addresses (to text file)” on page 55.
• DS-Client Grid Log: See “View DS-Client Grid Log” on page 56.
If you connect to a Grid DS-Client, the following screens will have an additional option to select by
the Node ID:
• Activity Log viewer screen
• Load Summary screen (Reports menu > Load Summary)
• DS-Client System Status screen (Setup menu > System Activities > System)
• DS-Client Advanced Configurations screen (Setup menu > Configuration >
Advanced Tab)
For more information, see the following Knowledge Base Articles:
• “Grid DS-Client” on page 320
• “Admin Processes with Grid DS-Client” on page 374
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 52
Confidential.
2 - Setup and Configuration
Monitor Grid Status
You can monitor the Grid DS-Client from DS-User.
1. Grid Menu > Grid Status. The Grid Status screen appears on the Graph Tab.
• The graph view gives a quick overview of the status of the Grid DS-Client.
2. Click List. The List Tab appears.
•
•
The list view shows details about each of the nodes of the Grid DS-Client,
including which one is the Main Node.
The list view also shows details about the Grid DS-Client’s database node.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 53
Confidential.
2 - Setup and Configuration
Stop a DS-Client Node
If you need to stop a node in the Grid DS-Client, you can do it from the Grid Status screen. You
can also stop the DS-Client service from a local node’s terminal using the DS-Client Service
Manager (Start > Programs > ASIGRA Televaulting > DS-Client Service Manager).
1. In the Grid Status List Tab. Highlight the node you want to stop.
2. Click Stop Node. The Stop Node screen appears.
•
•
•
Wait for all running activities to complete: Stops the DS-Client on the
selected node, after all the current activities have completed. No new
activities will be allowed once you click OK.
Stop when all activities complete or force stop after [...] minute(s): Stops
the DS-Client on the selected node after all the current activities have
completed, or forces a stop after the specified time has elapsed. No new
activities will be allowed once you click OK.
Stop Type: You must specify if you want to shut down or reboot the node, or
to only stop the DS-Client service (keep the computer running).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 54
Confidential.
2 - Setup and Configuration
Export the Grid DS-Client Addresses (to text file)
You can export the Grid DS-Client’s IP Addresses (internal or external) to a text file. This facilitates
distribution (e.g. to quickly configure each DS-User GUI installation with all the correct nodes of a
Grid DS-Client).
1. In the Grid Status screen, click Export. The Export Grid DS-Client Address screen
appears.
2. Select Internal or External Address and click OK. A Save As screen appears, allowing
you to select the destination format and location.
3. The exported file can then be imported to any other DS-User installation using the
“Load” button.
• Win32 DS-User: See “DS-User Initialization (Win32 Only)” on page 46.
• Java DS-User: See “DS-User Initialization (Optional - JAVA Only)” on
page 48.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 55
Confidential.
2 - Setup and Configuration
View DS-Client Grid Log
This log displays all events specific to the Grid DS-Client configuration.
1. In the Grid Status List Tab. Highlight the node you want to stop.
2. You can narrow the display in the Select by section.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 56
Confidential.
3 - Schedules and Retention Rules
3 - Schedules and Retention
Rules
This section provides information about creating and working with Schedules (for unattended
backups, etc.) and Retention Rules (for data that has been backed up).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 57
Confidential.
3 - Schedules and Retention Rules
About Schedules
The Schedules allow you to perform automatic, unattended activities on specified backup sets.
This is done by creating a schedule, then assigning backup sets to that schedule.
A Schedule is composed of Details. Each Detail refers to a specific backup circumstance (e.g.
"Occurs every 2 week(s) on Friday, at 6:00 PM"). When combined, the details indicate all times
when unattended backups will be performed.
The Schedule tab allows Administrators and Backup Operators to monitor and adjust the
scheduled backup load on the DS-Client. (For example: if the backup load from a particular
schedule becomes too heavy.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 58
Confidential.
3 - Schedules and Retention Rules
Create or Modify a Schedule
A Schedule is a set of details. Each detail refers to a specific backup circumstance (e.g. "Occurs
every 2 week(s) on Friday, at 6:00 PM"). Each Schedule must have at least one detail.
1. DS-User screen > Schedules tab.
2. To create a new schedule, right-click and choose New Schedule.
To modify an existing schedule, right-click on it and choose Edit Schedule.
3. The Schedule screen appears.
4. Enter a name for the schedule.
5. If this schedule is specifically for a Portable Computer, check the box and set a CPU
Usage limit (%). This will limit the DS-Client Service’s CPU usage to that amount in
order to permit continued use of the Portable by its user.
6. Add details to the schedule (See “Add a Detail to a Schedule” on page 60.).
7. Continue with step 6 until you are finished, then click Save.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 59
Confidential.
3 - Schedules and Retention Rules
Add a Detail to a Schedule
Each Detail is a description of a specific date/time pattern when to perform a backup. You may
add as many details to the schedule, as are required.
For example: You may wish to back up weekly, and back up on a specific day (such as the last
Friday of every month). To do so, create one detail for the weekly backup, and a second detail for
the monthly backup.
1. Adding a detail starts slightly differently for JAVA and Win32 versions:
• JAVA: Click the Detail Type Tab you want (One Time, Daily, Weekly, Monthly)
and click New.
• Win32: In the Occurs section, click the Detail Type you want and select
<New> from the Details List.
2. In the Detail Type section, specify when you would like this detail to run.
3. In the Daily frequency section, specify the frequency when this detail will run.
4. In the Detail Period section, specify the dates this detail will be active for this
Schedule.
5. In the Tasks section, specify the task(s) to run for this detail. You may run multiple
tasks in a single detail, but they will run in the following order:
• 1. Perform Backup: scheduled backup
• 2. Enforce Retention: enforce the Retention Rules (if any) for backup sets
(See “About Retention Rules” on page 67.).
• 3. Perform Validation: scheduled validation of backup set data. See
“Validation of On-line Storage” on page 206 for more information.
- When you check the box, the Verify Encryption Key screen appears, prompting you to
enter the DS-Client Encryption Key(s).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 60
Confidential.
3 - Schedules and Retention Rules
- Click >> to edit the Scheduled Validation Options.
Validate last generation only
• Select to validate only the latest generation of backup data for the selected backup set.
Exclude files deleted from source
• Select to skip validation of files that have been deleted from the source computer.
Resume from previously interrupted location
• Select to configure this Schedule to resume validation from the point of interruption if
the last scheduled Validation did not finish. This is useful for large backup sets that
might not be completed in the Schedule’s time window.
•
4. Perform BLM: Request DS-System to copy a backup set snapshot to BLM.
Click >> to edit the BLM Options. See “Backup Lifecycle Management (BLM)”
on page 219 for more information.
- Click >> to select the BLM Options.
Archive Options
Archive packages are specific to a particular backup set.
• The default (if these options are not selected) is for each BLM
Request to be added to the current Archive Package on the BLM
Archiver.
Close active package
Select to use a new archive package. Otherwise, this Archive request
will be added to the current archive package on the BLM Archiver.
You must specify when the package will be closed:
• at session start - makes a new Archive Package. This means the
previous package (if one exists) will be closed, and the new
request will go to the new package.
• at session end - uses the current Archive Package. This means the
new request will go to the current package, and after it finishes,
the package will be closed.
Once a package is closed, no new data will be added. Subsequent
archiving requests will create a new archive package.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 61
Confidential.
3 - Schedules and Retention Rules
Reference previous
archive packages
Generations to
include
Select to allow the Archive Package to contain references to older
packages. This may save space by removing data redundancy.
• The default (if this option is not selected) is for each Archive
Package to contain all of the required files.
• Latest generation - Creates a BLM Archive containing the latest
generation of all items selected.
• All generations - Creates a BLM Archive containing all the (online)
generations of all items selected.
•
5. Start LAN Scan of Shares: choose this if you have the LAN Storage
Discovery Tool enabled. The schedule will start scanning the LAN Shares for
statistical data. Since this may take a significant amount of time, this task is
run last.
6. Click Save. The Detail is saved.
• Each new detail is automatically assigned a name, based on the frequency
chosen and an automatic number (e.g. daily:1, weekly:2).
7. You may continue adding Details, as required by repeating steps 1-6 above.
8. When you are finished, click Close to exit.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 62
Confidential.
3 - Schedules and Retention Rules
Deleting Schedules and Schedule Details
To delete a Detail from a Schedule:
1. DS-User screen > Schedules tab.
2. In the Schedule Tree, highlight the Schedule you would like to edit.
3. Right-click
4. Click Edit Schedule. The Schedule screen appears, with the selected Schedule's
Details.
5. Highlight the detail in the left hand list, and right-click.
6. Click Delete to delete the Detail from the list.
7. A confirmation screen appears. Click Yes to delete the Detail.
Note:
You cannot delete the last Detail of a Schedule. In this case, you must delete the Schedule.
To delete a Schedule:
• The schedule must be empty in order to be deleted. This means, no Backup
Sets may be scheduled with it.
1. DS-User screen > Schedules tab.
2. In the Schedule Tree, highlight the Schedule you would like to delete.
3. Right-click.
4. Click Delete Schedule. A confirmation screen appears.
5. Click Yes to delete the Schedule.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 63
Confidential.
3 - Schedules and Retention Rules
Viewing Schedule Calendar
This is a visual representation of the backup schedules, and the backups that have occurred. You
can see if schedules overlap (which might cause higher network traffic), or if errors occurred for
backups that have run.
Highlight a cell to view what is
scheduled at that time in the
‘Cell details’ section.
Highlight a schedule to
view its description.
The color of the cell
corresponds to the
selection and Legend.
1. DS-User screen > Schedules tab > Right-click > Schedule calendar. The Schedule
Calendar Screen appears.
2. By default, the screen shows all schedules for the current week.
3. The display can be changed from the top left portion of the screen:
4. The table changes to reflect the selections.
5. Click any cell.
• The Schedules / Processes at that time are shown.
6. Enable the Performed radio button. The Schedule refreshes automatically.
7. The numbers that remain in the Calendar reflect the actual number of backups at that
time.
8. Click a time cell with an actual backup number to show the sets that were backed up.
9. The Description section displays the details of the highlighted Schedule.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 64
Confidential.
3 - Schedules and Retention Rules
Assign Backup Sets to a Schedule
Backup sets can be assigned to a schedule (but only one schedule at a time). This can be done as
follows:
• when they are created in New Backup Set Wizard
• from the Sets Menu > Backup Sets > Properties (Schedule Tab)
• from the DS-User Window’s Backup Schedules Tab - where DS-Client
administrators can manage all the Schedules from that Tab
When more than one backup set is assigned to a schedule, it may be necessary to manage the
order that those backup sets run.
Even though a backup schedule has a specific start time, the actual start time of a backup set may
depend on its priority in the schedule.
Change Backup Set Priority in a Schedule
You can view a list of all the backup sets using a specific Schedule.
1. DS-User screen > Schedules tab.
2. Highlight the Schedule that you wish to view and right-click.
3. Select Set Priority. The Set Backup Set Priority for Schedule screen appears.
4. The list displays the names of all backup sets that are specified using this particular
schedule.
5. Highlight the Backup Set you want to prioritize.
6. In the Backup set priority field, click the arrows to change the priority of the highlighted
backup set. The number in the # column changes with the number field. The set will
sort automatically by priority (lower number = higher priority), so the highest priority
items are first in the list.
7. Click Save to save the new settings.
Change Number of Simultaneous Backups
You can limit the number of backup sets that can be run simultaneously by this schedule.
This is useful if some data must be backed up through a slower connection, and there is no benefit
to running simultaneous backups. Similarly, if there are too many backup sets using the schedule,
this may decrease the DS-Client's efficiency.
If the number of sets scheduled to run simultaneously is higher than the DS-Client's Global
Parameter for Maximum Concurrent Activities (Maximum sessions), the Calendar Section number
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 65
Confidential.
3 - Schedules and Retention Rules
will appear in bold. The default (if no parameter is set) is 8 for DS-Clients running on 32-bit
Operating Systems, and 12 for DS-Clients running on 64-bit Operating Systems.
You can alter this setting from the DS-Client Advanced Configurations Tab (See “DS-Client
Advanced Configurations” on page 40.):
• For Windows DS-Clients, the parameter name is “MaxSessions”, found
under the “Performance“ category.
• For UNIX DS-Clients, the parameter name is “MaxSession Number”.
1. In the Schedule field, enter the maximum number of backup sets you would like to
permit to run simultaneously.
Note: For Grid DS-Clients, the limit will be the sum of all the “MaxSessions” parameters from
all running nodes.
2. Click Save to save the new settings.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 66
Confidential.
3 - Schedules and Retention Rules
About Retention Rules
Retention allows you to implement granularity (specific pattern retention) in your backed up
generations. For example: you might want to retain all generations of the previous day, then 1
generation each day for a week, 1 generation each week for a month, 1 generation each month for
a year and 1 generation each year for the next 10 years. When you define retention rules, you
implement a granularity according to your own retention policy.
Retention Rules are optional. If you do not use the retention feature, your backup data will remain
online according to the backup set generation setting (the oldest generation of a file will be
overwritten if the maximum number of generations is reached).
Retention Rules are applied per backup set, but are only enforced on demand or on schedule.
When a Retention Rule is enforced, the online data that does not qualify for retention is deleted. If
retention rules overlap, the default will be to keep the most data online possible.
The following sections describe how to work with Retention Rules:
• “Create or Edit a Retention Rule” on page 67
• “Assign Retention Rule to a Backup Set” on page 73
• “Enforce Retention Rule (on demand)” on page 73
WARNING: Since this feature deals with the removal of backed up data, you must be very careful
when you define Retention Rules.
More information is available in the following Knowledge Base article:
• See “Retention Rules vs. Maximum # of On-line Generations” on page 389..
Create or Edit a Retention Rule
The Retention Rule Wizard assists you with selecting the options for a Retention Rule. Once a
Retention Rule is defined (the collection of retention, delete, and other options), it can be assigned
to a backup set (backup set properties > Retention Tab | Retention Rules Tab > ).
For each Retention Rule, all selected retention options (generic or time-based) are combined
using the “AND” logic. It is not necessary to set every option. This means when the Retention Rule
is enforced, the maximum amount of data is kept on-line. Data that does not meet at least one of
the specified retention options will be deleted.
However, the Delete Options will always apply (if selected). Delete Options are specific for on-line
files, when the DS-Client has detected that the actual corresponding backup source file has been
deleted.
The Archive Options (if selected) apply only to what is ‘retained’ (i.e. after the files that should be
removed have been deleted from online). For more information about BLM, see “Backup Lifecycle
Management (BLM)” on page 219.
1. DS-User screen > Retention Rules tab.
2. To create a new Retention Rule, right-click and choose New Retention Rule.
To modify an existing rule, right-click on it and choose Edit Retention Rule.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 67
Confidential.
3 - Schedules and Retention Rules
3. The Retention Rule Wizard appears on the “Choose Retention Settings” screen.
•
•
•
Note:
For details on these options, see the online help for the screen.
This screen prompts you to select what type(s) of retention settings you want
to define for this Retention Rule.
The number of screens that appear in this Wizard depends on the selections
made in this screen. You must make at least one selection.
In order to explain the different screens, the following instructions assume you select
every available retention option in this screen.
4. Click Next. The Retention Rule Wizard appears on the Delete Options screen.
•
For details on these options, see the online help for the screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 68
Confidential.
3 - Schedules and Retention Rules
5. Click Next. The Retention Rule Wizard - Time Retention Rules screen appears.
•
To add a time-based rule, click Add. The New Time Retention Rule screen
appears.
•
For details on these options, see the online help for the screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 69
Confidential.
3 - Schedules and Retention Rules
6. Click Next. The Retention Rule Wizard - Archive Old Data to BLM screen appears.
•
•
•
•
This screen only appears if the DS-Client Administrator has activated the
Time-Push feature from the DS-Client Configuration screen (Setup Menu >
Configuration > Defaults Tab: Enable Time-Push). See “Configure the Default
Options (for Backup Sets)” on page 28.
For details on these options, see the online help for the screen.
To add an Archive rule, click Add. The New BLM Archive Rule screen
appears.
Select what files you want to ‘push’ to BLM.
-
Age: Online files older than the specified amount will be ‘pushed’ to BLM.
-
Filter options: All files (default), or files that conform to a specific filter pattern. You
can select a different pattern from the drop-down list, or add a new one. For details on
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 70
Confidential.
3 - Schedules and Retention Rules
these options, see the online help for the screen(s).
Tip:
Try to keep any rules as simple as possible.
7. Click Next. The Retention Rule Wizard - Local Storage Retention Options screen
appears.
•
For details on these options, see the online help for the screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 71
Confidential.
3 - Schedules and Retention Rules
8. Click Next. The Retention Rule Wizard - Choose The Name screen appears.
• For details on these options, see the online help for the screen.
9. Choose a name. Review the description (each option selected is listed). Once you are
satisfied, click Finish.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 72
Confidential.
3 - Schedules and Retention Rules
Assign Retention Rule to a Backup Set
Backup sets can be assigned to a Retention Rule (but only one at a time). This can be done as
follows:
• when they are created in New Backup Set Wizard
• from the Sets Menu > Backup Sets > Properties (Retention Tab)
• from the DS-User Window’s Retention Rules Tab - where DS-Client
administrators can manage all the Retention Rules from that Tab
Retention Rules only apply when they are enforced (either on demand, or on schedule).
1. DS-User screen > Retention Rules tab.
2. Browse for the backup set you want and highlight it.
3. Right-click and choose Assign to Retention. The Assign to Retention screen appears.
4. Select the Retention Rule to use for this backup set, then click OK.
Enforce Retention Rule (on demand)
You can enforce a backup set’s Retention Rule on demand. This can be done as follows:
1. DS-User screen > Backup Sets tab.
2. Browse for the backup set you want and highlight it.
3. Right-click (or open the Retention Menu) and choose Enforce Retention.
4. A confirmation screen appears. Click Yes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 73
Confidential.
4 - Creating and Modifying Backup Sets
4 - Creating and Modifying
Backup Sets
This section provides information about creating new backup sets and modifying backup sets.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 74
Confidential.
4 - Creating and Modifying Backup Sets
Introduction & Common Functions
A backup set includes:
• A list of the backup items you specify for backup.
• A series of settings defining how to back up the set (i.e. schedule, options,
etc.)
Creating backup sets is done using the New Backup Set Wizard.
• See “Creating Backup Sets (New Backup Set Wizard)” on page 76.
Once backup sets have been created, their properties can be modified through the Properties
function.
• See “Modifying Backup Sets (Backup Set Properties)” on page 77.
Most screens in the New Backup Set Wizard correspond to a tab on the Backup Set Properties
screen (where the fields and options are the same), as shown in the following table. Some screen
titles may be different, depending on the kind of backup set selected.
New Backup Set Wizard
Properties Tab
Choose the kind of backup set
N/A
Select the computer
Select the backup source (Linux)
N/A
Select share & path for the database / data dump screen
N/A
Specify the protocol for dumping the database (Linux DS-Client)
N/A
Select Items for Backup Set
Items
Select backup item options
Items
Choose a Retention Rule for this backup set
Retention
Specify backup set options
Options
Specify backup set Advanced Options (Windows DS-Client)
Advanced Options
Specify notification options
Notification
Choose a schedule for this backup set
Schedule
Choose the name for this backup set
Set Info
Some options are common to most backup sets:
• “Backup Set Options - Pre/Post” on page 78
• “Backup Set Options - Exclude Old Files” on page 79
• “Backup Set Options - Continuous Data Protection” on page 79
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 75
Confidential.
4 - Creating and Modifying Backup Sets
Creating Backup Sets (New Backup Set Wizard)
The New Backup Set Wizard helps you create a backup set by guiding you through the required
selections. The following selections are common to all backup sets:
• Select the kind of backup (file system, database, mail server, etc.).
• Select the computer to backup.
• Select the items to backup (files, directories, databases, E-Mails, etc.).
• Select any special backup options for the backup items.
• Select a Retention Rule for the backup set.
• Select any special backup options for the backup set.
• Select any notification options for the backup set.
• Select a Schedule for the backup set.
• Select a name for the Backup Set.
• Select the type of Backup Set (Regular, Self-Contained, Statistical).
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
Note:
This function is available only when you create a backup set. It cannot be modified. The
screen looks different, depending on the type of DS-Client you are using.
2. Choose the kind of backup:
Windows DS-Client
LINUX / MAC DS-Client
•
•
•
•
•
•
•
•
•
•
“File System Backups” on page 80
“MS SQL Server Database Backups” on page 93
“MS Exchange Server Backups” on page 97
“Permissions Only Backups” on page 101
“Oracle Database Backup” on page 102
“E-Mail Messages (DS-Recovery Tools)” on
page 114
“System i Server Backup” on page 119
“MySQL Database Backup (Windows DS-Client)”
on page 106
“MS SharePoint Server (DS-Recovery Tools)” on
page 123
•
•
•
•
•
•
•
•
“Local File System, NFS, Samba, UNIX-SSH Backup (LINUX
DS-Client)” on page 90
“System i Server Backup” on page 119
“MySQL Database Backup (LINUX DS-Client)” on page 108
“PostgreSQL Database Backup (LINUX DS-Client)” on
page 113
“DB2 Database Backup (LINUX DS-Client)” on page 109
“Oracle Database Backup” on page 102
“MS SharePoint Server (DS-Recovery Tools)” on page 123
“VMWare Backup (LINUX DS-Client)” on page 124
“XenSource Backup (LINUX DS-Client)” on page 126
3. Click Next. The next screen that appears depends on the kind of backup set you are
creating.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 76
Confidential.
4 - Creating and Modifying Backup Sets
Modifying Backup Sets (Backup Set Properties)
The Backup Set Properties screen helps you modify a Backup Set after it has been created.
1. Browse the Backup Set Tree for the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Use the various tabs in the Properties screen to modify the backup set. For details on
the options, see the online help for the screen.
Properties Tab
Function
Items
Use to change the selected set's backup items and backup item options.
Retention
Use to change the backup set’s retention rules
Options
Use to change the backup set options
Notification
Use to change the set's notification options.
Schedule
Use to change the set's schedule.
Set Info
Shows information about the backup set.
Use to change the set name.
Share
Use to view and edit information about the selected backup share(s).
Connection
Use to view and edit credentials used for connection to the backup source
or dump for certain kinds of backup sets (Appears instead of Share Tab).
Database
Use to view and edit credentials used for database backup sets (Appears
instead of Share Tab).
Advanced Options
Use to change the backup set’s Advanced Options (Windows DS-Client only).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 77
Confidential.
4 - Creating and Modifying Backup Sets
Backup Set Options - Pre/Post
This screen is accessed from the Backup Set Options.
Use this screen to specify a command to run before (Pre) and/or after (Post) execution of the
backup. This screen can also be brought up from the Restore Wizard, in order to execute Pre/Post
options with a restore operation (ex: stop service, restore file, start service).
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Options.
5. Click Pre/Post. The Pre & Post Execution screen appears.
6. For details on these options, see the online help for the screen.
7. Click OK to save the Pre/Post settings.
Special Case: Windows Services
Using the Pre/Post features, you can backup Windows Services. Services normally lock
associated files while the Windows computer is running (i.e. these files will not normally be backed
up). Examples of Services include DHCP and WINS.
Note:
It can be problematic to back up services on the DS-Client computer itself, since shutting
down some core services may cause problems for the backup process.
The steps that apply to Windows Service Backups are identical to File System backups. However,
you must know the specific file path of the service files to be backed up.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 78
Confidential.
4 - Creating and Modifying Backup Sets
Backup Set Options - Exclude Old Files
Use this screen to exclude old files from backup.
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Options.
5. Click Exclude Old Files. The Exclude Old Files screen appears.
6. Select the exclusion for this backup set:
• No exclusion
• Exclude files older than [...] days / weeks / months / years
• Exclude files older than [date]
Backup Set Options - Continuous Data Protection
Note:
The DS-Client Administrator must permit creation of CDP backup sets from the DSClient Configuration - Defaults Tab (Setup Menu > Configuration > Defaults Tab). See
“Configure the Default Options (for Backup Sets)” on page 28.
This section provides some background on the Continuous Data Protection option. It can be
applied to File System backup sets (Windows / UNIX DS-Client), and E-Mail backup sets of MS
Exchange E-Mails (Windows DS-Client with DS-MLR).
• For more information see the Knowledge Base article: “Continuous Data
Protection (Backup Set Option)” on page 474.
Knowing your data environment is important when using the continuous data protection option.
Statistical Backups and LAN Storage Discovery help you to test your data environment. You
should also take into consideration the number of generations that you want to maintain online
(each change will normally count as a generation).
• See “Statistical Backups (DS-Statistics)” on page 129.
• See “LAN Storage Discovery Tool” on page 243.
The backup trigger for any continuous data protection set is the detection of a change to a file on
the backup source. The File Change Detection method depends on the operating system and
backup set type. Backup frequency depends on the interval for changes selected, which can be
wide (up to many hours) or precise (down to the second-level).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 79
Confidential.
4 - Creating and Modifying Backup Sets
File System Backups
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select File System.
3. Click Next >
Step 2. Select the Computer
1. The New Backup Set Wizard prompts you to select the computer to back up.
2. Browse through and highlight the computer that contains the files to be backed up.
3. Click Next >.
Ask for Network Credentials:
• If Ask for Network Credentials is checked, Enter Network Credentials
appears.
• Enter the valid credentials to the computer.
Note: DS-Client connections to NetWare servers - You should supply a 'context' in the From
field of the Connect As box.
• Click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 80
Confidential.
4 - Creating and Modifying Backup Sets
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to the Shares & Directories List for the selected
computer.
2. From this screen, you can do the following:
Add an entire directory
• To add an entire directory, browse through the Shares & Directories List until the directory you want appears and Click it.
Note:
You can select only one directory at a time. Subdirectories are
automatically included, unless you clear the Include
Subdirectories check box.
Add files that match a filter
• To add files that match a filter, in the Filter field, enter the file pattern that you would
like to search for in the selected directory. (e.g. *.doc will search the directory for all
files with the .doc file extension.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 81
Confidential.
4 - Creating and Modifying Backup Sets
Add specific files
• To add specific files, browse through the Shares & Directories List until the directory the
files are stored in appears and Click it. A screen showing the list of files in that directory
appears. Highlight the file(s) you wish to add to the backup set and click Add.
Exclude directories
• You can exclude a subdirectory if its parent directory is selected for backup.
Exclude using Regular Expression
• Regular Expression provides more specific filtering than the Exclude function. For example, you can filter to exclude individual filenames or patterns.
• You should only use this option if you take the time to learn the Regular Expression syntax.
• Example: To exclude a specific filename from the backup, use \\filename\.ext$ (e.g.
\\cache\.dsk$ will exclude the file cache.dsk).
• Source code and some documentation available from: http://www.boost.org/libs/regex/
doc/syntax.html
Add special backup items
Windows File Systems have additional special backup items that can be selected:
- System State (including Registry)
- Services Database
For more information, see the following Knowledge Base articles:
• “Backing up Windows for Bare Metal Restore (BMR)” on page 401
• “Backup / Restore of Windows 2000” on page 448
3. The selected items appear in the Selected for Backup list. The icons indicate the type
of item:
• directory with subdirectory
• directory without subdirectory
• file
• filter extension
• exclude
4. To add more items to the backup set, repeat steps 2-3.
5. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 82
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options menu.
2. You should leave the default settings alone, unless there are specific backup set
option requirements. For details on these options, see the online help for the screen.
3. Generation and options apply to each backup item (each line), and can be changed by
highlighting the backup item and editing the settings.
• Permissions see “Permissions Only Backups” on page 101
4. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 83
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Retention Rule
[OPTIONAL]
The Retention feature allows you to define specific scenarios (Retention Rules) when online data
should be deleted. Retention rules are applied per backup set, but are only enforced on demand or
on schedule.
1. The New Backup Set Wizard switches to the retention rules screen.
2. You should leave the default settings alone, unless there are specific backup set
retention requirements. For details on these options, see the online help for the
screen.
• For more information, see “About Retention Rules” on page 67.
3. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 84
Confidential.
4 - Creating and Modifying Backup Sets
Step 6. Specify Backup Set Options
Backup options affect the way the set is handled during the backup process. Some options are
specific to the type of server that is being backed up.
1. The New Backup Set Wizard switches to the backup set options screen.
2. You should leave the default settings alone, unless there are specific backup set
option requirements. For details on these options, see the online help for the screen.
• For more detailed instructions on Pre/Post, see “Backup Set Options - Pre/
Post” on page 78
• For more detailed instructions on Excluding old files, see “Backup Set Options
- Exclude Old Files” on page 79
• For more detailed instructions on Continuous Data Protection, see “Backup
Set Options - Continuous Data Protection” on page 79
3. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 85
Confidential.
4 - Creating and Modifying Backup Sets
Step 7. Specify Advanced Options (Windows DS-Client)
Some additional advanced options are available for Windows File System backup sets.
1. The New Backup Set Wizard switches to the Specify Advanced Options screen.
2. You should leave the default settings alone, unless there are specific backup set
option requirements. For details on these options, see the online help for the screen.
• Windows options: Additional options specific to Windows file systems (2000
and up).
• Volume Shadow Copy: If the target backup computer supports this feature,
this option appears. When selected, DS-Client will use Volume Shadow Copy
Service (VSS) to copy the volume(s) selected for backup, then perform the
backup of items from that VSS copy. If the VSS copy fails, DS-Client attempts
to backup like a normal File System backup set. For more detailed
instructions, see “Backup using Microsoft VSS (Volume Shadow Copies)” on
page 414.
3. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 86
Confidential.
4 - Creating and Modifying Backup Sets
Step 8. Specify Notification Options
If the DS-Client has been configured with a default notification option (“Configure the Default
Options (for Backup Sets)” on page 28), the default notification will appear in this tab. You may
add more notifications from this tab, if you wish.
1. The Specify Notification Options Tab appears.
2. You should leave the default settings alone, unless there are specific notification
requirements.
3. Click Add (or modify), to specify a notification option for the backup set. The Add
Notification screen appears.
4. In the Notification section, you may select one of the notification options.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 87
Confidential.
4 - Creating and Modifying Backup Sets
Note:
The Email and Pager fields will be grayed out if the DS-Client has not been configured for
Email notification (DS-Client Configuration – Notification Tab).
5. The Recipient section options change, depending on the type of notification selected:
6. In the Completion list, select from one of the following notification conditions. The
specified notification will be sent, if a backup meets the selected condition.
7. Check the Detailed Notification box, to send more detailed backup set information.
8. Click OK to save the notification setting. The Notification screen returns with the new
option displayed in the Notification list.
9. Continue performing steps 3-8 for as many notification options and recipients as
required. Click OK to save any modifications.
10. In the Send SNMP Traps when section, check each box to notify about the event:
• Backup failed
• Backup completed with errors
• Backup completed without errors
11. Click OK to save any modifications.
12. Click Next >.
Step 9. Specify the Schedule
1. The New Backup Set Wizard Schedule screen appears.
2. You should leave the default settings alone, unless there are specific schedule
requirements for this backup set. For details on these options, see the online help for
the screen.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 88
Confidential.
4 - Creating and Modifying Backup Sets
Step 10. Name the Backup Set
1. The New Backup Set Wizard Choose the name for this backup set screen appears.
2. The Wizard assigns a default name in the Set Name field. You may change this name.
3. In the Set Type list, select what type of backup set you want:
• Regular: Creates a full featured backup set of any kind (File System,
Database, etc.).
• Self-Contained: See “Self-Contained Backup Sets” on page 130
• Statistical: See “Statistical Backups (DS-Statistics)” on page 129
4. Additional options appear if they are enabled for this DS-Client:
• BLM: See “Backup Lifecycle Management (BLM)” on page 219
• Local Storage: See “Local Storage Tool” on page 230
5. Click Finish to create the backup set as specified.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 89
Confidential.
4 - Creating and Modifying Backup Sets
Local File System, NFS, Samba, UNIX-SSH Backup
(LINUX DS-Client)
Linux DS-Client can backup the local file system, or servers visible on the LAN with NFS, Samba,
or UNIX-SSH.
More information is available in the following Knowledge Base articles:
• See “Backup / Restore using UNIX-SSH” on page 431.
• See “Backup / Restore of NFS” on page 432.
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Local File System, NFS, Samba, UNIX-SSH.
3. Click Next >
Step 2. Select the source for this backup set
1. Select from the available options:
Local File System
Back up the local DS-Client computer’s file system.
• If backing up the local DS-Client, make sure the backup items exclude (or do
not contain) the postgres data folder. This will likely happen if you select “/”
as the backup item (i.e. the entire “/” drive).
• If the DS-Client is currently using the local Postgres, backing up the postgres
data folder may cause errors during the backup.
NFS
Back up using the NFS protocol.
Samba
Back up using the Samba protocol.
UNIX-SSH
Back up using the UNIX-SSH protocol.
SSH Notes:
1. The backup source machine must be a Unix system (Linux, Solaris, HP-UX, or
AIX).
2. The source machine must have an OpenSSH compatible server installed and
started.
3. The source machine must have either Perl5 (core function, 5.6 or beyond)
installed, or Python (2.4) installed. [Alternatively, you can use the DIRECT option
to run a specific script/binary located on the source machine.]
4. The SSH approach cannot scan the LAN to get an initial machine list. You must
enter the IP of the source machine in the Path field (e.g. UNIX-SSH\10.20.30.100).
The user or administrator can also put the initial machine list into the file
hostlist_ssh located in the installation path (usually /usr/local/DS-Client).
5. For more details, see the Knowledge Base article “Backup / Restore using
UNIX-SSH” on page 431.
2. Browse through and select the server you want to backup.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer.
• Ask for credentials: Click to specify alternate credentials. For UNIX-SSH
backup sets, this user's default shell must be either the Bourne shell or the
BASH shell. If this user's default shell is anything else (like csh, tcsh), the
operation may fail with: "SSH connection failed! The host may not be
accessible!".
• ‘sudo’ as an alternate user (UNIX-SSH backup sets):
-
For security reasons, you may not want to use a super user for remote login to a
source machine. Linux DS-Client is able to login to a source machine as a regular
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 90
Confidential.
4 - Creating and Modifying Backup Sets
user, and then use 'sudo' to execute a shell as an alternate user with higher access
permissions.
-
The regular user must have privileges to connect to the SSH server on the source
machine. Both regular and alternate users must be listed in the ‘sudoers’ file on the
source machine.
-
The ‘sudoers’ file can be edited with ‘visudo’. (Please consult your 'sudo'
documentation for further information.)
-
•
The regular user must have privileges to run the "/usr/bin/perl" or “/usr/bin/python”
command on the source machine as the alternate user. If you have perl/python
installed in a different path, each ‘sudoers’ user must be able to run perl/python from
that installed path.
Advanced connection options (UNIX-SSH backup sets):
-
By default (if no selection is made), DS-Client runs PERL from the default path
(normally “/usr/bin”). If PERL is not located in that directory, you must specify the
exact path in this screen.
-
This screen allows you to specify the type of script to use for backup of files on the
source machine (PERL or PYTHON).
-
The DIRECT option allows you to run the specific program from the path entered in
this screen. (Only for use if you have a specific requirement.)
4. Click Next >.
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to its Select items for backup screen.
2. Browse through the Shares & Directories List and click Add for as many items as are
required.
3. Click Next >.
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 5. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 91
Confidential.
4 - Creating and Modifying Backup Sets
Novell NetWare Backups
There are some requirements that must be met in order to perform backups of NetWare Servers.
In particular, the DS-Client computer must be running a Novell NetWare Client.
For more information, refer to the following DS-Client Knowledge Base Articles:
• “Backup / Restore of Novell NetWare files from a Windows DS-Client” on
page 407
• “Backup / Restore of Novell NetWare files from a Linux DS-Client” on
page 408
NetWare files can be backed up with Windows and Linux DS-Clients. The files are backed up
using the corresponding File System backup set type. There is no separate “NetWare” backup
type, however there are special items (like NDS) that can be selected for backup.
For Windows DS-Clients, see:
• “File System Backups” on page 80
• Once NetWare is configured on DS-Client properly, you will be able to see the
“NetWare Services” network provider when you open New Backup Wizard:
For Linux DS-Clients, see:
• “Local File System, NFS, Samba, UNIX-SSH Backup (LINUX DS-Client)” on
page 90
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 92
Confidential.
4 - Creating and Modifying Backup Sets
MS SQL Server Database Backups
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Microsoft SQL Server.
3. Click Next >
Step 2. Select the Server
1. The Select a database server tab appears.
2. Browse through the list. The New Backup Set Wizard searches for all MS SQL servers
with active databases on the network and prompts you to select which one you want
to back up.
Note:
You can also type the server name in the Path box once you have clicked on the network:
(ex:\\server_name)
3. Browse through and select the server you want to backup.
4. By default, your current user login to the DS-Client will be used to connect to the
selected computer and database. There are two "ask for credentials" checkboxes
available, in the event that you need to specify alternate credentials:
5. Click Next >.
Ask for network credentials (MS SQL Server)
1. If the Ask for Network Credentials box is checked, the Enter Network Credentials
screen appears.
• See “Ask for Network Credentials:” on page 80
2. Enter the credentials and click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 93
Confidential.
4 - Creating and Modifying Backup Sets
Ask for database credentials
1. If the Ask for Database Credentials box is checked, the Enter Database Credentials
screen appears.
2. Enter the database credentials and click OK.
Step 3. Specify the Database Dump Method
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the path (on the selected computer) where you wish to save the dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
Note:
Backups of MS SQL 2005 databases only work with a disk dump (not DS-Client Buffer or
DS-Client Pipe). If there is insufficient space on the database server, you can specify a
remote dump location.
2. Select the dump location.
• Remote dump location: To specify a different computer for the database
dump, you can type a valid UNC path into the Dump Path field. The MS SQL
Server service account and the backup set user credentials must have rights
to access this UNC path (read-write permissions).
2. Select the dump location.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 94
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Specify the Backup Items
1.
The New Backup Set Wizard switches to its Database List screen.
Note:
Multiple instances on the same server are displayed, however you can only add from one
instance per backup set.
2. To Add a Database to the Backup Set:
• Browse through the Database List and highlight the database you wish to
include. Highlight the entire instance to backup all databases.
• Click Add. The database is added to the Selected Items for Backup list.
Note: Backups of MS SQL 2005 databases only work with a disk dump (not DS-Client Buffer or
DS-Client Pipe).
3. Continue performing step 2 for as many items as are required.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 95
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options menu. The type of
SQL Server is displayed at the top of the screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item. For more details on these options, see the
online help.
3. Click Next >.
Step 6. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 96
Confidential.
4 - Creating and Modifying Backup Sets
MS Exchange Server Backups
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Microsoft Exchange Server.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
Note:
You can also type the server name in the Path box once you have clicked on the network
(ex: \\server_name). You must supply the fully qualified domain name of the Exchange
computer (i.e. Do not supply the server's IP address.)
2. Browse through and select the server you want to backup.
• For clustered Exchange servers, you must select the Exchange cluster name.
If you choose an individual node’s name, you will get an error like 'Error
returned from callback function call’.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer and database:
• The "ask for credentials" checkbox allows you to specify alternate credentials.
4. Click Next >.
Ask for network credentials (MS Exchange Server)
See “Ask for Network Credentials:” on page 80 (File System section).
1. If the Ask for Network Credentials box is checked, the Enter Network Credentials
screen appears.
2. Enter the credentials and click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 97
Confidential.
4 - Creating and Modifying Backup Sets
Step 3. Specify the Database Dump Method
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the method to handle the database dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the dump option.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 98
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Specify the Backup Items
1. Once you have successfully connected to the computer, the New Backup Set Wizard
switches to its Database List screen.
2. To Add an MS Exchange Database to the Backup Set:
• Browse through the Database List and highlight an item to include.
• Click Add.
3. Continue performing step 2 for as many items as are required.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 99
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its options menu.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item. For more details on these options, see the
online help.
3. Click Next >.
Step 6. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 100
Confidential.
4 - Creating and Modifying Backup Sets
Permissions Only Backups
This special backup set type allows you to backup only the permissions of the selected item
(directory or file). It shortens the backup time (since this will not backup the actual files). You may
select more than one backup item. A separate dump file will be saved for each backup item you
select.
When a regular file system backup set is performed the files are saved with the current
permissions and attributes.
If only the permissions or attributes are changed and the content of the files remains the same,
DS-Client will not backup those changes to DS-System.
• For Windows 2000/2003, modifications to attributes like Compress, ReadOnly, Hidden, Archive, Index can only be detected (and backed up) using a
Permissions Only Backup Set.
• Modifications to the Encrypt attribute are detected by Regular File System
Backup Sets.
In order to save the last permissions and attributes for your files you must create a Permissions
Only Backup Set.
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Permissions Only.
3. Click Next >
Step 2. Select the Computer
The steps for all subsequent screens are the same as for File System Backups.
Follow from “Step 2. Select the Computer” on page 80 in the section for File System Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 101
Confidential.
4 - Creating and Modifying Backup Sets
Oracle Database Backup
There are some requirements that must be met in order to perform backups of Oracle Database
Servers.
You must refer to the DS-Client Knowledge Base Article: Oracle Database Servers (See “Backup
/ Restore of Oracle Database Servers” on page 433.).
Specifically, look at the sections:
• DS-Client Requirements
• Oracle Server Requirements
• General Requirements
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Oracle Database Backup.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
2. Browse through and select the server you want to backup.
• Oracle on Windows: Expand the Microsoft Windows Network tree.
• Oracle on SPARC (Solaris): Expand the Hummingbird NFS Network tree.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. There are two "ask for credentials" checkboxes available, in the
event that you need to specify alternate credentials:
Ask for Network Credentials
Will prompt you to enter a valid user name and password for the
selected computer.
• The Network Credentials must also be valid for the Network Protocol you select to dump the database file.
• The Network Credentials you specify must have "read" and “write”
privileges for the dump path you select.
Ask for Database Credentials
(Mandatory) Will prompt you to enter a valid user name and password
for the database server.
4. Click Next >.
Ask for network credentials (Oracle Server)
See “Ask for Network Credentials:” on page 80 (File System section).
1. If the Ask for Network Credentials box is checked, the Enter Network Credentials
screen appears.
2. Enter the credentials and click OK.
Ask for database credentials (Oracle Server)
1. The Ask for database credentials box is checked by default, and the Enter Database
Credentials screen appears.
2. Enter the credentials and click OK.
Specify the protocol for dumping the database (Linux DS-Client)
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the method to handle the database dump file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 102
Confidential.
4 - Creating and Modifying Backup Sets
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the protocol:
• Local File System (for Oracle or DB2 servers on the DS-Client computer):
dumps the database into the specified path on the local file system (on the
DS-Client computer).
• NFS (for remote Oracle or DB2 servers): DS-Client will read the database
dump files from the database server through the NFS transmission protocol.
• UNIX-SSH (for remote Oracle or DB2 servers): DS-Client will read the
database dump files from the database server through the UNIX-SSH
transmission protocol.
• DS-PIPE (for Oracle only): DS-PIPE is an alternative to the database dump
for Oracle database server backups. This option does not consume any
additional disk space. During backups, the DS-Client reads from the pipe on
the source database. This method is useful if your database is too big to be
dumped to a file on either the database server or the DS-Client buffer.
3. Click Next >.
Step 3. Specify the Dump Device Path
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the method to handle the database dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the Dump Device path.
• Make sure the Oracle Server username has “read and "write" privileges to this
dump path.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 103
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Specify the Backup Items
1. The New Backup Set Wizard switches to its Database List screen.
2. To back up the full Oracle Database, select all items in the list. Otherwise, browse
through the Database List and click Add for as many items as are required.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 104
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item. For more details on these options, see the
online help.
3. Click Next >.
Step 6. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 105
Confidential.
4 - Creating and Modifying Backup Sets
MySQL Database Backup (Windows DS-Client)
There are some requirements that must be met in order to perform backups of MySQL Databases:
• Windows DS-Client: The mysql utility must be listed in the PATH
environment variable of the DS-Client computer. (If you must edit this
variable, stop and restart the DS-Client service after making the change.)
• The user who performs MySQL Backup / Restore should have knowledge
about the MySQL database.
• DS-Client backs up MySQL Server using the MySQL utilities ‘mysqldump’ and
‘mysql’. The DS-Client’s mysqldump and mysql utilities must be compatible
with the MySQL version running on the source machine (MySQL server).
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of MySQL Database Servers” on page 441
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select MySQL.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
2. Browse through and select the server you want to backup. (You can also type the IP
Address of the machine in the Path field.)
3. Click Next >.
•
You must enter credentials to the database and click OK.
Step 3. Specify the Database Dump Method
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the method of transmitting the dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the dump location.
3. Click Next >.
Step 4. Specify the Backup Items
1. The New Backup Set Wizard switches to its Database List screen.
2. Browse through the Database List and click Add for as many items as are required.
3. Click Next >.
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 6. Specify Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 106
Confidential.
4 - Creating and Modifying Backup Sets
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 107
Confidential.
4 - Creating and Modifying Backup Sets
MySQL Database Backup (LINUX DS-Client)
There are some requirements that must be met in order to perform backups of MySQL Databases:
• Linux DS-Client: The mysql utility must be listed in the PATH environment
variable of user ’root’ on the DS-Client computer.
• Mac DS-Client: The path to the mysql utility must be added to the following
file on the DS-Client computer:
/etc/rc.common
•
•
The user who performs MySQL Backup / Restore should have knowledge
about the MySQL database.
DS-Client backs up MySQL Server using the MySQL utilities ‘mysqldump’ and
‘mysql’. The DS-Client’s mysqldump and mysql utilities must be compatible
with the MySQL version running on the source machine (MySQL server).
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of MySQL Database Servers” on page 441
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select MySQL.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
2. Browse through and select the server you want to backup. (You can also type the IP
Address of the machine in the Path field.)
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. Click "Ask for database credentials" to specify alternate
credentials.
4. Click Next >.
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to its Database List screen.
2. Browse through the Database List and click Add for as many items as are required.
3. Click Next >.
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 5. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 108
Confidential.
4 - Creating and Modifying Backup Sets
DB2 Database Backup (LINUX DS-Client)
There are some requirements that must be met in order to perform backups of DB2 Database
Servers.
You must refer to the DS-Client Knowledge Base Article: DB2 Database Servers (See “Backup /
Restore of DB2 Database Servers” on page 443.).
Specifically, look at the sections:
• DS-Client Requirements
• DB2 Server Requirements
• General Requirements
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select DB2 Database Backup.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
2. Browse through and select the server you want to backup.
• You must know the hostname or IP address of the target DB2 Server to
backup. (It can be on a different subnet.)
• This hostname or IP address must be the same one used in the DB2 ’catalog’
command.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. There are two "ask for credentials" checkboxes available, in the
event that you need to specify alternate credentials:
Ask for Network Credentials
Will prompt you to enter a valid user name and password for the selected
computer.
• The Network Credentials must also be valid for the Network Protocol
you select to dump the database file.
• The Network Credentials you specify must have "read" and “write”
privileges for the dump path you select.
Ask for Database Credentials
(Mandatory) Will prompt you to enter a valid user name and password for
the database server.
4. Click Next >.
Ask for network credentials (DB2 Server)
See “Ask for Network Credentials:” on page 80 (File System section).
1. If the Ask for Network Credentials box is checked, the Enter Network Credentials
screen appears.
2. Enter the credentials and click OK.
Ask for database credentials (DB2 Server)
1. The Ask for database credentials box is checked by default, and the Enter Database
Credentials screen appears.
2. Enter the credentials and click OK:
• User Name: Enter a valid database User Name on the DB2 database server
you want to back up.
• Password: Enter the corresponding password.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 109
Confidential.
4 - Creating and Modifying Backup Sets
•
•
•
Node Name: Enter the local alias of the target DB2 server node. This is the
name on the DS-Client computer that is used to identify that node.
Port Number: Enter the TCP/IP port number of the DB2 Server Database
Manager instance.
DB2 Client Instance: Enter the local DB2 instance name installed on the DSClient computer.
Step 3. Specify the protocol for dumping the database
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select the method to handle the database dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the protocol:
• Local File System (for DB2 Server on the DS-Client computer).
• NFS (for remote DB2 Server)
• UNIX-SSH (for remote DB2 Server)
3. Click Next >.
Step 4. Specify the Dump Device Path
In order to back up an active database, a copy or "dump" of the database must be made. Use this
screen to select where to place the database dump file.
1. New Backup Set Wizard prompts you to specify how to handle the database dump.
2. Select the Dump Device path.
• Make sure the DB2 Server username has “read and "write" privileges to this
dump path.
3. Click Next >.
Step 5. Specify the Backup Items
1. The New Backup Set Wizard switches to its Database List screen.
2. Browse through the Database List and click Add for as many items as are required.
3. Click Next >.
Step 6. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 7. Specify the Retention Rule
1. The New Backup Set Wizard switches to the retention rules screen.
2. You should leave the default settings alone, unless there are specific backup set
retention requirements. For details on these options, see the online help for the
screen.
• For more information, see “About Retention Rules” on page 67.
3. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 110
Confidential.
4 - Creating and Modifying Backup Sets
Step 8. Specify Backup Set Options
1. The New Backup Set Wizard switches to the backup set options screen.
2. You should leave the default settings alone, unless there are specific backup set
option requirements. For details on these options, see the online help for the screen.
Prune History /
Delete entries from the history file or log files from the active log path.
Logfile
• If unchecked, perform Offline DB2 backup. During an offline backup,
applications cannot connect to the database.
• If checked, perform Online DB2 backup. An online backup allows
Online Backup
applications to connect to the database and read and write to tables
during database backup. Log retain or userexit must be enabled for an
online backup.
3. Click Next >
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 111
Confidential.
4 - Creating and Modifying Backup Sets
Step 9. DB2 ‘userexit’ log path
1. This Wizard screen only appears if you selected “Online Backup” in the previous
screen. Otherwise, follow from “Step 8. Specify Notification Options” on page 87 in the
section for File System Backups.
•
•
If ‘User Exit’ is OFF on the DB2 database server, you can leave these fields
empty.
If ‘User Exit’ is ON on the DB2 database server, you must enter the path for
the DB2 Archive Logs.
Archive Log
backup path
This is the path where the DB2 Archive Log files are written by the ‘User
Exit’ program.
• Click [...] to specify the path. This opens the Select Directory screen.
Archive Log
restore path
(Optional) This will be the default path in the Restore Wizard for this
backup set.
This is the path where the DB2 Archive Log files will be retrieved by the
‘User Exit’ program (DS-Client will restore the Archive Logs to this path).
• Click [...] to specify the path. This opens the Select Directory screen.
2. Click Next >
Step 10. Specify Notification Options
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 8. Specify Notification Options” on page 87 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 112
Confidential.
4 - Creating and Modifying Backup Sets
PostgreSQL Database Backup (LINUX DS-Client)
There are some requirements that must be met in order to perform backups of PostgreSQL
Databases:
• The psql and pg_dump utilities must be listed in the PATH environment
variable of the user ’root’ on the DS-Client computer.
• The DS-Client computer’s psql and pg_dump utilities must be compatible
with the PostgreSQL version running on the source machine (PostgreSQL
server).
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of PostgreSQL Database Servers” on page 446
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select PgSQL.
3. Click Next >
Step 2. Select the Server
1. The New Backup Set Wizard scans for servers on the network.
2. Browse through and select the server you want to backup.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. Click "Ask for database credentials" to specify alternate
credentials or an alternate port number if PostgreSQL instance is not running on the
default port (5432).
4. Click Next >.
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to its Database List screen.
2. Browse through the Database List and click Add for as many items as are required.
3. Click Next >.
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
• For details on these options, see the online help for the screen (Press F1 in
this screen).
3. Click Next >.
Step 5. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 113
Confidential.
4 - Creating and Modifying Backup Sets
E-Mail Messages (DS-Recovery Tools)
NOTE: From v.7.0, the DS-MLR Service is bundled with the DS-Recovery Tools installation.
Windows DS-Client only:
• For online backup and restore of E-Mail servers at the message-level.
• This option must be enabled by your Service Provider from the DS-System.
• You must install the DS-MLR Service on the target MS Exchange, MS
Outlook, Lotus Notes / Domino Server or GroupWise computer.
• Refer to the DS-Recovery Tools Installation Guide for instructions.
For more information, refer to the following Knowledge Base articles:
• See “DS-MLR Installation & Setup” on page 328.
• See “Backup / Restore of E-Mails (using DS-MLR)” on page 452.
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select E-Mail Messages.
3. Click Next >.
Step 2. Select the E-Mail Server Type
1. You must select the E-Mail Server Type.
2. Select the type of E-Mail Server you want:
• Microsoft Exchange Server
• Microsoft Outlook
• Lotus
• GroupWise
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 114
Confidential.
4 - Creating and Modifying Backup Sets
Step 3. Select the Server
1. Browse through and select the server you want to backup. If the name resolution to IP
address is not functional, you can create the backup set by typing the IP address in
the Path field.
•
2.
3.
4.
5.
To backup E-Mails of clustered MS Exchange Servers, you must select the
virtual computer of the Exchange Cluster.
• To backup GroupWise E-Mails, you must select the server where the
GroupWise Client (and DS-Recovery Tools) are installed.
By default, your current user login to the DS-Client will be used to connect to the
selected computer. The "ask for credentials" checkbox allows you to specify alternate
credentials.
Click Next >.
If Ask for Network Credentials is checked, the Enter Network Credentials screen
appears.
Enter the credentials to the target computer. The amount of mailboxes that appear
will depend on the credentials supplied.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 115
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Select Directories / E-Mails for Backup
1. The New Backup Set Wizard switches to its Select directories / E-Mails for backup
screen.
2. This dialog is the same as the Select Items for Backup Screen (File System Backups),
except two name differences:
• The Shares and Directories List is called the Mailboxes List;
• The Files button is called the E-Mails.
3. Select the mailboxes to backup.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 116
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item. For more details on these options, see the
online help.
3. To add a filter to a backup item, highlight the item and click Filter. The Select Filter
screen appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 117
Confidential.
4 - Creating and Modifying Backup Sets
4. Select from one of the available filters, or click Add to create one. If you click Add, the
Add / Modify Filter Screen appears.
5. Create the filter by giving it a name in the Filter Name field.
6. Select the filter conditions (you can make complex filters with the AND, OR, and
BRACKETS). When finished, click OK.
Note:
If you add a filter, the backup will search and backup only those E-Mails that match the
filter description.
7. Click Next >.
Step 6. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 118
Confidential.
4 - Creating and Modifying Backup Sets
System i Server Backup
[Windows DS-Client] For this option to be enabled, the IBM™ iSeries Access for Windows must be
installed on both the System i Server and the computer on which the DS-Client is running.
For more information, see “Backup / Restore of System i Server” on page 460.
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select System i Server.
3. Click Next >
Step 2. Select the Server
1. The Select a System i Server to backup screen appears.
2. In the Path field:
• You must manually enter the IP address of the System i server.
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. To specify alternate credentials:
• The "ask for credentials" checkbox allows you to specify alternate credentials.
4. Click Next >.
Step 3. Specify the share & path for the data dump
1. New Backup Set Wizard prompts you to specify the location of the data dump.
2. Select a folder in the ROOT file system:
• The System i Server ROOT file system must be shared (with read-write
permissions) for this operation to work.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 119
Confidential.
4 - Creating and Modifying Backup Sets
Step 4. Specify the Backup Items
1. The New Backup Set Wizard switches to its Items List screen.
2. Create a list of items that you are going to backup. Your items list can consist of:
Applications
An application is a specific list of libraries you create for backup.
• To create or modify an application, click "Modify".
• In the Modify Applications screen, highlight the libraries that belong to the
application and click Modify.
•
In the Select Applications screen, enter or choose a name in the Application
name field and click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 120
Confidential.
4 - Creating and Modifying Backup Sets
•
•
In the Modify Applications screen, the application name appears to the left of
the selected libraries. Click OK to return to the Items List screen.
The application created will appear in the Applications folder.
Note: The "Selected Items for Backup" list cannot contain applications and libraries at the same
time.
Libraries
•
•
You can choose individual libraries for backup directly. The entire contents of
the selected library (or libraries) will be backed up.
If you wish to backup all libraries of your system, highlight the line "Libraries"
and press "Add".
Note: The "Selected Items for Backup" list cannot contain applications and libraries at the same
time.
System info
[Windows DS-Client only] You can backup the entire system info at once, or select either:
1. User Profiles - the user profiles of your System i Server, or
2. Configuration - the configuration, which consists of:
• Line descriptions
• Controller descriptions
• Device descriptions
• Mode descriptions
• Class of service descriptions
• Network interface descriptions
• Network server descriptions
• NetBIOS descriptions
• Connection lists
• Configuration lists
• Hardware resource data
• Tokenring adaptor data
Backup of files, members and objects.
•
•
In order to backup single files, expand a library and Add the file(s).
In order to backup a member, select the file, and press the "Objects" button.
In the window that appears, select a member and press "Add".
• In order to backup other objects from a library, e.g. programs or data areas,
select the library the objects are in, and press "Objects". In the window that
appears, select your objects and press the "Add" button.
• You can add as many items to the "Selected Items for Backup" list as you
need. If you wish to remove an item, use the "Remove" button.
• "Individual obj" checkbox: if you wish to be able to quickly restore individual
objects, check this box before you press the "Add" button. (Note: this option
will reduce the backup speed and increase the disk space required. The
performance will also be affected if the libraries contain a large number of
small objects.) The icon for "individual objects" contains an additional blue "+"
sign.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 121
Confidential.
4 - Creating and Modifying Backup Sets
Step 5. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 6. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 122
Confidential.
4 - Creating and Modifying Backup Sets
MS SharePoint Server (DS-Recovery Tools)
•
•
•
•
For online backup and restore of Microsoft SharePoint servers.
This option must be enabled by your Service Provider from the DS-System.
You must install the DS-Recovery Tools service on the MS SharePoint
computer.
Refer to the DS-Recovery Tools Installation Guide for instructions.
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of SharePoint Servers” on page 472
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select Microsoft SharePoint Servers.
3. Click Next >.
Step 2. Select the Server
1. Browse through and select the server you want to backup. If the name resolution to IP
address is not functional, you can create the backup set by typing the IP address in
the Path field.
2. By default, your current user login to the DS-Client will be used to connect to the
selected computer. The "ask for credentials" checkbox allows you to specify alternate
credentials.
3. Click Next >.
4. If Ask for Network Credentials is checked, the Enter Network Credentials screen
appears.
• Enter the credentials to the target computer.
Step 3. Select Items for Backup
The steps for all subsequent screens are the same as for Windows File System Backups.
• Follow from “Step 3. Specify the Backup Items” on page 81 in the section for
File System Backups.
• Some options may not appear for MS SharePoint backup sets.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 123
Confidential.
4 - Creating and Modifying Backup Sets
VMWare Backup (LINUX DS-Client)
There are some requirements that must be met in order to perform backups of Virtual-Machines
from a VMWare ESX Server.
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of VMWare (at Virtual Machine-level)” on page 468
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select VMWare.
3. Click Next >
Step 2. Select the Server
1. The “Select the source for this backup set“ screen appears.
2. In the Path field:
• You must manually enter the IP address of the VMWare Virtual Center
machine or ESX Server in the following format:
VMWare\IP_address
Note:
By connecting to the VMWare Virtual Center, you will be able to see (and backup) all the
Virtual Machines from all the VMWare ESX servers connected to this Virtual Center.
3. You must know the version of ESX that is running on the target Virtual Machine. The
protocol used to connect to it will depend on the version.
For ESX versions 3.0.1 and 3.0.2, the SSH protocol is used.
• By default, your current user login to the DS-Client will be used to connect to
the selected computer. To specify alternate credentials:
Ask for VMWare logon
credentials:
Credentials to logon to the Virtual Center or ESX Server (the target
computer specified at the IP address in step 2).
ESX Connect:
Ask for credentials:
Credentials to connect (using SSH) to the VMWare ESX Server.
ESX Connect:
“sudo” as an alternate
user:
Choose to perform ‘sudo’ after connecting to the VMWare ESX Server.
• You must supply the alternate user name, and the password of the
user with ‘sudo’ rights (that connects to the VMWare ESX Server).
• This is the same as for “Local File System, NFS, Samba, UNIX-SSH
Backup (LINUX DS-Client)” on page 90.
For ESX versions 3.5 and 3.5i, the HTTPS protocol is used.
• By default, your current user login to the DS-Client will be used to connect to
the selected computer. To specify alternate credentials:
Ask for VMWare logon credentials:
Credentials to logon to the Virtual Center or ESX Server (the
target computer specified at the IP address in step 2).
ESX Connect:
Ask for credentials:
Do not use this option for ESX version 3.5 or 3.5i.
ESX Connect:
“sudo” as an alternate user:
Do not use this option for ESX version 3.5 or 3.5i.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 124
Confidential.
4 - Creating and Modifying Backup Sets
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to its “Select Items for Backup“ screen.
2. Browse through the Shares & Directories List and click Add for as many items as are
required.
3. Click Next >.
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 5. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 125
Confidential.
4 - Creating and Modifying Backup Sets
XenSource Backup (LINUX DS-Client)
There are some requirements that must be met in order to perform backups of Virtual-Machines
from a XenSource server.
For more information, refer to the following Knowledge Base article:
• “Backup / Restore of XenSource (at Virtual Machine-level)” on page 471
Step 1. Choose the kind of backup set
1. Sets menu > New Backup Set. The New Backup Set Wizard screen appears.
2. Select XenSource.
3. Click Next >
Step 2. Select the Server
1. The “Select the source for this backup set“ screen appears.
2. In the Path field:
• You must manually enter the IP address of the XenSource server in the
following format:
XenSource\IP_address
3. By default, your current user login to the DS-Client will be used to connect to the
selected computer. To specify alternate credentials:
Ask for XenSource API Prompts you to enter a valid user name and password for the selected
logon credentials:
XenSource server.
4. Click Next >.
Step 3. Specify the Backup Items
1. The New Backup Set Wizard switches to its “Select Items for Backup“ screen.
2. Browse through the Shares & Directories List and click Add for as many items as are
required.
3. Click Next >.
Step 4. Specify the Backup Item Options
1. The New Backup Set Wizard switches to its backup item options screen.
2. You should leave the default settings alone, unless there are specific generation or
option requirements for each backup item.
3. Click Next >.
Step 5. Specify the Retention Rule
The steps for all subsequent screens are the same as for Windows File System Backups.
Follow from “Step 5. Specify the Retention Rule” on page 84 in the section for File System
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 126
Confidential.
5 - Backup Set Types
5 - Backup Set Types
This section describes how to create and use the different backup set types (Statistical Backup
Sets and Self-Contained Backup Sets).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 127
Confidential.
5 - Backup Set Types
Overview of Backup Set Types
This section describes the different types of backup sets. (These are in addition to the Regular
type.)
•
•
“Statistical Backups (DS-Statistics)” on page 129
“Self-Contained Backup Sets” on page 130
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 128
Confidential.
5 - Backup Set Types
Statistical Backups (DS-Statistics)
Statistical backup data can be generated to determine the data backup usage and trends before
performing actual backups. You do not need a customer account with a Service Provider, and no
backup data is transmitted. Statistical data is gathered and stored in the DS-Client database.
Statistical backup sets can help you to estimate the initial backup size, as well as the data change
trends of your backup data. This allows you to determine how long the initial backup of baseline
data will take.
You can estimate the amount of changes your backup data will experience between backups (the
greater the amount, the longer the backups time). To do so, simply let the backup(s) run on
schedule for at least five or more full sessions. This will distinguish the backup data change trend
from the initial baseline backup.
Note:
You cannot convert a Statistical Backup to a Regular Backup.
1. In the Set Type list, select Statistical.
2. The Calculate Transmit Amount checkbox appears. Check this box to emulate an
actual backup transfer process. During statistical backups, specified backup files will
be read from their source and processed for compression/encryption.
3. Click Finish.
4. Allow the backup set to run on schedule (or demand). To generate accurate trends,
you should let it run in your data environment for at least 1-2 weeks.
5. Use the DS-Client Load Summary, Storage Summary and Report features to view the
statistics generated. See the section: “11 - Logs and System Tools” on page 232.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 129
Confidential.
5 - Backup Set Types
Self-Contained Backup Sets
Self-Contained Backup Sets perform backup and restore using only local storage. Like Statistical
Backup Sets, this backup type is provided to help you to experience the features of ASIGRA
Televaulting.
Self-Contained backup sets have the following features and limitations:
• Platforms: DS-Client running on Windows 2000 / XP / 2003 / Linux
• Data is stored locally at customer site (local disc or UNC path)
• The Local Storage Path must be set (from Setup Menu > DS-Client
Configuration > Parameters Tab)
• Up to 5 self-contained backup sets
• Up to a total of 10 GB of protected data
• Only one generation of file protected (only latest generation)
• Data stored is compressed
Note:
You cannot convert a Self-Contained Backup Set to a Regular Backup Set. You can use
the Clone feature to duplicate it as a new Regular backup set (see “Clone a Backup Set” on
page 146).
1. In the Set Type list, select Self-Contained.
2. Click Finish.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 130
Confidential.
6 - Working with Backup Sets
6 - Working with Backup Sets
This section contains instructions for working with backup sets.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 131
Confidential.
6 - Working with Backup Sets
View Backup Set Information
Backup options affect the way the set is handled during the backup process. Some options are
specific to the type of server that is being backed up.
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Set Info.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 132
Confidential.
6 - Working with Backup Sets
Modify Share Access Properties
It may be necessary to change the User Name and password associated with a backup set (For
example: if you are creating backup set for someone with limited LAN access rights). The user
name and password to "connect as" will be used to connect to the backup items on the LAN in the
backup set.
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Share.
5. Click >> beside the Connect As field. The Modify Network Credentials screen
appears.
• See “Ask for Network Credentials:” on page 80.
6. Type a new User Name and/or a new password to be associated with the backup set.
7. In the From list, select the machine where the DS-Client will verify the user
information.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 133
Confidential.
6 - Working with Backup Sets
8. Click OK to save your changes and close the Modify Network Credentials screen. The
Share Tab returns with the modified Connect As information.
9. Click OK to save any modifications.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 134
Confidential.
6 - Working with Backup Sets
Exclude files that failed to backup
[Windows DS-Client, File System Backup Sets only]
This feature is added for your convenience when editing a backup set. You can exclude some or
all from this list, allowing you to define the exclusion quickly (especially with long lists).
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Edit. The Edit Items screen appears.
5. Click Failed Files.
6. The file list is a cumulative list of every file that ever failed to back up since this backup
set was created.
• Use the CTRL and SHIFT keys to highligh some or all of the files from the list,
or
• Select one of the failed files and check “Custom Exclude”. This will exclude all
files in the same path with the same extension.
7. Click Exclude. The Edit Items screen returns with your exclusions in the list of backup
items selected.
8. Click Close. The Items Tab returns. You must click Apply or OK to save your changes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 135
Confidential.
6 - Working with Backup Sets
Modify Database Information (MS SQL Servers)
1.
2.
3.
4.
Browse the Backup Set Tree and highlight the backup set you want.
Right-click.
Click Properties. The Backup Set Properties screen appears on the Items Tab.
Click Database.
•
If "Access integrated with share" is checked, you can only edit the credentials
from the "Dump location" section. Windows authentication will be performed
when connecting to the database.
Note: “Access integrated with share” will not work if your network is using Windows Integrated
Security. (Even though you can check and uncheck the box, and enter any credentials, the
Windows Integrated Security ignores any credentials from the “Database Info” section.)
5. Click OK to save any modifications.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 136
Confidential.
6 - Working with Backup Sets
Modify Connection Information (MS Exchange Server
and System i Server)
1.
2.
3.
4.
Browse the Backup Set Tree and highlight the backup set you want.
Right-click.
Click Properties. The Backup Set Properties screen appears on the Items Tab.
Click Connection.
5. Click OK to save any modifications.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 137
Confidential.
6 - Working with Backup Sets
Modify Connection Information (E-Mail backup sets)
This applies to E-Mail message backup sets created using DS-MLR (DS-Recovery Tools).
1. Browse the Backup Set Tree and highlight the backup set you want.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Connection.
• Click [>>] to modify the credentials used by the backup set.
5. Click OK to save any modifications.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 138
Confidential.
6 - Working with Backup Sets
Modify Connection Options (Linux DS-Client)
1.
2.
3.
4.
Browse the Backup Set Tree and highlight the backup set you want.
Right-click.
Click Properties. The Backup Set Properties screen appears on the Items Tab.
Click Connection Options.
•
The amount of options depends on the type of backup set and whether the
data source is local or remote.
• For details on these options, see the online help for the screen.
5. Click OK to save any modifications.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 139
Confidential.
6 - Working with Backup Sets
Re-name a Backup Set
You can rename a backup set from its Properties screen.
1. Browse the Backup Set Tree and highlight the backup set you want to rename.
2. Right-click.
3. Click Properties. The Backup Set Properties screen appears on the Items Tab.
4. Click Set Info.
5. In the Set name field, change the backup set name as desired.
6. Click OK to save the change.
7. The set reappears in the Backup Sets tree with the new name.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 140
Confidential.
6 - Working with Backup Sets
Suspend and Activate a Backup Set
Scheduled backups can be suspended indefinitely with the Suspend function. They will only
resume when you use the Activate function.
1. In the Backup Set Tree, highlight the backup set you want.
2. Right-click.
3. Click Suspend or Activate on the Backup Set desired.
4. The set's name changes color to reflect its new status:
• black = active
• gray = suspended
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 141
Confidential.
6 - Working with Backup Sets
Synchronize a Backup Set's Backup Logs
It is possible that a backup set's backup logs could fall out of synchronization with the DSSystem's On-line storage. This could happen to regular backup sets for a variety of reasons
(though not frequently during normal DS-Client operations).
The synchronization process is used to correct discrepancies between the DS-Client backup set
logs and the DS-System's On-line storage if they occur.
"Normal" synchronization is also run automatically during the Weekly Admin. and Scheduled
Backup processes, if "Files not in sync" errors are found for a backup set. If the synchronization
was successful, the files will maintain an active status. This enhances the probability of long-term
unattended operation of the DS-Client.
1. In the Backup Set Tree, highlight the backup set you want.
2. Right-click.
3. Click Synchronize. The Select Synchronization Options screen appears.
4. Choose the synchronization option, and click Synchronize. The Synchronization
Process screen appears, showing the progress.
5. Verify any errors that occurred for the Synchronization process. Errors that state
"Directory not in Backup Set" indicate that the directory was added to the Backup Set.
6. You may wish to run another Synchronization ("Check Only" this time) to verify that
the synchronization was successful. If no errors appear in the Activity Log, the Backup
Set is properly synchronized.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 142
Confidential.
6 - Working with Backup Sets
Migrate a Backup Set from one computer to another
A situation may arise, where you need to change the network provider (NT, NetWare, etc.), or
computer from which the DS-Client backs up an existing backup set. (This is useful if you rename
your computer, change the operating system, or change the physical location of files).
ASIGRA Televaulting allows you to change the provider/computer of a backup set with the
Migration feature. This involves selecting the backup set to migrate, then specifying the new path
from which the backup set will be backed up.
1. In the Backup Set Tree, highlight the backup set you want.
2. Right-click.
3. Click Migrate. Browse and select the new network / node path where you want to
migrate this backup set.
4. Click Next >
• If Ask for network credentials is checked, the Enter Network Credentials
screen appears. Enter the User name, password, and source server (if
applicable) from which to connect with the selected network / node, then click
OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 143
Confidential.
6 - Working with Backup Sets
5. The Migrate Backup Set Wizard switches to match the source / destination shares
screen.
6. Match each Source item with a Destination cell.
7. Click Next >.
8. The Select directories / files for backup screen appears.
9. The Selected Items for Backup remain, with their share path changed to the
destination share selected in the previous tab. Make sure that the new path is correct
for each backup item. You may add more files, or leave this screen unchanged.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 144
Confidential.
6 - Working with Backup Sets
10. Click Next >
11. The Specify backup item options screen appears.
12. Select the backup item options, as you would a normal backup set. Depending on
which network you have migrated to, you may see more or less backup options than
previously available for this backup set.
13. Click Finish to complete the migration.
14 The Backup Sets screen returns. If you check the properties for the migrated backup
set (Sets menu > Backup Sets > Properties), you will see the changes to the provider,
network and / or node.
15. Synchronize the migrated backup set. (See “Synchronize a Backup Set's Backup
Logs” on page 142.)
16. You may now perform backups and restores with this backup set.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 145
Confidential.
6 - Working with Backup Sets
Clone a Backup Set
This is a shortcut to copying an existing backup set with all its settings, except retention rule,
schedule and name.
1. In the Backup Set Tree, highlight the backup set you want.
2. Right-click
3. Click Clone. The Clone Backup Set Wizard appears on the Choose Retention Rule
screen.
• [Optional] Select a Retention Rule. For more information, see “About
Retention Rules” on page 67.
4. Click Next >. The Choose a Schedule screen appears.
• [Optional] Select a schedule.
5. Click Next >. The Choose the name for the backup set screen appears.
6. Select a set name, a set type, and click Finish.
7. The new backup set appears in the Backup Sets Tree.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 146
Confidential.
6 - Working with Backup Sets
Change Backup Set Ownership
The user who creates a backup set is that Backup Set's Owner. Administrators can change the
ownership of a backup set (e.g. due to personnel changes).
1. Browse the Backup Set Tree for the backup set you want.
2. Right-click.
3. Click Change Owner. The Change Backup Set(s) Owner screen appears.
4. Click >>. The Select Group / User screen appears.
5. Highlight the User you want, and click Select.
6. The Change Backup Set(s) owner screen returns with selected username.
7. Click OK to proceed with the change.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 147
Confidential.
6 - Working with Backup Sets
Backup Set Permissions
By default, only the administrator and the backup set's owner have permissions to a backup set.
This includes viewing, changing, backing up, restoring or deleting the backup set or items in it.
Backup Operators may perform demand backups on a backup set, as well as change the schedule
applied to it. These backup set permissions may be modified.
1. Browse the Backup Set Tree for the backup set you want.
2. Right-click.
3. Click Permissions. The Backup Set Permissions screen appears, showing users other
than the owner or Administrator, with rights to this backup set.
4. To add permissions to a user or group, click Add. The Add Permission for Users and
Groups screen appears. Users and groups only appear once they have logged into
the DS-Client.
5. Highlight the user or group that is to receive permissions.
6. In the Permission type section, check all permissions you want to apply: Backup,
Restore, Modify and Delete.
7. Click Add to add the permissions. The Backup Set Permissions screen returns with
the new user or group and permissions listed.
8. Click Close to exit this screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 148
Confidential.
7 - Deleting Backup Sets and On-line Files
7 - Deleting Backup Sets and
On-line Files
This section describes how to delete backup sets, and permanently remove backed up files or file
generations that are stored On-line on the DS-System.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 149
Confidential.
7 - Deleting Backup Sets and On-line Files
Overview of Delete Options
Since there is a cost to storing data, you may decide to remove obsolete items (backup sets,
directories, specific files and/or file versions) from On-line storage.
WARNING:Take care in any delete situation, since once data is deleted, it is gone.
Delete Option
Description
Selective Delete
Allows you to choose items to delete from a single backup set.
• See: “Selective Delete from On-line Storage” on page 151
Assisted Delete
Displays items to delete from all the DS-Client’s backup sets.
• See: “Assisted Delete from all On-line File System & DS-MLR backup sets” on
page 155
Delete Backup Set
Delete all of the backup set’s files and remove the backup set from the DS-Client.
• See: “Remove Backup Set from On-line Storage” on page 157
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 150
Confidential.
7 - Deleting Backup Sets and On-line Files
Selective Delete from On-line Storage
Since there is a cost to storing data, you may decide to remove obsolete items (backup sets,
directories, specific files and/or file versions) from On-line storage.
Performing a Selective Delete will remove the selected directories from On-line Storage. The
backup set, however, will continue to exist (and scheduled backups will continue to be performed).
Delete Directories
1. Browse the Backup Set Tree for the backup set you want.
2. Right-click.
3. Click Delete. The Delete Wizard screen appears on the Select how you want to delete
screen.
4. For details on these options, see the online help for the screen. Selections in this
screen help to narrow the display of files and directories for delete in the last Wizard
Tab.
• In the Data selection for Delete section, select the method that this Wizard will
use to select data. Time based data selection is the default, but Windows has
additional options if the data source is using a recognized HSM system (i.e. if
a placeholder/stub is detected on the source).
• Select the period of backups that you want to delete.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 151
Confidential.
7 - Deleting Backup Sets and On-line Files
5. Click Next >. The Delete Wizard switches to allow you to select delete options. For
details on these options, see the online help for the screen.
•
•
Archived data placeholders: These options relate to displaying generations
that have already been ‘pushed’ to BLM from online storage (i.e. the actual file
has been removed from online to BLM). Select what you want to display in the
next screen of the Delete Wizard (Include archived files, exclude archived
files, or show only archived files).
Move to BLM: select if you want to send a copy of all the files that are deleted
to BLM.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 152
Confidential.
7 - Deleting Backup Sets and On-line Files
6. The Select directories/files to delete screen appears. The contents of the Tree depend
on the options specified in the previous screen.
7. Browse through the Directory Tree and check the box beside each directory you want
to delete. The number and total size of the files selected for delete appear at the
bottom of the screen.
8. Click Finish. The Delete Process Screen appears.
Delete Individual Files
1. Follow Steps 1-7 in the previous section “Delete Directories” on page 151. The Select
directories/files to delete screen appears.
2. Highlight the directory containing the files you want to delete.
3. Click Show Files, the Files List appears, showing all of the files in the highlighted
directory.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 153
Confidential.
7 - Deleting Backup Sets and On-line Files
4. The Files List section appears.
5. Browse through the Files List and check the box beside each file you want to delete.
6. The number and total size of the files selected for delete appear at the bottom of the
screen.
7. You can view your delete selections by clicking the Selection button. The Delete
Selection screen appears, showing the full path \ file name of each delete item.
8. Click Finish. The Delete Process Screen appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 154
Confidential.
7 - Deleting Backup Sets and On-line Files
Assisted Delete from all On-line File System & DS-MLR
backup sets
Assisted Delete allows you to delete from ALL the File System & DS-MLR backup sets. Only
directories that have been removed from the backup source can be selected.
1. Sets Menu > Delete > Assisted Delete.
2. The Assisted Delete Wizard appears on the Select how you want to delete tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 155
Confidential.
7 - Deleting Backup Sets and On-line Files
3. For details on these options, see the online help for the screen. Selections in this
screen help to narrow the display of directories for delete in the next Wizard Tab.
• In the Delete period section, select the range of backups to delete and the
number of generations (if any) you want to leave on-line.
• In the Filter Section, enter the date and time limit for the delete selection. The
Assisted Delete Wizard will only display directories that were deleted from the
source backup computer before this date & time. The Filter is applied against
the directories that match the Delete Period.
• [Windows DS-Client only]: For file system backup sets, you have an additional
option for deleting files if a placeholder/stub is detected on the source.
• Move to BLM: select if you want to send a copy of all the files that are deleted
to BLM.
4. Click Next >. The Select Backup sets/directories tab appears.
5. Directories that are grayed out do not match the Delete Period or Filter selections.
6. Click Finish to start the Delete Process.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 156
Confidential.
7 - Deleting Backup Sets and On-line Files
Remove Backup Set from On-line Storage
Since there is a cost to storing data On-line, you may decide to remove obsolete items (backup
sets, directories, specific files and/or file versions) from On-line storage.
This option will remove all On-line backups of the set (and the set itself).
Note:
You can only remove Initial Backup sets that are marked ‘incomplete’. See “Monitor
Initial Backup Sets” on page 212.
1. Browse through and highlight the backup set you want to delete.
2. Sets Menu > Delete > Remove Backup Set. The Remove Backup Set screen
appears.
• For details on these options, see the online help for the screen.
3. Press the 'OK' button to continue. A confirmation screen appears.
• Click 'Y' to remove the set. Press any other key to abort.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 157
Confidential.
8 - Demand Backups
8 - Demand Backups
ASIGRA Televaulting is designed to perform unattended backups at scheduled intervals.
However, you may want to back up certain files at other times (on demand). This section provides
information on how to perform such demand backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 158
Confidential.
8 - Demand Backups
Perform a Demand Backup
You can perform demand (immediate) backups at any time. The options available depend on the
backup set type.
1. Browse the backup set tree and highlight the backup set you want.
2. Right-click.
3. Click Backup Now. The Backup Now Wizard screen appears on the Select items for
demand backup screen.
4. A check mark appears beside each item to indicate it is selected for the demand
backup. Uncheck any item(s) you do not want to backup.
5. You may change a backup item's options (for this session only) by highlighting it, then
checking or un-checking the option boxes that appear at the bottom of the tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 159
Confidential.
8 - Demand Backups
6. Click Next >. The Select options for demand backup screen appears.
7. In the Backup set options section, you may select options for this demand backup
session.
8. In the Open files section you can specify how the DS-Client will deal with any open
files encountered during the backup.
This does not guarantee an open file will be backed up. You will require 3rd-party
software to back up open files that are locked from other processes.
9. Click Finish to start the backup procedure.
10. The Backup Process screen appears, showing the progress of the backup session.
Note:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 160
Confidential.
8 - Demand Backups
Initial Backup (Premium Service)
For more information, see “Initial Backup” on page 209 from section Section 10 - Premium Backup
and Recovery Services.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 161
Confidential.
9 - Restoring Backups
9 - Restoring Backups
This section describes how to restore your backed up data. Various options are available to help
you select the specific items to restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 162
Confidential.
9 - Restoring Backups
Introduction & Common Functions
Restores are conducted per backup set:
• Select the backup set to restore
• Select the locations
The Restore Wizard assists you with the selection and options. An overview of common functions
is presented in this section. Separate sections appear with instruction for restoring each kind of
backup set.
Step 1. Select the backup set
See “Step 1. Select the Backup Set” on page 172.
Restore Wizard Screen
Description
Step 2. Select Items for Restore
See “Step 2. Select the Restore Items” on page 172.
• See “Advanced Restore Options” on page 164.
• See “Restore a Specific File or Files of a Specific Pattern” on
page 166.
• See “Restore only files that differ from those on the backup source
volume” on page 168.
• See “Restore an Older Generation of a File” on page 169.
Step 3. Select restore location
See “Step 3. Specify the Restore Location” on page 174.
• See “Restore to an Alternate Location” on page 194.
Step 4. Specify restore options
See “Step 4. Specify the Restore Options” on page 175.
• See “Pre/Post Restore Activity” on page 170.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 163
Confidential.
9 - Restoring Backups
Advanced Restore Options
The Advanced Restore Options screen allows you to narrow your restore selection:
• Select from a single backup session
• Select from a period of backups
• Filter the selection to show only deleted files
• Specify a file overwrite policy for the restore files
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click.
3. Click Restore Now.
4. The Restore Now Wizard opens and the Select directories / files to restore screen
appears.
5. Click Advanced. The Advanced Restore Options screen appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 164
Confidential.
9 - Restoring Backups
6. Specify the Advanced Restore Options.
• Select from a single backup session
• Select from a period of backups
• Filter the selection to show only deleted files. Directories and files deleted on
or before that time will not be available for selection.
Note: During each backup session, the DS-Client scans the directories on the backup source.
Over the course of time, some directories may have been deleted from the source. Using a
filter avoids restoring directories that were intentionally deleted.
• Specify a file overwrite policy for the restore files
7. When you have finished your selections, click OK. The Select directories/files returns
with the new restore selection availability.
8. In the Directories Tree, only those directories that match the specified restore options
will appear.
9. When you are finished selecting making your selections, click Next >. Follow from
“Step 3. Specify the Restore Location” on page 174 to complete the restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 165
Confidential.
9 - Restoring Backups
Restore a Specific File or Files of a Specific Pattern
A backup set may contain so many files, that you cannot easily find the specific file(s) you want to
restore. In this case, you can use the Find Backed Up File function to search through the entire set
for the desired file(s).
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click.
3. Click Restore Now.
4. The Restore Now Wizard opens and the Select directories / files to restore screen
appears.
5. Click Show Files. The screen expands to show the Files List, and the Find File button
activates.
6. Click Find File. The Find Backed Up File screen appears.
7. In the Search For section, enter the name/pattern of the file you would like to find. (ex:
document.doc will search the entire backup set for that specific file; *.exe will search
for all files with the .exe file extension).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 166
Confidential.
9 - Restoring Backups
8. Click Find. All files (including each generation of a file) that meet the search
parameters are displayed (including their original directory path).
9. Highlight the file that you want to select to restore.
10. Click Select. The Select Files to Restore tab reappears with the selected file added to
your restore list. The Files List appears and shows the contents of the directory that
contains the specified file.
11. Repeat as necessary. When you are finished selecting files to restore, click Next >.
12. Follow from “Step 3. Specify the Restore Location” on page 174 to complete the
restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 167
Confidential.
9 - Restoring Backups
Restore only files that differ from those on the backup source
volume
You may wish to restore only the files that are different (or do not exist) from those on the
destination volume. In this case, you can use the Show/Add Modified function to search through
the destination volume's directories, and select only those backed up files that are different from
those scanned on the destination.
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click, then select Restore Now from the menu.
3. The Restore Now Wizard opens.
4. Browse through the Directories Tree and highlight the directory containing the files
you want to restore.
5. Click Show Files. The Files List section appears with the files in the selected directory.
6. Click Show Modified to show any modified files in the selected directory. The DSClient will scan the backup source, and compare the files with the backup log. Files in
the list that do not exist on the source, or are different (changed), will be highlighted.
7. The Show Modified button changes to Add Modified. Click to add all of the modified
files to the restore selection.
8. Repeat as necessary. When you are finished selecting files to restore, click Next >.
9. Follow from “Step 3. Specify the Restore Location” on page 174 to complete the
restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 168
Confidential.
9 - Restoring Backups
Restore an Older Generation of a File
In some cases, you may wish to restore an older version of a backed up file. This is useful if you
discover that files after a certain date became corrupted. The number of On-line generations is
specified in the backup set item's Generation settings.
Note:
1.
2.
3.
4.
5.
If you select an older file generation, the directories/files displayed will change to show
the files backed up with the selected generation. The From and To fields in the Restore
Period (see “Advanced Restore Options” on page 164) changes to the backup time of the
selected backup generation.
Browse the Backup Sets tree and highlight the one you want to restore.
Right-click, then select Restore Now from the menu.
The Restore Now Wizard opens.
Browse through and highlight the directory with the file you want to restore.
Click Show Files. The Files List Appears.
6. Browse through and highlight the file whose previous generation you want to restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 169
Confidential.
9 - Restoring Backups
7. Click File Info. The Backup Generations screen appears.
8. Highlight the desired generation of the file from the list and click Select.
9. The Restore Now Wizard returns to the Select Files and Directories Tab, with your
selection highlighted with a red checkbox.
10. The directory list refreshes automatically to reflect the time of the selected generation.
11. Click Next >. Follow from “Step 3. Specify the Restore Location” on page 174 to
complete the restore.
Pre/Post Restore Activity
The DS-Client can perform an activity before and/or after the restore operation runs. This is the
same feature used in backups. It runs on either the DS-Client computer or on the target restore
computer.
For example: stopping an NT service, restoring the files, restarting the NT service.
Once you set the Pre/Post Execution Options for a backup set, they will be automatically reapplied on each subsequent restore of the set. Use the Skip Pre/Post checkbox to skip the Pre/
Post restore options (if any have been specified).
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click.
3. Click Restore Now.
4. Follow the steps for restoring until you reach the Select restore options screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 170
Confidential.
9 - Restoring Backups
5. Uncheck the Skip Pre/Post box. The Pre/Post Button appears.
6.
7.
8.
9.
Click Pre/Post. The Pre & Post Execution screen appears for this backup set.
Follow the steps specified in the section: “Backup Set Options - Pre/Post” on page 78)
Click OK when you are finished. The Select restore options screen returns.
Click Finish to start the Restore. The specified Pre/Post options will be saved, and reapplied during each subsequent restore of this backup set.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 171
Confidential.
9 - Restoring Backups
Restore File System Backups
File System backup sets are the most common backup type. Since the restore steps and options
of other backup types are similar, an explanation of all restore steps is provided for File System
backups. Abridged explanations are provided for other backup types (relevant differences are
noted).
Restoring a backup set involves the following basic steps:
“Step 1. Select the Backup Set” on page 172
“Step 2. Select the Restore Items” on page 172
“Step 3. Specify the Restore Location” on page 174
“Step 4. Specify the Restore Options” on page 175
Further information is available for special backup sets:
“Restore Windows System State (Registry) and Services Database” on page 176
“Restore NetWare Servers (Files and NDS)” on page 178
“Restore Continuous Data Protection Backup Set” on page 179
Step 1. Select the Backup Set
1.
2.
3.
4.
Browse the Backup Sets tree and highlight the one you want to restore.
Right-click
Click Restore Now.
The Restore Now Wizard opens and the Select directories / files to restore screen
appears.
Step 2. Select the Restore Items
1. For directories, check the box beside each directory you want to restore.
2. In the Directory Tree, check the box beside each directory you wish to select for
restore. You may choose multiple directories.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 172
Confidential.
9 - Restoring Backups
3. For individual files, browse through the directories list tree and highlight the directory
that contains the files you want to restore.
4. Click Show Files. The screen expands to display the File List section.
5. In the Files List section options:
• Selectively choose files for restore.
• View and select by File Info (See “Restore an Older Generation of a File” on
page 169.)
• Show modified, and select modified files: See the Restore Options section “Restore only files that differ from those on the backup source volume” on
page 168
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 173
Confidential.
9 - Restoring Backups
6. To review the selected restore items, click Selection. The Restore Selection screen
shows the selected restore items.
7. When you have made all your restore selections, click Next >.
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Select Restore Location screen.
3. Select the restore location:
• Original location - By default, the restore will be to the original backup
location. This will overwrite any existing files of the same name.
• Alternate location - see “Restore to an Alternate Location” on page 194.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 174
Confidential.
9 - Restoring Backups
Step 4. Specify the Restore Options
1. The Select restore options tab appears.
2. Select all restore options you require.
• Restore Method Description
OPTION
Save
All Files use indirect restore method.
Fast
All Files use direct restore method.
•
Direct restore method: Files are restored on a "write-data-as-received"
basis. Files are overwritten upon receipt of the first byte of data.
• Indirect restore method: Restores files to a temporary location first. If the file
is restored successfully, then the original file is overwritten with the temporary
file. This prevents partially restored files from overwriting an existing file.
3. Click Finish to restore as specified.
4. The Restore Process screen appears, showing the progress of each file as it is
restored.
Note:
The amount of data received may be different from the transmitted amount (in the backup
logs). This happens because the DS-Client sends some additional information during
backup (file name, size, etc.), that is stored on the DS-System. This information is not sent
on restore, and may cause a difference of about 50 bytes per file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 175
Confidential.
9 - Restoring Backups
Restore Windows System State (Registry) and Services Database
Windows backup sets have additional special backup items that can be selected for backup:
• System State (Registry for Windows NT)
• Services Database
One example of when you would want to recover the System State (Registry) would be if a user
account was accidentally deleted from a Windows computer. Since they are generated with a
unique Security ID, the only way to recover the user account is to restore a backed up Registry /
System State containing the deleted user account.
Note:
1.
2.
3.
4.
The Registry/System State contains information that is critical to your computer and
applications. Use caution when using this feature.
Browse the Backup Sets tree and highlight the one you want to restore.
Right-click, then select Restore Now from the menu.
The Restore Now Wizard opens.
Check the box beside the System State and/or Services Database icon in the
Directory Tree.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 176
Confidential.
9 - Restoring Backups
5. Click Next >. The Select Restore Location tab appears.
6. The default settings will automatically restore the System State / Servces Database to
its original source location.
Note: Disable the Use Buffer option for System State restores. This may cause restore problems.
7. Click Finish to start the restore.
8. Once the Restore is complete, you must re-boot the computer before the restored
System State / Servces Database takes effect.
9. If you are satisfied with the restored System State (Registry) after rebooting, you can
manually delete all of your old Registry files.
• The old Windows Registry files will be located in the following directories:
<WinNT>\HKEY_LOCAL_MACHINE\…
<WinNT>\HKEY_ USERS\…
Note:
You will lose any registry changes that have occurred since the backup time of the System
State / Services Database being restored.
For more information, refer to the following DS-Client Knowledge Base Articles:
• “Backing up Windows for Bare Metal Restore (BMR)” on page 401
• “Backup / Restore of Windows 2000” on page 448
• “Bare Metal Restore of Windows 2000 / 2003” on page 489
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 177
Confidential.
9 - Restoring Backups
Restore NetWare Servers (Files and NDS)
Restoring NetWare Server files is essentially the same as other restores. The following describes
some Server-specific options and notes.
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click, then select Restore Now from the menu.
3. The Restore Wizard opens on the Select Directories/Files tab.
4. Select the restore item(s) from the Directory Tree.
5. Click Next >. The Select Restore Location tab appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 178
Confidential.
9 - Restoring Backups
6. Click Next >. The Select Restore Options tab appears.
7. Note the following options:
Trustees
If you are restoring to an existing directory, the DS-Client will append the trustee
assignments to those of the existing directory. If your intention is to CLEAR the
existing permissions, you MUST DELETE the existing directory, then restore.
If restoring NDS
In the Restore NDS Object(s) from field, you may specify the object (container or
leaf) which you want to restore. The object name should be typeless and fully qualified (distinguished) from the Root. (The default is to restore the whole NDS).
8. Click Finish to start the restore. Once the files are restored, it may take a few minutes
to load the NDS (if it was restored).
Restore Continuous Data Protection Backup Set
Restoring a CDP backup set files is essentially the same as Regular File System backup set
restores. The only difference occurs if you need to select from a range of backups. Since files in a
CDP backup set have been backed up individually, as changes were detected, you can only
distinguish previous versions by the time they were backed up.
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click, then select Restore Now from the menu.
3. The Restore Wizard opens on the Select Directories/Files tab.
• To select data from a specific period, click Advanced.
• In the Advanced Restore Options screen, click Selective data (from a certain
period).
• In the Restore Period section, click [>>] beside the From and To fields to open
the Select backup time screen. Click OK.
4. Select the restore item(s) from the Directory Tree.
5. Continue from “Step 2. Select the Restore Items” on page 172 for File System Backup
Sets.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 179
Confidential.
9 - Restoring Backups
Restore MS SQL Server Backups
Only users with sufficient permissions may restore SQL Servers. Steps which are the same, or
very similar to File System restores are condensed.
Step 1. Select the Backup Set
1. Highlight the MS SQL Server backup set you want to restore.
2. Restore Menu > Restore Now. The Restore Now Wizard appears on the Select
Backup Set tab.
3. Browse through the tree of backup sets and highlight the one that contains the backup
items you want to restore.
4. Click Next >.
Step 2. Select the Database(s)
1. The Select Databases to restore tab appears. Browse through the tree and highlight
the database(s) you want.
2. The total size of the file selection and the total number of files selected appear in the
Selected for Restore section.
3. To view and/or select individual database tables, highlight a database and click Show
Files.
4. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 180
Confidential.
9 - Restoring Backups
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Specify Database Restore Location tab.
2. Select the restore location:
• Original location - By default, the restore will be to the original backup
location. This will overwrite any existing files of the same name.
• Alternate location - see “MS SQL Server Backup Sets (Alternate Location
Restore)” on page 200.
3. Select the Restore Options.
4. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Specify Database Restore Options tab.
Select restore options.
Click Finish to complete specifications and begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
Note:
For more information on Restoring MS SQL Server backups, please review the
Knowledge Base articles: “Backup / Restore of Microsoft SQL Server” on page 429 and
“Restoring the MS SQL Database Server MASTER Database (MS SQL 7.0 and up)” on
page 512.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 181
Confidential.
9 - Restoring Backups
Restore MS Exchange Server Backups
Only users with the proper authority may restore MS Exchange backups. The following headings
show the various steps. Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Database(s)
1. Browse through the tree and highlight the database(s) you want.
2. Click Add. The highlighted database will be tagged for restore.
3. The total size of the file selection, and the total number of files selected appear in the
Selected for Restore section.
4. Repeat 1-2 for as many databases as required.
5. Click Next >.
• DS-Client will try to detect if a Recovery Storage Group (RSG) exists on
selected Exchange server. An RSG is a specially defined location on an MS
Exchange 2003 server where any recovered data is saved.
Note: This process may take a while, depending on your network environment.
• If an RSG exists, the selected database will be restored to that location. A
popup message will inform you of this.
Note: The target Exchange server’s RSG must use the exact name "Recovery Storage Group".
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 182
Confidential.
9 - Restoring Backups
Step 3. Specify the Restore Location and Options
1. The Restore Now Wizard switches to its Select database restore location tab. If there
is no Recovery Storage Group, the default is to restore the Exchange databases to
their original backup source location(s).
2. Select the restore location:
• Original location - By default, the restore will be to the original backup
location. This will overwrite any existing files of the same name.
• Alternate location - see “MS Exchange Server Backup Sets (Alternate
Location Restore)” on page 202.
3. In the Restore Options section, check all options that you require.
4. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Select restore options tab.
Select restore options.
Click Finish to complete specifications and begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
Note:
If you restore only the DS database, you must run ISINTEG.EXE with the -patch option,
before starting the information store (MS Exchange 5.5).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 183
Confidential.
9 - Restoring Backups
Restore Permissions Only Backups
Only users with the proper authority may restore Permissions Only backups. The following
headings show the various steps. Steps that are similar to File System restores have been
condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Restore Items
1. Browse through the tree and highlight the permission(s) you want.
2. For each path, permissions are backed up as a single file named “dump.acl”.
3. Click Next >.
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Specify Restore Location tab.
2. Select the restore location.
3. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Specify Restore Options tab.
Select restore options
Click Finish to begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 184
Confidential.
9 - Restoring Backups
Restore Oracle Server Backups
The steps are the same as for MS SQL Server Backups. However, there are requirements and
limitations.
You must refer to the DS-Client Knowledge Base Article: “Backup / Restore of Oracle Database
Servers” on page 433.
Specifically, look at the sections:
• Backup Requirements (Oracle Server)
• Oracle Database Backup Sets (Alternate Location Restore).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 185
Confidential.
9 - Restoring Backups
Restore MySQL Backups
Only users with the proper authority may restore MySQL backups. The following headings show
the various steps. Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Database(s)
1. Browse through the tree and highlight the database(s) you want.
2. The total size of the file selection, and the total number of files selected appear in the
Selected for Restore section.
3. Repeat 1-2 for as many databases as required.
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Specify Restore Location tab.
2. Select the restore location.
3. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Specify Restore Options tab.
Select restore options.
Click Finish to begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 186
Confidential.
9 - Restoring Backups
Restore DB2 Backups
There are some requirements that must be met in order to perform restores of DB2 backups.
• You must refer to the DS-Client Knowledge Base Article: DB2 Database
Servers (See “Backup / Restore of DB2 Database Servers” on page 443.).
Only users with the proper authority may restore DB2 backups. The following headings show the
various steps. Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Database(s)
1. Browse through the tree and highlight the database(s) you want.
2. The total size of the file selection, and the total number of files selected appear in the
Selected for Restore section.
3. Repeat 1-2 for as many databases as required.
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Specify Restore Location tab.
2. Select the restore location.
3. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Specify Restore Options tab.
Select restore options.
Click Finish to begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 187
Confidential.
9 - Restoring Backups
Restore PostgreSQL Backups
Only users with the proper authority may restore PostgreSQL backups. The following headings
show the various steps. Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Database(s)
1. Browse through the tree and highlight the database(s) you want.
2. The total size of the file selection, and the total number of files selected appear in the
Selected for Restore section.
3. Repeat 1-2 for as many databases as required.
Step 3. Specify the Restore Location
1. The Restore Now Wizard switches to its Specify Restore Location tab.
2. Select the restore location.
3. Click Next >.
Step 4. Specify the Restore Options
1.
2.
3.
4.
The Restore Now Wizard switches to its Specify Restore Options tab.
Select restore options.
Click Finish to begin the restore.
The Restore Process screen appears, showing the progress of each file as it is
restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 188
Confidential.
9 - Restoring Backups
Restore E-Mail Backups (via DS-Recovery Tools)
NOTE: From v.7.0, the DS-MLR Service is bundled with the DS-Recovery Tools installation.
[Windows DS-Client]
Steps that are similar to File System restores have been condensed.
• See “DS-MLR Installation & Setup” on page 328.
• See “Backup / Restore of E-Mails (using DS-MLR)” on page 452.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Restore Items
1. Browse through the tree and check the item(s) you want.
2. To filter for specific E-Mails, click Filter.
• In the Select Filter screen, specify the filter conditions. You can make
complex filters with the AND, OR, and BRACKETS. When finished, click OK.
• The Restore Wizard will only display those E-Mails that match the filter
description.
• Select the item(s) you want.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 189
Confidential.
9 - Restoring Backups
Step 3. Specify the Restore Location
1. By default, data is restored to the original backup source location(s).
2. Select the restore location:
• Original location
• Alternate location - You must select the alternate server and the dump
location, then map the Source Mailbox to the Destination Mailbox.
3. Click Next >.
Step 4. Specify the Restore Options
1. Select the restore options you want.
2. Click Finish to begin the restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 190
Confidential.
9 - Restoring Backups
Restore System i Server Backups
Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Restore Items
1. Browse through the tree and check the item(s) you want.
• To restore individual Backup Objects:
a)Click Show Files > Highlight an item in the Files List
b)Click File Info > Highlight the generation to restore
c)Click Objects
d)Use the "Select"/"Deselect" buttons to selectively restore only the objects you need.
Unselecting objects has no influence on the restore speed if the objects were backed
up without the "Individual obj." option.
2. Repeat 1 for as many items as required.
3. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 191
Confidential.
9 - Restoring Backups
Step 3. Specify the Restore Location
1. By default, data is restored to the original backup source location(s).
2. Select the restore location:
• Original location
• Alternate location - You must select the alternate server and the dump
location, then map the Source Library to the Destination Library.
3. Click Next >.
Step 4. Specify the Restore Options
1. Select the restore options you want.
2. Click Finish to begin the restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 192
Confidential.
9 - Restoring Backups
Restore MS SharePoint Backups (via DS-Recovery
Tools)
Steps that are similar to File System restores have been condensed.
Step 1. Select the Backup Set
1. Browse the Backup Sets tree and highlight the one you want to restore.
2. Right-click. Click Restore Now.
Step 2. Select the Restore Items
1. Browse through the tree and check the item(s) you want.
2. Click Next >.
Step 3. Specify the Restore Location
1. By default, data is restored to the original backup source location(s).
2. Select the restore location:
• Original location
• Alternate location - You must select the alternate server and the dump
location, then map the Source SharePoint Server to the Destination
SharePoint Server.
3. Click Next >.
Step 4. Specify the Restore Options
1. Select the restore options you want.
2. Click Finish to begin the restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 193
Confidential.
9 - Restoring Backups
Restore to an Alternate Location
ASIGRA Televaulting allows you to restore your backups to alternate (different) locations, as
required. An alternate location can be another disk drive on your computer, another share on a
different computer, or another server on a different network (with some restrictions).
To restore to an alternate location, you must specify the new location and the path on the new
location. Since each backup type has particular requirements and specifications, instructions on
how to restore to an alternate location are listed below separately. Similar procedures are
condensed.
Follow these steps to restore to an alternate location:
Step 1.Select the backup set items for restore.
Step 2.Choose the destination computer.
Step 3.Select the destination share.
Step 4.Specify the path on the destination share.
Step 1. Select the backup set items for restore.
1. Follow the steps necessary to specify the restore items until the Restore Now Wizard
switches to its Select Restore Location tab.
2. Check the Alternate Location radio button. This activates the entire restore to
alternate location section.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 194
Confidential.
9 - Restoring Backups
Step 2. Choose the destination computer (optional)
Skip to “Step 3. Select the destination share” on page 196 if you wish to restore to an alternate
location on the same computer. To select a different computer:
1. Click >> beside the Location field. The Select Alternate Server screen appears,
allowing you to browse the available servers on the network (if any).
2. Browse through and highlight the computer that you want.
3. Click Select. If you are using Domain Security, your current login credentials are used
to access the destination computer. Otherwise:
• If the Ask for Network Credentials box is checked, you are prompted for
credentials to the destination computer. The Enter Network Credentials
screen appears.
• Enter the User Name and password and click OK.
4. The Restore Now Wizard reappears. The Location field contains the alternate
computer information.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 195
Confidential.
9 - Restoring Backups
Step 3. Select the destination share
You must select a share on the alternate computer.
1. Double click in the Destination field. A drop down list box will appear with all of the
available shares on the alternate node.
2. Select one of the shares from the Destination List. Depending on your DS-Client
computer, the Share Path cell may show the path of the destination directory on the
selected computer.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 196
Confidential.
9 - Restoring Backups
•
•
Share Path information appears automatically if you are restoring the Registry
or locked files with a DS-Client running on Windows NT.
A DS-Client running on Windows 98 is unable to retrieve the share path
information of the share when restoring to an alternate location. Therefore,
you must specify it manually. (The syntax is the same as with DOS; e.g.
[drive:]\[path]).
Step 4. Specify the path on the destination share
By default, files will be restored to the destination computer's share path (indicated in the Share
Path cell). To change the destination directory, select a directory from the Restore To cell (or
simply type in a restore directory).
1. Double click in the Restore To cell beside the specified destination.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 197
Confidential.
9 - Restoring Backups
2. The Select Directory screen appears. Browse through and highlight the directory
where you wish to restore the backup.
3. Click Select. The Restore Now Wizard reappears with the directory information in the
Path cell.
4. Truncate: If the selected restore item(s) contain a common restore path, you may
shorten that portion of the restore path by increasing the truncate level in the number
field. Truncated portions of the restore path will disappear.
5. Click in the number field beside the Truncate field. The number represents the
number of subdirectories in the current restore path.
6. Click the upward arrow to increase the truncation, and to reduce the number of
subdirectories from the rightmost directory.
Note: When restoring to an alternate location, if the entire path is truncated, the alternate
location directory will inherit the security of the truncated parent directory.
7. Click Next > The select restore options screen appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 198
Confidential.
9 - Restoring Backups
8. Click Finish to start the restore. The Restore Process screen appears, showing the
progress of each file as it is restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 199
Confidential.
9 - Restoring Backups
MS SQL Server Backup Sets (Alternate Location Restore)
Restoring to an alternate location involves specifying the alternate server's location and specifying
the path on the new location.
1. Follow the steps necessary to specify the restore items until you reach the Restore
Now Wizard's Select Restore Location tab.
2. Check the Alternate Location radio button. This activates the >> buttons and alternate
location section.
• To restore to a different directory on the same server, skip to step 6.
• To restore to a different server on the network, follow from step 3.
3. Click >> beside the Location field. The Alternate Database Server Wizard screen
appears, allowing you to browse the available servers on the network.
4. Browse through and highlight the server where you want to restore the backed up
database.
5. Click Select:
• If the Ask for Network Credentials box is checked, the Enter Network
Credentials screen appears. See “Ask for Network Credentials:” on page 80
• If the Ask for Database Credentials box is checked, the Enter Database
Credentials screen appears. See “Ask for database credentials” on page 94
6. If all your credentials are valid, the Select Restore Location screen reappears with the
Alternate Server in the Location field.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 200
Confidential.
9 - Restoring Backups
7. Click >> beside the Dump field. This brings up the Select Share & Path for the
Database Dump screen.
8. Browse through and choose the computer and path for the database dump. Click
Select.
Note: You may select the DS-Client Buffer as an option for the database dump, if none of your
shares has sufficient capacity. This will save the dump to the local storage on the DSClient computer. Similarly, you may choose the DS-Client Pipe option to bypass a dump
file altogether.
9. When restoring to a different location, you must re-specify the Destination Database
for each item. Do so by double clicking on the Destination cell adjacent to the source
name. The spreadsheet table will contain the list of databases (and/or tables)
specified for restore. Each line has four columns, which initially contain default restore
information:
Source
this cell shows the title of the database (or database\table name in the case
of tables).
Destination Database
this cell shows the destination database where the backup set will be
restored.
11. Follow the same steps if you are restoring individual database tables.
12. In the Restore Option Section you may choose from the following:
Restore only the dump
file(s)
Restores the dump files, but does not load them as databases (this
option is not available for DS-Client Pipe).
Restore Path
When restoring to an alternate location, you can specify the path for
the log and data files separately. Opens the Select Restore Path
screen.
13. Click Next >. The Select Restore Options Screen appears.
14. Click Finish when you are ready to start the restore. The Restore Process screen
appears, showing the progress of each file as it is restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 201
Confidential.
9 - Restoring Backups
MS Exchange Server Backup Sets (Alternate Location Restore)
Note:
Only MS Exchange 2000 backups may be restored to an alternate location.
1. Follow the steps necessary to specify the restore items until the Restore Now Wizard
switches to its Select Restore Location tab.
2. Select the Alternate Location radio button. This activates the >> button beside the
Location field.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 202
Confidential.
9 - Restoring Backups
3. Click >> beside the Location field. The Alternate Exchange Server Wizard screen
appears, allowing you to browse the available servers on the network.
4. Browse through and highlight the server where you want to restore the database.
Click Select.
• If the Ask for Network Credentials checkbox is marked, the Enter Network
Credentials screen appears.
• Enter the user name and password to connect to the server and Click OK.
5. The Restore Now Wizard returns.
6. Click Finish to start the restore. The Restore Process screen appears, showing the
progress of each file as it is restored.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 203
Confidential.
9 - Restoring Backups
Oracle Database Backup Sets (Alternate Location Restore)
Oracle requires certain conditions for successful restore. See “Restore Oracle Server Backups” on
page 185.
In addition, the following apply for Alternate Restore:
1. The backup must be a full Oracle database backup (with Control File). You must also
have a backup of the password file (this will be in a File System backup set).
2. The target restore computer must have an Oracle database service Instance of the
same name.
3. The target restore computer must have the same tablespace path as the original
backup (this can be created when setting up the database).
4. Restore the (File System) backup of the password file to the alternate computer. This
is a separate backup set of the password file from the original backup computer.
5. Restore the full Oracle database backup.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 204
Confidential.
9 - Restoring Backups
Restore from Disc / Tape
Once a Disc/Tape has been delivered, it can be restored at your convenience from Restore Menu
> Disc/Tape > Restore from.
• You must select the path (computer and directory) where the Disc/Tape data
can be read.
• Once the Restore from Disc/Tape Wizard appears, you can continue like a
regular restore (select the items to be restored, the restore location, and the
restore options).
For information on obtaining a Disc/Tape, see “Disc/Tape” on page 213 of Section 10 - Premium
Backup and Recovery Services.
Restore from BLM
Once you have a BLM Restorable Image it can be restored at your convenience from Restore
Menu > BLM Restore.
• You must select the path (computer and directory) where the BLM Restorable
Image is located.
• Once the BLM Restore Wizard appears, you can continue like a regular
restore (select the items to be restored, the restore location, and the restore
options).
For information, see “Backup Lifecycle Management (BLM)” on page 219 of Section 10 - Premium
Backup and Recovery Services.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 205
Confidential.
9 - Restoring Backups
Validation of On-line Storage
This process can be scheduled or performed on demand. It allows a DS-Client Administrator to
validate the on-line data down to the Digital Signature applied to each file at backup time.
• Scheduled Validation: See “Add a Detail to a Schedule” on page 60 in section
3 - Schedules and Retention Rules.
• On Demand Validation: See “Perform Validation on Demand” on page 206.
Perform Validation on Demand
1. Browse the Backup Sets tree and highlight the one you want to validate.
2. Right-click > Validation (or Restore Menu > Validation).
3. The Validation Wizard appears on the Set Validation Settings screen.
4. Enter the DS-Client Encryption Key(s).
5. Select the type of Validation:
• All: All generations of all data in this backup set will be validated.
• Selective: Allows you to specify the file(s) to validate.
6. Click Next >.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 206
Confidential.
9 - Restoring Backups
7. The Validation Wizard switches to the Select directories/files for validation screen.
This screen is the same as the one used in the Restore Wizard.
8. Select the items you want to validate (everything will be selected if you specified All in
the previous screen).
9. Click Finish to start the Validation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 207
Confidential.
10 - Premium Backup and Recovery Services
10 - Premium Backup and
Recovery Services
This section provides information on the premium services that may be offered by your ASIGRA
Televaulting Service Provider.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 208
Confidential.
10 - Premium Backup and Recovery Services
Initial Backup
The DS-Client service is designed to perform automated backups to an off-site location. This
approach requires an adequate communication link between the DS-Client and the DS-System
that allows backup of any changed data in the given time window.
After the first (initial) backup, the DS-Client service backs up only the incremental changes.
However, there may be a problem performing that first backup of a large baseline amount of data.
If the communication link between the DS-Client and the DS-System cannot handle this baseline
backup in a reasonable amount of time (e.g. a few days), then an Initial Backup can be performed.
• Use the LAN Storage Discovery Tool (See “LAN Storage Discovery Tool” on
page 243.) to analyze your LAN.
• Use Statistical Backup Sets (See “Statistical Backups (DS-Statistics)” on
page 129.) to calculate the amount of data to transmit. Divide this number by
your communications bandwitdh to estimate how long this baseline backup
will take.
The Initial Backup feature allows you to backup to local buffer location(s) that are either directly
connected to the DS-Client, or visible to it on the LAN. Then, you ship that media (e.g. disks) to
your Service Provider. Your Service Provider will import the Initial Backup data from the media
(either attached to the DS-System, or via a LAN connection). Once it is imported to the DSSystem, you can continue protecting your data with subsequent scheduled and on-demand
backups.
The following steps describe the Initial Backup Service:
1. Your DS-Client must be registered with the DS-System.
2. Configure the Initial Backup buffer path.
• See “Configure Initial Backup Path (Buffer)” on page 210.
3. Create the Initial Backup Set(s).
• See “Create Initial Backup Set” on page 211.
4. Perform a Backup of all Initial Backup Sets to the Initial Backup buffer.
• See “Perform a Demand Backup” on page 159.
5. Ship the Initial Backup buffer media to your Service Provider.
6. Monitor the status of Initial Backup Sets. Once your Service Provider has imported a
backup set, it will disappear from the Initial Backup Status screen’s list of Initial
Backup Sets.
• See “Monitor Initial Backup Sets” on page 212.
More information can be found in the Knowledge Base article: “Best Practices: Initial Backup” on
page 400.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 209
Confidential.
10 - Premium Backup and Recovery Services
Configure Initial Backup Path (Buffer)
You can configure as many Initial Backup Paths as you need. These are local disks or UNC path
locations (Windows DS-Client) that can be shipped to your Service Provider.
1. Initial Backup Menu > Path. The Set Initial Backup Path screen appears.
2. Click Add.
•
•
•
Specify the Computer and Directory for the Initial Backup path.
Use a descriptive name for paths (to make it easier for your Service Provider
to identify the DS-Client associated with the data).
Click OK to save the path.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 210
Confidential.
10 - Premium Backup and Recovery Services
Create Initial Backup Set
You can create as many Initial Backup Sets as required.
1. From the New Backup Set Wizard: Sets Menu > New Backup Set... > Specify
backup set options screen
From the Backup Set Tree: Right-click the backup set > Properties > Options Tab
• Check the “Initial Backup” box.
2. The Initial Backup Settings screen appears.
3. Highlight the Initial Backup path you want to use for this backup set. Click OK.
• Assign an Initial Backup Path to backup sets from only one DS-Client. (Do not
assign the same path to backup sets from two or more DS-Clients.)
4. Finish the New Backup Set Wizard, or click Apply if you are editing from the backup
set’s Properties Tab.
5. Perform a Demand Backup of all Initial Backup Sets to the Initial Backup buffer.
• See “Perform a Demand Backup” on page 159.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 211
Confidential.
10 - Premium Backup and Recovery Services
Monitor Initial Backup Sets
You need to monitor Initial Backup Sets, until your Service Provider has imported the data to the
DS-System. Scheduled and on demand backups of Initial Backup sets will fail until the data is
imported to the DS-System.
1. Initial Backup Menu > Status. The Initial Backup Status screen appears.
2. Before sending an Initial Backup buffer (the physical media) to your Service Provider,
make sure all the backup sets have “Completed” for their Set Status.
3. Once an Initial Backup Set has been imported to the DS-System, it will disappear from
the Initial Backup Status screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 212
Confidential.
10 - Premium Backup and Recovery Services
Disc/Tape
Disc/Tape is a tool that allows you to copy backed up files from the DS-System to any media
supported by your Service Provider (e.g. CD/DVD, Tape, Hard Disk Drive, or USB). This allows
you to have a copy of backed up data on hand (at your location). Data on the Disc/Tape media
must be restored through the DS-Client.
The steps are as follows:
• “Step 1. Request Disc/Tape” on page 213
• “Step 2: View Orders for Disc/Tape” on page 215
• “Step 3. Restore from Disc/Tape” on page 216
Step 1. Request Disc/Tape
1. Highlight the backup set you want from the Backup Sets Tree and right-click.
2. Click Request Disc/Tape. The Request Disc/Tape Wizard appears.
3. Select the Media and Option for the Disc / Tape request.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 213
Confidential.
10 - Premium Backup and Recovery Services
4. Click Next >. The Select directories/files screen appears.
•
If you chose the Snapshot option, the entire backup set will be selected and
you will not be able to change any settings.
• If you chose the Selective option, you must choose the directories/files for
restore. Do this in the same manner as for regular restores.
5. Once you are satisfied with the selection, click Finish.
6. The Disc/Tape Mailing Information screen appears.
7. Enter the pertinent mailing information and click OK to proceed.
Note:
This has the same effect as signing a Purchase Order Contract.
8. The DS-System will then mirror all of the selected files (from the Request Process) to
a buffer directory at the DS-System (i.e. your Service Provider's site). Your service
provider will then make the Disc/Tape order from this buffer.
Note:
This backup set will not be accessible (for backup / restore) until your service provider
makes the Disc/Tape.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 214
Confidential.
10 - Premium Backup and Recovery Services
Step 2: View Orders for Disc/Tape
You can view the progress of your order. Once the DS-System has resolved the requested files in
its database, the order status will be changed to 'Confirm Purchase'. However, the backup set's
files must not be altered (i.e. by subsequent backups). Therefore, the backup set is locked until
your Service Provider can replicate the requested restore files (i.e. when the Status is 'Finished').
1. Restore > Disc/Tape > Orders. The Orders for Disc / Tape screen appears.
2. You can review the columns to see the price, number of media (e.g. # of CDs), etc.
3. Highlight the order you want (order status must be 'Confirm Purchase').
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 215
Confidential.
10 - Premium Backup and Recovery Services
Step 3. Restore from Disc/Tape
Once a Disc / Tape has been delivered, you may restore from it at your convenience.
1. Restore menu > Disc/Tape > Restore from. The Select Disc/Tape restore path screen
appears.
2. Click >> to select the computer.
• See “Step 2. Select the Computer” on page 80
3. The computer field is filled with your selection.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 216
Confidential.
10 - Premium Backup and Recovery Services
4. Click >> to select the directory.
•
Select the directory containing the disc / tape catalog.
Shares and Directories Tree
Shows the available shares and directories.
Select
Click to select the highlighted directory.
5. Your selection appears in the Directory field.
6. Click OK. The Restore from Disc/Tape Wizard – Select directories/files to restore tab
appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 217
Confidential.
10 - Premium Backup and Recovery Services
7. Click Next >. The Select restore location tab appears.
8. Click Next >. The Select restore options tab appears. Specify any restore options.
9. Click Finish to start restoring.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 218
Confidential.
10 - Premium Backup and Recovery Services
Backup Lifecycle Management (BLM)
This tool must be enabled by your Service Provider from the DS-System.
The Backup Lifecycle Management (BLM) Module is a solution that works with DS-Client, DSSystem, and a BLM Archiver to extend the options for your backed up data. In addition to archiving
data to less costly media, this Module gives you additional options for copying, removing, and
destroying data.
Data stored in the BLM Archiver is billed on a different scale than the online (DS-System) data.
BLM Requests can be performed as follows:
1. On schedule from DS-Client side:
• “Configure BLM (per backup set)” on page 220
• “Create BLM Schedule” on page 221
• “Schedule Backup Set for BLM” on page 221
2. On demand from DS-Client side:
• “Perform BLM Request on Demand” on page 222
• “Tape Conversion to BLM” on page 224
3. On demand from DS-System (Service Provider) side:
• Contact your Service Provider.
BLM and Retention:
1. If the BLM Module is enabled for this DS-Client, an additional feature becomes
available for Retention: Time-Push.
• See “About Retention Rules” on page 67.
Restoring from BLM:
1. Data that is stored on the BLM Archiver can only be restored from a Restorable
Image:
• “Restore from BLM” on page 223
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 219
Confidential.
10 - Premium Backup and Recovery Services
Configure BLM (per backup set)
Backup sets are configured to save a specific number of generations. Once a backup item reaches
this number of generations, the oldest will be overwritten with each new generation backed up.
When you configure a backup set for BLM, the DS-Client will instruct DS-System to send a copy of
the oldest generation (that is about to be overwritten) to the BLM Archiver.
1. In the Backup Sets Tree, right-click the backup schedule you want.
2. Choose Properties > Options Tab. Check the “BLM (Infinite Generations)” option.
3. Click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 220
Confidential.
10 - Premium Backup and Recovery Services
Create BLM Schedule
You can create a new BLM schedule (or edit an existing Schedule by adding a detail to copy files
to BLM).
Use the Perform BLM detail with the Enforce Retention detail to set the policies for handling
backed up data.
1. In the Backup Schedules Tree, click the backup schedule you want.
2. Schedule Menu > Edit Schedule.
3. In the Details section, choose <new> to create a new detail.
4. Check Perform BLM.
5. Click [>>] beside Perform BLM. The Select BLM Options screen appears.
• Latest generations:
• All generations:
• Use new archive package:
6. Click OK.
7. Click Save.
Schedule Backup Set for BLM
Assign the BLM Schedule to the backup set(s) you want.
The backup set(s) do not have to be configured with the BLM (Infinite Generations) option.
1. In the Backup Sets Tree, right click the backup set you want.
2. Select Properties. The Backup Set Properties screen appears.
3. Click Schedule. The Schedule Tab appears.
4. Select Schedule and click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 221
Confidential.
10 - Premium Backup and Recovery Services
Perform BLM Request on Demand
BLM Requests can be performed as follows:
• On schedule from DS-Client side
• On demand from DS-Client side
• On demand from DS-System (Service Provider) side
You may perform an on Demand BLM Request for any existing backup set with backed up data
on-line. The backup set does not have to be configured with the BLM (Infinite Generations) option.
1. In the Backup Sets tree, highlight the backup set you want.
2. Backup Menu > BLM Request. The Request BLM Wizard appears. Select the backup
items you want to copy to the BLM Archive.
3. Click Next. The Select BLM Options screen appears.
• Select the BLM options.
4. Click Finish. A Process Window opens to show the progress of the BLM Request.
Note: An alternative is to contact your Service Provider and have them perform the BLM
Request from the DS-System side on Demand.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 222
Confidential.
10 - Premium Backup and Recovery Services
Restore from BLM
Once data has been sent to the BLM Archive, you may request to have any generation in the
archive written to media and shipped to you.
[Ask your Service Provider to generate a restorable image, or use the Web Portal if it is available.]
Data on BLM Media may be restored, as long as the media can be viewed as a directory on the
DS-Client network. Alternatively, you can copy the data from the BLM Media to a directory on the
network.
1. Restore Menu > BLM Restore. The Select BLM Restore Path screen appears.
2. Click [>>] and select the computer.
3. Click [>>] and select the directory.
4. Click OK. The Restore from BLM Wizard appears.
5. The next steps are the same as for a regular restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 223
Confidential.
10 - Premium Backup and Recovery Services
Tape Conversion to BLM
[Windows DS-Client]
DS-Client can convert data from tape backups into BLM format Archive Packages (See “Backup
Lifecycle Management (BLM)” on page 219.). These Archive Packages can then be sent to your
Service Provider to import to the BLM Archiver (for off-site storage).
The following are requirements to convert from tape to BLM:
• Tape Drive must be directly connected to the DS-Client computer.
• Tape Format must be MTF (Microsoft Tape Format).
The following limitations exist for data you convert from tape:
• Special Operating System backups that were created using the tape backup
utility (e.g. System State, MS Exchange) are not restorable.
Conversion Wizard - Tape to BLM
1. Load the tape(s) you want to convert.
2. Initial Backup Menu > Tape Conversion to BLM. The Tape Conversion Wizard
appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 224
Confidential.
10 - Premium Backup and Recovery Services
3. When this screen opens, the Tape Converter automatically counts how many physical
tapes are in the drives. At first, all tapes appear under “Unidentified Tapes”. This is
because identifying a tape requires more intense use of the tape drive (it must be
loaded and read).
•
Refresh: Updates the screen with the latest information that DS-Client has
from the Tape Library’s memory.
• Identify Tape: Scans the highlighted tape for information about the backup
data on the tape.
Note: If the DS-Client service is restarted, all tapes will be reset to “Unidentified Tapes”.
4. If you need to identify a tape, highlight it and click “Identify Tape”.
• A new activity will start (a separate Process Monitor will appear). When this
activity has finished, you must click Refresh to update the list.
IMPORTANT NOTE ABOUT CHANGING TAPES
The DS-Client Tape Converter depends on Windows to interface with the Tape Drives. Therefore,
you must change tapes in a way that Windows will always be aware of your changes.
To change a tape:
• Open the Tape Drive door, and take a tape out from its slot.
• Close the Tape Drive door. Let Windows perform its inventory, and the
removed tape will be marked as off-line.
• Open the Tape Drive door again, and put the new tape in the empty slot.
• Close the Tape Drive door. Windows will identify the new tape.
• After Windows finishes its identification of the Tape, you must click Refresh in
the Tape Conversion Wizard to update the DS-Client’s list from the Tape
Library’s memory.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 225
Confidential.
10 - Premium Backup and Recovery Services
5. Once a Tape has been identified, all the backup set(s) on that tape appear in the list.
.
Note: You can only convert from a tape that has been identified.
6. Highlight the level that you want to convert:
• Computer Name: converts all backup sets listed for that computer.
• Backup Set: converts the highlighted backup set.
7. Click Next. The Tape Conversion Wizard prompts you to select the backup data to
convert.
•
Select the data to convert. By default, the entire backup set is selected.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 226
Confidential.
10 - Premium Backup and Recovery Services
8. Click Next. The Tape Conversion Wizard prompts you to specify the conversion
options.
•
•
Before Conversion: The current implementation does not require any input.
If the tape is in MTF, DS-Client can convert the data without entering any
password(s).
After Conversion: You must specify the location where DS-Client will save
the Archive Package. The BLM Session and Backup Set Name are labels that
will help you find the Archive Package after it is imported to the BLM Archiver.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 227
Confidential.
10 - Premium Backup and Recovery Services
9. Click Next. The Tape Conversion Wizard displays a summary of the tape data you are
about to convert.
10. Click Finish. A Tape Conversion Process Window opens. When the conversion is
finished, the data in the Target Path can be shipped to your Service Provider for
import to the BLM Archiver.
• After the data has been imported to the BLM Archiver, you can request
Restorable Images. (See “Restore from BLM” on page 223.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 228
Confidential.
10 - Premium Backup and Recovery Services
Service Level Agreement – SLA Availability Tool
This tool must be enabled by your Service Provider from the DS-System.
You must request this tool from your Service Provider, and it should be a part of your service
agreement. It allows you to track the quality of the ASIGRA Televaulting service (DS-System
downtime, delivery times, errors, etc.).
The Backup Set Options will have an added selection for Backup Set Priority. See: “Step 6.
Specify Backup Set Options” on page 85 in the New Backup Sets section.
If the tool is enabled, this DS-Client can be registered with a DS-Client SLA Monitor service
(separate application). That application can monitor the status of several DS-Clients.
View SLA Credit Scale
If the SLA Availability Tool has been enabled by your Service Provider (from the DS-System), you
can view the Credit Scale (this should be part of your service agreement).
1. Setup Menu > View SLA Credit Scale. The View SLA Credit Scale screen appears.
2. Click Close to exit.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 229
Confidential.
10 - Premium Backup and Recovery Services
Local Storage Tool
This tool must be enabled by your Service Provider from the DS-System.
You must request this tool from your Service Provider, and it should be a part of your service
agreement. It allows you to save a copy of the latest snapshot of a backup set on a local storage
location (as well as on-line, off-site at the DS-System).
The Set Properties Options Tab will contain an additional checkbox to Save on Local Storage.
Local Storage behaves differently for backup sets depending on if they are assigned to a
Retention Rule:
• Without Retention: Local Storage keeps a copy of the latest generation of
the backup set files.
• With Retention: the same number of generations are backed up to Local
Storage as are on DS-System. Make sure there is enough space in the local
storage buffer, and perform the “Enforce Retention” process regularly.
Note:
In both cases, when a new backup session occurs and an existing generation of a file is
replaced by a new one, the deletion of the old generation will take place after the new one
was successfully saved on the local storage. This means there must be enough free space
on the Local Storage to accommodate both generations.
Set the Local Storage Path
1. Setup menu > Configuration. The DS-Client Configuration screen appears.
2. Click Parameters.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 230
Confidential.
10 - Premium Backup and Recovery Services
3. In the Local Storage Path field, enter a path where snapshots of the latest backup of
each selected Backup Set will be stored. When a path is entered, the Save on Local
Storage checkbox appears in the Options Tab of the Backup Set Properties screen.
4. Click OK to save the changes to this tab.
Apply the Local Storage Option (per Backup Set)
1.
2.
3.
4.
Browse the Backup Set Tree and highlight the backup set you want.
Right-click.
Click Properties. The Backup Set Properties screen appears on the Items Tab.
Click Options.
5. Click Save on Local Storage. The last backed up version of each file in this backup set
will be saved to the Local Storage location.
6. Click OK to save any modifications.
Restore from Local Storage Path
Backup sets flagged with Save on Local Storage will be restored from the local storage path. If any
files are missing, then the DS-Client will retrieve them from on-line storage on the DS-System.
1. Follow from “Step 1. Select the Backup Set” on page 172 in section 9 - Restoring
Backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 231
Confidential.
11 - Logs and System Tools
11 - Logs and System Tools
This section provides information on how to use the system logs and other system administration
tools.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 232
Confidential.
11 - Logs and System Tools
Activity Log
The Activity Log is a tool that is useful for tracking the activities on the DS-Client. You will only be
able to view activities that you have permission to see.
1. Logs menu > Activity Log. The Activity Log Viewer screen appears.
2. Click Find. The activities that are displayed reflect the parameters in the Select By
section.
3. You can change the Select By parameters if you would like to search for activities
from a specific time, a particular type of activity, a specific node/backup set or user:
4. Click Find to refresh the display the activities that meet your Select By specifications.
5. If an error occurred during the selected activity, a record of what happened is kept in
the Event Log. Click Event Log to display specific event information on the highlighted
activity.
6. Click Close when you are finished.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 233
Confidential.
11 - Logs and System Tools
File Log Information (Detailed Log)
This feature is available if the selected backup/restore session contains Detailed Log information
(refer to “Step 6. Specify Backup Set Options” on page 85). This means a log of all the files backed
up or restored in the selected session was recorded.
1. In the Activity Log, highlight the backup/restore session you would like to view.
2. Click Detailed Log. The Detailed Log appears, showing the items backed up or
restored during that activity session.
3. In the Tree, you are able to browse through and view the directories and files that
were backed up or restored during the selected session.
4. To show the files in a directory, click Show Files.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 234
Confidential.
11 - Logs and System Tools
5. Click File Info for more information on the highlighted file (generations). The Backup
Generations for […] screen appears.
6. Click Close when you are finished.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 235
Confidential.
11 - Logs and System Tools
Event Log
The Event Log is a searchable log that records events that occur on the DS-Client. Events include
errors, warnings, and information messages.
1. Logs menu > Event Log. The Event Log Viewer screen appears.
2. You can change the Select By parameters to narrow your search.
3. Click Find to refresh the display based on the Select By settings.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 236
Confidential.
11 - Logs and System Tools
Audit Trail
The audit trail is a log that records all of the changes made to the DS-Client database. You can
see who has made changes to the database, when, and what the changes were.
1. Logs menu > Audit Trail. The Audit Trail screen appears.
2.
3.
4.
5.
Click Find.
You can change the Select By parameters to narrow the display:
Click Find to refresh the display based on the information you specified.
Click Close when you are finished.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 237
Confidential.
11 - Logs and System Tools
Current Activity Monitor
The bottom section of the DS-User Screen contains a real-time activity monitor for the DS-Client.
More information about DS-Client connections may be found in the System Status Screen (see
“Monitor current connections and processes on the DS-Client” on page 267).
1. Current activities on DS-Client appear at the bottom of the DS-User Screen.
2. For more information, double-click a process.
3. The Process Window opens in the space to the right of the backup sets tree. From
here you may monitor details, or stop the activity.
Note: Since most processes are multi-threaded, they may finish faster than the GUI can refresh
the screen. This means sometimes the file that is displayed might not correspond to the
directory.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 238
Confidential.
11 - Logs and System Tools
Budget Allocation Tool
This tool must be enabled by your Service Provider from the DS-System.
The Budget Allocation Tool is intended for users with financial decision making authority. A
separate Budget password (CFO or CIO) is set while logged in to DS-Client. This tool is intended
to help the CFO / CIO with estimates, and management of usage:
“Step 1. Establish Budget User Credentials” on page 239
“Step 2. Estimation Tool” on page 240
“Step 3. Budget Specifications” on page 241
“Step 4. Users & Groups (Enforce Budget limits)” on page 241
Step 1. Establish Budget User Credentials
First, establish the password for the CFO and/or CIO users (pre-set usernames); therefore, you
only need to add the password (they may log in as regular users).
1. Setup menu > Budget. The Credentials for budget screen appears.
2. Click Set Password. The Set Budget Password […] appears.
3. Enter a new password and verify it in the verify field. Click OK. The Credentials for
Budget screen returns.
4. Click Budget Specifications to open the Budget Specification screen (with the
Estimation Tool visible).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 239
Confidential.
11 - Logs and System Tools
Step 2. Estimation Tool
The first time you open the Budget Specification screen, the parameters section will be empty. Use
the Estimation tool section to calculate and set the budget parameters.
1. In the Estimation Tool section, select either monthly budget or maximum storage, and
set a limit in the corresponding field.
2. Click Calculate. The Calculation Results screen appears. With the settings, based on
your Monthly Budget ($) or Maximum Storage (MB).
3. Click Save Budget to save these figures in the Budget Parameters section of the
Budget Specification screen.
4. Click OK to apply all changes to the Budget Specifications screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 240
Confidential.
11 - Logs and System Tools
Step 3. Budget Specifications
When you need to edit the Budget parameters, the Budget Specifications screen will appear with
the Estimation Tool hidden.
Step 4. Users & Groups (Enforce Budget limits)
Once you have made the Budget Specifications, you should enforce the on-line amount for all
users and groups that connect to the DS-Client. You should do this in consultation with the DSClient administrator.
•
•
In the Users & Groups screen, you must assign a Maximum On-line amount
to each group (and individual user, if applicable). See “Set a User/Group
Maximum On-line Storage Limit” on page 43
The total amount (from the Effective Limit column) must not exceed the
Budget limit (listed at the bottom of the screen).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 241
Confidential.
11 - Logs and System Tools
•
For more information, see “Set a User/Group Maximum On-line Storage Limit”
on page 43.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 242
Confidential.
11 - Logs and System Tools
LAN Storage Discovery Tool
This tool must be enabled by your Service Provider from the DS-System.
Use this tool to scan the shares on your LAN. It generates a list of the files on the LAN. This is
useful to identify shares that are contained within other shares, and duplicate files on the
network(s). This is a pay-per-use service, with a limited time license.
•
For more details, see the Knowledge Base article: “LAN Storage Discovery
Overview” on page 381
The following four steps are used with this tool:
Step 1. Share Discovery: You select the networks \ computers to scan, and supply the list
of credentials to use for connection. The first step depends on the type of DS-Client
you are using:
• “Step 1. Share Discovery (Windows DS-Client)” on page 244
• “Step 1. Share Discovery (Linux DS-Client)” on page 246
“Step 2. Scan Shares” on page 247: You can modify the discovered list of shares to scan.
You can set the Scan to run with a Schedule.
“Step 3. Scan Monitor” on page 249: Shows a real-time monitor of the Scan Process (at
the share level).
“Step 4. File Summary” on page 250: A list of the files scanned on the LAN. You can view
additional details about particular files (file duplication, etc.).
Additional LAN Storage Discovery Reports can be generated using the information from the File
Summary:
“LAN Storage Discovery Reports” on page 253
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 243
Confidential.
11 - Logs and System Tools
Step 1. Share Discovery (Windows DS-Client)
This wizard helps you select which networks \ workgroups \ domains \ computers to scan. Once
complete, a list of all the shares visible will be available for the Scan Shares process.
1. Reports menu > LAN Storage Discovery > Share Discovery.
2. The Share Discovery Wizard appears.
3. From the Network tree, specify each item you wish to scan and click Add.
4. When you have added all the networks you wish to scan, click Next. The Wizard
switches to the Network Credentials tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 244
Confidential.
11 - Logs and System Tools
5. In the Additional credential section, click Add. The Set Credentials screen appears.
6. Enter the credentials, and click OK.
7. Once you are satisfied with the settings, click Finish. The LAN Share Discovery
Process Window appears.
8. This process may take some time, especially on a large LAN.
9. When complete, a list of the discovered shares will appear in Reports Menu > LAN
Storage Discovery > Scan Shares: Share List (See: “Step 2. Scan Shares” on
page 247).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 245
Confidential.
11 - Logs and System Tools
Step 1. Share Discovery (Linux DS-Client)
This wizard helps you select which file system protocols \ computers to scan. Once complete, a list
of all the shares visible will be available for the Scan Shares process.
1. Reports menu > LAN Storage Discovery > Share Discovery.
2. The Share Discovery Wizard appears.
3. From the Network tree, specify each item you wish to scan and click Add.
• If the “Ask for credentials” box is checked, that screen appears for you to
enter the credentials. Click OK.
• (UNIX-SSH only) If the “‘SU’ to alternate user” box is checked, that screen
appears for you to enter the credentials. Click OK.
4. When you have added all the networks you wish to scan, click Next. The Wizard
switches to the Clean previous shares in list tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 246
Confidential.
11 - Logs and System Tools
7. Once you are satisfied with the settings, click Finish. The LAN Share Discovery
Process Screen appears.
8. This process may take some time, especially on a large LAN.
9. When complete, a list of the discovered shares will appear in Reports Menu > LAN
Storage Discovery > Scan Shares: Share List (See: “Step 2. Scan Shares” on
page 247).
Step 2. Scan Shares
Once you have run the Share Discovery Process, a Share List is generated, with the best
credentials to connect to each share. Shares discovered are automatically enabled/disabled,
depending on if they are already included in other shares (or if a connection cannot be
established).
Use this screen to edit the Scan settings.
1. Reports menu > LAN Storage Discovery > Scan Shares.
2. The Scan Shares screen appears.
3. Click Share List.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 247
Confidential.
11 - Logs and System Tools
4. The Share List screen appears with the enabled/disabled shares on the LAN to scan.
TIP:
1st time scan all. Subsequent scans you can disable / enable shares to your scan
requirements. (e.g. if you wish to do a quick scan of only one share.)
5. You can automate the Scan with a Schedule (new or existing), or perform it on
demand by clicking Scan.
6. To perform it on demand, click Scan. A monitor screen will start.
7. This will take some time, depending on your settings (# of threads), the number and
size of the share(s).
8. You may monitor the Scan Process through the “Step 3. Scan Monitor” on page 249.
9. Once the scan is complete, you may view the Scan results in “Step 4. File Summary”
on page 250.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 248
Confidential.
11 - Logs and System Tools
Step 3. Scan Monitor
This monitors the Scanned shares. It is updated at specified intervals with the most recent
information.
1. Reports menu > LAN Storage Discovery > Scan Monitor.
2. Check the Show disabled shares box to display all shares found on the network(s)
scanned.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 249
Confidential.
11 - Logs and System Tools
Step 4. File Summary
The File Summary is compiled from the information gathered during the Scan Monitor.
1. Reports menu > LAN Storage Discovery > File Summary.
2. For more information, highlight a line and click Details. The Details screen appears.
3. Options:
• This screen shows all of the files for the selected line from the File Summary
(e.g. All Files, Changed Files, etc.).
• The Duplication Level is important, since it indicates the level of redundancy
of some LAN data. You should monitor Backup Sets to ensure this duplication
is considered.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 250
Confidential.
11 - Logs and System Tools
•
The Details list is limited to a maximum of 50,000 files. If the scan returns
more than this number (which is likely on a LAN), the results are sectioned.
4. Click Close to exit this screen.
File Summary Filtered View
Use the Filtered View section (the lower half of the screen) to narrow your search.
1. The options at the bottom of the screen can be applied to narrow your search.
2. Highlight a line in the Global or Filtered views, and click to open the Details screen.
3. Each line shows a different file.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 251
Confidential.
11 - Logs and System Tools
4. Highlight a file and click Show Duplicates.
5. Click Close to exit.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 252
Confidential.
11 - Logs and System Tools
LAN Storage Discovery Reports
Based on the File Summary scan results, you can generate the following reports that describe the
data trends on the LAN:
“Large Files” on page 253
“Extensions” on page 254
“Access” on page 256
“Growth” on page 257
“Share Usage” on page 258
“Generate Reports (one-click reports)” on page 259
• (One-click reports can be generated to HTML, CSV and XLS files.)
Large Files
Reports Menu > LAN Storage Discovery > Large Files
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 253
Confidential.
11 - Logs and System Tools
Extensions
Reports Menu > LAN Storage Discovery > Extensions: This is a customized view of the File
Summary information. It sorts the files by extensions specified. The report shows the results of the
extension search (of files scanned by the LAN File Summary Tool).
1. To search for specific file extensions, click New Report.
• To search for the most frequent file extensions, click Top Report. The Select
Extensions (Top Report) screen appears.
A.Fill in all the fields.
B.Click OK to scan and return the results in the Extension Report screen.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 254
Confidential.
11 - Logs and System Tools
•
To search for selective file extensions, click Customize Report. The Select
Extensions screen appears.
A.Click Add. A new extension line appears.
B.Enter the extension (without a period ".").
C.Continue for as many extensions you want.
D.Click OK to scan and return the results in the Extension Report screen.
2. Fill in the required information and click OK.
3. The Extension Report screen returns with a graph and list of the results.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 255
Confidential.
11 - Logs and System Tools
Access
Reports Menu > LAN Storage Discovery > Access: This is a customized view of the File
Summary information. It sorts the files by the time the file(s) were last accessed.
1. Click New Report to specify the report intervals. The Select Access Intervals screen
appears.
• Click Add. A new Access Time line appears.
• Select the time interval.
• Continue for all the Access Time intervals required.
• Click OK to scan and return the results in the Access Report screen.
2. The Access Report screen returns with a graph and list of the results.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 256
Confidential.
11 - Logs and System Tools
Growth
Reports Menu > LAN Storage Discovery > Growth: This is a customized view of the File
Summary information. It sorts the files by the growth (positive and negative) over time (days). This
report shows the data patterns (if any) on the LAN (or a specific share).
You may change the view to different charts (Bar, Line) from the View drop down list.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 257
Confidential.
11 - Logs and System Tools
Share Usage
Reports Menu > LAN Storage Discovery > Share Usage: This is a customized view of the File
Summary information, sorted by owner and share.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 258
Confidential.
11 - Logs and System Tools
Generate Reports (one-click reports)
Reports Menu > LAN Storage Discovery > Generate: The above customized reports of the LAN
Storage Discovery process can be generated to text, XLS, and HTML files at your request. This
will generate all reports to a file folder you specify on the network. This may take some time,
depending on the size of the report data.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 259
Confidential.
11 - Logs and System Tools
On-line File Summary Tool
This tool must be enabled by your Service Provider from the DS-System.
Use this tool to scan the backup sets created by your DS-Client. It generates a list of the files on
the DS-System on-line vault. This is useful for identifying duplicate files that are being backed up.
You can reduce backup traffic and on-line storage with this information.
The screens are the same as for the LAN file summary (See: “Step 4. File Summary” on page 250
in the LAN Storage Discovery Tool section).
1. Reports Menu > On-line File Summary.
•
For each row, a file is only counted once (even if there are multiple
generations of that file).
2. Click Find. The process scans all of the backup files (based on the Filter parameters)
on the DS-System.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 260
Confidential.
11 - Logs and System Tools
3. Highlight a line in the Summary and click Details. The Details screen appears.
•
Each line represents a unique file. If more than one copy exists, the
duplication amount is indicated in that column.
4. Highlight a file from the list and click Show Duplicates. The location of each duplicate
file is shown in this screen.
5. Click Close when you are finished.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 261
Confidential.
11 - Logs and System Tools
DS-Client Load Summary
The load summary is a visual tool that helps administrators analyze the load on the DS-Client
computer for a selected period.
Note:
You can only view an analysis of the backup sets to which you have sufficient rights.
How to read the chart:
•
•
•
•
•
The default chart type is Line. You can change it to a bar graph from the
dropdown list.
The chart displays the period of days in the Select By section. You may
change this period as required. By default, the last seven (7) days are
selected.
The horizontal axis shows the time intervals selected in the Chart Options
section. By default, intervals each represent one day.
The default graph shows the Send & Receive load (in KB), and the CPU load
(%) on the DS-Client for the corresponding time.
You can view more load information by selectively adding load summary
items from the Series screen (described below).
Reports menu > Load Summary. The DS-Client Load Summary screen appears.
1. To change the Load Summary content, click Series. The Load Summary Series
screen appears
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 262
Confidential.
11 - Logs and System Tools
2. Add/change as many items as you wish. (It is recommended to view only 2-3 items at
a time, to keep the display manageable).
3. Click OK. The Load Summary graph reappears with the updated information.
•
•
If you modify any Select By options, you must click Refresh if you wish to
update the graph.
To view more details about a particular period, hover the cursor over a point
or bar. The details for that point / bar are displayed in a tooltip.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 263
Confidential.
11 - Logs and System Tools
DS-Client Storage Summary
During the Daily Admin. process, storage information is saved about the backup sets specified on
the DS-Client.
Note:
If the daily Admin. process is not run, the Storage Summary will use the results of the last
daily Admin. that was run.
This chart will automatically open and refresh on the "best fit" for the screen. You may modify the
type of chart or its appearance, depending on your particular requirements.
Reports menu > Storage Summary. The DS-Client Storage Summary screen appears.
1. To change the display, click Series. The Storage Summary Series screen appears.
2. Add as many items as you wish.
3. Click OK when you are done selecting items.
4. The Storage Summary screen returns and is updated automatically.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 264
Confidential.
11 - Logs and System Tools
System Administration Tools
Administrators and Backup Operators have access to more detailed tools to administer the DSClient. The System Activities Administration tools provide a variety of options to perform real-time
troubleshooting. You can communicate with users connected to the DS-Client, disconnect users
from, view the process queues, specify administrative backups and shut down the DS-Client
computer.
Setup menu > System Activities. The System Activities Administration screen appears.
DS-Client Activiites:
• Enable / Disable Scheduled activities
• Enable / Disable Demand activities
DS-Client Operations:
• “Shutdown the DS-Client Computer” on page 268
• “Repair the DS-Client Database” on page 268
Administrative Processes:
• “Update DS-Client Statistics immediately” on page 266
• “Run a Daily Admin immediately” on page 266
• “Run a Weekly Admin immediately” on page 266
System Status Operations:
• “Monitor current connections and processes on the DS-Client” on page 267
• “Send messages to users connected to the DS-Client” on page 267
• “Disconnect Network Connections to the DS-Client” on page 268
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 265
Confidential.
11 - Logs and System Tools
Update DS-Client Statistics immediately
Statistical data is gathered during one part of the Daily/Weekly Admin process. This feature allows
you to update the statistics (number of files per backup set, on-line amount per backup set, and
statistical data for Storage Summary) without running a full Daily or Weekly Admin:
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Press Update Now beside the “Statistics updated on ...” field.
3. The Update Statistics process window appears.
Run a Daily Admin immediately
The following steps describe how to run the Daily Admin on demand:
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Press Run Now beside the “Last Daily Admin run on ...” field.
3. The Daily Admin process window appears.
Run a Weekly Admin immediately
The following steps describe how to run the Weekly Admin on demand:
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Press Run Now beside the “Last Weekly Admin run on ...” field. The Weekly Admin
Options screen appears.
• For details on these options, see the online help for the screen.
3. Click OK to proceed.
Note:
For more information, see the Knowledge Base Article “Weekly Admin and
Synchronization” on page 372.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 266
Confidential.
11 - Logs and System Tools
Monitor current connections and processes on the DS-Client
You can monitor the current connections and processes, as well as view details of message
queues and database connections through the DS-Client System Status screen.
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Click System for real-time information about the current connections and activities on
the DS-Client. The DS-Client System Status screen appears.
3. Click Refresh to update the screen as required. The information provided in the tables
is current as of the moment you selected the System Status screen, or refreshed the
screen.
Send messages to users connected to the DS-Client
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Click System. The System Status screen appears.
3. In the Network Connections tab, highlight the recipient for your message.
4. Click Send Message. The Enter Message Screen appears.
5. Type the message in the Send Message Field.
6. Click Send to send the message.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 267
Confidential.
11 - Logs and System Tools
Disconnect Network Connections to the DS-Client
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Click System. The System Status screen appears.
3. Highlight the connection you wish to remove in the Network Connections section of
the screen.
4. Click Disconnect to disconnect the highlighted user from the DS-Client. A confirmation
screen appears.
5. Click Yes to disconnect the selected user.
Shutdown the DS-Client Computer
The following steps describe how to shut down the DS-Client computer:
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Click Initiate beside the System Shutdown checkbox. The Initiate System Shutdown
screen appears.
3. Enter the time (in seconds) that you wish to allow before shutting down.
4. Check the Reboot box if you want the DS-Client computer to reboot after shutdown.
5. Enter a message (if any) that you wish to send to users connected to the system.
6. Click Shutdown to proceed.
Repair the DS-Client Database
The following options are available to repair the DS-Client database:
• “Recover the DS-Client Database (Disaster Recovery of DS-Client
Computer)” on page 271
• “Recover 'Orphaned' backup sets to the DS-Client” on page 269
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 268
Confidential.
11 - Logs and System Tools
Recover 'Orphaned' backup sets to the DS-Client
It is possible (though unlikely), for some backup sets to become 'orphaned' on the DS-System.
This means the backup data exists on the DS-System, but the settings have somehow been lost
from the DS-Client's database. (This is possible if the DS-Client database is deleted, overwritten
with an older version, or damaged.)
The Event Log will have "Backup Set not found in Backup Log" errors, if this has occurred. These
will appear on Daily or Weekly Admin. activities.
Use the System Activities > Repair DS-Client Database > Orphaned backup sets to Repair to
repair the missing database information. This does not restore backup data; it recreates any
missing backup sets in the DS-Client database.
Once the backup sets are recovered, you may perform restores immediately.
However, in order to resume backups, you must re-specify all of the information (backup items,
schedule, etc.) using one of the following two options:
Option A. Migrate (See: “Migrate a Backup Set from one computer to another” on page 143)
Option B. Respecify the Backup Set's information individually.
Step 1. Specify the Connection Information (Network Credentials) for a Recovered
Backup Set
Step 2. Re-Specify the Backup Set's Backup Items
Step 3. Re-Specify the Backup Set's Backup Schedule
Step 4. Activating the Recovered Backup Set
Recover a Specific Backup Set
1. Setup menu > System Activities. The System Activities Administration screen
appears.
2. Click Repair. The Repair DS-Client screen appears.
3. Select the Orphaned backup sets radio button. Click OK.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 269
Confidential.
11 - Logs and System Tools
4. The Backup Set Recovery screen appears. Select the Backup Set you would like to
recover.
5. In the Recovery Info screen, select the appropriate User Name and/or Network
Provider for the Backup Set.
6. Click Save to save the Recovery Info profile as specified.
7. In the Backup Set Recovery Screen, click Recover. The Backup Set will be recovered
and Synchronized.
8. Open the Backup Sets screen and the recovered set(s) appear in suspended status
(grayed out).
9. Once you have recovered the backup sets, you may restore files (to alternate
location) at any time.
10. To perform backups you must ensure that the Computer Name, Connect As, Backup
Items, and Backup Schedule information are complete.
11. For Backup Sets missing the Computer Name information, you must Migrate the
backup set from <Unknown> to the actual provider name.
12. In the Backup Sets screen, Activate the Backup Set.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 270
Confidential.
11 - Logs and System Tools
Recover the DS-Client Database (Disaster Recovery of
DS-Client Computer)
In case of a disaster or other event at your location that requires the replacement of the DS-Client
computer, you will need to recover the DS-Client's Database to the new machine. This database is
backed up, based on the specification in the DS-Client Configuration—Parameters Tab (See:
“Configure the DS-Client Parameters” on page 33).
The recovered database will show data up to the time it was last backed up. Run a Weekly Admin.
process to ensure that no other data exists on the DS-System that is not in the DS-Client's
database. If more data exists, an error will appear and you must synchronize the backup set
before any further backup/restore activities may be performed (See: “Synchronize a Backup Set's
Backup Logs” on page 142).
1. Assemble the replacement DS-Client computer (hardware).
2. Install the Windows Operating system (same version as previous DS-Client), recreate
the user accounts (including the DS-Client account) and then reinstall the DS-Client
software to the computer.
3. Start the DS-Client Service and run DS-User.
• Verify the DS-Client’s database patch levels (Help Menu > About DS-User >
DS-Client Info: “Database Build”)
4. Setup menu > System Activities.
5. Click Repair. The Repair DS-Client screen appears.
6. Choose the DS-Client Database button or the DS-Client & Delta databases button.
7. Click OK. A recovery message appears, instructing you to restart the DS-Client
service.
8. Stop and Restart the DS-Client service. The recovered Database will become active
upon restart.
9. Run a Weekly Admin. process to ensure that the recovered DS-Client database data
is not missing any backup sets. If it is, perform a backup set recovery. (See: “Recover
'Orphaned' backup sets to the DS-Client” on page 269.)
10. Follow the steps to Take Ownership of the backup sets (See: “Change Backup Set
Ownership” on page 147).
11. Verify the DS-Client’s database patch levels again (Help Menu > About DS-User >
DS-Client Info).
• If the “Database Build” number is less than the number seen in Step 3, the
database you recovered was from an older version of DS-Client, and is
missing some patches. Re-run the most recent DS-Client service pack
upgrade to get back to the same database build.
Note:
For more information, see the Knowledge Base Article “Recovering the DS-Client
Database” on page 508.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 271
Confidential.
12 - Reports
12 - Reports
This section provides information on the various reports that DS-User can produce, as well as the
steps involved in generating these reports.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 272
Confidential.
12 - Reports
Print Reports
The DS-User can print and export the following reports:
• “Backup Sets Report” on page 273
• “Restorable Report” on page 274
• “Backup Users Report” on page 275
• “Backup/Restore Report” on page 277 (All DS-Clients / Single DS-Client)
• “Backup Trends Report” on page 276
• “Backup Groups Report” on page 279
• “Statistical Summary” on page 280
• “Backup Items Report” on page 282
You can only view reports that include all DS-Client users if you are logged into DS-Client as a
member of the Administrators group.
Backup Sets Report
This report shows information about each of the DS-Client's backup sets.
1. Reports menu > Backup Sets. The Backup Sets screen appears.
2. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Backup Sets Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self contained backup
sets.
• Statistical backup sets allow you to estimate the potential storage those
backup(s) would occupy.
• Self contained backup sets perform backup and restore using only the Local
Storage (DS-User Setup Menu > Configuration > Parameters Tab > Local Storage
Path)
Columns
Description
Backup Set Column
The Backup Set Column lists all of the Backup sets specified on the DS-Client.
Connect As
The Connect As column lists the User Name being used to connect to the share/
application.
Files
The Files column lists the number of files in each backup set (including all file generations).
Protected Size / Stored
Size
The Protected Size / Stored Size columns show the amount of space occupied Online by the backup set's files.
• The Stored Size column only appears if it is enabled from the DS-System.
Last Backup
The Last Backup column indicates the most recent date a scheduled backup was
performed for that share.
Status
The Status column indicates whether the corresponding backup set is active or suspended.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 273
Confidential.
12 - Reports
Restorable Report
This report shows information about restorable files.
1. Reports menu > Restorable. The Restorable screen appears.
2. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Restorable Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self contained backup
sets.
• Statistical backup sets allow you to estimate the potential storage those
backup(s) would occupy.
• Self contained backup sets perform backup and restore using only the Local
Storage (DS-User Setup Menu > Configuration > Parameters Tab > Local Storage
Path)
Columns
Description
Backup Set Column
The Backup Set Column lists all of the Backup sets specified on the DS-Client.
With / Without deleted
data
Two sets of columns appear, showing the restorable amounts for backup sets with
deleted data and without deleted data. Deleted data is backed up files that no
longer exist on the source computer.
Files
Size of the files available to restore
Restorable Size
The On-line Amount column shows the amount of space occupied On-line by the
backup set's files.
Last Backup
The Last Backup column indicates the most recent date a scheduled backup was
performed for that share.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 274
Confidential.
12 - Reports
Backup Users Report
This report shows every user that is currently associated with any backup sets on the DS-Client.
1. Reports menu > Backup Users. The Backup Users screen appears.
2. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Backup Users Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self contained backup
sets.
• Statistical backup sets allow you to estimate the potential storage those
backup(s) would occupy.
• Self contained backup sets perform backup and restore using only the Local
Storage (DS-User Setup Menu > Configuration > Parameters Tab > Local Storage
Path)
Columns
Description
User Name
The User Name column lists each user associated with at least one backup set.
Full Name
The Full Name column lists the corresponding full name of each user who created
the backup set (if applicable).
Connect As
The Connect As column lists the credentials being used to access the backup set's
share.
Backup Set
The Backup Set column lists the share\set name of each backup set on the DS-Client.
On-line Limit
The On-line Limit column lists the maximum limit that each user may store On-line.
On-line Amount
The On-line Amount column lists the amount that each user currently has On-line.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 275
Confidential.
12 - Reports
Backup Trends Report
This report shows usage statistics.
1. Reports menu > Backup Trends. The Backup Trends screen appears.
2. By default, you will see trends for all backup sets from the beginning of the month to
the current day. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Backup Trends Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Period
Weekly / Monthly Summary indicates the period covered by the report.
Regular
Statistical
Self contained
Deleted
Shows if this report covers regular (actual), statistical, self contained, or deleted backup
sets.
• Statistical backup sets allow you to estimate the potential storage those backup(s)
would occupy.
• Self contained backup sets perform backup and restore using only the Local Storage (DSUser Setup Menu > Configuration > Parameters Tab > Local Storage Path)
• Deleted backup sets are calculated using data from the Activity Log.
User Name
Shows the user or <All>
Backup Set(s)
Shows the backup set, or <All>
Columns
Description
Week / Month
Lists the week or month number for each row of data.
Date
Lists the date each row of data covers.
Files
Shows the total number of files backed up in each period.
Total Size
Shows the total size of all the files backed up in each period.
Backup Time
Shows the total time taken for backups in the corresponding period (in minutes).
Total
Shows a grand total of each of the last three columns.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 276
Confidential.
12 - Reports
Backup/Restore Report
This report summarizes each user's backup and restore operations during the specified Report
period.
1. Reports menu > Backup/Restore. The Backup/Restore Report screen appears.
2. By default, you will see trends for all backup sets from the beginning of the month to
the current day. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Backup / Restore Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Period
Weekly / Monthly Summary indicates the period covered by the report.
Regular
Statistical
Self contained
Deleted
Shows if this report covers regular (actual), statistical, self contained, or deleted backup
sets.
• Statistical backup sets allow you to estimate the potential storage those backup(s)
would occupy.
• Self contained backup sets perform backup and restore using only the Local Storage
(DS-User Setup Menu > Configuration > Parameters Tab > Local Storage Path)
• Deleted backup sets are calculated using data from the Activity Log.
User Name
Shows the user or <All>
Backup Set(s)
Shows the backup set, or <All>
Columns
Description
User Name
The User Name column lists the user who performed the backup or restore, and the date of
the operation.
Activities
The Activities columns list the total time taken for backup/restore activities and the total
number of sessions for the listed user.
Backup Activities
The Backup Activities columns list the number of files backed up that day, the volume of
data backed up, and the number of connections made on that day for backup.
Restore Activities
The Restore Activities column lists the number of files restored that day, the volume of
data restored, and the number of connections made on that day for restores.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 277
Confidential.
12 - Reports
User Totals
At the bottom of the data for each user is a summary for that user.
Grand Totals
At the bottom of the report are Grand Totals of all backup and restore network activity.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 278
Confidential.
12 - Reports
Backup Groups Report
This report is a breakdown of the current On-line usage, sorted by user group.
1. Reports menu > Backup Groups. The Backup Groups Report screen appears.
2. Leave the Group Name field empty for a summary for all backup groups. To specify a
single group, click the >> button. The Select Group screen appears.
3. Highlight the group you want and click Select.
4. Select Regular [Default], Self Contained, and / or Statistical backup set type(s).
5. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
6. Click the printer icon to print.
Backup Groups Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Group
Shows the backup group, or <All>
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self contained backup sets.
• Statistical backup sets allow you to estimate the potential storage those backup(s)
would occupy.
• Self contained backup sets perform backup and restore using only the Local Storage (DSUser Setup Menu > Configuration > Parameters Tab > Local Storage Path)
Columns
Description
Group
The first column lists the user group.
User Name
Shows all users belonging to the Group.
Full Name
May contain the appropriate real name associated with the user in the User Name column
(if applicable).
Files
Lists the number of files that the user currently has stored On-line.
On-line Amount
Lists the total amount which the files occupy On-line.
Totals
At the bottom of the data for each group, there is a summary total in the Files and the Online Amount columns.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 279
Confidential.
12 - Reports
Statistical Summary
This report shows usage statistics. It is particularly useful in conjunction with the Statistical Backup
Set feature (see “Statistical Backups (DS-Statistics)” on page 129).
1. Reports menu > Statistical Summary. The Statistical Summary screen appears.
2. Make your report selections.
• For details on these options, see the online help for the screen (Press F1 in
this screen).
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Statistical Summary Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
User Name
Shows the user, or <All>
Backup Set(s)
Shows the backup set, or <All>
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self
contained backup sets.
• Statistical backup sets allow you to estimate the potential
storage those backup(s) would occupy.
• Self contained backup sets perform backup and restore
using only the Local Storage (DS-User Setup Menu > Configuration > Parameters Tab > Local Storage Path)
Columns
Description
Machine Name / Backup Set / User
Sorted by computer / backup set / user.
Date
Date
Number of new files
New files
Amount of data in new files
Amount of new data (MB)
Number of backed up files
Total number of new files backed up
Amount of data backed up
Total size of new files backed up (MB)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 280
Confidential.
12 - Reports
Amount of data transmitted
Total size of new files transmitted (MB)
Compression ratio
Compression ratio achieved (total transmitted)
Number of files stored off-site
Total number of backup files stored off-site
Amount of data stored off site
Total size of backup files stored off-site (MB)
Backup time (min.)
Total backup time (min.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 281
Confidential.
12 - Reports
Backup Items Report
This report shows information about each of the DS-Client's backup sets.
1. Reports menu > Backup Items. The Backup Items screen appears.
2. Make your report selections.
3. Click OK (Java DS-User) or Print Preview (Win32 DS-User). A preview of the report
appears.
4. Click the printer icon to print.
Backup Items Report details
Title
Description
Account No.
The customer account number.
Account Name
The name of the customer account.
DS-Client No.
The number of the DS-Client covered in this report.
Printing date
Day the report was printed.
Regular
Statistical
Self contained
Shows if this report covers regular (actual), statistical, or self contained backup
sets.
• Statistical backup sets allow you to estimate the potential storage those
backup(s) would occupy.
• Self contained backup sets perform backup and restore using only the Local
Storage (DS-User Setup Menu > Configuration > Parameters Tab > Local Storage
Path)
Columns
Description
Backup Set
The Backup Set Column lists the source server, backup set name, and backup set
owner.
Set Type
Shows what type of backup set (Regular, Statistical, Self Contained).
Backup Items
The Backup Items column lists the individual backup items specified in the backup
set.
• A double-plus sign (++) indicates this backup item includes sub-directories.
• A single-plus sign (+) indicates this backup item does not include sub-directories.
• A minus-sign (-) indicates that this is an “Exclude” backup item.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 282
Confidential.
12 - Reports
Export
An export function is included to allow you to save important backup set information in an
electronic format.
Backup Sets Info
This exports the following:
ID
Unique Backup Set ID number
Name
Backup Set Name
Restorable Files
(without deleted data)
Number of files available for restore without deleted data. This is the size
that the Restore Wizard would display when selecting to restore the
entire backup set.
Deleted data is backed up files that no longer exist on the source computer.
Restorable Amount
(without deleted data)
Amount (in Bytes) of data available for restore.
Restorable Files
Number of files available for restore with deleted data.
Restorable Amount
Amount (in Bytes) of files available for restore with deleted data.
Protected Generation Count
Total number of file generations stored on the DS-System.
Protected Amount
Amount (in Bytes) of the data storage on the DS-System (as it appears in
the Backup Set’s Properties > Set Info - Online Amount).
Last Backup
The Last Backup column indicates the most recent date a backup was performed for that share.
Files that were not backed up by the last backup session. If the backup
Files not picked up by Last Backup was not interrupted by the user ("User Stop"), this is the number (amount)
of files that did not change.
Amount not picked up by Last
Backup
Note:
Amount (in Bytes) of the above.
Some additional columns might be visible (depending on the DS-Client configuration set
by your Service Provider).
1. Reports Menu > Export > Backup Sets Info. The Backup Sets Info screen appears.
2. In the File Format list, select a format to export the Backup Sets Info as.
3. In the Save As section, click the icon to open a standard Save As dialog.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 283
Confidential.
12 - Reports
Global Reports (Java DS-User)
NOTE: You do not need to be connected to a specific DS-Client to use this feature. This option is
always available from the JAVA DS-User > Reports Menu > Global Reports.
Global Reports are the same as the reports available from:
• “Print Reports” on page 273
The Global Reports feature allows you to print the selected report for multiple DS-Clients in the
same print session. This saves a lot of time if your environment has many DS-Clients, since you
would otherwise have to connect to each DS-Client individually, and then print the desired
report(s).
The Java DS-User must be able to connect to the selected DS-Clients, and you must supply valid
credentials to each DS-Client.
The following Global Reports can be generated:
• “Global Report - Export Backup Sets Information” on page 287
• “Global Report - Backup Sets Report” on page 287
• “Global Report - Restorable Volume Report” on page 287
• “Global Report - Backup Users Report” on page 287
• “Global Report - Backup / Restore Report” on page 288
• “Global Report - Backup Trends” on page 288
• “Global Report - Backup Groups Report” on page 288
• “Global Report - Backup Items Report” on page 288
• “Global Report - Statistical Summary Report” on page 289
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 284
Confidential.
12 - Reports
Selecting DS-Client(s) for a Global Report
Global Reports require a list of the DS-Clients and credentials in order for the Java DS-User to
connect and generate the reports.
Remember that this section (under the Global Reports sub-menu) applies only to the current Java
DS-User installation from which you are working.
1. A DS-Client field appears at the top of each Global Report print screen.
2. Click [...]. The Select DS-Clients screen appears.
•
From this screen, you create the list of DS-Clients whose reports you want to
generate.
• You must specify at least one DS-Client (otherwise no report can be
generated).
3. You can add DS-Clients to the list individually, or together as a group using the
Autosearch feature.
To add DS-Clients individually:
• Click Add / Modify. The New / Modify DS-Client Connection Entry screen
appears.
• When you enter the IP address of the target DS-Client computer, press TAB
or highlight a different field. Java DS-User attempts to connect to the DSClient at that IP address. If successful, the drop-down list activates beside the
From field (with the available servers where the credentials can be verified).
• You must supply valid credentials to this DS-Client. These must be
administrator equivalent if you want to view Reports for all users and groups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 285
Confidential.
12 - Reports
To add using the Autosearch feature:
• Click Auto Search. Java DS-User scans the network, and the DS-Clients Auto
Search screen appears with the visible DS-Clients in its list.
•
To add multiple DS-Clients, hold down the CTRL key while clicking. When
you have finished making your selections, click Add Selected.
• The DS-Client Connection Entry screen appears. You must enter a user
name and password that is valid on all of the selected DS-Clients. If you do
not have common credentials (with sufficient permissions), you must specify
each DS-Client individually.
• Click OK. The Select DS-Clients screen returns with the added connection
entries.
4. You can save the connection entries you have listed, but they will only be retrievable
from the current Java DS-User installation. (The computer / IP / credentials are saved
to the local user.ini file in encrypted format.)
• To save or load credentials, click the corresponding button. Enter the key to
lock or unlock the credentials and click OK. If loading, the Select DS-Clients
screen returns with the saved connection entries.
Note:
You can only save one set of DS-Client Connection Entries. If you click Save again,
whatever is in the Select DS-Clients screen at that time will overwrite any saved
credentials.
5. Once you have finished the list of DS-Clients, click OK. The Global Report Print
screen returns with the selected DS-Clients in the corresponding field. Make any
required report selections, then click OK to generate the reports.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 286
Confidential.
12 - Reports
Global Report - Export Backup Sets Information
1. Reports menu > Global Reports > Export Backup Sets Info. The Global Report Backup Trends screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Export Options section, specify how you want to save the file.
4. Click OK. The report that is exported is essentially the same as the regular Backup
Sets Info report.
• See “Backup Sets Info” on page 283.
Global Report - Backup Sets Report
1. Reports menu > Global Reports > Backup Sets. The Global Report - Backup Sets
screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Sets report.
• See “Backup Sets Report details” on page 273.
Global Report - Restorable Volume Report
1. Reports menu > Global Reports > Restorable. The Global Report - Restorable
Volume screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Volume report.
• See “Restorable Report details” on page 274.
Global Report - Backup Users Report
1. Reports menu > Global Reports > Backup Users. The Global Report - Backup Users
screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 287
Confidential.
12 - Reports
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Users report.
• See “Backup Users Report details” on page 275.
Global Report - Backup / Restore Report
1. Reports menu > Global Reports > Backup / Restore. The Global Report - Backup /
Restore screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup / Restore
report.
• See “Backup / Restore Report details” on page 277.
Global Report - Backup Trends
1. Reports menu > Global Reports > Backup Trends. The Global Report - Backup
Trends screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Trends report.
• See “Backup Trends Report details” on page 276.
Global Report - Backup Groups Report
1. Reports menu > Global Reports > Export Backup Sets Info. The Global Report Backup Groups screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Groups report.
• See “Backup Groups Report details” on page 279.
Global Report - Backup Items Report
1. Reports menu > Global Reports > Backup Items. The Global Report - Backup Items
screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Backup Items report.
• See “Backup Items Report details” on page 282.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 288
Confidential.
12 - Reports
Global Report - Statistical Summary Report
1. Reports menu > Global Reports > Statistical Summary. The Global Report - Statistical
Summary screen appears.
2. To select the DS-Client(s):
• See “Selecting DS-Client(s) for a Global Report” on page 285.
3. In the Report Selection section, specify what you want to display. For details on the
options, see the online help for the screen.
4. The report that appears is essentially the same as the regular Statistical Summary
report.
• See “Statistical Summary Report details” on page 280.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 289
Confidential.
12 - Reports
Custom Reports
The Custom Reports feature allows you to create your own reports, based on the data provided
from the DS-Client database tables. This feature is meant for advanced users.
This requires a third-party application (either JasperReports or Crystal Reports), which means
you must have the development resources to create and compile the custom report templates.
“Step 1. Create Customized Data” on page 290
“Step 2. Create Customized Report (with Third-Party application)” on page 293
“Step 3. View Customized Report” on page 294
Step 1. Create Customized Data
The first step is to select what data you want to use for the customized report.
1. Reports menu > Customized Data. The Customized Data Wizard screen appears..
•
•
•
Choose an existing Data Set or select <new> to create a new one. Data Set
selections are saved in the ‘.ini’ file for the DS-User installation you are using
(“user.ini” for Java DS-User or “DSUSER.INI” for Win32 DS-User).
Choose a ‘View’. Data is grouped into different ‘views’. Each view can contain
one or more tables from the DS-Client database.
The same table can appear in different views.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 290
Confidential.
12 - Reports
2. Click Next. The “Customized Data Wizard - Select Display Columns” screen appears.
•
A list of all fields from all tables for the selected ‘View’ appears in the left
column.
• Click on a field to select it. At the bottom of the screen you will see an
expanded description of what that field contains.
• Click Add to move the field to the selected column list on the right. (Multiple
fields can be selected using the SHIFT or CTRL keys).
• You can order the selected fields with the Up and Down arrow buttons. This
is the order in which the data fields will be written.
• Continue for as many fields as you require.
3. Click Next. The “Customized Data Wizard - Select Order” screen appears.
•
•
•
•
A list of all available sort fields appears in the left column. This is based on the
fields you selected to display in the previous screen.
Add as many sort fields as you require. You can order the selected fields with
the Up and Down arrow buttons. This is the order in which the data set will
be sorted.
Continue for as many columns as you require.
If you do not make a selection, data will be written as it is read from the
database. (Note: This sort order is not used by JasperReport or Crystal
Reports.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 291
Confidential.
12 - Reports
4. Click Next. The “Customized Data Wizard - Select Data Filters” screen appears.
• The default (if you do not set any filters) is to search for all data.
• If you set a filter, only data that matches the filter will be exported.
5. Click Next. The “Customized Data Wizard - Enter Data Set Name” screen appears.
•
•
You can save the Data Set settings for quicker access next time. These
selections (with the exception of Data Filters) are saved in the ‘.ini’ file for the
current DS-User GUI installation you are running.
“Export data to file” is selected by default. You must export the Data Set to a
file in either XML or CSV format.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 292
Confidential.
12 - Reports
6. Click Next. The “Customized Data Wizard - Confirm Data Set Summary” screen
appears.
•
•
Note:
Click Finish. If “Export data to file” was selected, a Save As dialog appears,
allowing you to save the Data Set to a file in either XML or CSV format.
Export as XML if you want to create a custom report template.
The Data Set you export contains a snapshot of the data from the fields you queried from
the DS-Client database at the moment you clicked “Finish”. This can be used to create a
one-time custom report. However, it is the data structure (data fields) that is used to
create a re-usable custom report template.
Step 2. Create Customized Report (with Third-Party application)
A third-party application is required to manipulate the Data Set into a custom report (and custom
report template). There are two options, depending on the type of DS-User you are using:
• Win32 DS-User: You must purchase the Crystal Reports application from
http://www.crystaldecisions.com. These examples use v.10 of the Crystal
Reports software.
• Java DS-User: You need to download the free JasperReports application
from http://www.jasperforge.org. These examples use v.2.0.2 of the
JasperReports software.
1. With the exported Data Set (XML file), you must now use the third-party jasper tools to
create your custom report using the fields from the Data Set.
2. Refer to the DS-Client Knowledge Base article describing “Customized Reports” on
page 358 for instructions.
3. Once you have created the compiled .jasper or .rpt report file, copy it to the \report
subdirectory of the folder where this DS-User GUI is running (if it does not exist,
create it - this is case-sensitive, so make sure the folder is named ‘report’).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 293
Confidential.
12 - Reports
Step 3. View Customized Report
1. Reports menu > Customized Reports. The Customized Report Wizard screen
appears.
•
In the Template name field, select the custom report you wish to view. The list
shows the compiled report template files in the \report subdirectory of the
folder where this installation of DS-User is running.
2. Click Next. The “Customized Report Wizard - Select Data Filters” screen appears.
•
•
The default (if you do not set any filters) is to display all data in the report.
If you set a filter, the custom report will display only data that matches the
filter.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 294
Confidential.
12 - Reports
3. Click Next. The “Customized Report Wizard - Confirm Report Summary screen”
appears.
4. Click Finish. The Custom Report appears.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 295
Confidential.
Glossary of Terms
Glossary of Terms
ASIGRA Televaulting
An automatic, unattended backup/restore management service, including the DS-System, DS-System Software,
DS-Operator Software, DS-Client, DS-Client Service Software, DS-User Software, and communication links.
Administrator
A user with full access privileges to the DS-Client.
Audit Trail
A log that records changes made to the DS-Client database.
Backup Groups (Report)
The backup groups report summarizes the usage by user group (Administrator, Backup Operator, Regular User,
etc.).
Backup Operator
A user with rights to backup sets that would not otherwise be accessible. Backup Operators possess the full
backup authority, but not the permissions of Administrators (e.g. no unlimited restore permissions).
Backup Set
A list of the items (directories, files, and applications) you wish to back up from your computer (or network). A
Backup Set includes information about how these items will be backed up (Backup Options), and when they will
be backed up (Schedule).
Backup sets are created through the DS-User program.
Backup Sets (Report)
This report shows all of the DS-Client's backup sets. It shows details about the source path, owner, connection,
number of files, On-line amount, last scheduled backup and status.
Backup Trends (Report)
This report shows usage statistics (files backed up, size in KB, and Backup time in Minutes) grouped by week or
by month. It can be made for an individual user, all users, or a particular node /share.
Backup Users (Report)
This report displays all of the users who currently have specified backup sets. This is useful when tracking the
storage usage of users, and may assist to determine whether an individual requires a higher storage limit.
Backup/Restore (Report)
This summary provides a detailed breakdown of each ASIGRA Televaulting user's daily backup and restore
activities. Then it breaks down usage by connection time, number of files, and data volume. A summary total is
provided for the selected time period at the bottom of the user's section.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 296
Confidential.
Glossary of Terms
Grand totals are provided for the entire period at the bottom of the report.
Backup Wizard
A DS-User utility to guide you through the creation of a backup set.
Current Activity Monitor
A DS-User utility that allows Administrators to monitor DS-Client connections and activities.
Daily Admin.
Performs a verification of backup sets, and (if configured) transfers a dump of the DS-Client database to the DSSystem.
Demand Backup
A DS-User utility that allows users to backup a set immediately (as opposed to waiting for it to run at a scheduled
time).
Details (Schedule)
Each Detail is a description of a specific date/time pattern when to perform a backup. You may add as many
details to a Schedule, as are required. Each Detail refers to a specific backup circumstance (e.g. "Occurs every 2
week(s) on Friday, at 6:00 PM").
For example: You may wish to back up weekly, and back up on a specific day (such as the last Friday of every
month). To do so, simply create one detail for the weekly backup, and a second detail for the monthly backup.
Digital Signature
A standard feature applied to all backup files. ASIGRA Televaulting automatically creates, attaches and stores a
unique digital signature for each backup file. During restore processes, the signature of the restored file is
compared with the signature that was generated at backup time. If they match, this confirms a 'carbon-copy'
restore of the file that was backed up.
Disaster Restore
A process to restore a large amount of backup data that is coordinated between the DS-Client LAN
Administrator and the Service Provider. The restore is performed via direct (or LAN) connection to Disc/Tape
media brought to the recovery site.
DS-Client
ASIGRA's proprietary software, designed to perform unattended and demand backups and selective restoration
of a user's specified files. The DS-Client software runs as a service on Windows Platforms, and as a daemon on
Linux Platforms.
It serves as a gateway to the DS-System: User data tagged for backup (see Backup Set) flows through the DSClient, where it is compressed, encrypted and sent to the DS-System for storage.
DS-Client Buffer
DS-Client buffer is disk space on the DS-Client computer that is used as temporary storage during some types of
backups (ex: MS Exchange Server, MS SQL Server dumps).
DS-Client Pipe
DS-Client Pipe is an alternative to the database dump for MS SQL and MS Exchange Server backups. This
option does not consume any additional disk space. During backups, the DS-Client reads from the pipe on the
source database. This method is useful if your database is too big to be dumped to a file on either the database
server or the DS-Client buffer.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 297
Confidential.
Glossary of Terms
DS-Client Service Manager
This program allows you to start and stop the DS-Client service. By default, it is located in the "ASIGRA
Televaulting" Start Programs Menu folder.
DS-System
The DS-System stores the customer's On-line data, and is located at a ASIGRA Televaulting Service Provider's
secure, off-site, Vault location.
DS-User
DS-User is the end-user software that runs on your standalone PC or LAN workstation. This application is the
interface that permits you to create a Backup Set to identify the files and directories you want the DS-Client to
back up.
Event Log
A log that displays the error, warning, and information messages that occurred during DS-Client activities for the
period selected.
Exclude
An option which is available in some screens. This allows you to exempt specific subdirectories, if the parent
directory has been selected.
Filter
A pattern that can be specified to reduce a search of a large list (e.g.: *.exe will search for all files with an 'exe'
extension).
Generation
Indicates the version of a file kept On-line.
Incremental Files
A standard DS-Client feature, whereby only the changed files are backed up to the DS-System. This process
eliminates the redundancy of backing up unchanged files.
Initial Backup
The Initial Backup feature allows you to backup to local buffer location(s) directly attached to the DS-Client (or
on the LAN). Then, you can ship that media (e.g. disks) to the DS-System location. Your Service Provider will
attach the media to the DS-System and import the Initial Backup data. Once it is imported to the DS-System, you
can continue protecting your data with subsequent scheduled and on-demand backups.
Knowledge Base
The “DS-Client Knowledge Base” on page 301 contains additional information regarding DS-Client operations
for more technical users.
Load Summary
The Load Summary is a tool that can help administrators analyze the load on the DS-Client computer for a
selected period of time.
Migration
ASIGRA Televaulting allows you to change the provider/computer of a backup set with the Migration feature.
This is useful if you rename your computer, change the operating system, or change the physical location of files.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 298
Confidential.
Glossary of Terms
Registration
During the first activity between the DS-Client and DS-System, the DS-Client is registered with the DS-System.
In this process, the DS-Client sends a unique key identifier (based on the operating system and hardware
configuration of the DS-Client computer), which is used in the dial-up and verification process.
This registration is an added security step, whereby the DS-System will only accept communication from the
registered installation of the DS-Client. (i.e. You cannot copy the DS-Client software from one machine to
another and use it as if it were the same machine.)
Regular User
The majority of ASIGRA Televaulting users in a LAN environment are Regular Users. Their main requirement
is to be able to specify and backup data that they can access, and restore their backups, as required.
Reports
Reports are an important administrative and bookkeeping tool for administrators. These help to track usage and
trends among ASIGRA Televaulting users. The DS-User software can create, print and export five different
reports (Backup Sets, Backup Users, Backup/Restore Summary, Backup Trends, and Backup Groups). Each of
these reports sorts the collected data in different ways.
Restore Wizard
The Restore Wizard is a graphical tool that will assist you to restore a backup set. It is divided into separate tabs
that depend on the type of backup you are trying to restore. The information in these tabs change to reflect each
successive choice you make in a previous tab. The Wizard is designed to guide you through the necessary
selections to restore a backup set.
Schedule
A Schedule is a set of Details that indicate when unattended (automatic) tasks like backups are to be performed.
Each Detail refers to a specific backup circumstance (e.g. "Occurs every 2 week(s) on Friday, at 6:00 PM").
Scheduled Backup
A backup that runs automatically, according to the Schedule used.
Statistical Backups
The only difference between Statistical Backups and Regular backups, is that backup data is not sent to the DSSystem for storage with a Statistical Backup. All other processes are performed, allowing you to analyze the data
trends before committing to perform real backups.
Status
An item's status indicates whether activities are being performed with it. The corresponding status could be
Active, Suspended, or Synchronize.
Storage Summary
The Storage Summary is a tool to help administrators analyze the trends for On Line amount, number of files and
backup time.
Suspended
A Suspended status indicates that scheduled backups are not being performed on this item. Backup data will
remain stored on the DS-System according to the backup sets' Generation settings.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 299
Confidential.
Glossary of Terms
Use Buffer
The Use Buffer option can be used for backups and restores. It is useful in cases where the LAN allows only a
short screen for backup/restore. Since the data must be transferred and compressed/encrypted through the DSClient, it may take more time than the period available.
If Use Buffer is selected, the backup/restore process will copy all of the specified backup files to the local storage
on the DS-Client's hard disk first. This ensures that the backup/restore transfers files from/to the target servers at
LAN speed (i.e. as fast as possible given your LAN infrastructure).
User Name
The name that you use on the machine or domain where the DS-Client will verify your credentials.
Weekly Admin.
Performs all Daily Admin. activities, and a low-level synchronization of backup sets. During this process, an indepth verification occurs between the DS-System's and the DS-Client log.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 300
Confidential.
DS-Client Knowledge Base
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 301
Confidential.
Knowledge Base: SETUP
Knowledge Base: SETUP
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 302
Confidential.
Knowledge Base: SETUP
Ports used in ASIGRA Televaulting applications
Creation Date: November 2, 2005
Revision Date: February 13, 2008
Product:
DS-Client
Summary
The following table shows the map of IANA ports used in ASIGRA Televaulting applications:
New
Old (before v.6.0)
Description
4401
3000
DS-Client -> DS-System
4403
3002
DS-User -> DS-Client
DS-Client SLA / DS-Client SLA Manager -> DS-Client
4405
3007
DS-Client -> DS-MLR
4407
3006
DS-Client SLA Manager -> DS-Client SLA Monitor
4408
N/A
DS-Client -> DS-Recovery Tools
4410
N/A
DS-Client -> DS-Client (Grid DS-Client)
Note:
Port numbers above 4406 are not IANA-assigned.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 303
Confidential.
Knowledge Base: SETUP
Resolving port conflicts for the DS-Client software
Creation Date: October 18, 2005
Revision Date: October 18, 2005
Product:
DS-Client installed on Windows Operating Systems
Summary
In order to operate, the DS-Client needs to open the port 4403 (or 3002 for versions older than
v.6.0) for the TCP/UDP protocols on the machine where it is installed. If this fails, the DS-Client
service will stop and will record the following error in the Windows Application Log: "Failed to open
ports (ds-user,TCP)."
The DS-Client might fail to start on some Windows Operating Systems because of a port conflict
between the DS-Client and some Microsoft services like WMI. A workaround from Microsoft to
resolve the port conflicts is described below:
1. Run "RegEdit".
2. Browse to
"HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\TCPIP\Parameters"
3. Double click the key named "ReservedPorts", and add "4403-4403" (or "3002-3002"
for DS-Clients before v.6.0).
4. Make sure that the key value ends with one empty line by hitting the "Enter" key.
5. Click the "OK" button to save the Registry changes.
6. Restart Windows and the port conflict should not occur.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 304
Confidential.
Knowledge Base: SETUP
Running DS-Client using PostgreSQL database on Mac
OS X with Apple Remote Desktop (ARD)
Creation Date: March 02, 2006
Revision Date: March 02, 2006
Product:
DS-Client (Macintosh)
Summary
This article deals with some potential problems when running DS-Client using PostgreSQL
database on Mac OS X with Apple Remote Desktop (ARD) installed.
Problem
ARD uses a built-in PosgreSQL that listens to port 5432. If the DS-Client's own PostgreSQL is also
configured to listen to port 5432, the database fails to start because of this conflict.
DS-Client may not work well with this built-in database due to version problems.
Workaround
The port conflict can be avoided by changing either port number to another value (other than
5432):
1. Edit the file postgresql.conf
• The file is under the folder defined by $PGDATA (usually /Library/
PostgreSQL8/).
• For ARD, this file is normally located in /var/db/RemoteManagement/RMDB/
rmdb.data/.
2. Uncomment the line "port = xxxx" and change it to something else.
3. Restart the service.
When installing DS-Client, make sure to set the port number in the Database Login Screen to the
correct value.
If the software is already installed, you can check / change the “Database Port” field value in the
configuration file. Changes will take effect after the service restarts.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 305
Confidential.
Knowledge Base: SETUP
Configuring DS-Client with Firewalls
Creation Date: March 8, 1999
Revision Date: March 21, 2008
Product:
DS-Client
Summary
In order to operate, the DS-Client needs to establish a session with the DS-System on port 4401. If
you have a firewall installed, you need to allow access to port 4401.
In a standard firewall configuration there is an inside network interface (i.e. your LAN with the
DS-Client) and an outside network interface (i.e. the Internet or WAN). The inside network is
considered to be 'trusted', while the outside network is 'not trusted'.
Connections with the DS-System are always initiated by the DS-Client. (A DS-System never
initiates a connection to the DS-Client.) Therefore, you must allow port 4401 for the TCP protocol
for the inside network interface.
If you do not use DHCP for the DS-Client computer, you have additional flexibility:
• You can specify in the firewall that only the DS-Client computer's IP address
can use port 4401.
• Depending on your firewall's configuration, you may even be able to set up a
range of IP addresses.
Setup
Transparency
1. Most default firewall configurations provide transparency for users inside your firewall,
but not for the users outside the wall. A DS-Client needs transparency for the
connection with the DS-System. Therefore, you must either set transparency ON for
the internal network interface (if it is not ON yet), or allow the connection on port 4401
to be transparent. This will depend on the type of firewall you are using.
2. There is no need for transparency on the outside network interface.
Ports
1. The basic configuration required to setup your firewall for DS-Client activities (backup/
restore) is to allow port 4401 for the TCP protocol.
Monitoring the DS-Client with the DS-User (GUI) from an outside connection:
1. You must allow port 4403 (TCP and UDP) in addition to port 4401.
2. If the DS-Client computer has more than one network interface (assuming the
DS-Client computer is running Windows) and has default gateways on each interface,
then you must modify the routing table manually to include the network from which the
DS-User machine is connecting.
Grid DS-Client
The nodes in a Grid DS-Client communicate with one another on port 4410. All nodes must be in
the same domain, therefore an external firewall is unlikely to be an issue.
However, if a firewall is configured on any of the DS-Client nodes, make sure it does not prevent
the DS-Client service from using port 4410.
• See “Grid DS-Client” on page 320.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 306
Confidential.
Knowledge Base: SETUP
Conclusion
To summarize - if you want full control of the DS-Client from the GUI, enable port 4401 (TCP) with
transparency, as well as enabling port 4403 (TCP and UDP).
See Also
“Ports used in ASIGRA Televaulting applications” on page 303
“Grid DS-Client” on page 320
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 307
Confidential.
Knowledge Base: SETUP
Windows XP Service Pack 2 changes that affect the
ASIGRA Televaulting Product
Creation Date: September 16, 2004
Revision Date: November 16, 2005
Product:
DS-Client
Summary
The following changes in Windows XP Service Pack 2 affect the ASIGRA Televaulting Product.
1. Firewall port conflict
In the README.TXT file shipped with the Release 5.9.5 there is a note about a port conflict
between DS-Client and Internet Connection Firewall (ICF) on Windows XP:
“In order to run DS-Client/DS-User on Windows XP, Internet Connection
Firewall (ICF) should not be running. There is a port conflict with the
firewall. We are working with Microsoft to resolve this conflict.”
After applying Windows XP Service Pack 2, the Internet Connection Firewall service has been
changed to Windows Firewall/Internet Connection Sharing (ICS) service and we did not encounter
such conflicts anymore; therefore you can ignore the recommendation to disable the Internet
Connection Firewall from README.TXT.
2. Firewall access rules
After applying the XP Service Pack 2, the Windows Firewall is automatically enabled with very
restrictive access rules and DS-User – and DS-Client SLA, if applicable - may not discover DSClient service. This is because the broadcast messages and incoming connections are blocked by
the firewall. You will need to do one of the following configuration changes, depending on your
environment:
a. If you try to connect from a different computer, you need to add the TCP port 4403 in
the Windows Firewall’s Exceptions List. This works when trying to connect from the
local computer as well.
b. If you try to connect from the local computer, unless you add the firewall rule as
described above, you need to specifically add either the loopback address (127.0.0.1)
or the local IP address in the initialization file (Win32 DS-User) or menu (Java DSUser).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 308
Confidential.
Knowledge Base: SETUP
DS-Client Database (Maintenance)
Creation Date: July 24, 2007
Revision Date: July 24, 2007
Product:
DS-Client
Summary
The DS-Client database is created by the DS-Client Installation. Ideally, you should not have to
perform any further configurations after installation.
This article covers some of the possible maintenance issues that might arise:
• “Increasing Disk Space for DS-Client Database” on page 309
Increasing Disk Space for DS-Client Database
DS-Client is installed with notification levels to warn when the DS-Client Database free disk space
is running low.
You have the following options if the disk location of the DS-Client database is running out of
space:
Windows DS-Client databases (MS SQL Server)
Option 1:
Free up disk space on the database drive.
Option 2:
Move the DS-Client database to a bigger drive by using any method of backing up
and restoring the DS-Client database.
• Make sure the MS SQL Server version on the target drive is compatible. The simplest way is to use the same version. MS SQL Server 2000 instances can be
restored to MS SQL Server 2005 instances, but not the other way (i.e. 2005 to
2000).
• You must re-configure the DS-Client to point to the new database location.
Modify the “Database” registry key on the DS-Client computer
(HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DS-Client\Parameters). Set the value to the UNC path to the new database instance (e.g. \\servername\instance_name\dsclient).
• Since this is an MS SQL Server specific task, no instructions are provided on how
to perform these steps.
Create additional data files for the DS-Client databases on other disks (please refer
to the MS SQL Server documentation).
Option 3:
• NOTE: If the additional data files are located on another drive and those paths
(NOT Recommended)
do not exist when recovering the DS-Client database to another machine, then
DS-Client will report errors and the database recovery will fail.
Linux / Mac DS-Client databases (PostgreSQL Server)
Option 1:
Free up disk space on the database drive.
Option 2:
Move the DS-Client database to a bigger drive by using any method of backing up
and restoring the DS-Client database.
• Make sure the PostgreSQL Server version on the target drive is compatible. The
simplest way is to use the same version.
• You must re-configure the DS-Client to point to the new database location.
Modify the “Database Host” value in the DS-Client’s configuration file (dsclient.cfg). Set the value to the IP address or UNC path of the server where the
new database instance is located.
• Since this is an PostgreSQL Server specific task, no instructions are provided on
how to perform these steps.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 309
Confidential.
Knowledge Base: SETUP
See Also
“DS-Client Database Installation Script” on page 311
“DS-Client Database Migration (from MS Access to MS SQL Server)” on page 312
“DS-Client Database Migration (from MSDE to MS SQL 2000)” on page 313
“Recovering the DS-Client Database” on page 508
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 310
Confidential.
Knowledge Base: SETUP
DS-Client Database Installation Script
Creation Date: November 19, 2002
Revision Date: November 19, 2002
Product:
DS-Client (with MS SQL Server database or MSDE database)
Integrity and Scalability Recommendations, Changes, Improvements
It is recommended that the DS-Client database data files reside on a different physical device than
the log files – and if possible, on a different disk controller (unless using different, more
sophisticated integrity strategies, like RAID subsystems, database replication, standby servers,
etc). Microsoft’s recommendation is: "Do not place the transaction log file or files on the same
physical disk with the other files and filegroups".
This will maximize the performance due to parallel disk I/O. It will also improve the chances to
recover the database to its state at the point of disk failure (in case that disk is damaged)
Installation Versions 5.7.5 and lower
Versions 5.7.5 and earlier install the DS-Client database files on the same location as the one of
the "master" database. In case of a hard disk failure, both the data files and log files were lost,
making a database recovery to its state at the point of disk failure impossible.
Even if the SQL Server’s options had been changed to the default locations for the data / log files,
the DS-Client installation script did not retrieve them. The result was the data and log files were
created in the same location as the "master" database.
New Implementation for Installation Versions > 5.7.5
The new database installation script automatically detects the Default Data Directory and the
Default Log Directory for the particular SQL Server (or instance) where it is installed. However, if
the defaults are empty (this is likely), even the new DS-Client installation’s scripts will create both
the data and log files in the same location (i.e. the one where the "master" database resides).
Before running the DS-Client installation to upgrade to a newer version, it is recommended to reset
the Default Data Directory and the Default Log Directory to a different path on different physical
drives as specified above. This can be done using SQL Enterprise Manager: select the SQL
Server or Instance where the DS-Client database will be installed > Right-click > Properties >
Database Settings tab.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 311
Confidential.
Knowledge Base: SETUP
DS-Client Database Migration (from MS Access to MS
SQL Server)
Creation Date: September 19, 2002
Revision Date: January 11, 2007
Product:
DS-Client (Windows)
Summary
If you are upgrading a DS-Client that uses an MS Access database, an installation screen will
appear to 'Convert Database'. You can convert it to MS SQL Server or Microsoft Database Engine
(MSDE) database.
You can choose an existing MS SQL instance. If there is no MS SQL instance installed on the
target computer, an option appears to install a MSDE, which is a free database engine. This option
appears at the beginning of the installation.
DS-Client Database Migration (NT / 2000 / XP / 2003)
A DS-Client Access database can be migrated to an MS SQL if there is at least one MS SQL
instance installed on the target computer. If no MS SQL instance exists, the DS-Client installation
will install an MSDE instance (free of charge).
Before starting the migration process, make sure that there is enough space on the hard drive
where MS SQL is installed. It must be at least three times greater than the sum of the dsclient.mdb
and dsdelta.mdb databases to be converted.
Migration will take time, based on your DB size and your system resources (anywhere from 30
minutes to 3 hours).
Run DS-Client installation and choose in the 'Convert Database' screen to convert your database
to a selected MS SQL instance. Your DS-Client will be reconfigured to use the new MS SQL
database, if the Migration finished successfully. The old MS Access databases will be moved to
the '..\DS-Client\db\old' directory. If the migration fails with a 'Timeout expired' error, you must
increase your system resources (RAM, CPU, etc.) and try again.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 312
Confidential.
Knowledge Base: SETUP
DS-Client Database Migration (from MSDE to MS SQL
2000)
Creation Date: November 18, 2005
Revision Date: November 18, 2005
Product:
DS-Client (Windows)
Introduction
The following options are available if you want to migrate a DS-Client database from Microsoft
MSDE to Microsoft SQL 2000. You need to migrate if you reach the 2GB limit of the MSDE
database, or if you plan a significant increase to the number of files protected with this DS-Client.
• “Solution 1 - Upgrade the existing MSDE instance to SQL 2000.” on page 313
• “Solution 2 - Install an instance of MS SQL 2000 and migrate.” on page 313
Solution 1 - Upgrade the existing MSDE instance to SQL 2000.
1. Run a Daily Admin that will backup the databases to the DS-System.
2. Stop DS-Client Service.
3. Upgrade the MSDE instance to SQL 2000. If this is successful continue with Step 4,
otherwise try Solution 2.
4. Start DS-Client Service.
5. Test the connection with the DS-System by running a Daily Admin to dump the DSClient databases and back them up to DS-System.
Solution 2 - Install an instance of MS SQL 2000 and migrate.
1. Run a Daily Admin that will backup the databases to the DS-System.
2. Stop DS-Client Service.
3. Install a SQL 2000 instance. Backup all three DS-Client databases (dsclient, dsdelta
and dslanfiles) and restore them in the new MS SQL 2000 instance with MS SQL
2000 tools.
4. Reconfigure the Registry Keys for DS-Client in order to use the restored databases
from the SQL 2000 instance.
• In Registry
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DS-Client:
Provide the path for the database:
Parameters\Database=\\MACHINE_NAME\INSTANCE_NAME\dsclient
•
Change the Dependency for DS-Client service by modifying the value
DependOnService from “MSSQL$MSDE_INSTANCE” to “MSSQLServer”.
5. Start DS-Client Service.
6. Test the connection with the DS-System by running a Daily Admin to dump the DSClient databases and back them up to DS-System.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 313
Confidential.
Knowledge Base: SETUP
DS-Client Database Migration (from MSDE to SQL
Server 2005 Express)
Creation Date: November 28, 2007
Revision Date: November 28, 2007
Product:
DS-Client (Windows)
Introduction
The following options are available if you want to migrate a DS-Client database from MSDE to
SQL Server 2005 Express. You need to migrate if you reach the 2GB limit of the MSDE database,
or if you plan a significant increase to the number of files protected with this DS-Client.
Note:
•
•
SQL Server 2005 Express has a 4GB database limit.
“Option 1 - Migrate by importing DB files to a new Instance” on page 314
“Option 2 - Migrate by upgrading the DB Instance” on page 315
Option 1 - Migrate by importing DB files to a new Instance
1. Run a Daily Admin. This will backup the DS-Client databases to the DS-System.
2. Stop DS-Client Service.
3. Backup (dump) all three DS-Client databases (dsclient, dsdelta and dslanfiles).
• You can also use the dump files created by the Daily Admin in step 1 (if the
DS-Client is configured to keep them in the DS-Client Buffer).
4. Obtain and install a SQL Server 2005 Express (SP2) instance (free download).
5. Obtain Microsoft SQL 2005 Management Studio Express (which can be downloaded
from http://www.microsoft.com).
• Using the Studio Express tools, restore all three DS-Client databases (from
the dump files in step 3) to the new SQL Server 2005 Express instance.
6. Reconfigure the Registry Keys on the DS-Client computer, in order to use the new
SQL 2005 Express instance (where you have just restored the DS-Client databases).
• In Registry
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DS-Client:
-
Provide the path for the database:
Parameters\Database=\\MACHINE_NAME\INSTANCE_NAME\dsclient
Note:
To view the instance names that are running, type ‘osql –L ‘ from the Command Prompt.
This will list all the running database instances.
-
Change the Dependency for DS-Client service by modifying the value
DependOnService from “MSSQL$MSDE_INSTANCE” to “MSSQLServer”.
7. Start DS-Client Service.
8. Test the connection with the DS-System by running a Daily Admin. Verify there are no
errors in the Activity Log.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 314
Confidential.
Knowledge Base: SETUP
Option 2 - Migrate by upgrading the DB Instance
1.
2.
3.
4.
Run a Daily Admin. This will backup the DS-Client databases to the DS-System.
Stop DS-Client Service.
Obtain a SQL Server 2005 Express (SP2) installation from Microsoft (free download).
Running the SQL Server 2005 Express installation over the MSDE instance is NOT
sufficient to perform a successful upgrade.
• You must follow the instructions for installation using the skuupgrade
parameter that can be found at:
https://msdn2.microsoft.com/en-us/library/ms144259.aspx#skuupgrade
5. After the upgrade is successful, start the SQL Server 2005 Express instance.
6. Start the DS-Client service.
7. Test the connection with the DS-System by running a Daily Admin. Verify there are no
errors in the Activity Log.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 315
Confidential.
Knowledge Base: SETUP
DS-Client Database Migration (from SQL Server 2005
Express to MS SQL Server 2005)
Creation Date: November 28, 2007
Revision Date: November 28, 2007
Product:
DS-Client (Windows)
Introduction
The following options are available if you want to migrate a DS-Client database from SQL Server
2005 Express to Microsoft SQL Server 2005. You need to migrate if you reach the 4GB limit of the
SQL Server 2005 Express database, or if you plan a significant increase to the number of files
protected with this DS-Client.
• “Option 1 - Migrate by importing DB files to a new Instance” on page 316
• “Option 2 - Migrate by upgrading the DB Instance” on page 317
Option 1 - Migrate by importing DB files to a new Instance
1. Run a Daily Admin. This will backup the DS-Client databases to the DS-System.
2. Stop DS-Client Service.
3. Backup (dump) all three DS-Client databases (dsclient, dsdelta and dslanfiles).
• You can also use the dump files created by the Daily Admin in step 1 (if the
DS-Client is configured to keep them in the DS-Client Buffer).
4. Install a new MS SQL Server 2005 instance (separate purchase required).
5. Obtain MS SQL Server 2005 Management Studio Express (which can be downloaded
from http://www.microsoft.com or which comes with the MS SQL Server 2005 you
purchased).
• Using the Studio Express tools, restore all three DS-Client databases (from
the dump files in step 3) to the new MS SQL Server 2005 instance.
6. Reconfigure the Registry Keys on the DS-Client computer, in order to use the new MS
SQL Server 2005 instance (where you have just restored the DS-Client databases).
• In Registry
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DS-Client:
-
Provide the path for the database:
Parameters\Database=\\MACHINE_NAME\INSTANCE_NAME\dsclient
-
Change the Dependency for DS-Client service by modifying the value
DependOnService from “MSSQL$MSDE_INSTANCE” to “MSSQLServer”.
7. Start DS-Client Service.
8. Test the connection with the DS-System by running a Daily Admin. Verify there are no
errors in the Activity Log.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 316
Confidential.
Knowledge Base: SETUP
Option 2 - Migrate by upgrading the DB Instance
1.
2.
3.
4.
Run a Daily Admin. This will backup the DS-Client databases to the DS-System.
Stop DS-Client Service.
Obtain a new MS SQL Server 2005 instance (separate purchase required).
Running the MS SQL Server 2005 installation over the SQL Server 2005 Express
instance is NOT sufficient to perform a successful upgrade.
• You must follow the instructions for installation using the skuupgrade
parameter that can be found at:
https://msdn2.microsoft.com/en-us/library/ms144259.aspx#skuupgrade
5. After the upgrade is successful, start the MS SQL Server 2005 instance.
6. Start DS-Client service.
7. Test the connection with the DS-System by running a Daily Admin. Verify there are no
errors in the Activity Log.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 317
Confidential.
Knowledge Base: SETUP
DS-Client Service Account
Creation Date: May 3, 1997
Revision Date: February 13, 2008
Product:
DS-Client (Windows)
Summary
The DS-Client software runs as a service on a Windows computer and requires a user account in
order to logon (to allow access to network resources). This account must be provided during the
DS-Client installation process (make sure that this user account exists on the target Windows
machine).
Before starting the DS-Client installation program, you must log on to the DS-Client computer as
the administrator or other user with equivalent permissions.
Service Account Rights
The Service Account requires some advanced user rights. Therefore, the DS-Client installation
program grants the following rights to the DS-Client Service Account:
• "Act as part of the operating system".
• "Logon as a service".
• "Backup files and directories".
• "Restore files and directories".
How the DS-Client uses the Service Account
The DS-Client installation/configuration programs store the username and password for the
DS-Client Service Account in the Registry (in encrypted form). The DS-Client service uses this
user account for logon impersonation during backup/restore sessions that are not configured with
a user account that has permissions to perform logon impersonation (e.g. connection to a
non-Windows computer). This (logon impersonation) allows the DS-Client to perform
simultaneous backup/restore operations from/to the same server with different user credentials.
Changing and Maintaining Service Account
In order to provide uninterrupted service, make sure that the Service Account is not disabled, that
the "Password never expires" option is set, and that no expiry date is set for this account. If the
DS-Client Service Account or password must be changed, reconfigure with Start > Programs >
ASIGRA Televaulting DS-Client > DS-Client Setup. Do not reconfigure through Control Panel >
Services > Startup, because the DS-Client service may not function properly.
If the service account is changed, re-create the Mail Profile used for DS-Client notifications.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 318
Confidential.
Knowledge Base: SETUP
DS-Client under heavy processing loads
Creation Date: January 9, 2003
Revision Date: February 6, 2004
Product:
DS-Client (Windows)
Summary
Error messages may occur on DS-Client in heavy processing load situations.
If lots of activities (especially Backup activities) are running on a DS-Client (Windows NT,
Windows 2000) at the same time, DS-Client could report errors "Insufficient System Resources
Exist to Complete the Requested Service" (Error code: 1450) even if the system has plenty of
RAM and disk space available.
Details
For some specific scenarios, Microsoft has confirmed these are problems in the Microsoft
products, or are limitations by design. The following articles discussed some of these scenarios:
• Ms-help://MS.MSDNQTR.2002APR.1033/kbwinnt/Source/ntrelease/
q142719.htm
• Ms-help://MS.MSDNQTR.2002APR.1033/kbwinnt/Source/ntrelease/
q296265.htm
• Ms-help://MS.MSDNQTR.2002APR.1033/kbsql/Source/sqlserver/
q274310.htm
Usually, the problem is, if the System under heavy load, the maximum value for paged-pool
memory (Windows NT: 192MB; Windows 2000: 470MB and the maximum value for non-pagedpool memory is 256MB) or some other resource limitation may be reached (i.e. The maximum
number of simultaneous active context - 256).
For DS-Client, if the System Resources problems occur, you can try with less activities running at
the same time or reduce the threads settings for DS-Client in the registry (i.e. "MaxThreads" for
Backup activities and "MaxRestoreThreads" for Restore activities).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 319
Confidential.
Knowledge Base: SETUP
Grid DS-Client
Creation Date: February 08, 2008
Revision Date: February 29, 2008
Product:
DS-Client (Windows)
This article provides an overview of the Grid DS-Client.
“1. Introduction & Overview” on page 320
“2. Operating Systems Supported” on page 321
“3. Hardware and Software Setup” on page 321
“4. Connectivity” on page 323
“5. Grid DS-Client Setup” on page 324
“6. Specific GUIs for Grid DS-Client” on page 324
“7. Upgrading, Recovering DS-Client DB, and Version control” on page 325
“8. Configuring the Grid DS-Client Nodes (node level configuration)” on page 326
“9. Frequently Asked Questions (FAQ)” on page 327
1. Introduction & Overview
Data storage protection is a fast growing market. More and more data needs to be backed up and
the backup jobs / sets are getting bigger and bigger. Meanwhile, backup time windows are
shrinking and RTO (recovery time objective) is vital. This means multiple DS-Clients for a single
LAN are becoming commonplace. Automatic balancing between multiple DS-Clients for higher
performance becomes a new challenge. High availability becomes more important. The
Agentless Grid DS-Client is the ASIGRA Televaulting solution to achieve these requirements
and to meet customer Service Level Agreements.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 320
Confidential.
Knowledge Base: SETUP
1. The Grid DS-Client is designed to deliver better performance scalability of the
DS-Client and to increase the availability of the Backup Service. It is designed so that
the DS-Client can survive failures of some of its nodes without interrupting the backup
service.
2. Configuring the Grid DS-Client means that several DS-Clients will work together to
provide backup and restore services as if they are a single DS-Client (from the
DS-System perspective). Any of the nodes in the Grid DS-Client is able to provide the
same service (backup, restore, delete, synchronization, admin, etc.) as long as the
nodes are configured properly (see section “3. Hardware and Software Setup” on
page 321).
3. All nodes in a Grid DS-Client share the same DS-Client database. They also share the
same Account Number, DS-Client number and private/account encryption keys.
4. Each node in the Grid DS-Client has a separate network connection to DS-System.
5. One of the nodes will be selected as the “Main Node” to perform common internal
tasks and to synchronize and balance activities. It also interacts with DS-User GUI
and DS-Client SLA. Any other node is called a “Leaf Node”. Leaf nodes will perform
tasks assigned by the Main node.
6. Activities are controlled by the Main Node and assigned to all nodes in a balanced
way. The balance is measured by the load (determined by the activities assigned,
compared to the “MaxSession” parameter configured for that node) and CPU usage.
7. If the Main Node goes down, the other (leaf) nodes will continue their current tasks. In
the meantime, a new Main Node will be elected.
8. Even if only one node is alive and all other nodes are down because of failures or
other reasons, the Grid DS-Client will still be available and will continue providing the
same backup services.
2. Operating Systems Supported
Grid DS-Client can be installed on the following platforms. It is strongly recommended to run all
nodes on the same platform, or at the very minimum the same architecture (32-bit only or 64-bit
only).
Platform
Version
Windows® XP
x86 (32-bit) or x64 (64-bit)
•
•
Professional SP2, OR
Media Center SP2
•
•
•
•
•
Standard SP1/SP2/R2, OR
Enterprise SP1/SP2/R2, OR
SBS SP1
Ultimate, or
Enterprise
Windows® 2003
x86 (32-bit) or x64 (64-bit)
Windows® VISTA
x64 (64-bit)
3. Hardware and Software Setup
NOTE: For step-by-step instructions, refer to the Windows DS-Client Installation Guide
(filename: installation_dsclient.pdf) section “Grid DS-Client Installation“.
1. In order for each node to be able to provide the same backup services, the nodes
must have the same access to the source data. This means that the nodes must be
configured the same way with regards to network credentials:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 321
Confidential.
Knowledge Base: SETUP
•
2.
3.
4.
5.
6.
If one node with a specific network credential can access the source data, all
other nodes must also be able to access that source data with that same
network credential.
• Moreover, if one node has software installed to access a specific data source
type (e.g. “Oracle Client” to backup Oracle Server, “iSeries Access for
Windows” to backup System i Servers, etc.) all other nodes must also be
configured with the same capability.
Each of the nodes must be able to access the DS-Client database using a trusted
connection. This means that a central database must be configured for the Grid
DS-Client to access. ASIGRA recommends that the database be clustered in order to
avoid single point of failures.
All nodes (including the DS-Client database machine) must be in the same domain to
achieve the above two requirements.
Grid DS-Client is supported on VMWare. Multiple nodes can be configured to run on
VM on the same physical machine. Since all these nodes share the same CPU/RAM
on the physical machine, if some nodes are idle or down, other nodes will get more
CPU/RAM resources and will become more powerful.
Database configuration is the same as for stand-alone DS-Clients:
• The database configuration is kept in the Registry of each node’s machine.
• The database service account must have enough credentials to access the
DS-Client buffer on each of the Grid’s nodes (in order to perform database
dump during Daily/Weekly Admin).
• Proper delegation must also be configured so that bulk insert is possible from
each node’s DS-Client buffer.
Each node’s service account must have enough credentials to remotely start/stop the
DS-Client service on all other nodes. This is required for the “Auto upgrade” feature. In
addition, perform the following:
• On Windows 2003 / XP / VISTA: Go to the Windows Control Panel >
Administrative Tools > Local Security Settings > Local Policies > Security
Options > Network Access: Sharing and security model for local accounts.
Set its value to “Classic - local users authenticate as themselves.”
• On Windows VISTA: Go to the Windows Control Panel > Network and
Internet > Network and Sharing Center: the option “File Sharing” should be
set to ON.
• On Windows XP / VISTA, configure the firewall setting:
-
For XP, make sure “File and printer sharing” is open.
-
•
For VISTA, make sure “File and printer sharing” and “Remote Administration” are in
the exception list.
Check if the firewall allows remote control of the DS-Client service between
the nodes with the following commands:
sc \\[other-node] start|stop ds-client
taskkill /S \\[other-node] /IM dsclient.exe
Note:
Replace [other-node] with the IP address or machine name of the target node. If these
commands fail, you have a network or configuration problem that you must resolve before
you can continue.
7. All nodes (including the DS-Client database machine) must be synchronized to the
same time server and configured to the same time zone to ensure time-consistency.
Otherwise, confusing (or even failure) scenarios may occur regarding logs and
backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 322
Confidential.
Knowledge Base: SETUP
8. To configure a Grid DS-Client, you must first install the DS-Client software on all
nodes (pointing to the same database and using the same encryption keys, etc.)
WITHOUT starting the DS-Client service.
• After completing all installations, run DS-Client setup (DSConfig.exe) on any
node to configure the nodes that will join together as the Grid DS-Client. See
“8. Configuring the Grid DS-Client Nodes (node level configuration)” on
page 326.
• The machine name (NetBIOS name) and internal/external IP are needed in
the Grid DS-Client configuration for each node. The internal IP is used for
communication between nodes in a Grid DS-Client. The external IP is used by
the DS-System to identify if connection is allowed for that DS-Client.
• DS-User and DS-Client SLA can use either internal or external IP, depending
where the DS-User and DS-Client SLA is located (LAN/WAN).
9. If a stand-alone DS-Client is upgraded to a Grid DS-Client, the original DS-Client must
be the first node in the Grid DS-Client to be configured using DS-Client setup
(DSConfig.exe).
10. To downgrade a Grid DS-Client to a stand-alone DS-Client, you can run DS-Client
setup on the node that will become stand-alone, and remove all nodes from the Grid
DS-Client configuration.
• Alternatively, you can start DS-Client setup on any of the other nodes. You
must leave the node that will become the stand-alone DS-Client in the Grid
DS-Client configuration, and all other nodes must be removed from the list.
11. If you need to re-configure (add new nodes or remove existing nodes) a Grid
DS-Client (including upgrade from stand-alone and downgrade to stand-alone):
• You must first stop the DS-Client service on all nodes. After that, start
DS-Client setup to configure the Grid DS-Client.
• After the Grid DS-Client configuration is done, modify the connection on
DS-System side accordingly for this (Grid) DS-Client. Un-register this (Grid)
DS-Client on DS-System side. Start the DS-Client service on the desired
nodes, and register to DS-System.
• Any nodes that were not started at the time you re-registered to DS-System
will send their hardware registration information to DS-System later, on their
next connection to DS-System.
12. If any node’s hardware information is changed, or new nodes are added into the Grid
DS-Client (including upgrading from stand-alone), you must re-register to DS-System.
For more details, see:
• “Re-register the DS-Client with the DS-System” on page 27
13. Port “4410” is used for the communication between nodes in a Grid DS-Client. This
port must be opened on all nodes of the Grid DS-Client.
14. Since the Grid DS-Client configurations are stored in the DS-Client database,
whenever you change the Grid configuration, you should backup the DS-Client
database with Daily Admin or Weekly Admin as soon as possible. Otherwise, if the
database becomes corrupted or suffers some type of failure, you will have to reconfigure after recovering the DS-Client database.
4. Connectivity
1. The DS-User will only be able to connect to the Main Node.
• Since the Main Node is variable, the DS-User must be initialized with all the IP
addresses of all the nodes of the Grid DS-Client.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 323
Confidential.
Knowledge Base: SETUP
2. Each node will connect to DS-System in a separate network connection, using its own
external IP.
3. Each node must be able to connect to all source data to be protected.
4. DS-Client SLA monitor will only connect to the Main Node. However, since any node
could be elected as the Main Node, the IP of all nodes must be configured in the
DS-Client SLA.
5. A High-speed network connection (at least 1 Gigabit per second is recommended) is
necessary between Grid DS-Client and the data source to improve the overall backup
service performance.
5. Grid DS-Client Setup
NOTE: For step-by-step instructions, refer to the Windows DS-Client Installation Guide
(filename: installation_dsclient.pdf) section “Grid DS-Client Installation“.
The DS-Client Setup (default path "C:\Program Files\Data Storage\DS-Client\DSConfig.exe") has
an optional screen to “Enter Grid DS-Client information”. The Grid DS-Client section is displayed
when the user selects “Configure Grid DS-Client” or if DS-Client Setup is running on an existing
Grid DS-Client.
•
•
You must configure at least two nodes to make a Grid DS-Client. If you
configure only one node (or none), this DS-Client will be a standalone DSClient.
User input and modification of nodes is controlled by the “Add”, “Update” and
“Delete” buttons.
6. Specific GUIs for Grid DS-Client
In general, the DS-User functionalities are the same as for the stand-alone DS-Client, with a few
additional functionalities for managing the Grid DS-Client. For a description, see:
• “Grid DS-Client (Windows DS-Clients)” on page 52
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 324
Confidential.
Knowledge Base: SETUP
7. Upgrading, Recovering DS-Client DB, and Version control
NOTE: For step-by-step instructions, refer to the Windows DS-Client Installation Guide
(filename: installation_dsclient.pdf) section “Grid DS-Client Installation“.
Manual upgrade
To manually upgrade a Grid DS-Client to a new version:
1. Stop all DS-Client services on all nodes in the Grid DS-Client.
2. Run the Service Pack / Release / Hot Fix package on each node, using the same
steps as for stand-alone DS-Client.
3. Start all the DS-Client services that are part of the Grid DS-Client.
Auto upgrade
Grid DS-Clients can auto-upgrade if their DS-System is configured to allow it.
1. The first node that downloads a higher version auto-upgrade package from
DS-System will stop the DS-Client service on all other nodes. After the first node has
finished upgrading, it will restart the DS-Client services on all other nodes. Once those
nodes restart, they will connect to DS-System and download the auto-upgrade
package (this time auto-upgrade will only stop the DS-Client service on the local
node).
2. Auto-upgrade will be triggered if:
• When starting DS-Client service, at least one other node is found to have a
higher version (only the node performing upgrading will be stopped for
upgrading and restarted automatically).
• When connecting to DS-System, a higher version DS-Client auto-upgrade
package is available.
Recover DS-Client Database
1. The “Recover DS-Client database” process can be performed on any node (DS-User
> Setup Menu > System Activities: Repair). Since the DS-Client Database Recovery
needs exclusive access to the database, all nodes are required to stop for recovery.
After the node that performed recovery successfully downloads the database dump, it
will notify all other nodes to stop. Once it detects all other nodes have stopped, it will
notify the user to restart the DS-Client service on that node. Before that node has
successfully recovered the DS-Client database (database load completed), other
nodes will not be able to start.
2. If an old DS-Client database is recovered and is not compatible with the current
DS-Client executable, you must run the latest DS-Client installation to upgrade the
DS-Client database. Otherwise, the nodes will not be allowed to start.
3. For more information on this process, see the Knowledge Base article: “Recovering
the DS-Client Database” on page 508 .
Version control
• If a node’s version is lower than the highest version in the Grid DS-Client, it
will perform auto-upgrade right after starting the DS-Client service.
• If auto-upgrade is not allowed or fails to upgrade, a version compatibility
check will be performed and nodes that are not compatible will not be allowed
to start.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 325
Confidential.
Knowledge Base: SETUP
8. Configuring the Grid DS-Client Nodes (node level configuration)
The default configuration (created by installing and running DS-Client Setup) is sufficient to run a
Grid DS-Client. Advanced users may wish to configure individual nodes for optimum performance.
For different nodes in the same Grid, some DS-Client parameters can be different. These local
parameters are flagged “Local Setting”. All local parameters must be configured from the DSClient configuration - Advanced Tab (see: “DS-Client Advanced Configurations” on page 40).
Every “Local Setting” parameter has a corresponding “Global Setting” that is the default value for
each node. To switch, a user must check the “Use global setting”. If unchecked, the Value field
activates and the user can give each node a different value.
A special parameter is “DSCBuffer”. This is same as “DS-Client Buffer” in the DS-Client
Configuration - Parameters Tab. However, it can be set to a different value for each DS-Client
node. This is because each DS-Client node can have its own buffer.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 326
Confidential.
Knowledge Base: SETUP
9. Frequently Asked Questions (FAQ)
Question
How is the Main node elected?
1. Answer
• The first node that detects there is no existing Main node will become the Main node. This means the
first node that is started will most probably become the Main node.
Question
How is a Leaf crash handled by the Grid DS-Client?
Answer
• In case a Leaf node crashes (for example because of hardware failure), all activities on that node will
be interrupted. However, if there are still some nodes active, the rest of the nodes will continue functioning and the rest of the activities running on other nodes continue to run. All activities that are run2.
ning on the node that crashed will be considered to have “failed”.
• For interrupted backup sessions, the files that have already been completely sent to DS-System will be
protected, while the others will be backed up in the next backup session.
• Retries for scheduled activities keep the same behavior as on a stand-alone DS-Client: it will retry in
case the connection to DS-System is lost, but not if the activity is stopped on the DS-Client side.
Question
How is a Main node crash handled?
Answer
3. • In case of the Main node is down, the internal tasks (scheduling, etc.) will be temporarily stopped.
However, all activities that are running on the Leaf nodes will continue. In the meantime, a new Main
node will be elected from among the remaining nodes. This will occur in a short period (usually a few
seconds, but sometimes it may take a few minutes).
Question
How many nodes can be configured in a Grid DS-Client?
Answer
4. • The minimum number of nodes in a Grid DS-Client is logically two (2). If there is only one node configured, it becomes stand-alone DS-Client. There is no actual maximum node limit. However, a larger
number of nodes means the DS-Client database server must have the CPU and RAM capabilities to support the nodes.
Question
How do you add a new node to the Grid DS-Client?
Answer
• To add a new node, you must install the DS-Client software pointing to the same database, using the
same registration info (Account number and DS-Client number, etc.), and same encryption key config5.
uration. After that, you must stop all nodes in the Grid DS-Client and re-configure the Grid DS-Client
via DSConfig.exe. Then you must start the nodes and re-register with the DS-System. Removing an
existing node from a Grid DS-Client is similar, you just need to stop the Grid, re-configure, and re-register.
Question
How do you downgrade a Grid DS-Client to a stand-alone DS-Client?
6.
Answer
• See #10 in section “3. Hardware and Software Setup” on page 321.
See Also
“Grid DS-Client (Windows DS-Clients)” on page 52
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 327
Confidential.
Knowledge Base: SETUP
DS-MLR Installation & Setup
Creation Date: August 13, 2004
Revision Date: November 15, 2007
Product:
DS-Client (Windows) with DS-MLR Service (DS-Recovery Tools)
Summary
NOTE: From v.7.0, the DS-MLR Service is bundled with the DS-Recovery Tools installation.
This article covers DS-MLR (Message Level Restore) installation and setup issues:
• “DS-MLR Server Installation Support Matrix” on page 328 :
• “DS-MLR Service Account requirements” on page 329
DS-MLR Server Installation Support Matrix
This Matrix shows the platforms where DS-MLR can be installed:
Microsoft Exchange Server Version
Platform for Exchange Server
Support status
Exchange Enterprise 2007
Windows Server 2007 (64-bit ONLY)
Supported
Exchange Enterprise 2007 Cluster
Windows Server 2007 (64-bit) in Single quorum device server clusters
NOT Supported
Exchange Enterprise 2003
Windows Server 2003
Supported
Windows Server 2003 in Single quorum device server clusters
Supported
Exchange Enterprise 2003 Cluster
Exchange Enterprise 2000
Microsoft Outlook Version
Outlook 2000
Outlook 2003
Outlook 2007
Lotus Version
Windows Server 2000 in Single quorum device server clusters
Support Possible
Windows 2000 Advanced Server
Supported
Windows Server 2003
Supported
Platform for Outlook
Support status
Windows 2000 Advanced Server
Supported
Windows 2003 Server
Supported
Windows 2003 Server
Supported
Windows 2003 Server in Single quorum device server clusters
Supported
Windows 2003 Server (32-bit/64-bit)
Supported
Windows 2003 Server (32-bit) Server in Single quorum device server clusters Supported
Platform for Lotus
Support status
Windows XP Professional
Supported
Windows 2000 Advanced Server
Supported
Windows 2003 Server
Supported
Lotus Domino Server
6.5 & 7.0
Windows 2000 Advanced Server
Supported
Windows 2003 Server
Supported
GroupWise Version
Platform for GroupWise Client
Support status
Windows 2000 Advanced Server + Novell Client 4.9.1 SP3
Supported
Windows 2000 Professional + Novell Client 4.9.1 SP3
Support Possible
Windows 2003 Server + Novell Client 4.9.1 SP3
Supported
Lotus Notes
6.5 & 7.0
GroupWise Client 6.5.4 & 7
Matrix Legend:
• Supported: DS-Client supports backup / restore on these target objects.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 328
Confidential.
Knowledge Base: SETUP
•
•
•
Support Possible: Asigra did not perform backup / restore tests on these
platforms, but there should not be any technical limitations.
Not Supported: Backup / restore is not supported.
No Vendor Support: Vendor does not support installation of target object on
these platforms.
DS-MLR Service Account requirements
This section is reproduced from the DS-Recovery Tools installation guide. It describes the
requirements for the DS-MLR Service Account (the Windows account used by the DS-MLR
service).
NOTE: If you encounter any backup or restore problems when using DS-MLR, it is most likely
due to problems with the DS-MLR Service Account configuration.
GroupWise:
• The DS-MLR Service Account must be a local administrator.
Lotus Notes / Domino Server:
• The DS-MLR Service Account must be a local administrator.
MS Outlook:
• The DS-MLR Service Account must be a local administrator.
MS Exchange:
• The DS-MLR Service Account determines the rights to backup the MS
Exchange Server’s E-Mails. Even if the service is run by a user from the local
Administrators group, that user may not have enough rights to backup all the
MS Exchange Server’s E-Mails.
• The following table shows the User Scenarios for backup / restore, depending
on the permissions of the DS-MLR Service Account:
Service Account is a
User Scenarios
member of:
•
Domain Admins
•
•
•
Domain User
•
•
•
•
Local Administrator
•
DS-MLR service account must be a member of Domain Admins and
local/Builtin Administrators groups.
This scenario is simple, but some network security policies may not
allow use of the Domain Admins group.
DS-MLR service account must be a member of local Administrators
group.
DS-MLR service account must be a member of Domain Builtin Backup
Operator or Administrators group.
DS-MLR service account must be delegated as Exchange Full Administrator.
This scenario is a little complicated, but does not require use of the
Domain Admins group.
This option is more flexible from a network security standpoint.
However, when starting up, DS-MLR may fail to grant the "Receive As"
right for some or all mailboxes to the service account.
Therefore, you must manually add the "Receive As" privilege to the
Windows User account for the backup set (Backup Set Properties > Connection Tab).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 329
Confidential.
Knowledge Base: SETUP
•
Microsoft Exchange Contacts and Distribution Lists:
Contacts and Distribution Lists may need to be handled with different APIs in order to successfully
backup Microsoft Exchange Servers.
Backup using MAPI API
Backup using Exchange CDO API
Because the Distribution Lists and Contacts are Outlook-based attributes, the DS-MLR can use MAPI to
perform backups. MAPI has the following limitations
based on the DS-MLR service account:
• In order to logon to another user’s mailbox
through MAPI, the service account needs the
“receive as” right, and the right to create a
temporary profile.
• DS-MLR can grant the “receive as” right if the
DS-MLR service account is either a Domain
Admin or an Exchange Full Admin.
If DS-MLR uses Exchange CDO to backup all
items, some Outlook attributes (like the
members list of the Distribution List) cannot be read. With CDO, DS-MLR has the following limitations:
• The restored Distribution Lists are
empty.
• The restored Contacts cannot be seen
in Outlook Address Book.
1. Both CDO and MAPI APIs are kept in DS-MLR. The default is to try using MAPI API.
2. If DS-MLR fails to grant “receive as” right to its DS-MLR service account, then DSMLR will use the CDO API.
3. If DS-MLR fails to use MAPI, then DS-MLR will use the CDO API.
4. When using the CDO API, DS-MLR will not backup the Distribution List.
See Also
“E-Mail Messages (DS-Recovery Tools)” on page 114
“Backup / Restore of E-Mails (using DS-MLR)” on page 452
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 330
Confidential.
Knowledge Base: SETUP
Setting up DS-Client Notifications
Creation Date: April 28, 1997
Revision Date: March 21, 2008
Product:
DS-Client (Windows)
Summary
DS-Client can be configured to send e-mail / pager notifications in the event of a critical backup
failure, allowing an Administrator to react instantly to such failures. In addition, DS-Client can
regularly mail out a summary of backup activities (during Admin processes).
DS-Client notifications can be:
• SMTP
• MAPI
Messaging Service Setup
Restrictions
The delivery of notifications is provided by 3rd-party mail clients installed on the DS-Client
computer and registered with the Windows Messaging Subsystem (MAPI). By design, MAPI and
most mail clients cause their client applications to pop up dialog boxes to interact with a user.
Because DS-Client is unattended service software, it would hang if it displays a dialog. Therefore,
DS-Client will only use compatible mail clients known to never display a user interface. Such mail
clients are listed in the order of preference in the Registry value
• [HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\DS-Client\Para
meters]
• MailClientsSupported
The entry for Microsoft Outlook is added to this list by DS-Client Setup. DS-Client will use the
first MailClientsSupported entry installed on the computer, i.e. listed under
• [HKEY_LOCAL_MACHINE\Software\Clients\Mail]
Note that DS-Client is not compatible with the Outlook Express mail client.
Restrictions Specific to Windows
The normal procedure for sending e-mail in Windows is as follows. The client application places
the message in the Outbox of a message store provider, the latter notifies the MAPI Spooler,
the Spooler dispatches the message to the appropriate transport provider based on message
recipients and, finally, the transport provider takes over message delivery.
Since Microsoft overlooked security and identity issues in designing the MAPI Spooler, it cannot
properly work with client applications that are services. For instance, the Spooler may not be able
to access Mail Profiles due to incorrect security context, and may not receive new message
notifications from a message store provider by way of window messages (every service runs in its
own virtual desktop and window messages do not propagate between desktops). Because
DS-Client runs as a service on Windows, it must not use the MAPI Spooler. This means DS-Client
notifications will forever remain in the Outbox of the message store provider unless the latter is
tightly coupled to a transport provider, so that the two can work out between themselves how to
send the message without the intervention of the MAPI Spooler.
At this time, only the Microsoft Exchange Server mail client is known to offer tightly coupled
message store and transport.
You can specify the message store and transport to be used by DS-Client by creating a Mail
Profile (see next section) and selecting it in DS-User Configuration (See “Configure the E-Mail
Notification Setup” on page 30.).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 331
Confidential.
Knowledge Base: SETUP
To use DS-Client with non-tightly coupled transports, such as Internet Mail, you can force
DS-Client to use the MAPI Spooler by setting the Registry value
• [HKEY_LOCAL_MACHINE \ System \ CurrentControlSet \ Services \
DS-Client \ Parameters]
• MailUsingSpooler
to a nonzero DWORD value. Keep in mind that such use is not supported by Windows architecture
and errors are bound to ensue. Make sure no other MAPI client applications are executed on the
DS-Client computer.
How to Create a Mail Profile for DS-Client
1. Have a mail account created on the mail server for use by DS-Client.
2. Login to the DS-Client computer using the <<DS-Client service account>>.
• If the DS-Client computer is running Windows, it is the account found in the
Services Control Panel for ASIGRA Televaulting service. Don't forget to select
the correct domain when logging in.
3. While logged in with the DS-Client service account, install your mail client (if not
already installed) and use it to create a new (or edit an existing) Mail Profile.
• a. Add to the Mail Profile a messaging service that includes a tightly coupled
message store and transport, such as Microsoft Exchange Server, and
configure this messaging service to use the mail account created in step 1;
• b. Specify a message store added in 3.a as the default message store;
• c. Move transports added in 3.a to the top of the transport order;
• d. Specify the default address book of your choice;
• e. Save the Mail Profile, start a mail application, configure it to use the Profile
just created and proceed to send a test message.
Once you have successfully tested your Mail Profile, you may configure DS-Client to use it. (See
DS-User Guide: Notification Tab).
Notes
1. ASIGRA strongly recommends using SMTP notifications.
2. Certain mail clients (e.g. Eudora Mail) may replace the MAPI Stub Library (MAPI32.DLL) with a
version that does not support the Extended MAPI interface. If this happens, reinstall Microsoft
Outlook.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 332
Confidential.
Knowledge Base: SETUP
SNMP Notification
Creation Date: May 27, 2002
Revision Date: August 22, 2005
Product:
DS-Client
Traps
ASIGRA Televaulting software can send traps as notifications in case the following events occur:
DS-Client
• Backup failed
• Backup completed with errors
• Backup completed without error
For DS-Client, a trap will be sent once, immediately after each backup activity finishes.
In addition, DS-Client can be configured to send a special trap as a "heartbeat" signal (at a
user-defined frequency). This signal can be used to determine if the monitored ASIGRA
Televaulting service is running normally.
DS-Client SLA Monitor
DS-Client SLA Monitor tool can be configured to send traps after it receives the following events
from DS-Clients (the events are already processed by the event filter):
• Backup completed with critical errors
• Backup completed with intermediate errors
• Backup completed normally
Further information (backup set name and DS-Client name) about this backup activity is in the first
VarBind parameter coming with the trap. For example, in HP OpenView, you can use "$1"
parameter in event message setting to retrieve the first VarBind data.
ASIGRA MIB
The MIB (Management Information Base) file for ASIGRA Televaulting can be found in the
DS-Client installation directory (filename: asigra.mib). This file describes how the objects are
organized.
ASIGRA’s IANA Private Enterprise Number is 15538. Check http://www.iana.org/assignments/
enterprise-numbers.
Configuration
DS-User
From main menu, choose "Setup > Configuration > SNMP" to configure DS-Client SNMP settings
(destinations). Notification events are configured per backup set ("Sets > Backup Sets >
Properties > Notification"). For more details, use the on-line help for these dialogs.
DS-Client SLA Manager
In the notification tab, check "Send SNMP trap" or click "SNMP settings" button to open SNMP
configuration dialog. For more details, use the on-line help for the dialog.
Configuration Sample (With HP OpenView)
Load asigra.mib into HP Openview.
1. Options > load/unload mibs: snmp >load from disk
2. After that, two new categories (enterprises) can be found in event configuration dialog.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 333
Confidential.
Knowledge Base: SETUP
Configure DS-Client Events
1. Options > event configuration
2. Choose DS-Client from enterprises portion. There are 4 options in event list for
enterprise DS-Client
• Clientbackup completed
• Clientbackup completed with errors
• Clientbackup failed
• Client Heartbeat
3. You can modify these events by double-clicking these specific events, setting event
message actions, severity level and event log messages.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 334
Confidential.
Knowledge Base: SETUP
Setting up the Novell NetWare Client on the DS-Client
computer
Creation Date: April 7, 1999
Revision Date: January 23, 2008
Product:
DS-Client (Windows)
Summary
If you wish to backup and restore NetWare file systems (including NDS, Trustees, etc.) the
DS-Client computer must have the Novell NetWare client loaded.
Windows
For DS-Clients running on Windows, Novell's NetWare client v.4.9.1 SP2 or higher is required.
Conclusion
Once the appropriate Novell NetWare client is installed, the DS-Client will be ready to backup/
restore NetWare servers (with all features, including security).
See Also
“Backup / Restore of Novell NetWare files from a Windows DS-Client” on page 407
“Backup / Restore of Novell NetWare files from a Linux DS-Client” on page 408
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 335
Confidential.
Knowledge Base: SECURITY
Knowledge Base: SECURITY
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 336
Confidential.
Knowledge Base: SECURITY
Digital Signature Verification
Creation Date: October 7, 1997
Revision Date: February 21, 2008
Product:
DS-Client
Summary
In order to ensure integrity of the data that the DS-Client backs up and restores on a customer
network, a digital signature is created and attached to every file that the DS-Client transfers to the
DS-System. A digital signature represents 128-bit code that identifies data within the file. Even a
one-bit change to a file will produce a different digital signature.
Digital Signatures are used for several processes:
• “Digital Signature during Restore” on page 337
• “Digital Signature during Validation” on page 337
• “Verify Digital Signature (option on Demand Backup)” on page 337
Digital Signature during Restore
During a restore operation, the DS-Client recreates the digital signature and compares it to the one
attached to the file. This verifies that the file content is exactly the same as that which was backed
up. This is especially important when restoring databases, Registry, NDS and other types of data
where even one-byte changes can make the data useless or even harmful.
Digital Signature during Validation
Validation uses the Digital Signature to verify the integrity of the online file.
• For more information see Knowledge Base Article “Validation Overview” on
page 396.
Verify Digital Signature (option on Demand Backup)
[Windows DS-Clients only]
During a Demand Backup, you have the option to select “Verify signature for unchanged files”.
This feature is intended as a troubleshooting tool. If you use it, DS-Client will read the digital
signature from the latest on-line generation of each unchanged file, and compare it with the digital
signature that is generated from the current source file. If the signatures do not match (this should
not occur often, or even at all), DS-Client will re-backup that file in that same backup session.
• This option is available for file system, E-Mail (DS-MLR) and System i Server
backup sets.
• This option will apply only to latest generation of the files.
• This option cannot be used in conjunction with the “Use Buffer” option.
If you use this feature, backup performance will slow by a significant amount, since the files that
would otherwise be ignored must be processed.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 337
Confidential.
Knowledge Base: SECURITY
DS-Client Encryption Keys
Creation Date: October 7, 1997
Revision Date: March 26, 2008
Product:
DS-Client
Summary
In order to secure customer information that is transferred to the DS-System, the DS-Client
encrypts every file it sends to the DS-System with encryption keys provided by the customer. The
files are stored and remain encrypted on DS-System storage at all times. The decryption process
occurs during the restore operation on the DS-Client itself. This ensures that any information
transferred and stored outside the customer location is always encrypted. Currently, the DS-Client
uses either the DES encryption algorithm (56-bit encryption key), or AES encryption algorithm
(128-bit, 192-bit, or 256-bit).
• “Configuration and Location of Encryption Keys” on page 338
• “DS-Client Encryption Key Types and Usage” on page 338
• “Encryption Key Verification” on page 338
• “Retrieving the DS-Client Encryption Keys” on page 339
• “AES Disclaimer” on page 339
Configuration and Location of Encryption Keys
The DS-Client encryption keys are configured during DS-Client installation or with the DS-Client
configuration program (dsconfig.exe: START > Programs> ASIGRA Televaulting > DS-Client
Setup). Encryption keys are stored in the DS-Client database in encrypted form, so even a person
with full access to the DS-Client computer (like administrators) cannot find out the values of the
encryption keys.
For Grid DS-Clients, all DS-Clients in the same Grid must be configured with the same Private and
Account Encryption Keys (both Types and Values).
DS-Client Encryption Key Types and Usage
The DS-Client can be configured with two encryption keys: a private key and an account key:
Private Key
(Mandatory)
This is a default encryption key that always used by the DS-Client except in the cases outlined below.
Account Key
(Optional)
If the customer account has more than one DS-Client installation, each DS-Client for this
customer account must be configured with the same account key.
A DS-Client that is configured with the wrong (or no) account key will not be granted connection to DS-System.
The account key is used to encrypt customer files if the DS-Client discovers (during the
backup process) that a backup file was already backed up to the DS-System by another
DS-Client within same customer account. In this case, the file will be located in the account
library area and encrypted with the account key.
Encryption Key Verification
In order to ensure that the DS-Client uses the same encryption keys as were initially configured
(reinstalling DS-Client or hackers), the DS-System is able to verify the DS-Client key integrity on
every connection. This is accomplished by comparing the encryption cookies (code generated
with the encryption key, but not the key itself) that the DS-Client sends on every connection
request, with the cookies that the DS-System received during DS-Client registration.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 338
Confidential.
Knowledge Base: SECURITY
Intentional or unintentional changes to the encryption keys will make data stored on the
DS-System unusable. This verification process ensures integrity of both private and account keys
(account key verification ensures that all DS-Clients for the same customer account are configured
with the same account key).
Retrieving the DS-Client Encryption Keys
The DS-Client has the capability to forward its encryption keys to the DS-System for safekeeping.
This option must be enabled by your Service Provider.
• For more details, see “Encryption Key Safeguarding at the DS-System” on
page 27.
AES Disclaimer
The DS-Client integrates Dr. Brian Gladman’s implementation of the AES (Rijndael) algorithm
designed by Joan Daemon and Vincent Rijmen.
This implementation is referenced in the information on the AES development efforts on the
Computer Security Resource Center website maintained by NIST (National Institute of Standards
and Technology - USA). For more information please visit the following URLs:
http://csrc.nist.gov/CryptoToolkit/aes/rijndael
http:/fp.gladman.plus.com/cryptography_technology
Here is the copyright notice for Dr. Brian Gladman’s implementation:
------------------------------------------------------------------------Copyright (c) 2001 Dr Brian Gladman <[email protected]>, Worcester, UK
TERMS
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
1.Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2.Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
This software is provided 'as is' with no guarantees of correctness or
fitness for purpose.
-------------------------------------------------------------------------
See Also
“Encryption Key Safeguarding at the DS-System” on page 27
“DS-Client to DS-System Authentication” on page 340
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 339
Confidential.
Knowledge Base: SECURITY
DS-Client to DS-System Authentication
Creation Date: April 30, 1997
Revision Date: September 26, 2002
Product:
DS-Client
Summary
In order to prevent unauthorized access to the DS-System, several protection layers are
implemented on the DS-System computer to ensure that only authorized computers are able to
gain access to DS-System storage. Those protection layers can be divided into following
categories:
Network access layer
1. Outside connections can only be initiated on a separate network interface with the
TCP/IP protocol.
2. The only TCP and UDP ports enabled are those used by the DS-System and
DS-Client services.
3. The incoming DS-Client connection's IP address (or range) is validated against the
DS-Client profile (optional).
4. User ID and password validation is performed for dialup connections (T1/ISDN
access).
5. CLID (caller ID) validation is performed for T1/ISDN access (optional).
Configuration layer
1. The DS-Client must pass valid Customer Account and DS-Client numbers to the
DS-System.
Registration layer
1. The DS-Client performs an automated, one-time registration with the DS-System (if
"requires registration" is selected).
• The registration is performed automatically on the first DS-Client connection
to the DS-System.
• If re-registration is required, a registration request must be explicitly enabled
by the DS-System operator at the request of the DS-Client user.
2. The Registration process passes information constructed from the DS-Client
computer's hardware and system on every connection request.
• Once a DS-Client is registered, the DS-System can optionally validate
DS-Client registration information for every subsequent connection attempt.
Registration validation provides a high level of confidence that the DS-Client
computer attempting to connect is the same computer that performed the
registration.
3. The DS-Client registration validation will fail in the following circumstances:
• if you reinstall the Operating System of the DS-Client computer
• install the DS-Client on a different computer
• boot a different Operating System on the DS-Client computer (e.g. if you have
a dual-boot machine.)
• change hardware components like the system hard drive or network card
Encryption authentication layer
1. Encryption Key Cookies:
• The Registration process also saves encryption key cookies (meaningless
data encrypted with DS-Client keys, that are passed on every connection
request) that the DS-System validates on each connection attempt. This
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 340
Confidential.
Knowledge Base: SECURITY
prevents a DS-Client from connecting to the DS-System with changed or
corrupted encryption keys.
Additional conditions for connection request failure
1. Customer Account or DS-Client does not have 'active' status.
2. DS-System shutdown is in progress.
3. DS-System activities are disabled.
4. DS-Client Service period violation (service period expired).
5. Account Key required and not configured for customers with multiple DS-Clients.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 341
Confidential.
Knowledge Base: SECURITY
Logon Impersonation and Integrated Security
Creation Date: October 7, 1997
Revision Date: January 23, 2008
Product:
DS-Client (Windows)
Summary
When the DS-Client is installed and deployed on the Windows platform, it uses the Logon
Impersonation feature. This feature allows the DS-Client to perform backup/restore activities under
the security context of that particular user account. Several such activities can be performed
simultaneously, each under a different (or the same) user account, connecting to a different (or the
same) network resource. This feature is especially valuable (and sometimes even essential) when
connecting to resources on a Microsoft Windows Network.
Connecting to resources on a Microsoft Windows Network
When supplying credentials to a resource on a Microsoft Windows Network, the 'from' value
determines if the user account should be authenticated (if the 'from' value is not <None>) or if a
simple connection to the network resource should be made with the supplied credentials.
Microsoft Developer Network's definition of Impersonation is: "... the ability of a
thread to execute in a security context different from that of the process that owns
the thread ... [thereby allowing] ... the server thread to act on behalf of that [process]
Logon Impersonation. to access objects or validate access to its own objects."
In ASIGRA Televaulting, "logon impersonation" is the DS-Client's ability to run under a
different security context for each backup set, as specified in the "Connect As" field
(Sets Menu > Backup Sets > Properties > Share Tab).
When the 'from' value is something other than <None> (e.g. represents a server or a
domain), the DS-Client will perform user account authentication and logon impersonConnecting with inte- ation before connecting to the network resource. This allows the network server to see
grated security.
the incoming connection as if it were established by that user account. This is essential
to successfully connect to network resources such as MS SQL server and MS Exchange
server that use integrated security to validate user access.
Connecting without
integrated security.
When the 'from' value is <None>, the DS-Client performs logon impersonation of the
user account under which the DS-Client service is running (this is necessary in order to
allow simultaneous connections to the same network server). Then, the DS-Client connects to the network resource with the supplied credentials.
Connecting to resources on other networks
When connecting to resources that are not on a Microsoft Windows Network, the DS-Client
performs the same steps as in 'Connecting without integrated security'. If connecting to NetWare
servers, the 'from' value is used as a context in NDS authentication.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 342
Confidential.
Knowledge Base: SECURITY
User Rights and Privileges
Creation Date: October 14, 1997
Revision Date: March 21, 2008
Product:
DS-Client (Windows)
Summary
When the DS-Client is installed and deployed on the Windows platform, it uses the User Privileges
feature. The DS-Client attempts to activate specific user privileges when performing backups or
restores of a Windows computer. Those privileges are applied for each activity (thread) under the
supplied user's credentials. To successfully activate those privileges, the user account must have
user rights enabled for that privilege (in 'User Manager'). Depending on the server configuration,
failure to activate those privileges may not permit the backup/restore to be performed successfully.
Privileges used by the DS-Client
•
Back up files and directories - SE_BACKUP_NAME
•
Allows a user to back up the files, directories and registry of a computer. This right
supersedes files, directory and registry permissions. Used in the backup process.
Restore files and directories - SE_RESTORE_NAME
•
Allows a user to restore the files, directories and registry of a computer. This right
supersedes files, directory and registry permissions. Used in the restore process.
Manage auditing and security log - SE_SECURITY_NAME
Allows a user to manage the auditing of files, directories, and other objects. Used by the
backup and restore processes to backup/restore security information (auditing portion
of ACL).
See Also
See “Logon Impersonation and Integrated Security” on page 342.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 343
Confidential.
Knowledge Base: SECURITY
Encrypting your Network Credentials
Creation Date: December 10, 2005
Revision Date: December 10, 2005
Product:
DS-Client
Summary
If you want to distribute credentials without telling the recipient the actual password to a network
resource, DS-Client can accept input from an encrypted file. All the recipient needs to know is the
key (password) that unlocks the file.
For example: If your Service Provider is managing the DS-Client, and you do not want them to
know the credentials, you can create an encrypted file (default filename: backup.key). You can
supply this file to your Service Provider and tell them the password to use the backup.key.
The backup.key file can be used in the Enter / Modify Credentials screen.
1. Create an encrypted file.
• A software tool (filename: MakeKey.jar) is supplied for you to make the
backup.key file.
• MakeKey.jar is located in the DS-User or DS-Client folder (the Java 2
Runtime Environment Version 1.4.2 or later must be installed on the local
computer).
• Double click on the application icon and enter the information.
2. Give the file to your service provider and tell them where to use it. They need to know
the key that unlocks the file.
• Multiple encrypted key files can be created. Using descriptive names can help
recipients know the right key to use.
• If you want, you can use the same password (unlock key) for different backup
key files, according to your requirements.
3. The encrypted file can be used when creating or editing backup sets.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 344
Confidential.
Knowledge Base: ADMINISTRATION
Knowledge Base:
ADMINISTRATION
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 345
Confidential.
Knowledge Base: ADMINISTRATION
DS-Client Advanced Configurations
Creation Date: March 20, 2008
Revision Date: March 26, 2008
Product:
DS-Client
Summary
WARNING:The default settings are sufficient to run any DS-Client. Do not attempt to change
these settings, unless you have a specific requirement and have confirmed this with your
Service Provider.
The Advanced Configuration option contains a list of parameters that can fine-tune how the DSClient behaves. To access the Advanced Configurations settings:
1. From DS-User Setup Menu > Configuration.
2. In the DS-Client Configuration screen, select the “Advanced” tab.
3. Parameter values can only be edited. The parameters screen is slightly different,
depending on the type of DS-Client:
• “Windows DS-Client parameters” on page 347
Note: Windows DS-Clients have additional settings for Grid DS-Clients (Global parameters and
Leaf-Node-Specific parameters). Some parameters can only be Global, while others can
be both. These differences are noted in the table.
• “Linux / Mac DS-Client parameters” on page 353
WARNING:If you change any of these parameters, they will significantly change DS-Client
behavior (performance). Changes to some parameters only take effect after the DS-Client
restarts.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 346
Confidential.
Knowledge Base: ADMINISTRATION
Windows DS-Client parameters
•
•
•
•
•
•
“Category: NOTIFICATION” on page 347
“Category: MISCELLANEOUS” on page 348
“Category: COMMUNICATION” on page 350
“Category: ADMIN” on page 350
“Category: PERFORMANCE” on page 351
“Grid DS-Client Only - Local Setting” on page 352
Category: NOTIFICATION
Parameter
Global / LeafDescription / Values
Node-Specific
Global only
This parameter configures the Free Memory Warning Level. If the DS-Client free memory falls to equal or below this level, DS-Client will start
issuing Low Memory Warning Notifications.
• Default: 30 (30%)
• Range: 10 to 100
MemEmergencyLevel Global only
This parameter configures the Free Memory Emergency Level. If the DSClient free memory falls to equal or below this level DS-Client will start
issuing Low Memory Emergency Warning notifications.
• Default: 20 (20%)
• Range: 5 to 100
MemWarningFreq
Global only
This parameter value (in hours) configures the interval at which regular
Low Memory Warning Notifications will be issued by DS-Client.
• Default: 4
• Range: 1 to 24
Global only
This parameter value (in hours) configures the interval at which regular
Low Memory Emergency Warning Notifications will be issued by DS-Client.
• Default: 1
• Range: 1 to 6
Global only
This parameter value (in MB) configures the Minimum amount of free
space reserved in the DS-Client Database. Low space checking will not
count this reserved space as free space.
• Default: 100
• Range: 10 to 500
Global only
This parameter value (in %) sets the Warning level for DS-Client Local
Storage root. If the DS-Client Local Storage free space falls equal or
below this level DS-Client will start issuing Warning Notifications.
• Default: 300 (3%)
• Range: 1 to 10,000
Global only
This parameter value (in %) sets the Emergency Warning level for DS-Client Local Storage root. If the DS-Client Local Storage free space falls to
equal or below this level DS-Client will start issuing Emergency Warning
notifications.
• Default: 30 (0.3%)
• Range: 1 to 10,000
Global only
This parameter value (in hours) configures the interval at which regular
Low Local Storage Warning Notifications will be issued by DS-Client.
• Default: 4
• Range: 1 to 24
MemWarningLevel
MemEmergencyFreq
DBReserveSpace
OLWarningLevel
OLEmergencyLevel
WarningFrequency
EmergencyFrequency Global only
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
This parameter value (in hours) configures the intervals after which regular Low Local Storage Emergency Warning Notifications will be issued
by DS-Client.
• Default: 1
• Range: 1 to 6
Generated on: 3/28/08
Page: 347
Confidential.
Knowledge Base: ADMINISTRATION
Category: MISCELLANEOUS
Parameter
Global / LeafDescription / Values
Node-Specific
When this parameter is set to "YES", then in the New Backup Set Wizard
(for File System & Permissions Only Backup Sets) you can see the
"Backup as POSIX" checkbox.
"Backup as POSIX" can only be selected when you create a new backup
set. It cannot be configured from backup set properties.
• No = OFF (default)
• Yes = ON
ShowPOSIX
Global only
DebugMessage
If this parameter is set to a value other than 0, more detailed error
Can be either messages will be reported in the DS-Client Event Log. The default value
of this parameter is 0.
AllowScheduledBackGlobal only
upCheckSignature
Configures scheduled backups to use the "verify signature for unchanged
files." feature.
By default scheduled backups do not verify the signatures of unchanged
files on the backup source. If this parameter is set to "YES", then scheduled backups will verify the signatures of unchanged files on the backup
source. Turning this option ON can have significant implications on the
performance of the DS-Client.
• No = OFF (default)
• Yes = ON
MaxErrors
Global only
Default maximum number of errors to stop a backup activity.
By configuring this parameter you can set the default maximum number
of errors for a backup activity. If a backup activity reaches this number
of errors, it will be stopped automatically by the DS-Client. This parameter only applies to backup activities.
• range 1 to 9999, default is 500
ScheduleMiss
Global only
(Hours) - This is the period in which missed schedules will be triggered
by the DS-Client, even after the actual scheduled time.
• range 1 to 16, default is 6
AllowLocal
Global only
If set to "YES", it allows the execution of local commands during Pre/
Post Activities. You must be an administrator and have this option
enabled, in order to enable the Pre/Post Activities. If this parameter is
changed, it takes effect next time the DS-User GUI connects to DS-Client Service.
• No = OFF (default)
• Yes = ON
RemoteExecutionTimeout
Global only
(Minutes) - This parameter configures the default timeout period of DSClient for Remote Command Execution during Pre/Post Activities.
• range 1 to 1440, default is 60
SecurityDll
Can be either
Path to a third party security DLL to secure the communication. By
default, this path is empty.
Global only
This parameter only applies to time consuming Database queries known
by the DS-Client. The value (in hours) sets the longest Database query
timeout period. If a Database Query takes more time than this parameter value, it is aborted by the DS-Client.
• Default: 18
• 0=Unlimited Timeout
• Range: 0 to 19
DBQueryTimeout
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 348
Confidential.
Knowledge Base: ADMINISTRATION
Global only
This parameter value (in seconds) sets the default Database query timeout.
• Default: 500
• 0=Unlimited Timeout
• Range: 0 to 65535
WaitConfirmation
Global only
(Seconds) - This parameter value sets the time the DS-Client will wait
for file confirmation from the DS-System if a backup activity is stopped.
• Default: 60
• Range: 0 to 3600
HclnfsRemapShare
If yes, try re-mapping the connection in case of connection problems for
some HummingBird Client versions. By default (with selection of "Auto")
DS-Client will set this based on known versions that have this problem.
Can be either
• No = OFF
• Yes = ON
• Auto = Let DS-Client decide (default, RECOMMENDED)
HclnfsSkipLink
If yes, skip links to avoid handle-leak problems for some HummingBird
Client versions. By default (with selection of "Auto") DS-Client will set
this based on known versions that have this problem.
Can be either
• No = OFF
• Yes = ON
• Auto = Let DS-Client decide (default, RECOMMENDED)
HclnfsSkipLongPath
If yes, skip long path for some HummingBird Client versions that have
long path support problems. By default (with selection of "Auto") DS-Client will set this based on known versions that have this problem.
Can be either
• No = OFF
• Yes = ON
• Auto = Let DS-Client decide (default, RECOMMENDED)
DBQueryDefaultTimeout
AllowAutoConfig
ForceBackupCheckSignature
LocalDriveAllowed
Global only
Allow DS-Client to apply Auto-configuration from the file “configupdate.xml”.
• No = OFF (default)
• Yes = ON
Global only
If yes, force all applicable backup sets to check signature for unchanged
files. The checking will be performed once during the next backup of
each backup set. This setting applies only once. This means, as soon as
you select "Yes" and apply, it will immediately take effect and the value
is changed to "No" again.
• No = OFF (default)
• Yes = ON
Global only
This parameter value will configure the Local Drive Filter Flag for
Backup. By changing this parameter value you can control the Drives
available for backup in the New Backup Set Wizard (applicable only to
File System & Permissions Only backup sets).
The default value for this parameter is -1, allowing all the available
local drives. This value is converted from decimal to binary to determine if a drive is allowed (“1” means allowed, “0” means disabled).
For example: to allow only ‘C’ and ‘E’ drives, use the value “20”
... F E D C B A [drive letter map]
... . 1 0 1 0 0 [binary]
... . . . . 2 0 [decimal value]
The binary representation of “20” matches bit0 for 'A:' disabled, bit1 for
'B:' disabled, bit2 on - 'C:' allowed, etc.
•
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Note for Grid DS-Client, this parameter has no effect.
Generated on: 3/28/08
Page: 349
Confidential.
Knowledge Base: ADMINISTRATION
Category: COMMUNICATION
Parameter
Global / LeafDescription / Values
Node-Specific
DialUser
Global only
This parameter configures the Dial-up username for DS-System Connection. This is only applicable if you are using Dial Up connection to
connect to DS-System
Global only
This parameter configures the interval after which the network connection with DS-System is checked regularly by the DS-Client having
schedule(s) configured with the option of verify network connection.
This is particularly useful for DS-Client installed on portable devices.
LaptopCheckInterval
DSSystemAlternatePort Global only
TcpSocketBuffer
Default value of this parameter is 4401. This parameter configures the
Alternate port to connect to DS-System.
The value of this parameter is in Bytes. This value is used if it is bigger
Can be either than the default TCPWindowSize. Default value of this parameter is
24*MSS=0x87C0 (34752) Bytes
This parameter configures flags about the communication encryption
between DS-Client and DS-System or DS-Client and DS-MLR. It is a bitwised value of the following:
CommunicationFlags
Can be either
DSSYS_OLD_STYLE
(0x1)
DSSYS_NEW_NONE
(0x2)
DSSYS_NEW_MARC4
(0x4)
DSMAIL_OLD_STYLE
(0x8)
DSMAIL_NEW_NONE
(0x10)
DSMAIL_NEW_MARC4 (0x20)
Default value of this parameter is 54. This value is computed as:
(DSSYS_NEW_NONE | DSSYS_NEW_MARC4 | DSMAIL_NEW_NONE |
DSMAIL_NEW_MARC4 )
Category: ADMIN
Parameter
DSCDBDumpPath
AdminSkipSync
AdminThreads
AdminSyncOrder
Global / LeafNode-Specific
Description / Values
Global only
This parameter configures the Dump path for DS-Client Database during admin activities. This path can be local or a UNC path. UNC is recommended for Grid DS-Clients.
• If not set, the default dump path will be the DS-Client Buffer.
Global only
Skip synchronization of backup sets during Weekly Admin if no database inconsistencies are detected.
• No = OFF
• Yes = ON (default)
Global only
This parameter configures maximum number of synchronization
threads during weekly admin.
• Range: 1 to 8
• Default Value: 1
Global only
Specifies the order in which backup sets will be synchronized during
Weekly Admin. Possible values are:
• No specific order enforced
• Bigger sets first (ones that contain more backup items) (default)
• Smaller sets first
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 350
Confidential.
Knowledge Base: ADMINISTRATION
Category: PERFORMANCE
Global / LeafNode-Specific
Description / Values
Global only
If this parameter is set to "YES" then the SQLite Database File is
cached to improve the speed. By default this parameter is set to
"YES".
• No = OFF
• Yes = ON (default)
Can be either
This parameter configures the maximum concurrent activities supported by DS-Client. Increase the value of this parameter only if your
hardware can support additional processing.
For Grid DS-Client this parameter also refers to the Task Limit as seen
in DS-User: Grid Menu > Grid Status > List Tab for each Leaf/Node.
• range 1 to 99, default is 8 (32-bit Operating Systems) and 12 (64bit Operating Systems)
MaxThreads
Can be either
This parameter configures the maximum number of threads for each
backup activity. Increase the value of this parameter only if your
hardware can support additional processing.
• range 1 to 16, default is 8
MaxRestoreThreads
Can be either
This parameter configures the maximum number of threads for a
restore process.
• range 1 to 16, default is 6
Parameter
CacheSQLiteFile
MaxSessions
SkipCompressionOnGlobal only
CompressedFiles
If the value of this parameter is "YES", then DS-Client will skip compression on files identified as already being compressed. The delta
algorithm is also not applied. Files types identified as compressed are:
pk, zip, gif, png, Microsoft Cabinet Files, gzip, win, jpeg & jfif.
• No = OFF
• Yes = ON (default)
StatisticalCpuUsage
Global only
(%) - Limits the DS-Client's consumption of the computer's CPU during
statistical backups to this percentage.
• range 0 to 100, default is 70
Global only
(MB) - If the file size is bigger than this value, DS-Client maintains
additional meta-data during backup until a new generation is confirmed to have been saved on DS-System. This overhead is balanced by
the benefit of reducing the chance of sending the next generation as a
master in case the backup experiences unexpected failures.
• range 1 to 102400, default is 100 MB
Can be either
This parameter configures number of delta threads per backup
thread. If set to 0, Delta backup is singled threaded. If set to 1, a single thread does compression/encryption but it is separated from I/O
thread. If set to a value more than 1, then the Delta process is multithreaded.
• range 0 to 16, default is 2
Can be either
This parameter configures number of delta threads for file system
backups. If you only backup big files, this can improve speed. For
backup of small files, the default DS-Client backup threads are usually
sufficient.
• range 0 to 16, default is 0
Global only
Defines the number of records in one block for System i Server (formerly AS/400) backup sets. The bigger the block size, the more efficient the delta algorithm, but more memory will be required during
restore. The default is 100000 (about 50 MB).
BigMasterSize
DeltaThreads
DeltaThreadsFS
AS400BlockSize
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 351
Confidential.
Knowledge Base: ADMINISTRATION
DefaultCompression
Global only
For ZLIB Compression only: Enter 0-9, 0 = no compression (faster) and
9 = maximum compression (slower). Default value is 3.
MinDeltaSize
Global only
(KB) - Minimum file size for delta algorithm to apply.
• range 8 to 1048576, default is 32.
MaxDeltaSize
Global only
(GB) - Maximum file size for delta algorithm to apply. The bigger it is,
the more memory is needed for delta processing.
• range 1 to 102400, default is 512 (32-bit Operating System) and
4096 (64-bit Operating System)
MasterGenerations
Global only
Generate a master as defined by this value in order to avoid the delta
chain being too long.
• range 1 to 25, default is 10
MinDeltaGen
Global only
The minimum number of on-line generations required in order to process files as deltas. Enter 2 or 3. Default value is 3.
Global only
This parameter can be set as follows (selection is effective immediately):
• Bulk inserts disabled
• Bulk inserts from files allowed
• Bulk inserts from memory allowed
• Bulk inserts from files and memory allowed (RECOMMENDED)
(default)
Global only
Defines how often to retry the primary DS-System connection after
switching to a secondary connection (in hours). -1 never retries, 0
retries immediately.
• range -1 to 24, default is 24
DBBulkOptions
RetryPrimary
DBConnections
Can be either
(RESTART REQUIRED)
This parameter configures the number of DS-Client database connections to be created when DS-Client service is started. Changes to this
parameter only take effect after the DS-Client service is restarted.
• Default: 3
• Range: 1 to 16
Grid DS-Client Only - Local Setting
This parameter only appears for Grid DS-Clients, when you select “Local Setting”.
Parameter
Description / Values
DSCBuffer
DS-Client buffer path. This can only be a local path on the selected Leaf-Node of the
Grid DS-Client. The DS-Client service account must have full privileges for this location.
• The Global Value for the DS-Client buffer can be set from DS-User > Setup > Configuration > Parameters Tab.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 352
Confidential.
Knowledge Base: ADMINISTRATION
Linux / Mac DS-Client parameters
Category: ALL
Parameter
Description / Values
MaxSession Number
(RESTART REQUIRED)
Maximum concurrent activities supported by DS-Client. Increase if hardware can
support additional processing.
• range 1 to 99, default is 8 (32-bit Operating System) and 12 (64-bit Operating
System)
MaxThread Number
(RESTART REQUIRED)
Maximum number of threads for each backup activity. Increase if hardware can
support additional processing
• range 1 to 99, default is 2
Account Number
(RESTART REQUIRED)
The DS-Client Account Number. Used to connect to the DS-System.
• This is specified during installation. If this parameter is not correct, DS-Client
cannot connect to DS-System.
Client Number
(RESTART REQUIRED)
The DS-Client Number. Used to connect to the DS-System.
• This is specified during installation. If this parameter is not correct, DS-Client
cannot connect to DS-System.
MinDeltaGen
(RESTART REQUIRED)
The minimum number of on-line generations required in order to process files as
deltas. Enter 2 or 3. The default value is 3.
• range 2-3
Skip WeeklyAdmin Sync
Skip synchronizations during Weekly Admin if no database inconsistencies are
detected: 1: Yes, 0: No
• 0 = OFF
• 1 = ON (default)
Max AutoSync Number
The maximum number of synchronization activities that can run at the same time
during Weekly Admin. The default value is 1.
• range 1-7
RetryPrimary
Defines how often to retry the primary DS-System connection after switching to a
secondary connection (in hours). -1 never retries, 0 retries immediately.
• range -1 to 24, default is 24
AutoSync Order
Specifies the order in which backup sets will be synchronized during Weekly Admin
based on the estimated synchronization time:
• 0 = synchronize according to backup set ID
• 1 = big backup sets first - DEFAULT
• -1 = small backup sets first
AllowAutoConfig
Allow DS-Client to apply Auto-Configuration from the file "config-update.xml".
• 0 = OFF (default)
• 1 = ON
Skip Compress
Skip compression on files identified as already being compressed. The Delta algorithm is not applied either. File types skipped are: lzop, zip, standard linux compression, gzip, bzip2, scocompress, bzip, jpeg, jfif, png, and gif.
• 0 = OFF
• 1 = ON (default)
DB2 Client Library Direc- Specify the DB2 client library directory on the DS-Client machine. Please make sure
tory
the dynamic library <libdb2.so.1> resides in this directory.
(RESTART REQUIRED)
• For example: /opt/ibm/db2/v9.1/lib32/
See Also
“DS-Client Advanced Configurations” on page 40
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 353
Confidential.
Knowledge Base: ADMINISTRATION
Access to DS-Client & Remote Management of DSClient
Creation Date: October 14, 1997
Revision Date: December 03, 2007
Product:
DS-Client
Summary
The DS-Client software runs on Windows, Linux, and MAC computers (refer to the corresponding
installation guide for supported Operating System versions). All interactions with the DS-Client are
performed via the DS-User software, which is a GUI interface for DS-Client administration.
The DS-User software can run on any computer with the TCP/IP protocol installed. The DS-User
software can administer a DS-Client running on a local or remote computer (thereby providing
remote management over a TCP/IP connection, and even over the Internet). The DS-User (or user
that uses it) is required to provide valid credentials to the DS-Client for authentication before it is
able to perform any activity. The authentication method that the DS-Client uses for user access
validation depends on the DS-Client platform.
There are two different DS-User products that are included on the installation DVD:
1. Win32 DS-User: installed by default by the Windows DS-Client installation process.
This only works with Windows DS-Clients.
2. Java DS-User: installed by default on Linux and Mac by DS-Client installation
process. (It can also be installed on Windows computers using the separate “DSUser-Java“ installation.)
Access to DS-Client using Win32 DS-User
Win32 DS-User can only connect to Windows DS-Clients. Only one connection per GUI instance
is possible.
Access to DS-Client using Java DS-User
Java DS-User also allows users to connect to multiple DS-Clients from the same GUI instance,
allowing them to switch easily between DS-Client management sessions with one click. The DSClients can be on any platform (Windows / Linux / Mac), as long as they are visible on the network
from the DS-User computer.
DS-Client authentication of DS-User connections
A DS-Client performs logon validation (for DS-User sessions) with the local or domain user
account database (if applicable).
• For Windows DS-Clients, by default, only administrators or backup operators
are allowed access to the DS-Client.
• For Linux and Mac DS-Clients, by default, only "root" users are allowed
access to the DS-Client.
An administrator can configure the DS-Client with different user and group roles for access to DSClient. A DS-Client allows multiple, simultaneous DS-User connections, with the same or different
authentication.
• See “Configure DS-Client User and Group Roles” on page 37.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 354
Confidential.
Knowledge Base: ADMINISTRATION
Note
1. DS-Client uses the DS-User credentials as default credentials for network resources when creating
new backup sets.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 355
Confidential.
Knowledge Base: ADMINISTRATION
Activity, Event and Audit Logs
Creation Date: October 22, 1997
Revision Date: November 30, 2007
Product:
DS-Client
Summary
The DS-Client software logs all information about the activities performed (scheduled and
demanded) in the DS-Client database. This information is organized into four categories and can
be used to troubleshoot, monitor and report DS-Client activities. The DS-Client keeps this
information in its database for a period specified in the ‘Keep DS-Client logs' parameter of the
DS-Client configuration (DS-User > Setup Menu > Configuration: Parameters Tab).
Activity Log
The Activity Log contains a high-level summary of a particular DS-Client's activities (such as
backup or restore). This information can be viewed using the Activity Log Viewer, which contains
the following fields:
User Name
Shows the name of the user that performed the activity (empty if scheduled).
Type
Shows the type of activity (backup, restore, delete, ...).
Owner
Shows the name of the Owner of the Backup Set
Description
Shows the node, and backup set name.
Errors
Shows the number of errors that occurred during activity.
Start
Shows the date and time the activity started.
End
Shows the time of day the activity ended.
Duration
Length of time between the activity's start and end times.
Files
Shows the number of files that were affected by the activity.
On-Line
Shows the amount of data affected by the activity.
Completion
Shows the completion status of the corresponding activity. An Activity would have an incomplete status, if it was stopped by an event that did not allow it to complete. Such events are:
time limit, user stop, amount limit, too many errors, internal error, lost connection/didn't
connect to the DS-System and failed to connect to network resource.
ID
Activity's unique identification number.
Event Log
The Event Log contains detailed information (events) which was recorded during a particular
activity. It contains mostly error events that occurred during an activity. The Event Log also
contains entries for all DS-User logon/logoff attempts and errors that occurred outside of any
activity (like in schedule module). This information can be viewed with the Event Log Viewer or
from the Activity Log Viewer and it contains the following fields:
Icon
Shows the event type (Information, Warning or Error)
Time
Shows the date and time that the event occurred.
User
Shows the User Name of the user (if any) associated with the event
Category
Shows the category of the event (database, socket, system, ...)
Event #
Shows a numeric error ID code.
ID
Unique ID numbers used to distinguish one activity from another.
Text
May display additional information associated with the message (ex: the IP address of a connection).
Description
Shows a description of the event.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 356
Confidential.
Knowledge Base: ADMINISTRATION
Detailed Log
The Detailed Log contains a log of all files that were affected by a specific backup or restore
activity. Only those activities whose 'Detailed Log' flag is set, will have that information recorded.
This is set as follows:
• Scheduled backups: Backup Set Properties > Options Tab
• On-Demand backups: Backup Wizard > Select options for demand backup
screen
• Restores: Restore Wizard > Select Restore Options screen.
Detailed Log information can be viewed from the Activity Log Viewer.
Audit Trail
The Audit Trail contains a log of all modifications (additions, deletions and updates) made to the
DS-Client configuration information. This information includes DS-Client Setup, Backup Set, and
Schedule information. The DS-Client administrator can use these logs for troubleshooting and
auditing purposes. This information can be viewed with the Audit Trail and it contains the following
fields:
Time
Shows the time the modification occurred.
User
Shows the name of the user who performed the modification.
Operation
Shows the type of modification performed.
Table
Shows the table that was modified.
Description
Shows details of the modification that occurred.
Note
1. If a DS-Client fails to start due to a configuration, database or other error, it will record errors in the
Operating System Event Log:
•
•
•
For Windows, they can be seen in the Event Viewer.
For Linux, this is either /tmp/dsclient.err, or /tmp/dsclient.out,
or /var/log/messages.
For Mac, this is either /Library/Logs or /var/log.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 357
Confidential.
Knowledge Base: ADMINISTRATION
Customized Reports
Creation Date: February 11, 2008
Revision Date: February 11, 2008
Product:
Third-Party (For information only)
Summary
The Custom Reports feature allows you to create your own reports, based on the data provided
from the DS-Client database tables. This feature is meant for advanced users.
This requires a third-party application (either JasperReports or Crystal Reports), which means
you must have the development resources to create and compile the custom report templates.
The basic steps for this feature are as follows:
“Step 1. Create Customized Data” on page 290
• After this step is completed, you will have a Data Set file (XML) containing the
structure and data you chose for export.
• You can actually use the Data Set file to generate a one-time report.
• If you want to regularly generate a custom report, you must use the structure
of the data fields to create and compile a template file.
“Step 2. Create Customized Report (with Third-Party application)” on page 293
• This article gives general instructions on how to make the template.
• Refer to the corresponding third-party documentation for the most up-to-date
information.
“Step 3. View Customized Report” on page 294
• Once you have created a custom report template, you place it in the \report
subfolder of the GUI you are using. The GUI will then be able to generate the
custom report.
Creating the customized report template requires a third-party application. This depends on the
type of GUI you plan to use to view the report:
• “Java GUI (JasperReports)” on page 358
• “Win32 GUI (Crystal Reports)” on page 364
Java GUI (JasperReports)
You need to download and install the free JasperReports application from http://
www.jasperforge.org. These examples use v.2.0.2 of the JasperReports software.
1. With the exported Data Set (XML file), you must now use the third-party jasper tools to
create your custom report using the fields from the Data Set.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 358
Confidential.
Knowledge Base: ADMINISTRATION
2. Open the Jasper Report Designer, and start a new document.
3. A new blank document appears in the designer.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 359
Confidential.
Knowledge Base: ADMINISTRATION
4. “Data” menu > “Connections/Data Source”. A data source dialog appears. This dialog
allows you to configure the data source for the template.
5. Click “New” to create a new data source. A wizard appears.
6. Select XML file data source in the wizard, and click on Next.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 360
Confidential.
Knowledge Base: ADMINISTRATION
7. In the following screen:
•
•
Input the data source name
Select the XML data file (the one that was exported in “Step 1. Create
Customized Data” on page 290).
• Select “Use the report XPath expression when filling the report” option.
• Click Save to close the dialog.
8. Close the Data Source dialog.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 361
Confidential.
Knowledge Base: ADMINISTRATION
9. In the Jasper Report Designer, select “Data” menu > “Report Query”. The Report
Query dialog appears.
10. Select the “Report Query” Tab.
• Set the query language to “XPath”.
11. On the right-side of the dialog, you will see the structure of the XML File.
• Input a query in the form “/<root_element>/*” in the text edit area.
• In this example “backupsets” is the root element of the XML data file, thereby
requiring the query “/backupsets/*”.
12. The root element name may change for different XML data file.
root
element
input query here
field table
data fields
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 362
Confidential.
Knowledge Base: ADMINISTRATION
13. Expand the <> Item in the tree. You will see some sub-items in the tree. These are the
available data fields for your custom report.
14. Use your mouse to drag (any or all) these items to the field table.
15. Click OK to close the dialog. Now you can see those fields in the document structure
panel of the designer.
16. By default, all the fields are set to the java.lang.String type. For some fields this may
not be a suitable format. It will be apparent when you generate a test report.
• If you need to modify the Field Class Type to the correct type, right-click on a
field and click Edit.
• In the Add/Modify field dialog, you can set the correct field data type from the
“Field Class Type” list.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 363
Confidential.
Knowledge Base: ADMINISTRATION
17. Start designing the custom report. You can preview your design with the following
commands:
• “Build” menu > “JRViewer Preview”
• “Build” menu > “Execute (with active connection)”
18. When you are satisfied with the report design, click on “Build” menu > “Compile”.
• The report will be compiled into a “.jasper” file that is generated in the Jasper
installation path.
19. Once you have created the compiled .jasper report file, copy it to the \report
subdirectory of the Java DS-User folder (if it does not exist, create it).
20. Now you can generate the custom report from that DS-User installation.
•
See “Step 3. View Customized Report” on page 294.
Win32 GUI (Crystal Reports)
You need to purchase and install the Crystal Reports application from http://
www.crystaldecisions.com. These examples use v.10 of the Crystal Reports software.
1. With the exported Data Set (XML file), you must now use the third-party Crystal
Reports tools to create your custom report using the fields from the Data Set.
2. Open the Crystal Report and create a new Report.
•
Select Blank Report in the Welcome page. Click OK to continue.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 364
Confidential.
Knowledge Base: ADMINISTRATION
3. Click “Database” menu > “Database Export”. The Database Expert dialog appears.
4. Expand the “Create New Connection” item. Select “Database Files”.
5. Expand “Database Files”.
• An Open File dialog will appear if this is the first time you create a database
file data source.
•
Otherwise, Double click “Find Database File” below the Database Files item.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 365
Confidential.
Knowledge Base: ADMINISTRATION
6. Select the XML data file (the one that was exported in “Step 1. Create Customized
Data” on page 290). Click Open to close the dialog.
7. In the Database Expert dialog, one new sub-item appears in the tree under the
“Database Files” item. Select “Item” in the Available Data Sources list and click the “>”
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 366
Confidential.
Knowledge Base: ADMINISTRATION
button. The new database file appears in the Selected Tables list.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 367
Confidential.
Knowledge Base: ADMINISTRATION
9. Click OK to return to the main window.
10. In the Field Explorer, you can find the database fields in the XML file.
11. Now you can start designing the custom report.
Note:
All the fields are “string” in the table. You may need to create some Formula fields for
fields that are not string.
12. After you finish designing, you will get a “.rpt” file.
• Copy this file to report sub-directory in the DS-User installation path.
13. Now you can generate the custom report from that DS-User installation.
•
See “Step 3. View Customized Report” on page 294.
See Also
“Custom Reports” on page 290
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 368
Confidential.
Knowledge Base: ADMINISTRATION
Administrative Processes
Creation Date: April 29, 1997
Revision Date: January 11, 2007
Product:
DS-Client
Summary
The DS-Client software has been designed for unattended operation, which is both self-tuning and
self-maintaining. In order to accomplish these tasks, the DS-Client performs regular administrative
processes. These processes clean, tune and backup the DS-Client database, create statistical
data, and verify backup sets with the DS-System's actual online storage.
Types of Administrative Processes
Type
Description
Local
Performs activities that do not require a connection to the DS-System. This type of administrative
process is always performed and cannot be disabled. (A Local Admin runs every time that the
DS-Client starts, once every 12 hours since the previous Admin, or every 24 hours.)
Daily
Performs all Local activities (see above), a verification of backup sets (see Detailed Activities
below) and transfers the DS-Client database dump to the DS-System. A Daily Admin process can be
disabled or configured to run at a specific time (Setup Menu > Configuration > Parameters Tab).
Weekly
Performs all Daily activities and a low-level synchronization of backup sets (see below). A Weekly
Admin process can be disabled or configured to run at a specific date and time (Setup Menu > Configuration > Parameters Tab).
Configuration and Scheduling of Administrative Processes
Default Configuration
The default administrative configuration (which can be changed from Setup Menu > Configuration
> Parameters Tab) will have the following settings:
• The Daily Admin process is scheduled to run every day at 6:00 AM.
• The Weekly Admin process is scheduled to run every Sunday at 6:00 AM.
Automated reboot
An automated system reboot can be performed after the admin process. This option is turned off
by default, but can be reconfigured (Setup Menu > Configuration > Parameters Tab). It is
recommended that this option be turned on if the DS-Client computer performs unattended
scheduled backups and does not normally shut down. This will refresh computer resources and
memory leaks (if any have occurred).
Execution of Administrative processes
No other activities (backup, restore, etc.) are allowed while an Admin process executes.
Therefore, any demand activity will be rejected. If an activity is executing at the time the admin
process is scheduled, the admin process will wait for all activities to terminate.
During this time (waiting for activities to terminate) new activities can still be executed. Therefore it
is possible that the scheduled Admin process never gets the opportunity to run (i.e. in the unlikely
event that you have scheduled backups that run 24hrs/7days a week).
Who should perform Administrative processes?
It is recommended that you schedule the DS-Client to perform Daily and Weekly administrative
processes wherever possible for all DS-Client configurations (i.e. Typical or Custom installation on
LANs as well as on Standalone PCs). If it is not possible to schedule Admin processes, you should
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 369
Confidential.
Knowledge Base: ADMINISTRATION
manually execute a Daily or Weekly Admin occasionally (Setup Menu > System Activities
Administration dialog).
Administrative Process Activities Description
Activities Matrix
The following table shows administrative activities in the order that they are performed, and the
administrative processes that perform them. The DS-System column indicates whether a
connection to the DS-System is required for that activity.
Activity
Local
Daily
Weekly
1. Prepare database dump
X
X
X
2. Clean database
X
X
X
3. Update statistical data
X
X
X
4. Verify backup sets
X
X
5. Transfer database dump
X
6. Synchronization (Normal)
7. Send daily email notification
X
X
DS-System
X
X
X
X
X
X
Detailed Activities Description
1. Prepare database dump.
• [MS SQL Server] This activity depends on the selection for “Keep DS-Client
database dump file” (Setup Menu > Configuration > Parameters):
a) [Do not delete] Save the previous dump, dump the DS-Client database and dsdelta
database, run database consistency checks (DBCC). If a fatal error occurs, restore
the previous dump, otherwise the previous dump will be deleted.
b) [Delete after successful backup] Save the previous dump (if it exists). Dump the
DS-Client database and dsdelta database, run database consistency checks (DBCC).
If a fatal error occurs, restore the previous dump (if it exists), otherwise the previous
dump will be deleted.
c) [Always delete] Dump the DS-Client database and dsdelta database, run database
consistency checks (DBCC).
Note: For more details, see “Database Dump method (MS SQL Server)” on page 371.
• [PostgreSQL] This step is not performed.
2. Clean the databases.
• Delete old history logs (activities, events and statistics), drop unused tables
and delete unused records.
3. Update statistical data
• Update statistical information for each backup set (number of files and on-line
amount).
• Update statistical information used by the storage summary.
4. Verify backup sets.
• Send a list of all backup sets to the DS-System. The DS-System will send
back a list of backup sets that:
a) Do not exist on the DS-System's disk or
b) Exist on the DS-System's disk but were not included in the DS-Client's list
• Update the information needed to recover backup sets falling into category 'b'.
5. Transfer database dumps.
• [MS SQL Server] Transfer database dumps to DS-System if Activity 1 was
performed successfully.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 370
Confidential.
Knowledge Base: ADMINISTRATION
•
[MS SQL Server] Delete database dumps if Activity 1 (b) or (c) was selected
(from Setup Menu > Configuration > Parameters).
• [PostgreSQL] Instead of transferring a dump, the database is backed up via
Pipe to DS-System.
6. Synchronization (Normal).
• Perform synchronization check for all backup sets that are not in category 'a'
or 'b' of Activity 4. (Note this is the same as a 'Normal' synchronization.
However, any synchronized files will retain an 'active' backup status.)
7. Send daily email notification.
• If the DS-Client is configured for email notifications with Daily Notification on,
a summary of backup activities will be sent to the administrator, showing a
summary of what occurred since the last admin process.
Database Dump method (MS SQL Server)
To speed up the Daily Admin process, Windows DS-Client uses differential backups if a full
database dump exists on the DS-System.
• DS-Client will always perform a full database dump during Weekly Admin.
• If Weekly Admin is disabled, a full database dump is performed during Daily
Admin every 6 days (the full backup rotates the day on which it occurs).
A differential backup creates a copy of all the pages in a database modified since the last full
database backup.
The database dump of dsclient and dsdelta will be composed of the following:
• xxxxxxxxxxxx.dmp (full backup)
• xxxxxxxxxxxx_diff.dmp (differential backup)
• dsdelta.dmp (full backup)
• dsdelta_diff.dmp (differential backup)
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 371
Confidential.
Knowledge Base: ADMINISTRATION
Weekly Admin and Synchronization
Creation Date: September 14, 2007
Revision Date: October 02, 2007
Product:
DS-Client
Summary
Weekly Admin can be configured to run automatically, once a week, based on the specification in
the DS-Client Configuration - Parameters Tab (See: “Configure the DS-Client Parameters” on
page 33).
The Weekly Admin performs all the tasks of a Daily Admin, and also performs a synchronization of
backup sets. The type of synchronization depends on how the Weekly Admin is run:
• “Synchronization during Scheduled Weekly Admin” on page 372.
• “Synchronization during On-Demand Weekly Admin” on page 372.
Synchronization types
The following backup set synchronizations can be performed by the Weekly Admin process:
• Normal: Compare and update where necessary, the DS-Client backup log
(database) with the DS-System's On-line storage information.
• Check only (On-Demand only): Perform only a check of the synchronization
between the DS-Client's backup log and the DS-System's On-line storage.
This will only identify whether inconsistencies exist (i.e. no corrective action
will be taken.).
• DS-System based (On-Demand only): Update the entire DS-Client backup
log with the DS-System's On-line storage information.
Synchronization during Scheduled Weekly Admin
Scheduled Weekly Admin performs a “normal” synchronization on any backup sets that have
already been marked “Out of Sync”.
• In addition, Windows DS-Client will perform “normal” synchronization on a
backup set if it detects any database inconsistencies that might cause it to be
“Out of Sync”.
Note: This does not apply to Linux DS-Clients.
If you want the scheduled Weekly Admin to perform the synchronization on all the backup sets,
you must configure the AdminSkipSync parameter in the DS-Client Advanced configuration
options (See “DS-Client Advanced Configurations” on page 40.).
Synchronization during On-Demand Weekly Admin
On-Demand Weekly Admin is requested from Setup menu > System Activities > Weekly Admin:
Run Now (See “Run a Weekly Admin immediately” on page 266.). This opens the Weekly Admin
Options screen.
The default is to synchronize all backup sets with a “normal” synchronization. You can also select
how many simultaneous synchronizations to run.
If “Synchronize all sets” is unchecked:
• Weekly Admin performs a “normal” synchronization on any backup sets that
have already been marked “Out of Sync”.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 372
Confidential.
Knowledge Base: ADMINISTRATION
•
In addition, Windows DS-Client will perform “normal” synchronization on a
backup set if it detects any database inconsistencies that might cause it to be
“Out of Sync”.
Note: This does not apply to Linux DS-Clients.
Weekly Admin for DS-Client database backup / recovery
• If Weekly Admin was run specifically to provide you with a DS-Client database
backup that you intend to recover immediately, and you notice that the
Weekly Admin performed synchronization on any backup sets, you should run
the Weekly Admin again to obtain the latest and most accurate backup of the
DS-Client databases.
• This will avoid your having to go through the synchronization process again
after the database is recovered.
See Also
See “Run a Weekly Admin immediately” on page 266.
See “Administrative Processes” on page 369.
See “Recovering the DS-Client Database” on page 508.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 373
Confidential.
Knowledge Base: ADMINISTRATION
Admin Processes with Grid DS-Client
Creation Date: March 26, 2008
Revision Date: March 26, 2008
Product:
Grid DS-Client (Windows)
Summary
This article explains the specific differences that occur when a Grid DS-Client run Daily Admin or
Weekly Admin activities.
For a more general description, refer to the Knowledge Base article “Administrative Processes” on
page 369.
Description
For standalone DS-Clients, Daily / Weekly Admin activities instruct the MS SQL Server where the
DS-Client databases reside to save a copy of the DS-Client databases in the DS-Client Buffer. By
default, the DS-Client buffer is located in the folder configured as the default Operating System
temporary folder (usually C:\Windows\Temp).
For Grid DS-Clients, Daily / Weekly Admin activities instruct the MS SQL Server where the DSClient databases reside to save a copy of the DS-Client databases in the DS-Client Buffer of the
node that performs the Daily / Weekly Admin activity.
• The Daily / Weekly Admin activity is allocated to a node with a lower load by
the Main Node of the Grid DS-Client.
By default, the DS-Client Buffer folder for a node in a Windows Grid DS-Client is the folder
configured as the default Operating System temporary folder (usually C:\Windows\Temp). The
DS-Client Buffer can be configured for each node in the Grid DS-Client using the DS-Client
Advanced Configuration options (See “DS-Client Advanced Configurations” on page 346.).
See Also
“Grid DS-Client (Windows DS-Clients)” on page 52
“Grid DS-Client” on page 320
“DS-Client Advanced Configurations” on page 346
“Administrative Processes” on page 369
“DS-Client Buffer” on page 378
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 374
Confidential.
Knowledge Base: ADMINISTRATION
Backup Set Migration
Creation Date: April 30, 1997
Revision Date: July 30, 2004
Product:
DS-Client
Summary
The migration process for backup sets has two purposes:
1. It allows users to map an existing backup set to a different computer (other than the
one the backup set is currently on).
2. It allows users to update crucial information (i.e. computer name, operating system)
about a backup set, if such a change occurred to the backup source computer.
Details
When creating backup sets, the DS-Client service automatically collects information about the
backup source computer (i.e. operating system, file system). Based on this information, the
DS-Client presents the available backup options for the selected computer.
Each time a backup is performed, the DS-Client service automatically updates part of the collected
information (i.e. operating system version, file system type). However, you must migrate the
backup set if you wish to keep your backed up data in any of the following situations:
• The backup source computer's name has been changed.
• The backup source computer's Operating System has been changed.
• The backup directories or files have been moved to another computer.
Restrictions
1. You cannot migrate a backup set containing the Registry, NDS or Bindery to a
different Operating System. If you wish to migrate a backup set containing the
Registry, NDS or Bindery to a different Operating System, you must first delete all
generations of these special backup items from the backup set (with the Delete
Wizard). Then, you must remove these items from the backup set's Selected Items for
Backup ('Directories Tree' dialog).
2. For each share selected for backup (or backed up), you should select the destination
share on the computer to which you are migrating. The DS-Client service restricts the
migration to a one-to-one match (i.e. you cannot select the same destination share for
two different source shares).
3. When migrating items from one file system to another, you should verify the backup
set's Permissions and Streams options are consistent with the new file system (i.e.
these options must be unchecked if you migrate from NTFS to FAT32).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 375
Confidential.
Knowledge Base: ADMINISTRATION
When to Migrate a Backup Set
Creation Date: October 31, 2007
Revision Date: October 31, 2007
Product:
DS-Client
Summary
ASIGRA Televaulting DS-Client stores information about the source machine that is being backed
up with a specific backup set: machine name, machine IP address, Operating System version, etc.
Because of these specifications, you may need to “migrate” a backup set to respecify those
settings if they are changed on the source. The following scenarios require migration:
• “Scenario # 1: Source computer’s Operating System has been upgraded” on
page 376
• “Scenario # 2: Source computer’s Machine name or IP address has changed”
on page 376
• “Scenario # 3: Source data has been moved to a different machine” on
page 377
• “Scenario # 4: Orphaned backup set was recovered by the DS-Client from the
DS-System” on page 377
Scenario # 1: Source computer’s Operating System has been upgraded
If the Operating System of the source machine (for the backup data) has changed, DS-Client will
fail to perform the backup activity with the following message:
“Server changed from Windows 2000 to Windows 2003. Please create a new
backup set for this version.”
In order to continue to backup with the same backup set, you must migrate the backup set, and
re-select the same computer (with the upgraded Operating System). Otherwise, you can create a
new backup set and start backing up the data again.
IMPORTANT NOTES:
• Not all Operating System upgrades will allow a backup set migration. For
example: Upgrading from Windows NT to Windows 2003 will not allow you to
migrate the “registry” to “system state and services database”. In these cases,
you must create a new backup set.
• If you perform a Bare Metal Restore from a migrated backup set, you must
make sure that you only restore Operating System files from the same
backup session (if applicable). Otherwise, you may restore a combination of
incompatible files from different versions of the Operating System.
Scenario # 2: Source computer’s Machine name or IP address has changed
If the source computer’s machine name or IP address has changed, the DS-Client will fail to
backup with the message:
“The network name was not found.”
Any backup sets created with the previous machine name or IP address must be migrated.
Otherwise, you can create new backup sets and start again.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 376
Confidential.
Knowledge Base: ADMINISTRATION
Scenario # 3: Source data has been moved to a different machine
If the actual data has been moved from one server to another server, you can migrate the backup
set, specify the new machine information and continue backing up with the same backup set.
However, you must pay attention to the following items:
• If you move data from one server to another and you keep the same path
format for that data, then DS-Client will backup incremental data. For
example: if data resides on e$\data and you moved it to e$\data or c$\data on
the new server, then DS-Client will process incremental backups for those
files.
• If you move data from one server to another and you do not keep the same
path format for that data, then DS-Client must perform an initial backup (which
will take longer). For example: if data resides in e$\data and you move it to
e$\newlocation\data or c$\destination\newlocation\data on the new server,
then DS-Client will process new masters for the files found in the new
location.
Scenario # 4: Orphaned backup set was recovered by the DS-Client from the DS-System
See Knowledge Base Article: “Recovering 'Orphaned' Backup Sets” on page 510.
See Also
See “Migrate a Backup Set from one computer to another” on page 143.
See “Backup Set Migration” on page 375.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 377
Confidential.
Knowledge Base: ADMINISTRATION
DS-Client Buffer
Creation Date: October 14, 1997
Revision Date: October 22, 2007
Product:
DS-Client
Summary
The DS-Client buffer is a temporary storage location on the DS-Client computer. This directory can
be seen or changed from the DS-User > Setup > Configuration > Parameters tab.
• For more information, see: “Configure the DS-Client Parameters” on page 33.
When the Use Buffer option is employed:
1. Backup files are transferred to the buffer location first, then
2. The backup/restore operation is performed (data is processed through the DS-Client).
This minimizes the time that the LAN must support the additional backup/restore traffic. It is
particularly useful if the DS-Client's connection to the DS-System is much slower than its
connection with the LAN.
The DS-Client buffer can also provide temporary storage as the database dump location for MS
SQL and MS Exchange database backups (this avoids the need for extra disk capacity on network
servers).
Adequate disk capacity for your backup needs is required on the drive containing the DS-Client
computer's buffer directory.
Types of DS-Client activities that use the DS-Client Buffer
Use Buffer
Backup: Speeds up backup operations by copying files to DS-Client buffer first (at LAN
speed) and then transferring files to the DS-System (at DS-System connection speed).
Minimizes time that the network resource is used for the backup operation.
Restore: Speeds up restore operations by restoring files to the DS-Client buffer first (at
DS-System connection speed) and then copying files to the network resource (at LAN
speed). This minimizes the time that the network resource is used for the restore operation.
MS Exchange Server
The DS-Client always copies the MS Exchange Server database(s) to the DS-Client Buffer
first, and then transfers the files to the DS-System. For extremely large MS Exchange
Server databases (that would require too much disk space), you can specify that backups be performed with the “DS-Client Pipe” option.
MS SQL Server, Oracle Server
When performing backups/restores of MS SQL Server or Oracle Server databases with
the 'Dump to DS-Client Buffer' option, database dump(s) are created on the DS-Client
Buffer and then transferred to the DS-System. This provides disk space for database
dumps on the DS-Client computer and saves the need for extra disk capacity on the
database servers.
Notes
1. The DS-Client deletes all files from the DS-Client buffer after each activity, regardless whether or
not the operation was performed successfully.
2. Do not select the Use Buffer option with backup sets that have data on the DS-Client computer. Use Buffer copies backup files to the DS-Client buffer. From there, they are processed for
backup by the DS-Client. If the DS-Client buffer directory is part of a backup set, problems may
occur since the Backup may catch a loop that reads the same directories being copied for backup.
3. DS-Client Buffer and Performance: The DS-Client Buffer is also used by activities that access DSClient Database to create temporary files for bulk insert (for optimization of processing). If a
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 378
Confidential.
Knowledge Base: ADMINISTRATION
backup set is not assigned enough credentials to Create/Delete/Read/Write files in the DS-Client
Buffer directory, bulk insert operations will fail and a regular insert is used instead. To maximize
the speed, we recommend providing enough credentials for all backup sets to access the DS-Client
Buffer directory.
4. Backup sets configured to use the DS-Client buffer automatically benefit from the Block-Level
Resume feature (See “Block-Level Resume” on page 473.).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 379
Confidential.
Knowledge Base: ADMINISTRATION
DS-Client performance considerations
Creation Date: November 17, 1997
Revision Date: March 21, 2008
Product:
DS-Client
Summary
The DS-Client software is designed to perform unattended, scheduled backups of single PCs or
an entire LAN. To maximize the DS-Client's performance, there are some issues that you should
consider.
Considerations
In order to maximize backup speed, consider the following points:
Use the latest supported
Windows Operating System
Running the DS-Client software on the latest supported Windows Operating System will boost backup speed, since the DS-Client software is able to take advantage of features like asynchronous I/O processing and multi-processor support.
Since the DS-Client software performs compression and encryption during the
Provide adequate CPU and backup, it is CPU-intensive. Use the DS-Client 'Load Summary' feature to determemory
mine CPU and memory utilization during backups. If it is very high, you should
consider a more powerful CPU and/or more memory for the DS-Client computer.
Use multi-processor systems
The DS-Client software is designed to scale on SMP systems, when installed on
Windows. Running the DS-Client on such a system provides large performance
boosts when compared with a single CPU configuration.
Use MS SQL Server
The DS-Client uses a database to store backup logs (catalogs). When using the
DS-Client in a LAN configuration that can exceed a few hundred thousand backup
files, the database update/retrieve speed will affect backup performance significantly. Use MS SQL Server as the DS-Client database to provide faster update/
retrieve performance.
When running the DS-Client on a powerful system (e.g. dual CPU), LAN connecProvide 100 Base or higher
tions of 10 mbps (Ethernet) or 16 mbps (Token Ring) become a bottleneck. ProLAN connections.
vide a faster LAN connection to significantly improve the backup speed.
Schedule appropriate
number of backups
Scheduling too many backups at the same time will increase overall backup time
due to CPU, memory and LAN connection over utilization. 'Load Summary' feature
of DS-Client can be used to determine CPU and memory utilization during backups.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 380
Confidential.
Knowledge Base: ADMINISTRATION
LAN Storage Discovery Overview
Creation Date: August 18, 2006
Revision Date: August 18, 2006
Product:
DS-Client
Summary
•
For step-by-step instructions, see the section: “LAN Storage Discovery Tool”
on page 243
It is very useful to analyze the LAN storage before using any backup application. The most
important information is the redundancy (duplication) factor, and the frequency of data changes.
The main purpose of the LAN Storage Discovery Tool is to provide customers with a clear view of
information about their LAN by scanning and analyzing the LAN files.
•
•
•
•
•
•
“LAN Storage Discovery” is a tool integrated in DS-Client, designed to
analyze the LAN storage.
To analyze the LAN, you must first discover the shares on the LAN (or a
particular part of the LAN) using a list of credentials you provide. Then, the
share list is arranged, defining which shares to scan and how they will be
scanned. Finally, the scan process is started for the files on the LAN.
Tools to manage and monitor the discovery and scan processes are also
provided.
The scan process runs on DS-Client and can be scheduled.
Several reports are generated to analyze the scanned storage: Duplication,
growth trends, access reports, file type distribution, etc.
Summary and detailed reports are provided, as well as an export feature that
you can customize.
LAN Storage Discovery Tool
This section outlines the features of the LAN Storage Discovery Tool.
• “Discovery” on page 382
• “Scan process” on page 382
• “Reports” on page 383
• “Unix Support Limitations (Windows DS-Clients)” on page 385
• “Unix Support Limitations (UNIX DS-Clients)” on page 385
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 381
Confidential.
Knowledge Base: ADMINISTRATION
Discovery
1. Configure the range (extent) of your LAN that will be analyzed. This range is a
collection of items. Each item can be a network provider, a domain, or a computer. A
list of credentials can be provided for the discovery / scanning process. For Unix DSClients, an additional level of authentication for credentials is available.
2. The discovery process will automatically analyze the overlapping of shares, if the
shared path can be retrieved. The overlapped shares will be disabled for scanning by
default to avoid false duplication counting.
3. LAN Storage Discovery (Windows DS-Client) supports the following network
providers:
• Microsoft Windows Network
• NetWare Services
• Hummingbird NFS
4. LAN Storage Discovery (UNIX DS-Client) can discover shares on the network
through:
• SAMBA
• NFS
• SSH
5. The discovery processes are allocated on the DS-System side (by your Service
Provider):
• For Windows DS-Clients, if the all allotted discovery processes are used up, a
new discovery process cannot be started until additional discovery processes
are assigned.
• For UNIX DS-Clients, the discovery can be run at any time (allotted processes
are only checked at scan time). If no new shares are added to the share list,
additional scans will be performed without decreasing the number of allotted
processes.
Scan process
1. The scan process is applied to the list of shares found by the discovery process.
2. The discovery process automatically disables some shares:
• if the share is covered by other shares;
• if not enough credentials were provided to retrieve all necessary information
from the share
• if the share is not supposed to be scanned (e.g. CDROM, etc.)
Note: The status (disabled / enabled) can be manually changed from the GUI.
3. By default, the credentials used to discover the share are also set as the scan
credentials for that share by the discovery process. However, the credentials used for
scanning can be changed for particular shares from the GUI.
4. The scanning of a share to follow reparse point (Microsoft Windows only) is
configurable from the GUI.
5. To speed up the scanning process and reporting, the scanning process can be
configured from the GUI to skip files that are smaller than a specific size.
6. The number of scanning threads is also configurable from the GUI (to provide
scalability).
7. The scan process can be scheduled, or started on demand. The best practice is to
schedule it to run over a period (i.e. a few weeks) to get more accurate statistical
information on data growth and changes.
8. A “Scan Monitor” is available to give a real-time overview of the scan process.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 382
Confidential.
Knowledge Base: ADMINISTRATION
Reports
The reports can be divided into three categories:
• “One-click generated reports” on page 383
• “LAN File Summary ” on page 384
• “Other reports” on page 384
One-click generated reports
The “One-click generated reports” are the most important ones. Windows DS-Clients have 12
reports and UNIX DS-Clients have 8 reports. The generated reports will be saved as files in HTML
and Microsoft Excel format. Many of them can be customized. The reports included are:
Report
Description
Share usage
Reports the total files and size (all and duplicated) for each share.
Largest Files
List top n (default is 100) largest files. Also report the percentage size compared to the entire LAN.
Largest Duplicates
List top n (default is 100) largest duplicate files. Also report the total duplicate
file number and the percentage of this number as well as the total size of the
top n files comparing to the entire LAN.
Ownership
(Windows DS-Client only)
Reports the total storage occupied by each owner for each share as well as the
total.
File Type Distribution
Select top n (default is 10) file types, sorted either by space or file number
(default is by space). For each file type, select top m (default is 100) largest
files from the entire LAN.
Partition Size
(Windows DS-Client only)
For each partition, report the total, free, and used space.
For each share, and each interval (5 intervals are provided: <1 Day, >1 Day, >1
Week, >1 Month, >1 Year), report the top n (default is 100) largest files whose
Access Report / Dormant Files last access time is within the specified interval.
There is also a summary report of the total size and files for each interval of
each share.
Growth and Modified Files
Reports how many files and size created/modified for each share, each day
over the specified period (default is 14 days).
SQL Server Size
(Windows DS-Client only)
For each computer, how much space (total, free, used) are for SQL Server.
Exchange Server Size
(Windows DS-Client only)
Report all .edb and .pst files.
Index of Generated Reports
An index of all generated reports.
All Duplicate Files
A list of all duplicate files. By default this report will not be generated.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 383
Confidential.
Knowledge Base: ADMINISTRATION
LAN File Summary
This provides an overview, as well as detailed (up to file level) information of the scanned files on
the LAN. Complicated filters are also available so that it is possible to analyze a particular group of
files.
Report
Description
Global view
An overview of the total files and size for the following categories:
• All files
• Duplicate files
• Duplicate groups
• Changed and new files
• Unchanged files
• Not accessed files
The changed / unchanged, new, not accessed are determined by the parameter ‘last n
days’. The default is last 30 days.
Filtered view
This is similar to the global view. However, it is for each share based on the specified
condition. This condition is the combination of the following:
• ‘Last n days’: to determine changed/unchanged, new, not accessed.
• Filter: like ‘*.c*’ on file name
• Duplication: Only the files with duplicates equal to or greater than the specified
number will be counted.
• Share: Specify a group of shares to be considered.
Show Details
Show the detailed information of the files corresponding to the selected row from the
global / filtered view.
Charts
Show the pie charts for the selected row from the global / filtered view. The charts
could be based on size or file numbers for all categories (Duplicated, Unchanged, etc.).
Show Duplicates
Show all files that are duplicated with the selected file.
Other reports
These reports are already included in the “One-click generated reports.” However, they can be
customized in a more powerful way from DS-User > Reports Menu > LAN Storage Discovery:
report_name.
Report
Description
Large Files report
List top n (default is 100) large files whose duplicate count is at least equal to the given
value (default is all files) for the specified share or all shares.
Extension report
There are two kinds of reports. The “Top Report” shows the top n extensions ordered
either by size or by file numbers for the specified range (a share or all shares). The
“Customize Report” asks for a list of specific extensions and the range (specific shares).
The total size and file numbers are also reported.
Access report
Reports the files and size for the given intervals, set within the given range (specific
shares). An interval could be a number of days, weeks, months, or years.
Growth report
User provides the period for analysis: intervals (in days), range (specific shares), and
type (total or new). Report shows the files and size for each interval that falls within
the specified period.
Share usage report
Reports the files and size grouped by owner for the specified shares.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 384
Confidential.
Knowledge Base: ADMINISTRATION
Unix Support Limitations (Windows DS-Clients)
Like backup/restore, LAN Discovery uses Hummingbird NFS to access Unix servers. The
limitations are described below.
1. Soft links and device files will be silently skipped.
2. Hard links will be treated as regular files. If two hard links point to the same file, they
will be considered as duplicates of each other.
3. “Owner” field will always be empty.
4. Hummingbird Client (hclnfs.sys) has some serious known problems:
• Kernel/regular memory leaks that eventually could crash the DS-Client
machine. These problems are fixed in V8.0.0.17 and V9.0.0.5
• File handle leaks (when reading symbolic links) that eventually could crash
the DS-Client machine. V9.0.0.5 has this problem, and it is fixed in V9.0.0.6
• Windows “blue screen” when accessing a long path. This problem was found
in all known versions. To bypass this problem, LAN Discovery will simply skip
all files/directories with paths longer than or equal to 260 characters.
• Extra dot in the hostname for stand alone machine. This problem was found
only in version 9. To bypass this problem, add the stand alone host using IP
address instead of machine name.
Unix Support Limitations (UNIX DS-Clients)
1. Soft links and device files will be silently skipped.
2. Hard links will be treated as regular files. If two hard links point to the same file, they
will be considered as duplicates of each other.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 385
Confidential.
Knowledge Base: ADMINISTRATION
Load and Storage Summaries
Creation Date: April 30, 1997
Revision Date: October 2, 2002
Product:
DS-Client
Summary
The DS-Client process accumulates different statistical information that can help to analyze load,
utilization and storage trends about the DS-Client service. The DS-Client service can be instructed
to perform statistical backups, which are the same as regular backups (the data source is
scanned, new files are compressed and encrypted) except no data is sent to DS-System.
Statistical Backups can help you analyze data amounts, trends and incrementals before
performing actual backups. Statistical summaries can be viewed, analyzed and printed from the
Load Summary / Storage Summary dialogs (Setup menu).
For more details, a tool can be enabled for LAN Storage Discovery. Ask your service provider.
Load Summary statistics
The Load Summary can help administrators analyze the load on the DS-Client computer for a
selected period of time. If you observe high values at a particular time period, you should consider
rescheduling the activities to distribute the load more evenly. If you observe high values at all
times, you should consider using a more powerful computer or delegate some backup sets to
another DS-Client.
The DS-Client service automatically collects data for these statistics at one-minute intervals. Every
five minutes, the DS-Client service updates an internal table with the peak amounts for the
following statistics:
Send amount
Peak of transmitted amount to DS-System (KB/sec)
Receive amount
Peak of received amount from DS-System (KB/sec)
CPU load
CPU utilization (0-100%)
Memory load
Memory utilization (0-100%)
Memory committed
Amount of allocated memory (in MB)
Activities
Number of DS-Client activities
Storage Summary statistics
The Storage Summary can help administrators analyze the trends for On Line amount, number of
files and backup time.
There are two types of figures (statistics): primary (such as On-Line, Files, Backup Files, etc.) and
derived (all incremental). A primary figure reflects a real number obtained from the statistics. A
derived figure is linked to a primary figure (e.g. Incremental Files is linked to Files), and is obtained
by subtracting the current primary figure point from the previous primary figure point.
During administrative processes, the DS-Client service automatically calculates the following
statistics:
Time statistics (in minutes)
Average Time
An average of the backup times for scheduled backups.
Actual Time
The actual backup time duration of both Scheduled and Demand Backups for the selected period.
Files statistics
Total Files
The total number of files stored On-Line (including all generations)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 386
Confidential.
Knowledge Base: ADMINISTRATION
Incremental Files
This is a derived figure, showing the increment to the Total files.
New Files
The total number of new backed up files (i.e.: files backed up for the
first time).
Backup Files
The total number of files backed up for the selected period.
Incremental Backup Files This is a derived figure, showing the increment to the Backup Files.
Amount statistics (MB)
Total On-Line
The total amount stored On-Line.
Incremental On-Line
This is a derived figure, showing the increment to the Total On-Line.
New On-Line
The total amount for the new backed up files.
Transmitted
The total amount of data transmitted to DS-System (includes the effects
of compression, DS-Delta and DS-Library technologies.)
Incremental Transmitted
This is a derived figure, showing the increment to the Transmitted
amount.
On-Line Backup
The total amount of data backed up for the selected period.
Incremental On-Line
Backup
This is a derived figure showing the increment to On-Line Backup.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 387
Confidential.
Knowledge Base: ADMINISTRATION
Simple and Advanced mode interface
Creation Date: October 14, 1997
Revision Date: October 21, 2005
Product:
DS-Client (Not including DS-User JAVA version)
Summary
The DS-Client software provides a robust set of features that would satisfy even the most
demanding administrator or power user. However, many of the features and information presented
by the DS-Client (through DS-User interface) may not be needed by less technical users or by
small stand-alone installations. In these cases, users can opt to run DS-User in Simple Mode.
Simple Mode streamlines the DS-User interface to a minimal subset of options and screens. In this
mode, a user is limited to performing backup and restore operations, creating backup sets, and
viewing the Activity Log.
Functions and options not available in Simple Mode
•
•
•
•
•
•
•
•
•
•
•
•
Storage and Load Summary.
System Activities.
Audit Trail.
Backup Schedules.
Recovery.
Disaster Restore.
Users and Groups.
Migration.
Synchronization.
Change Backup Set permissions and ownership.
Creation of backup sets other than File System (i.e. MS SQL Server, MS
Exchange Server).
Change backup set options (permissions, pre/post, ...) other than number of
generations.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 388
Confidential.
Knowledge Base: ADMINISTRATION
Retention Rules vs. Maximum # of On-line Generations
Creation Date: October 09, 2007
Revision Date: January 24, 2008
Product:
DS-Client
Summary
This information is only provided as a sample of different strategies. Each customer is ultimately
responsible for the storage and deletion policies for their data.
This article outlines the differences between setting up maximum generations on a backup set and
using retention rules. It also describes how these two functions work together.
The main point is that the customer must choose what mechanism will be in charge of deleting
generations from online storage:
• Maximum Generations are passive - they allow generations to be overwritten
whenever necessary (on the DS-System online storage).
• Retention Rules are active - they must be applied to a backup set, then
enforced (either on schedule or on-demand) to physically delete generations
from the DS-System online storage or move generations from DS-System
online storage to BLM Archiver..
• The default setting from DS-Client installation is to use maximum generations,
meaning the oldest version of a file will be overwritten if you have backed up
the maximum allowed number of generations for a file.
Generations are created on the online storage when the backup detects that a file has changed.
Files that never change have only one generation on the DS-System online storage.
Maximum Generations
The maximum generations parameter is set up in the backup set properties, and it must be a
number between 1-10,000. This means that this backup set will save up to this maximum number
of restorable generations on the DS-System online storage. It will not keep more than this number
on the online storage (when it reaches the limit, the oldest generation is overwritten). Overwriting
is done during the backup process and does not take into consideration any retention rules that
might apply, since retention rules run separately from the backup.
Best uses for maximum generations are:
• for CDP (continuous data protection) backup sets, where files are constantly
changing and immediately being backed up, and the client would like to
control the size of the online storage.
• when there are no retention rules applied, and online storage size is a
concern.
All cumulative backups (on-demand and scheduled) will keep up to the maximum generation
number. In case a low number of maximum generations is set up for a backup intended to run on
schedule, be aware that if you run an on-demand backup, what is kept online may not be what you
expect. For example:
• You create a backup set with maximum generations set to 7, and schedule it
to run daily (to keep the daily changes for a week). Assuming all backup files
change daily, you would expect one generation for each day. If an on-demand
backup is run on this set, it will disrupt the pattern, and you will have 2
generations from the same day (and restorable generations going back 6
days, instead of 7). [This assumes that the file was changed before the ondemand backup, and before the scheduled backup.]
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 389
Confidential.
Knowledge Base: ADMINISTRATION
Retention Rules
Retention rules apply to the online generations every time they are enforced on a backup set. This
can happen in two ways:
• On-demand, separately from the backup process.
• Within a schedule, independently or right after a backup task for this backup
set.
When using retention rules, the “enforce retention” process works with what is saved in the online
storage by the backup process. The following considerations should be made when applying
Retention Rules to a backup set:
1. Retention Rule compatibility with Maximum number of generations
• You must make sure the Retention Rules work with the maximum number of
generations for the backup set. If the maximum generations is set to a low
number (e.g. 7), then the retention rules may not produce the intended result.
(The oldest generations are likely to be overwritten by the backup process,
before any of the generations qualify for deletion by the retention rules.)
2. Retention Rule compatibility with its own rules (Delete options, Time-based online Retention,
and Moving old data to BLM Archiver)
• Retention Rules work best if the maximum generations parameter is set to the
maximum (10,000) or to a high number (e.g. 300). The retention rules help by
deleting what you define to be unnecessary, and to ‘retain’ on-line what you
define to be critical. As a result, you will most likely never reach a high number
of generations for the same file on the DS-System online storage.
Note: Results depend on the Retention Rules and how often they are enforced.
Delete options (“Deletion of files removed from source / HSMed data”):
• Once this retention rule is enforced on a backup set, it will check the options
configured for the files that are removed from source, or for data that has
been moved by a third-party HSM/ILM solution to a remote location.
• DS-Client can be instructed to keep [x] number of generations for each file in
the backup set after a certain period of time, since the file has been removed
from the source machine.
Note: DS-Client detects that files have been removed from source when the backup activity is
running.
• If a placeholder / stub is detected on the source machine, (Windows) DSClient can be instructed to delete all file generations backed up before the
stub / placeholder was detected, or to delete all generations that are not stubs
/ placeholders and were backed up in an earlier backup session than the stub.
• By default, enforcing any Retention Rule will cause a deletion of all data that
is defined as obsolete on from the DS-System online storage. However, a
copy of this data can be sent to BLM Archiver before it is removed completely
from the DS-System online storage.
Time-based online retention (deletion of files from the DS-System online storage based
on user-specified time-based rules):
• “Keep most recent generations” has a default value of 1. All generations of a
file will be removed from the DS-System online storage, with the exception of
the latest (most recent) generation. If this number is increased to a very high
amount (e.g. 9999), all the other time-based rules specified in this Retention
Rule configuration will not have any effect or the required effect (because they
will be over-ruled by this particular rule).
• “Keep all generations for [x] interval of time for [y] interval of time”. Timebased rules should be as specific as possible. When a retention rule has more
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 390
Confidential.
Knowledge Base: ADMINISTRATION
details, it will work better and be much more precise than a general rule. For
more details, see “Retention Rule Examples” on page 393.
Archive old data to BLM Archiver:
• Specify the age of the files at which DS-Client will move that data to BLM
Archiver. The algorithm will compare the last modification date with the
backup session date, and will apply the oldest of the two for the archiving
rules.
• For example: If all files older than one (1) month should be sent to BLM, DSClient will compare the “last modification time” and “backup time” of a file; it
will take the oldest value to calculate the age of the file and will execute the
corresponding action (archive / do not archive).
Local Storage Retention:
• This only applies to the files saved in the DS-Client Local Storage Buffer(s).
• In order to have the DS-Client save multiple generations on the local storage,
the backup set must be assigned to a retention rule that has the Local
Storage Retention options enabled.
• Local Storage can only keep data on the local storage buffer if that same data
(exact generation) exists on the DS-System online storage as well.
To Summarize
Customers have a choice between 2 methods of deleting online generations.
Passive:
• Maximum generations: overwrites oldest generation whenever necessary
(no user intervention required)
-
If set to a low number, this will make the backup set's retention rule inefficient. It is
best used with a CDP backup, because it is enforced every time a backup runs (once
maximum generations have been reached).
Active
• Retention rules: to be used correctly, the following best practices apply:
-
Maximum generations of the backup set should be set to the maximum, or another
high number (several hundreds/thousands).
-
Keep most recent generations should be set to a low number, such as 1, if timebased rules are also specified in the same Retention Rule.
-
•
Time-based rules should be as specific as possible (e.g. ‘Keep one generation every
week on or before Sunday at 11:59PM’ for 1 Month) instead of being generic (like
‘Keep one generation every week for 1 Month).
Manual Delete: (Sets Menu > Delete > Selective Delete) can be performed
on-demand at any time to free up space on the DS-System online storage.
NOTE: Because of the many configurations that are possible, it must be emphasized that the
customer is responsible for configuring the storage and retention policies. Treat retention
as if you are performing a manual delete of data: once data is deleted from on-line, you
can never get it back.
Your Service Provider might also offer the BLM Archiving to lower cost media.
• Every time you delete data, you have the option to send a copy of the
generations that are about to be deleted to BLM.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 391
Confidential.
Knowledge Base: ADMINISTRATION
•
When BLM selected for a backup set, you can effectively save a copy of every
backup generations forever.
See Also
“About Retention Rules” on page 67
“Retention Rule Examples” on page 393
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 392
Confidential.
Knowledge Base: ADMINISTRATION
Retention Rule Examples
Creation Date: November 15, 2007
Revision Date: January 23, 2008
Product:
DS-Client
Summary
This article describes some common retention policies that have been implemented in production
environments.
NOTE: Because of the many configurations that are possible, it must be emphasized that the
customer is responsible for configuring the storage and retention policies. Treat retention
as if you are performing a manual delete of data: once data is deleted from on-line, you
can never get it back.
Example 1
The most common requirement for companies to retain data on the DS-System online storage is
the following:
• 1 generation every day for a week
• 1 generation every week for a month
• 1 generation every month for a year
• 1 generation every year for 7 years
In order to implement this (or a similar) Retention Rule:
1. The backup set must be configured with a high number of generations for the backup
items (e.g. 300).
• Know your backup data: Retention is designed for backup items that change
regularly (e.g. daily). A backup item that does not change will have only one
generation.
2. Follow the steps from “Create or Edit a Retention Rule” on page 67.
3. In the Retention Rule Wizard, make the following configurations.
4. In the Generic retention options screen’s “Keep most recent generations” field:
Choose the number of most recent generations that you always want to be able to
restore. Retention will not apply to these generations. Some examples of common
choices:
• 1, for the most recent generation (e.g. for disaster recovery);
• 7, for the most recent 7 generations (assuming one daily backup for items that
change, this keeps the last week’s worth of backups);
• 5, for most recent 5 generations (assuming daily backups during business
days from Monday-Friday for items that change, this keeps the last business
week’s worth of backups).
5. In the Time retention options screen, add each time-based rule individually to the list.
Rules appear in the form “Keep one generation every [x - time] for [y - time]”.
• Choose the interval of time (x) over which you want to keep one generation
online. All other generations in that interval will be deleted when retention is
enforced.
• For the same rule, you must also choose the interval of time (y) that the rule
applies to the entire online storage. This means one generation is retained for
every x-interval that fits into y (e.g. “every 1 month for last 1 year” means 12
generations will be retained).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 393
Confidential.
Knowledge Base: ADMINISTRATION
6. Add the four time-based retention options so the Time Retention Option List looks as
follows:
Keep one generation every 1 day(s) for last 1 week(s)
Keep one generation every 1 week(s) for last 1 month(s)
Keep one generation every 1 month(s) for last 1 year(s)
Keep one generation every 1 year(s) for last 7 year(s)
•
However, you may wish to be more specific with the data that you want to
retain. For example:
Keep one generation every week on or before Friday at 23:59:59 for last 6
month(s)
7. Finish creating the Retention Rule.
8. Apply the Retention Rule to the backup set(s) you want.
9. Schedule the “Enforce Retention” process (or run it on-demand). This will delete all
online generations, except those specified to be kept in the Retention Rule.
Example 2
More complex rules and regulations can be implemented with ASIGRA Televaulting software. For
example, a company may have the following data retention requirements:
Any files deleted from source should be retained online on the DS-System
online storage for a period of three (3) months, and afterwards this data
must be moved to archive.
All files must be moved from DS-System online storage to BLM Archiver if
files are older than 6 months.
In order to do this, you would create the following Retention Rule:
1. Open the New Retention Rule Wizard.
• Select “Deletion of files removed from source / HSMed data“
• Select “Archive old data to BLM”
2. Click Next. In the Delete Options screen:
• Configure “If files are removed from source after 3 months, Keep
Generations: 0”
3. Click Next. In the Archive Options screen:
• Add the Archive Rule “Archive files older than 6 month(s)”
• Make sure the rule applies to “All files”
4. Click Next. In the Choose a name screen:
• Select the option “Move obsolete data to BLM”
5. Click Finish.
See Also
“About Retention Rules” on page 67
“Retention Rules vs. Maximum # of On-line Generations” on page 389
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 394
Confidential.
Knowledge Base: ADMINISTRATION
Scheduled Operations
Creation Date: February 10, 2006
Revision Date: March 20, 2008
Product:
DS-Client
Summary
This article provides additional information about scheduled activities on DS-Client.
Description
DS-Client checks for scheduled operations that are to be triggered every minute (24 hours a day).
If a scheduled operation is started but cannot be completed (because the connection to DSSystem cannot be established or is lost), it will retry, by default, 3 times over five minutes to
resume or initiate the connection. The number of attempts and the interval between retries (up to
60 minutes) can be configured (DS-User > Setup > Parameters). If the scheduled operation is
missed for this reason, a new attempt to perform it will be made at the next scheduled time (e.g. a
backup scheduled to take place everyday at 14:00 will retry next day at 14:00.).
If an activity is running at the time of a scheduled operation, and that activity prevents other
operations from running, the scheduled operation will start as soon as that activity ends. By
default, DS-Client will attempt to start a scheduled operation every minute for 6 hours from the
(actual) scheduled start time. If more than 6 hours pass without successful completion, a new
attempt to perform the operation will be made at the next scheduled time. This interval is
configurable on Windows DS-Clients using the “ScheduleMiss” parameter from the “DS-Client
Advanced Configurations” on page 346.
Examples:
• If Daily Admin or any other activity which is locking the backup set is running,
the schedule will start as soon as that activity ends.
• If the schedule is skipped for a reason other than losing connection to DSSystem (e.g. DS-Client service is stopped), the schedule will start as soon as
the DS-Client reaches its normal state (e.g. DS-Client is running).
See Also
“Configure the DS-Client Parameters” on page 33
“DS-Client Advanced Configurations” on page 346
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 395
Confidential.
Knowledge Base: ADMINISTRATION
Validation Overview
Creation Date: August 24, 2006
Revision Date: August 24, 2006
Product:
DS-Client
Summary
The “Validation” process is designed to help you to verify restorability of on-line data.
Without the customer / DS-Client encryption keys, DS-System is not able to create the digital
signature to validate backed up data for some types of corruption. In order to avoid transmitting
large amounts of data from DS-System to DS-Client for validation, DS-Client will send the
encryption keys to DS-System based on your ACCEPTANCE / ACKNOWLEDGEMENT /
AGREEMENT to this option.
The decision to perform validation must be made from the DS-Client side. The customer knows
better than anyone else what data is more important (i.e. data that needs to be validated more
often). When a Validation process is triggered on DS-Client side, DS-Client sends a request to
DS-System to perform the validation.
• For each file (generation), DS-System will first check the file header and delta
linking/library linking, etc.
• If everything is fine, it will try to validate the data by performing a procedure
like a “virtual restore”. The data will be decrypted and decompressed to
generate the original signature.
• If it fails due to a decryption or decompression problem, the validation fails.
• Finally, it will compare the generated signature with the original one: if it does
not match, the validation fails; otherwise the validation is successful.
• For any validation failure, the error will be reported on both DS-Client and
DS-System. If the validation fails due to reading or network problems, it is
unknown whether or not the file is valid. Validation will skip the file and report
the corresponding errors on both DS-System and DS-Client event logs.
• For other failures where DS-System can confirm the file is corrupted, the file
will be moved to the trash (\del directory). All dependant files will also be
moved as well.
Since the validation process will read all data to check the digital signature, the validation process
is Disk I/O intensive on DS-System side.
The whole process is almost the same as an actual restore, except that INSTEAD OF writing to a
target location, the decrypted/decompressed data is not kept after generating the signature.
A variety of options are provided to help validate on-line data in the most flexible and efficient way.
These options include: validation of all data, selective validation, scheduled / on-demand
validation, excluding data deleted from source, and resuming mechanism, etc.
Validation functionality description
1. The encryption keys must be input by the customer (from DS-User) and DS-Client
verifies them. The dialog that asks for encryption key(s) will display a warning with a
description of how the encryption key(s) are involved in the Validation process.
• The encryption keys are encrypted when being transmitted from DS-User to
DS-Client, and from DS-Client to DS-System.
• Encryption keys are only used to perform the data Validation: DS-System will
not keep the keys after the Validation has finished.
2. The Validation process can be triggered on demand, as well as scheduled.
3. The demand Validation has two options:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 396
Confidential.
Knowledge Base: ADMINISTRATION
•
•
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
Validate all online data (all generations of all files).
Selective – pop up a selection tree similar to the restore tree to allow selection
of directories/files as well as generations to validate.
The execution sequence for a backup set’s scheduled activities is: 1. Perform Backup,
2. Enforce Retention, 3. Perform Validation, 4. Perform BLM.
When setting a schedule to perform Validation, the customer must input the
encryption key(s) and DS-Client verifies them. The Validation activity can only be
enabled in a schedule if the user provides the correct encryption key(s).
The scheduled Validation has options to:
• Validate all on-line data (all generations of all files) or last generation only
(snap shot)
• Include or exclude files already deleted from source.
The scheduled Validation also has the option to resume from the point of interruption
of the previous scheduled Validation process.
• If a scheduled Validation completely processes all selected files, the next
scheduled Validation (for the same backup set) will process files from the
beginning.
• To determine the interruption point, the files are processed in sequence
based on the order of share ID, directory ID, file ID and generation.
Note: On demand Validations do not have the resume mechanism.
Validation is not available for statistical backup sets, since there is no data on
DS-System to validate.
If a file corruption is detected (including “Digital Signature does not match” errors), that
file and all files that actually depend on it (occasionally, a delta may formally depend
on a file, but does not actually depend on it) will be moved to the \del directory. The
corresponding error will be reported on both DS-System and DS-Client sides.
If a file’s restorability status cannot be determined temporarily (networking problems,
etc.), DS-System will skip the validation for this file. The corresponding error will be
reported on both DS-System and DS-Client sides.
If a file originally did not have a signature that is needed for Validation, a warning will
be reported.
If any bad files are removed, DS-System will mark the backup set as “out of sync” at
the end of the Validation process.
Only users with the Administrator Role on DS-Client are allowed to start a Validation
process.
See Also
“Validation of On-line Storage” on page 206
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 397
Confidential.
Knowledge Base: BACKUP
Knowledge Base: BACKUP
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 398
Confidential.
Knowledge Base: BACKUP
Backup Limitations
Creation Date: March 17, 2006
Revision Date: October 31, 2007
Product:
DS-Client
Summary
This article describes some DS-Client backup limitations related to the length of the source file
names and to the length of the path where the source files reside.
Details
The following directory path and file name limits exist, depending on the type of database used by
the DS-Client:
Windows DS-Client
• Directory Path Limit: 435 characters (the entire path up to the beginning of the
file name).
• File Name Limit: 255 characters (file system limitation).
Linux DS-Client
• Directory and File Path Limit: 1023 characters (the entire path including the
file name).
• File Name Limit: 255 characters (file system limitation).
In most cases, the file system will prevent users from creating directory paths longer than these
limits. However, if your environment has paths that exceed a DS-Client Database limit, the DSClient will log an error (Directory path is too long.).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 399
Confidential.
Knowledge Base: BACKUP
Best Practices: Initial Backup
Creation Date: December 04, 2007
Revision Date: December 04, 2007
Product:
DS-Client
Summary
This article describes the Initial Backup Best Practices.
DS-Client-side best practices for Initial Backup
When running initial backups the following aspects need to be taken into account:
• The path specified must accommodate the size of the incoming data.
• The file system on the initial backup buffer must be able to handle the size of
the incoming files (e.g. FAT32 has a 4GB file size limitation).
• When running several initial backups at the same time, make sure the device
where initial buffer is located can handle the I/O load. If too many initial
backup processes are sending data to the same path at the same time, the
sessions may stop and the related errors will be reported.
• All Initial Backup Sets written to the same Initial Backup Path must be
"completed" before the physical media is sent to your Service Provider (check
in DS-User > Initial Backup > Status).
• Always check the DS-Client Activity Log and the Event Viewer at the end of
every initial backup session to ensure that no errors are reported.
• If the initial backup session is interrupted, it can be resumed but you must
synchronize the backup set (Right-click the backup set > Synchronize:
Normal). To resume, start another backup session. The other option is to
reset the backup set as “Incomplete”, then re-run the Initial Backup from the
beginning (DS-User > Initial Backup > Status).
See Also
“Initial Backup” on page 209
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 400
Confidential.
Knowledge Base: BACKUP
Backing up Windows for Bare Metal Restore (BMR)
Creation Date: April 23, 2007
Revision Date: November 05, 2007
Product:
DS-Client (Windows)
Summary
A Bare Metal Restore is the restore of an entire machine (usually to replacement hardware and to
a new Operating System installation).
To be able to perform BMR, you must protect the target computer with a single backup set that
contains:
• System State and Services Database
• Operating System Volume
NOTE: Some applications can be installed and can store data across multiple volumes. You must
include all of those volumes in this backup set if you want to be able to restore those
applications.
Depending on the applications running on the target computer, you may need to stop them for the
initial backup, in order to facilitate a smooth BMR. To protect those services after the initial backup
and when they are running (i.e. in “hot” mode), you must create separate backups with the
corresponding special backup sets (e.g. “MS SQL Server Database Backups” on page 93).
Details
The reason you must perform at least one backup of the target computer with the service
applications stopped is to ensure that any locked files used by those applications are backed up at
least once. Otherwise, those services will not start after you perform the BMR.
In order to restore from the special backup sets (e.g. MS SQL Server), the DS-Client needs to
connect to a running service. If the service cannot start, you must repair that service installation
with the corresponding Installation Package.
In general, the steps for BMR of a Windows computer running MS SQL Server are:
1. Assemble the replacement hardware for the target BMR computer.
2. Re-install the same Windows Operating System (you do not need to apply any
Service Packs).
3. If the Hardware is different from the original computer, you must install the
corresponding hardware drivers.
4. Restore from the target computer’s backup set (including Operating System Volume,
System State and Services Database).
5. Restart the MS SQL Server (if applicable).
6. Restore the latest version of MS SQL Server from the separate special backup set (if
applicable).
See also
•
•
•
“Bare Metal Restore of Windows 2000 / 2003” on page 489.
“Bare Metal Restore of Windows XP” on page 496.
“Important Notes for Bare Metal Restore” on page 497.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 401
Confidential.
Knowledge Base: BACKUP
Backup of Windows Encrypted Files
Creation Date: March 26, 2008
Revision Date: March 26, 2008
Product:
DS-Client (Windows)
Summary
When a DS-Client encounters “Windows encrypted” files on a Windows source machine, the DSClient uses a different Microsoft API to back them up. “Windows encrypted” refers to files
encrypted using the Windows File System encryption.
• The DS-Client will receive the data in its encrypted format, and it will encrypt it
again and compress it, then send it to the DS-System.
• The master/delta algorithm is still invoked, however the delta file size will be
close (in terms of size) to the master file’s size.
During restores, the DS-Client will retrieve the data from the DS-System, decrypt the data from the
DS-Client encryption, and then save it to the destination machine (in Windows Encrypted form).
The restored files are still encrypted as they were when they were backed up. Windows has to
manage and decrypt them at that point (i.e. you cannot restore them on FAT, etc.).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 402
Confidential.
Knowledge Base: BACKUP
Backup of Microsoft SQL Server 2000 Desktop Engine
Creation Date: February 6, 2004
Revision Date: July 30, 2004
Product:
DS-Client
Summary
This article deals with backups of the Microsoft SQL Server 2000 Desktop Engine (MSDE).
Problem
Due to a Microsoft security fix in the MSDE, the databases’ backup through pipe does not work for
instances build version >=818.
Windows SharePoint Services 2003 is one example (there may be others) of an application that
installs MSDE v.8.00.880 by default. When backing up databases from this instance using DSClient Pipe or DS-Client Buffer, DS-Client fails and records an error for each database backed up,
like:
"Cannot open backup device ‘\\.\pipe\model.1’. Device error or device offline. See the SQL Server error log for more details. BACKUP DATABASE is
terminating abnormally."
Workaround
There are three options when creating a SQL Server type set:
1. Backup through DS-Client Pipe.
2. Backup through DS-Client Buffer.
3. Backup through local buffer (it dumps the databases to a specified location on the
same server as MSDE/SQL Server.
Use the option 3. (above) in order to successfully backup MSDE instances build version >= 818.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 403
Confidential.
Knowledge Base: BACKUP
Backup of Microsoft SQL Server 2005 and SQL Server
2005 Express
Creation Date: January 12, 2007
Revision Date: November 20, 2007
Product:
DS-Client (Windows)
Summary
This article deals with backup of Microsoft SQL Server 2005 and backup of SQL Server Express
2005.
Note:
Backups of MS SQL 2005 databases only work with a disk dump (not DS-Client Buffer or
DS-Client Pipe).
Troubleshooting / FAQ / Error Messages
Problem
If you try to backup a remote instance of Microsoft SQL Server 2005 or SQL Server Express 2005,
it may fail with the following error:
"SQL server does not exist or access denied. ConnectionOpen (Connect(
)).SQL:exec xp_msver ProductVersion)"
Reason
The remote SQL Server instance may not be configured for remote connections.
• By default, SQL Server Express 2005 is installed (configured) only for local
connections.
• By default, MS SQL Server 2005 is installed (configured) for remote
connections, but this might have been changed.
Workaround
Use the SQL 2005 "Surface Area Configuration for Services and Connections" tool:
1. Start > All Programs > Microsoft SQL Server 2005 > Configuration Tools > SQL
Server Surface Area Configuration > Surface Area Configuration for Services and
Connections.
2. Browse the Instance tree for Database Engine > Remote Connections. Select “Local
and remote connections” and “Using TCP/IP and named pipes”.
3. Start SQL Browser service on the remote server.
Note:
This does not apply to local SQL Server instances (residing on the DS-Client machine).
--Problem
64-bit Windows DS-Client fails to create a new MS SQL Server backup set (in New Backup Set
Wizard) with the following popup error:
"Runtime Error!
Program: c:\program files\Data Storage\DS-Client\dsclient.exe
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 404
Confidential.
Knowledge Base: BACKUP
R6034
An application has made an attempt to load the C runtime library
incorrectly.
Please contact the application's support team for more information."
Reason
This is a Microsoft Bug with MS SQL Server 2005.
• The 64-bit MS SQL Server 2005 release (prior to Service Pack 1) has a
problem with native 64-bit applications that use SQL-DMO (SQL Distributed
Management Objects).
Solution
The MS SQL Server 2005 minimum requirement for DS-Client is Service Pack 1.
• Use 64-bit MS SQL Server 2005 Service Pack 1 for the DS-Client database.
--Problem
DS-Client backing up a mirrored MS SQL Server 2005 database receives the following error:
"BACKUP LOG WITH TRUNCATE_ONLY cannot operate on database '<databasename>' because it is configured for database mirroring."
Reason
This is a limitation with MS SQL Server 2005.
• Mirrored MS SQL Server 2005 databases do not support the “Truncate
Transaction Log” backup option.
Solution
•
•
Truncate logs should not be used on backup sets connecting to a mirrored
MS SQL Server 2005 database. (Do not select “Truncate Transaction Log” in
the New Backup Set Wizard - Set Properties Items Tab screen.)
You can turn this option off from Backup Set Properties > Items Tab:
“Truncate Transaction Log”
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 405
Confidential.
Knowledge Base: BACKUP
Backup of NetWare Servers (DOS Partition)
Creation Date: March 10, 2000
Revision Date: December 21, 2005
Product:
DS-Client (NetWare 6.x)
Summary
This article covers one of the methods you can use to backup the DOS Partition of a NetWare
Server.
Mount the DOS Partition as a volume
1. Once NSS is loaded, issue the following command at the server console prompt:
dosfat.nss
2. The volume DOSFAT_C will be created and can be backed up by DS-Client.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 406
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Novell NetWare files from a
Windows DS-Client
Creation Date: January 21, 2008
Revision Date: January 21, 2008
Product:
DS-Client (Windows)
Summary
This article deals with Backup and Restore of NetWare files from a Windows DS-Client.
NOTE: You must install the corresponding Novell NetWare Client on the target backup/restore
computer.
There are several other Knowledge Base articles that deal with specific situations. These are listed
below, under “See Also”.
Backup
Once Novell NetWare is properly configured, the NetWare files can be backed up (and restored)
through:
• a “File System” backup set (See “File System Backups” on page 80.).
Restore
Since NetWare files are backed up as File System backup sets, see the following restore sections
for instructions:
• “Restore File System Backups” on page 172
• “Restore NetWare Servers (Files and NDS)” on page 178
See Also
“Novell NetWare Backups” on page 92
“Restore NetWare Servers (Files and NDS)” on page 178
“Setting up the Novell NetWare Client on the DS-Client computer” on page 335
“Backup of NetWare Servers (DOS Partition)” on page 406
“Backup / Restore of Novell NetWare files from a Linux DS-Client” on page 408
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 407
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Novell NetWare files from a Linux
DS-Client
Creation Date: April 11, 2007
Revision Date: January 21, 2008
Product:
DS-Client (Linux)
Summary
This article deals with setup of Novell NetWare for Backup and Restore of NetWare files from a
Linux DS-Client.
Once Novell NetWare is properly configured and its mount point is visible to Linux DS-Client, the
NetWare files can be backed up (and restored) through:
• a “Local File System” backup set, if the file system is mounted on the DSClient computer;
• an “SSH” backup set, if the file system is mounted on a different network
computer.
Note: You cannot use the NFS protocol to browse to a mounted NetWare File System.
Linux DS-Client can backup the following NetWare configurations:
• NetWare on Open Enterprise Server (with Novell Client for OES)
• NetWare on SuSE 9 (with Novell Client for SuSE 9)
• NetWare on SuSE 10 (with Novell Client for SuSE 10)
NOTE: You must install the corresponding Novell NetWare Client on the target backup/restore
computer.
Configuring NetWare Server
Once a NetWare volume is mounted and its share is visible to DS-Client, its files can be backed up
and restored like any other pure data backup sets:
• On the NetWare Server, install Novell Client for the corresponding type of
Operating System (Open Enterprise Server, SuSE 9, or SuSE 10). Novell
Client automatically starts upon successful installation.
• Login to NDS using either gnwlogin or nwlogin utilities. By default, they are
located in /opt/novell/ncl/bin;
• By default the Novell Netware of the server that logged in will be mounted on /
var/opt/novell/nclmnt.
• If using the DS-Client on the NetWare Server, you can create “Local File
System” backup sets to backup files under the mounted NetWare volume(s).
If using DS-Client on another machine, you can create an “SSH” backup set
to backup files under the mount point.
• You should be able to perform backup, disc/tape, blm, and restore.
There are several other Knowledge Base articles that deal with specific situations. These are listed
below, under “See Also”.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 408
Confidential.
Knowledge Base: BACKUP
See Also
“Novell NetWare Backups” on page 92
“Restore NetWare Servers (Files and NDS)” on page 178
“Setting up the Novell NetWare Client on the DS-Client computer” on page 335
“Backup / Restore of Novell NetWare files from a Windows DS-Client” on page 407
“Backup of NetWare Servers (DOS Partition)” on page 406
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 409
Confidential.
Knowledge Base: BACKUP
Backup of Open Files
Creation Date: May 2, 1997
Revision Date: February 02, 2008
Product:
DS-Client (Windows)
Summary
Since workstations and servers can have any number of open files during backups, those files
might cause problems and/or backup errors. Open files can be backed up successfully, fail to be
backed up, or be backed up with potential integrity problems.
Depending on the type of open file and operating system of the server/workstation, steps can be
taken to reduce or eliminate this Open Files Backup problem.
• “Types of Open Files” on page 411
• “Open File Backup Strategy Options” on page 412
• “Third Party Software - Open File Managers” on page 412
• “VSS (Volume Shadow Copy Service)” on page 413
• “Conclusion” on page 413
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 410
Confidential.
Knowledge Base: BACKUP
Types of Open Files
Type of Open file
Temporary or
System-Only Files
e.g.:
• “pagefile.sys”
• “backout.tts”
Special File Types
e.g.:
• MS Exchange
• Oracle
• DB2
• MS SQL Server
• MS Outlook
• System State /
Registry
• etc.
Files opened by
other applications
Backup Methods
These files are just temporary storage and do not require backup/restore.
System-only files (like backout.tts on NetWare servers or pagefile.sys on Windows servers) and temporary files created by various applications are useless and should be
excluded from backups.
The DS-Client has a list of the files that will be ignored during the backup process,
thereby eliminating unnecessary errors (the DS-Client installation sets up a default list
of System only files for Windows and NetWare computers). This list can be expanded to
exclude additional files that are unnecessary for backup.
• To modify this list, run the Registry Editor (Filename: regedt32). Open
HKEY_LOCAL_MACHINE \ System \ CurrentControlSet \ Services \ DS-Client \ Parameters \ System Files, and simply add filename(s) for files you want the DS-Client to
skip.
The DS-Client has separate backup set types for a significant number of common applications which use locked files (e.g. Databases).
When backing up such resources, they are not backed up as files. Instead, the DS-Client will use the native backup API corresponding to the backup source (it will perform
hot backup of such databases, without any locked files or consistency issues).
• The DS-Client automatically excludes known Special Files, like Registry and Bindery
files during regular file system backups, in order to eliminate unnecessary errors.
Any open file that does not belong to first two categories (Temporary or Special files)
is considered a regular file. DS-Client will attempt to backup a regular file using the
steps described below.
Files can be opened by applications in different ways. In general, the DS-Client will be
able to back up a file successfully as long at it has permission to read it. To improve
the chance of reading a file, DS-Client has the following options:
• On read failure, the DS-Client can be instructed to retry up to 10 times with a userconfigurable delay between retries (Backup Set Properties > Options Tab).
• If a locked file can be opened for reading, the DS-Client will attempt to make a
consistent backup by trying to prevent other applications from writing to the file,
using 4 levels of locking (whole file lock, complete byte ranges lock, partial range
lock and no lock usage). Locking options can be modified by the end-user (See
below: “Open File Backup Strategy Options” on page 412).
• Pre/Post capabilities in the DS-Client allows a customized backup to be performed
for special files/applications for which the DS-Client does not have a built-in
backup set type. This allows the DS-Client to issue “dump” commands to 3rd party
applications or to stop applications/service that keep files locked and once the
backup is complete, to erase the dump files or restart/resume the application.
(See “Backup Set Options - Pre/Post” on page 78.).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 411
Confidential.
Knowledge Base: BACKUP
Open File Backup Strategy Options
Each backup set is configured (Backup Set Properties > Options Tab) with a strategy to handle
open files. Unless altered, the default setting will apply (Setup > Configuration > Defaults Tab).
If the DS-Client encounters an open file during the backup process, it will deal with it as prescribed
in the strategies below:
Strategy
Backup Strategy Description
Try Deny Write
Attempt to open backup file in 'Deny Write' mode. If this fails (because the file is already
open for writing), place the backup file in 'Allow Write' mode.
Deny Write
This mode prevents any other process from opening backup file for writing to, while the
DS-Client has it open. DS-Client will not back up the file, if another process has already
opened it for writing. (However, you may instruct the DS-Client to retry backing up the
open file.)
Prevent Write
Attempt to open backup file in 'Deny Write' mode. If this fails (because the file is already
open for writing), then open in Allow Write mode and lock the file, thereby preventing any
process from writing to the file for duration of backup. This ensures that the most recent
version of the file is backed up.
Allow Write
Allow another process to read/write to the backup file (no restrictions). Since other applications can write to the file while it is being backed up, this may affect file consistency.
If the backup of an open file fails on the first attempt, the DS-Client can be instructed to retry up to
ten times.
Note:
Even with the Open File Backup Strategy options, files that are completely locked will not
be accessible (they will fail to be backed up with errors). However, these files can be
accessed by using a third-party Open File Manager (See below: “Third Party Software Open File Managers” on page 412). Once DS-Client can read the file, it can be backed up.
Third Party Software - Open File Managers
The DS-Client will fail to backup files that are completely locked (i.e. files opened with deny read/
write). Even if open files are backed up, those files may have potential integrity problems (as
described above).
If you must backup those locked files, then consider a third-party solution like the one provided by
St. Bernard Software: Open File Manager™ is a solution for backing up locked files (even if
completely locked by another application).
The drawback is it must be installed as an agent on each target backup computer (with any locked
files). It runs only on Windows NT and NetWare Servers. For more information visit
www.stbernard.com.
You will need to configure the software to work with the DS-Client. Follow these steps to configure
St. Bernard Software's Open File Manager (These instructions are valid for OFM version 6.2 on
Windows NT or NetWare):
1. Install and run the Open File Manager software.
2. Use OFM to install the Agent on the target backup node (the one with the locked files).
3. Start the Agent and synchronize it with the OFM (Right-click / synchronize).
4. Open the Properties dialog and switch to the Agents Tab.
5. Disable all entries except "Remote System Backup NT".
6. Enable the "Remote System Backup" option.
7. In the Agent configuration section, specify User Name: <name>. (This must be the
same user name as in the Backup Set Properties > Share Tab > Connect As field.) St.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 412
Confidential.
Knowledge Base: BACKUP
Bernard recommends that you do not use user names like Administrator, Admin, or
Supervisor.
8. Once configured, Open File Manager will process and manage open files on the
target computer. (Note: OFM also has a list of system files that it excludes from OFM
management.)
9. Now, the DS-Client can backup the open files on the target computer (even if they are
opened in 'deny read/write' mode).
VSS (Volume Shadow Copy Service)
Some Windows servers support VSS, which is a Windows feature that DS-Client can use to create
an exact copy of the files, including all open files.
• VSS is configured from the Backup Set Properties > Advanced Options Tab
(for Windows servers that have the service available).
• If configured, DS-Client will initiate a VSS snapshot for the specified computer
(for any local volumes included in the backup) and perform the backup from
the VSS snapshot.
• If the VSS snapshot fails, DS-Client tries to backup like a regular File System
backup set (where the Open File strategy will apply).
• For more information about VSS, refer to the corresponding Windows Help.
Conclusion
To reduce problems caused by backup of open files:
1. Perform scheduled backups during off-peak hours.
2. Perform special file backups for appropriate backup types.
3. Exclude system and useless files to eliminate unnecessary errors.
See Also
“Backup Set Options - Pre/Post” on page 78
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 413
Confidential.
Knowledge Base: BACKUP
Backup using Microsoft VSS (Volume Shadow Copies)
Creation Date: February 05, 2008
Revision Date: February 05, 2008
Product:
DS-Client (Windows)
Summary
This article covers backup of Windows Servers (XP, 2003, VISTA) using Microsoft VSS (Volume
Shadow Copy Service). It explains how DS-Client works with VSS and when it is recommended to
use VSS to perform backups.
Details
File System backup sets for Windows Servers (XP, 2003, VISTA) may be configured to use VSS
to perform the backup. This option must be specifically enabled for each backup set in the Set
Properties Advanced Options Tab.
During backup of sets configured to use VSS:
1. The DS-Client will connect to the source machine and will instruct the VSS service to
take a snapshot of that machine.
2. After the snapshot is generated, DS-Client will continue its backup using the VSS
snapshot.
Note: In order to use the VSS backup method, sufficient storage must be available on the source
machine in order to hold the snapshot.
3. If any problems occur during the backup from the snapshot (or if the VSS snapshot
fails), DS-Client will try to backup using the traditional ASIGRA Televaulting
‘agentless’ backup (lock the files, open them, read the files, process the files for
incremental forever, compression, encryption and send the files to the DS-System).
4. The "Do not involve writers" option is left unchecked by default (recommended). This
means DS-Client will communicate with the applications that integrate with Microsoft
VSS in order to produce the most consistent backup of data.
Backup of Windows VISTA servers (File System backup sets)
For Windows VISTA servers, VSS is always used to backup the System State and Services
Database.
Common scenarios when to backup using VSS
•
•
•
Locked files. See How ASIGRA Televaulting handles locked files article in
“Backup of Open Files” on page 410.
Bare Metal Restore
Other databases (not part of the special backup types available in the New
Backup Wizard) if the database engine you are trying to backup integrates
with VSS (has writers).
See Also
“Backup of Open Files” on page 410
“Backing up Windows for Bare Metal Restore (BMR)” on page 401.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 414
Confidential.
Knowledge Base: BACKUP
Backup of UNIX Server
Creation Date: November 13, 1997
Revision Date: December 19, 2005
Product:
DS-Client (Windows)
Summary
Note:
This article applies to WINDOWS DS-Client backups of UNIX servers. The LINUX DSClient does not have these requirements.
Windows DS-Clients can support UNIX file backups, if some requirements are fulfilled on both the
DS-Client computer and the UNIX side.
Configurations must be made on the UNIX side if you wish to backup file security information
(UNIX file permissions, file owner and file group). These configurations will allow "root" access to
your UNIX server(s). If you do not want to allow root access, the DS-Client can still backup your
UNIX servers. However, backups will not contain any file system security information, and you
may not have full access to all backup data.
Windows DS-Clients can backup and restore UNIX files via Hummingbird NFS or via SAMBA:
• For Hummingbird NFS, see “Requirements for backup via Hummingbird” on
page 415
• For SAMBA, see “Requirements for backup via SAMBA” on page 416
Requirements for backup via Hummingbird
1. NFS Client on DS-Client Computer
• The DS-Client computer must be running an NFS Maestro client from
Hummingbird Communications Inc., version 8.0 (with patch # 8007) or
higher.
2. Allowing "root" access to UNIX shares
You need to configure the DS-Client computer's Registry with the following:
• HKEY_LOCAL_MACHINE > SOFTWARE > Hummingbird > Connectivity >
8.0 > NFSClient
• Edit Menu > Add Value:
Value:
EnableRootAccess
DataType:
REG_DWORD
DWORD
Data
Value:
1
3. Specify UNIX computer by NAME (not by IP address)
• Whenever required, you should specify the UNIX computer by its machine
name (and not its IP address).
4. NFS Server Daemon on UNIX Server
• In order to backup UNIX servers (including file system security information)
the UNIX server must be running an NFS server daemon.
• The UNIX server must be running a PCNFS daemon in order to authenticate
the DS-Client computer, or HCLNFSD.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 415
Confidential.
Knowledge Base: BACKUP
5. Allowing "root" authentication to the UNIX server
• By default, PCNFSD will only allow authentication or print requests for users
with UIDs in the range 101 to 60002. This corresponds in SVR4 to the range
for non-system accounts. In order to override this range limitation, you must
add a line to the pcnfsd.conf file (usually located in the /etc directory). This
line should be in the form:
uidrange 0-655376
•
If the pcnfsd.conf file does not exist, you must create it. For more information,
check the UNIX man pages about NFSD and PCNFSD.
• Please note that this change allows "root" access to your UNIX server(s).
6. Allowing "root" access to UNIX shares
• Once "root" authentication has been configured, you must permit "root"
access to the UNIX shares. Normally, this is done in the dfstab file or exports
file. However, it may differ depending on the type of UNIX that you are
running. Consult your share or exports man page for more information.
• The following is a sample dfstab file:
#place share(1M) commands here for automatic execution
#on entering init state 3.
#
#share [-F fstype] [ -o options] [-d "<text>"] <pathname> [resource]
#.e.g,
#share
-F nfs
-o rw=engineering
-d "home dirs"
/export/home2
share -F nfs -o rw,root=ds-combo:devel-1 /
share -F nfs -o rw,root=ds-unix1:ds-combo:devel-1 /usr
share -F nfs -o rw,root=ds-combo /tmp
share -F nfs -o rw,root=ds-combo:devel-1 /export/home
•
Once the above configurations have been implemented, you will be able to
perform backups and restores of your UNIX data with full "root" access.
Requirements for backup via SAMBA
1. SAMBA Server Daemon on UNIX server
• The target backup UNIX server must be running a SAMBA server daemon.
This will allow Windows DS-Client to backup that UNIX server’s data (but not
the file system security information).
2. User credentials on SAMBA Server
• The DS-Client service must provide the correct SAMBA user credentials to
connect to the SAMBA Server.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 416
Confidential.
Knowledge Base: BACKUP
Limitations of UNIX Server Backups (with Windows DS-Client)
No UNIX Link support (backup or restore)
The following limitations exist with respect to backups and restores of UNIX Server Files:
Backup
Windows DS-Client does not support backup of UNIX links. Instead, the full
file will be backed up. Therefore, a separate backup will occur at every
instance of a link in the backup set files. This means that more backup data
will be stored on-line than was originally specified (especially if there are
several links, or if the linked files are particularly large).
Restore
No links will be restored. At every instance of a link in the original backup
file, the full linked file will be restored in its place. This means that more
backup data will be restored than was originally backed up. This can be a
particular problem if there is insufficient disk space on the restore server.
Limited UNIX Permission support (backup or restore)
Windows DS-Client backup and restore of UNIX permissions is limited.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 417
Confidential.
Knowledge Base: BACKUP
Backup of VMWare (host-side backup)
Creation Date: October 25, 2005
Revision Date: January 18, 2007
Product:
DS-Client
Introduction
The DS-Client normally performs backup of virtual machines from the "guest" side, treating them
like any other Windows or Linux computer.
However, it is possible to backup a virtual machine from the "host" side. This unique solution offers
the advantage of an "image" backup, combined with the advantages of the ASIGRA Televaulting
backup solution (e.g. incremental backup, common file elimination, off-site backup, etc.).
Host-level backup and restore of a virtual machine refers to a backup of the files that make up the
virtual machine (the guest OS is not involved in the backup and restore operation).
ASIGRA Televaulting supports host-level backup and restore of:
• VMWare ESX Server 2.5.x and 3.x virtual machines running any operating
system. (See “Backup of VMWare (ESX Server host-side backup)” on
page 419.)
• VMWare GSX Server 3.1.x virtual machines running any operating
system.(See “Backup of VMWare (GSX Server host-side backup)” on
page 421.)
Advantages
•
•
•
•
•
•
•
Incremental backup: The initial backup operation saves all the files that make
up the virtual machine. Subsequent backups are incremental backups on both
the file level (only new or changed files are backed up) and on the block level
(only changed or new blocks of data are backed up).
Agentless architecture: There is no need to install software agents on the
ESX/GSX server, or the virtual machines.
The virtual machines can run any operating system supported by VMWare.
Their operating systems are not involved in the backup or restore operations.
Virtual machines can be running, or they can be turned off during the backup
operation.
Multiple generations of virtual machines: Asigra software can be configured to
backup multiple generations of a virtual machine.
Common files elimination: Only one instance of identical files is stored at the
remote backup location.
Compression and encryption of backed up data.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 418
Confidential.
Knowledge Base: BACKUP
Backup of VMWare (ESX Server host-side backup)
Backup requirements
The VMWare ESX Server (2.5.1 or 3.x) must be configured for the host-side backup and restore.
Step 1. Update Perl
Backup of VMWare virtual disks of a size greater than 2GB is not possible if Perl (which is installed
on the ESX server 2.5.1 and 3.x) is not compatible with large files. To check the compatibility, run
the following command on the ESX server:
perl –V
Check the output for the “uselargefiles” variable. If this variable is undefined, you must update Perl
to the version 5.8.1 or higher. In order to do this, go to the web site www.activestate.com and
download the latest release. Next, run the following commands:
rpm –ivh updatefile.rpm
/opt/updatefile/bin/perl
mv /usr/bin/perl /usr/bin/perl.old
ln –s /opt/updatefile/bin/perl /usr/bin
Note: in the above examples, replace updatefile with the name of the downloaded file,
e.g. ActivePerl-5.8.7.813-i686-linux-22.17-gcc-148120.
Step 2. Configure the vmware-cmd file
After the Perl upgrade, the vmware-cmd command may no longer work since it is not compatible
with the new Perl. You will, however, need this command in order to register restored virtual
machines. To fix this problem, go to the /usr/bin/ directory and edit the vmware-cmd file as well as
the vmware*.pl files in this directory; change the first line in each file to refer to the old Perl
installation (replace “#!/usr/bin/perl” with “#!/usr/bin/perl.old”). Run vmware-cmd without
parameters to verify that it works.
How to make an ESX host-side backup set
Follow these steps in order to make a host-side backup of a Virtual Machine:
1. Using a Linux DS-Client, create a file-system backup set containing:
• The configuration file (*.vmx), log files (*.log) and the nvram file.
ESX server 2.5.1: These files are located in a subdirectory of /root/vmware.
ESX server 3.x: These files are located in the same location as the virtual disk file,
which is located in a subdirectory of /vmfs
• The virtual disk (or disks). They are located in a subdirectory of /vmfs.
2. Make sure one of the following is true:
• The virtual machine being backed up is turned off, or
• The virtual disks are in the undoable mode, or
• The virtual disks are in the nonpersistent mode, or
• The virtual disks are in the append mode
3. When creating the backup set, make sure that the “Backup ACL” option is turned on
(you can find this option in the backup items options).
Note 1: if a virtual disk is in the persistent mode, the backup operation will not be successful.
Note 2: if you fail to backup ACL, you will have to manually restore the attributes of the .vmx file in
order to start the restored virtual machine.
Note 3: if the ESX server does not allow remote logon of the administrative user account necessary
to perform backup/restore, you can create a host-side backup set that connects with a
regular user account, and then uses the "sudo" option (Backup Set Properties >
Connection Options).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 419
Confidential.
Knowledge Base: BACKUP
How to backup an ESX host-side backup set
1. Run the backup set as you normally would.
2. When finished, check the DS-Client event log for errors. Make sure all the Virtual
Machine files were backed up without errors.
How to restore an ESX host-side backup set
1. Restore the files that make up the virtual machine.
2. If your Virtual Machine is still registered (this can happen if your virtual disks were
destroyed, but the Virtual Machine registration was not removed), you do not have to
perform this step. However, if your Virtual Machine is no longer registered (and as a
result, it does not appear in the VMWare status monitor), you must register it running
the following command on the ESX server:
vmware-cmd –s register "path-to-vmx-file"
Note: in the above command line, replace path-to-vmx-file with your path to the vmx file,
e.g.:
vmware-cmd –s register "/root/vmware/suzelinux/suzelinux.vmx"
Disaster Restore of an ESX server
Bare Metal Restore of the ESX 2.5.1 or 3.x Server running on RedHat Linux is not supported. If
you have lost your server in a disaster, follow these steps:
1.
2.
3.
4.
5.
Install the VMWare ESX Server from you installation CD on a new computer.
Configure the ESX server for host-side backup and restore as described above.
Restore the Virtual Machine files (directories /root/vmware and /vmfs).
Register the restored Virtual Machines using the vmware-cmd command.
If you installed the ESX server on a different hardware, you may want to fine-tune the
Virtual Machines (e.g. if the new hardware has a different amount of RAM, you may
want to assign a different amount of RAM to each virtual machine etc.).
6. Start the Virtual Machines.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 420
Confidential.
Knowledge Base: BACKUP
Backup of VMWare (GSX Server host-side backup)
Backup and Restore support
In the simplest case, you can backup the directory of the VMWare machine as a normal file system
backup set. This approach, however, is only possible if the virtual machine is not running.
If the VMWare machine to backup is running, you may encounter unpredictable results. Therefore,
you should suspend the virtual machine before the backup operation, perform the (incremental)
backup operation, and then resume the virtual machine.
If your GSX server virtual machine must be running during the backup operation, you cannot
suspend it. You can, however, use another solution:
• Change the mode of the virtual disk to nonpersistent.
The following examples demonstrate the suspend method.
Configure batch files to suspend and resume a Virtual Machine
To automatically suspend and resume a VMWare machine, you can use the DS-Client’s Pre/Post
feature. The following sample batch files: "suspend.bat" and "resume.bat" demonstrate this
solution.
The "suspend.bat" file uses a sample script provided by the VMWare Scripting API. The script
"suspend.pl" is normally located in "C:\Program Files\VMware\VMware VmPerl Scripting
API\SampleScripts".
These are the contents of the "suspend.bat" file:
c:
cd "\Program Files\VMware\VMware VmPerl Scripting API"
perl samplescripts\suspend.pl "C:\Virtual Machines\Windows 2000 Advanced
Server\win2000AdvServ.vmx"
Note:
You must modify the above according to your path and configuration file name.
VMWare did not provide a sample script to resume a suspended virtual machine. A "resume.pl"
script can be created by modifying the following lines of the "suspend.pl" script:
if ($curState == VM_EXECUTION_STATE_ON) {
print "Can only start a Virtual Machine which is not running.\n";
} else {
# Resumes the suspended Virtual Machine.
if (!$vm->start()) {
my ($errorNumber, $errorString) = $vm->get_last_error();
print "Could not resume: Error $errorNumber: $errorString\n";
}
}
Once you have modified the script, create the "resume.bat" file:
c:
cd "\Program Files\VMware\VMware VmPerl Scripting API"
perl samplescripts\resume.pl "C:\Virtual Machines\Windows 2000 Advanced
Server\win2000AdvServ.vmx"
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 421
Confidential.
Knowledge Base: BACKUP
How to make a GSX host-side backup set
Create a backup set that performs the following steps:
1. Use the "suspend.bat" file as the Pre-command:
"C:\Program Files\VMware\VMware VmPerl Scripting
API\SampleScripts\suspend.bat"
•
(Use the "Delay backup" checkbox to make sure the Virtual Machine is
suspended when the backup starts.)
2. Backup the virtual machine files as a file system backup set.
3. Use the "resume.bat" file as the Post-command:
"C:\Program Files\VMware\VMware VmPerl Scripting
API\SampleScripts\resume.bat"
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 422
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Windows XP
Creation Date: April 10, 2006
Revision Date: April 10, 2006
Product:
DS-Client (WIndows)
Summary
This article covers various backup/restore Windows XP issues.
Backup of Windows XP from a remote DS-Client
In order to perform a full backup of a Windows XP computer, make sure the following
requirements are met:
• The 'Simple File Sharing' option must be unchecked;
Windows Explorer > Tools > Folder Options > View > Use Simple File Sharing
•
Network Access: Sharing and security model for local accounts must be set to
“Classic - local users authenticate as themselves”.
Start > Programs > Control Panel > Administrative Tools > Local Security
Policy > Local Policies > Security Options > Network Access: Sharing and
security model for local accounts > “Classic - local users authenticate as
themselves”
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 423
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Microsoft Exchange Server
Creation Date: June 19, 1997
Revision Date: March 21, 2008
Product:
DS-Client (Windows)
•
•
•
•
•
“Summary” on page 424
“Microsoft Exchange Server Support Matrix” on page 424
“Backup” on page 424
“Restore” on page 425
“Requirements for Microsoft Exchange Server 2007 SP1” on page 426
Summary
The DS-Client service allows you to backup live Microsoft Exchange Server databases (i.e. while
the databases are running). For more information, or to compare the benefits of online/live versus
offline backups, see Microsoft Knowledge Base article - Q237767.
• The machine on which the MS Exchange Server is running must have all the
default administrative shares (C$, D$, ADMIN$).
Microsoft Exchange Server Support Matrix
Check the Matrix for supported Exchange Server Versions:
Exchange Version
Platform for Exchange Server Platform for DS-Client
Support status
Exchange Server 2007
Standard & Enterprise Edition
Windows 2003 Server (x64 version)
Windows XP, 2000, 2003
Supported
Windows 2003 Server
Windows XP, 2000, 2003
Supported
Windows 2000 Advanced Server
Windows XP, 2000, 2003
Support Possible
Windows 2000 Advanced Server
Windows XP, 2000, 2003
Supported
Windows 2003 Server
Windows XP, 2000, 2003
Support Possible
Exchange Enterprise 2003
Exchange Enterprise 2000
Matrix Legend:
• Supported: DS-Client supports backup / restore of Exchange server.
• Support Possible: Asigra did not perform backup / restore tests on these
platforms, but there should not be any technical limitations.
• Not Supported: Exchange server backup / restore is not supported.
• No Vendor Support: Vendor does not support installation of Exchange on
these platforms.
Backup
The account that you are using either must be a member of the administrative group, or explicitly
included in MS Exchange with administrator rights.
If the DS-Client is not a member of the same domain as the MS Exchange server, you must enter
the network credentials when creating the backup set (Select Server Wizard Tab). In the Enter
Network Credentials dialog, you must specify either a computer name or domain name for
authentication. MS Exchange server will not accept <None>, as in this case DS-Client performs
logon impersonation (and this is invalid, since the DS-Client is not a member of the same domain).
You must also create an account on the DS-Client computer, which is exactly the same (name &
password) as the MS Exchange server administrator account. This way, when the DS-Client
computer performs the authentication, you can select DS-Client computer name in the "From"
field.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 424
Confidential.
Knowledge Base: BACKUP
MS Exchange Backups are "packages" of files that are all interdependent. If one file is missing or
corrupted, the entire backup session cannot be successfully restored. If for any reason, there is an
error in the backup of the MS Exchange Server, DS-Client will delete all the files backed up during
that session.
Restore
For restores of MS Exchange 2000:
• If, during restore, you receive the error "The server is not operational",
make sure the DS-Client computer can resolve the fully qualified domain
name of the Exchange computer through a proper DNS setting.
In cases where you are performing disaster recovery drills, or an actual disaster recovery, several
checks must be performed:
1. Assuming the machine that you backed up no longer exists (i.e. was destroyed), you
must configure a new machine and install MS Exchange on it. If you had a backup set
for the entire machine (including registry), you can restore immediately. Otherwise,
follow the next step;
2. If you did not restore the registry, check the following:
• Make sure that the machine names are the same (the server that you are
restoring to must have the same name as the server that you backed up).
• The same applies for the domain name and the administrator account.
• Make sure the location of the databases is the same (including the drive
letters).
• Once you have all these checks performed, you can start the restore process.
After the restore is complete, you should have no errors, and MS Exchange
should be up and running.
3. For more information, see Microsoft Knowledge Base articles - Q175469, Q176239,
and Q224977.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 425
Confidential.
Knowledge Base: BACKUP
Requirements for Microsoft Exchange Server 2007 SP1
The following information is specific for backup and restore of Microsoft Exchange Server 2007
with Service Pack 1:
1. To adhere to the “Microsoft Secure by Default” initiative, the remote streaming
functionality (server-wide) in Exchange 2007 SP1 is disabled by default. This
functionality is required by the DS-Client in order to perform backup and restore of the
Exchange server.
• To enable this functionality, edit the following registry value on the target
Exchange server (using regedt32.exe):
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\MSExchangeIS\Paramet
ersSystem
Name: Enable Remote Streaming Backup
Type: DWORD
Value: 0 = default behavior (remote backup disabled);
1 = remote backup enabled
2. When you apply SP1 to an existing MS Exchange 2007 server, the Microsoft version
number changes from 8.0 to 8.1.
• Any existing Microsoft Exchange Server backup sets will not work.
• You can migrate an existing backup set (See “Backup Set Migration” on
page 375.) or create a new one for the SP1 version.
See Also
“Backup Set Migration” on page 375
“Microsoft Exchange Server Backup Troubleshooting” on page 427
“Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox recovery)” on
page 483
“Alternate Location Restore of Microsoft Exchange Server 2007 (mailbox recovery)” on page 485
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 426
Confidential.
Knowledge Base: BACKUP
Microsoft Exchange Server Backup Troubleshooting
Creation Date: February 23, 2007
Revision Date: February 29, 2008
Product:
DS-Client (Windows)
•
•
•
•
•
“Summary” on page 427
“MS Exchange backup set errors with Firewall” on page 427
“MS Exchange Server errors when backing up with firewall enabled” on
page 427
“Error creating new MS Exchange server backup set” on page 428
“Information Store may crash during MS Exchange server backups” on
page 428
Summary
This Knowledge Base article contains a list of known errors, the reason(s), and suggested
solutions.
MS Exchange backup set errors with Firewall
Problem:
• During MS Exchange server backup, you get the following error in DS-Client
event log
Error returned from an ESE function call (%d). (-1003)
(\\crsexc01\G$\Exchsrvr\First Storage
Group\MDBDATA\zzArchiveMailboxStorePriv.stm )
Reason:
• One known reason for this problem is the firewall between DS-Client and
Exchange server is enabled and blocks some ports. For example, after
applying Windows XP SP2 to the DS-Client machine, the XP firewall will be
enabled automatically and causes this error. These ports are not required
directly by the DS-Client, but are required by the Exchange server functions
that DS-Client invokes.
Solutions:
• Disable the firewall; or
• If you must keep the firewall up and running, configure it to allow connections
between the DS-Client machine and the Microsoft Exchange Server.
MS Exchange Server errors when backing up with firewall enabled
Problem:
• Microsoft Exchange Server experiences unexpected stops after a backup
starts.
Solution:
• Disable the firewall; These unexpected stops were not reproducible after
disabling the firewall.
--Problem:
• Backup or restore of Exchange set fails with one of the following errors:
"Error returned from an ESE function call (%d). (317)"
"The remote procedure call failed."
Solution:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 427
Confidential.
Knowledge Base: BACKUP
•
Disable the firewall.
Error creating new MS Exchange server backup set
Problem:
• When creating a new MS Exchange server backup, you get the following error
when you select the server:
Error returned from a callback function call (0x%X).
Reason:
• You have tried to select the MS Exchange server by supplying its IP address.
Solution:
• You must supply the fully qualified domain name of the Exchange computer.
The DS-Client computer must be able to resolve the fully qualified domain
name of the Exchange computer. This can be done through a proper DNS
setting.
Information Store may crash during MS Exchange server backups
Problem:
• The MS Exchange server Information Store crashes during backup.
Reason:
• When a backup session is started for an MS Exchange Server backup set,
DS-Client invokes dedicated Exchange API functions that open a TCP/IP
connection to the Exchange Server.
• The ports used may change from one session to another. If a firewall on DSClient computer, on Exchange Server or anywhere in between is blocking the
required ports, the connection method will change to RPC. Eventually, this will
also fail and may cause an Information Store crash.
Solution:
• In order to prevent such events, the “dsclient.exe” must be added as an
exception in your firewall configuration.
• All the steps taken by MS Exchange API / ESE Backup during a backup
session are listed in the Operating System Event Viewer/application log on
the Exchange Server computer.
• If you see the line “Backup data transfer method is TCP/IP”, this confirms TCP
ports are available for use by dsclient.exe.
See Also
“Backup / Restore of Microsoft Exchange Server” on page 424
“Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox recovery)” on
page 483
“Alternate Location Restore of Microsoft Exchange Server 2007 (mailbox recovery)” on page 485
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 428
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Microsoft SQL Server
Creation Date: April 30, 1997
Revision Date: December 11, 2007
Product:
DS-Client
Summary
The DS-Client software allows you to perform online backups of MS SQL Server databases. The
DS-Client supports MS SQL Server versions 7.0 and above.
Requirement for MS SQL Server 2000 Support
You must have MS SQL Client Tools installed on the DS-Client computer in order to backup /
restore MS SQL 2000 databases.
Requirement for Clustered MS SQL Server 2000
In order to support clustered SQL 2000, the DS-Client computer must be running Windows 2000
Advanced Server.
Features Supported
Features
7.0
2000
2005
Skip Database Load
+
+
+
On-Line Database Backup
+
+
+
NT Integrated Security
+
+
+
Database Server Browsing
+
+
+
Alternate Server Restore
+
+
+
Alternate Database Restore
+
+
+
Backup Integrity Verification
+
+
+
Truncate Transaction Log before Backup
+
+
+
DB Consistency Check
+
+
+
Dump to DS-Client Buffer/Pipe
+
+
Multiple Instances on Same Computer
+
+
Security and User Accounts
The DS-Client software requires either one or two user accounts in order to successfully backup
an MS SQL Server. The number depends on the setup of the MS SQL Server:
Network user account
This account is used when connecting to the computer where the MS SQL server is
running. This account must have sufficient permissions (e.g. member of the Administrator Group).
This is a database user account. If the MS SQL server is configured for integrated
Database user account security access, this account is not required and the network user account will be
used for both network and database access.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 429
Confidential.
Knowledge Base: BACKUP
Backup Dump Devices
Depending on the MS SQL Server's version and the backup set's configuration, the DS-Client will
use different backup/restore methods:
Dump to disk file
Databases will be dumped directly to a disk file either on the MS SQL Server computer, or to an accessible UNC path (remote location). The file name will be in the
form 'database.y', where 'y' is an internal number. After the database is dumped, the
dump file will be backed up like a regular file and then removed. The backup set's
configuration should provide the path for the dump location.
You can enter a UNC path directly in the “Dump Path” field when you select the
dump location.
Dump to DS-Client
buffer
Databases will be dumped directly to a disk file on the DS-Client computer in the
DS-Client buffer directory (this directory location is set up in the DS-Client Configuration dialog box - Parameters tab). You can use this option if you do not have enough
space on the MS SQL Server computer.
DS-Client Pipe
The database is dumped through a pipe. During backups, the MS SQL server writes to
the pipe, and the DS-Client service reads from the pipe and sends data to the DS-System. The pipe is created on the MS SQL Server computer. Use this method if your
database is too big to be dumped to a file with either of the above options.
NOTE: You should only use this option if you have a consistently fast and reliable
connection to the DS-System.
Truncate Transaction
Log before Backup
In order to dump the transaction log, before backing up a database, the DS-Client will
use the native dump transaction with NO_LOG statement.
Using DBCC
DS-Client service can run a Database Consistency Check (DBCC) after the database is dumped.
The DBCC will check the database and the database allocation ('checkdb'/ 'checktable' and
'checkalloc' options). If using the DS-Client Pipe option, the DBCC is performed before the dump.
In either case, the DS-Client service can be instructed not to perform the backup if DBCC errors
are found.
Restoring Databases
A database that was backed up using the “dump to disk file“ option can only be restored using the
same method. (i.e. you cannot restore such a backup using “DS-Client Pipe“.)
The file name generated by the restore using the "dump to disk file" option will be in the form
'database.y', where 'y' is an internal number.
See also
“MS SQL Server Database Backups” on page 93
“Restore MS SQL Server Backups” on page 180
“MS SQL Server Backup Sets (Alternate Location Restore)” on page 200
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 430
Confidential.
Knowledge Base: BACKUP
Backup / Restore using UNIX-SSH
Creation Date: June 30, 2006
Revision Date: December 20, 2006
Product:
DS-Client (Linux & Mac)
Summary
This article covers various backup/restore issues for backup sets using the UNIX-SSH protocol.
This is the type of connection DS-Client opens to the target computer. To backup or restore, the
DS-Client must run the corresponding script on the source / target computer in either PERL or
PYTHON languages.
SSH Requirements
1. The backup source machine must be a Unix system (Linux, Solaris, HP-UX, or AIX).
2. The source machine must have an OpenSSH compatible server installed and started.
3. The source machine must have either Perl5 (core function, 5.6 or beyond) installed, or
Python (2.4) installed. [Alternatively, you can use the DIRECT option to run a specific
script/binary located on the source machine.]
4. The SSH approach cannot scan the LAN to get an initial machine list. You must enter
the IP of the source machine in the Path field (e.g. UNIX-SSH\10.20.30.100). The
user or administrator can also put the initial machine list into the file hostlist_ssh
located in the installation path (usually /usr/local/DS-Client). The following is a sample:
#================= sample hostlist_ssh begin =================
# format: (comments must begin with '#')
# name_or_IP_address[:port]
10.20.30.101
10.20.30.102
10.20.40.33
[shortdescription] (less than 20 chars)
[Computer 1]
[Computer 2]
[Server A]
10.20.40.34:2233
[Server B]
# SSH server running on port 2233
#================= sample hostlist_ssh end =================
5. If PERL or PYTHON is not installed in the default path (usually /bin, /usr/bin, ...) on the
source machine, you must enter the exact path in the Advanced connection options
screen.
SSH Limitations
Due to a PERL limitation, UNIX-SSH backup sets can not backup files with a <tab> symbol at the
end of the file name.
• If a file with this type of name is encountered, backup of that file will fail. The
following error message will appear in the Event Log:
“Open for read failed (cannot open file <file_with_path> for reading: No
such file or directory)”
See also
“Local File System, NFS, Samba, UNIX-SSH Backup (LINUX DS-Client)” on page 90
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 431
Confidential.
Knowledge Base: BACKUP
Backup / Restore of NFS
Creation Date: December 10. 2007
Revision Date: December 10. 2007
Product:
DS-Client (Linux & Mac)
Summary
This article covers various backup/restore issues for NFS backup sets using the “Local File
System, NFS, Samba, UNIX-SSH” backup type.
Configuring a source machine for backup through NFS using Linux DS-Client
Note:
The following are general suggestions that do not take into consideration network security
requirements. Consult your network administrator and NFS documentation for full details.
1. In order to backup a source machine that supports NFS (version 3 or higher), the NFS
source machine must be configured to export the NFS share (assuming the source
machine is an NFS server).
2. To verify if the source server is exporting the NFS share, run the following command
on the DS-Client:
Shell> rpcinfo –p NFS_server_address
3. If it is working, “nfs” should be listed in the output, and you should be able to connect
to the NFS share via Linux / Mac DS-Client. Otherwise continue with step 4.
4. Strictly speaking, you only need to edit /etc/exports to get NFS to work with DS-Client.
This file is on the source machine, and contains a list of entries. Each entry indicates a
volume that is shared and how it is shared. Check the man pages (man exports) for a
complete description of all the setup options for the file, although the description here
will probably satisfy most people's needs.
• An entry in /etc/exports will typically look like this:
directory machine1(option11,option12)
•
For example:
/ 192.168.1.250(rw,no_root_squash)
•
The above line allows the DS-Client machine whose IP is 192.168.1.250 to
have read and write access to the / folder. If the option ‘no_root_squash’ is
selected, then ‘root’ on the DS-Client machine will have the same level of
access to the files on the NFS share as ‘root’ on the NFS server.
5. Save the file and restart the NFS daemon with the following command:
Shell> /etc/init.d/nfs restart
6. Now, the DS-Client machine should be able to connect to the NFS share.
See also
“Local File System, NFS, Samba, UNIX-SSH Backup (LINUX DS-Client)” on page 90
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 432
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Oracle Database Servers
Creation Date: March 12, 2003
Revision Date: January 30, 2008
Product:
DS-Client
•
•
•
•
“Oracle Backup Set Overview” on page 433
“Oracle Database Server Support Matrix” on page 434
“Backup / Restore of Oracle Database Servers using Windows DS-Client” on
page 436
“Backup / Restore of Oracle Database Servers using Linux DS-Client” on
page 438
Oracle Backup Set Overview
This table summarizes the DS-Client capabilities to backup and restore online Oracle databases.
Functionality
On a scheduled or an on-demand basis, the DS-Client will instruct the Oracle’s Recovery Manager (RMAN) to
access the Oracle Server via IP (LAN, WAN, etc) and use the Oracle-supplied functions to perform a database
backup (through Pipe or using dump files). The data is then compressed, encrypted and transmitted to the DSSystem. The first time this action is performed, the entire database is dumped and transmitted (creating a
“master”). During subsequent backups, only the changes are transmitted (creating a “delta”). The DS-Client
never accesses the Oracle database data files directly and therefore, there is never an issue with open and
locked database files. The database does NOT have to be taken offline to perform the backup.
SECURITY
During the Oracle server backup (as with all backups), the database credentials (sysdba username and password) are entered and stored in the DS-Client database, using AES128 encryption. The backup data is
encrypted with a security algorithm that is secure up to AES-256 (256-bit) with a private key known only by you
(the customer). Your Service Provider will never have access to this information. The DS-System uses a oneway hash to validate encryption keys, however the hash cannot be used to recover the encryption keys.
Items available for backup/restore
- individual tablespaces
- control file
- archived logs
- Whole database backup:
• Backup all items (individual tablespaces, control file, and archived logs) in one oracle database backup set.
• Create a file system backup set to backup only init<sid>.ora and pwd<sid>.ora.
Options for backup:
• Logical Corruption Check
• Backup Only Current Archived Logs
• Truncate Transaction Logs
Possible items to restore:
- Original restore (restore to the original Oracle server)
• individual tablespaces
• control file + tablespaces + archived logs
• Whole database (including files init.ora & pwd.ora)
- Alternate restore (restore to another Oracle server)
• All possible options in Original restore
• Restore only the dump files
Options for restore:
• Restore only dump files
• Create temp tablespace
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 433
Confidential.
Knowledge Base: BACKUP
Oracle Database Server Support Matrix
Check the Matrix for supported Oracle Server Versions, and on which platform to install Linux DSClient or Windows DS-Client in order to backup and restore:
Microsoft Windows
DS-Client
Oracle Server
Linux DS-Client
Version
Platform
Red Hat
ES/AS Linux 4
Red Hat
SUSE Linux
ES/AS Linux 5 Enterprise 9
SUSE Linux
Windows
Enterprise 10 XP, 2003
Solaris 9 (SPARC 64-bit)
Support
Possible
Support
Possible
No Vendor
Support
Support
Possible
Solaris 10 (SPARC 64-bit)
Supported
Supported
No Vendor
Support
Supported
Windows XP, 2003 (x86/x64)
Not
Supported
Not
Supported
No Vendor
Support
Windows VISTA Ultimate
(x86/x64)
Not
Supported
Not
Supported
Windows VISTA Enterprise
(x86/x64)
Not
Supported
Windows VISTA
Enterprise,
Ultimate
Not
Supported
Not
Supported
Not
Supported
Supported
Supported
No Vendor
Support
Not
Supported
Supported
Supported
Not
Supported
No Vendor
Support
Not
Supported
Supported
Supported
Red Hat ES/AS Linux 4 (x86/x64) Supported
Supported
No Vendor
Support
Supported
Red Hat ES/AS Linux 5 (x86/x64) Supported
Supported
No Vendor
Support
Supported
SUSE Linux Enterprise 10 (x86/
x64)
Supported
Supported
No Vendor
Support
Supported
Not Supported
Not Supported
RS6000 AIX 5L (64-Bit)
Not
Supported
Not
Supported
No Vendor
Support
Not
Supported
PA-RISC 2.x HPUX 11i
(11.23) (64-bit)
Supported
Supported
No Vendor
Support
Supported
Solaris 10 (SPARC 64-bit)
Supported
Supported
Support
Possible
Supported
Not
Supported
Solaris 9 (SPARC 64-bit)
Supported
Support
Possible
Support
Possible
Supported
Not
Supported
Windows XP, 2003 (x86/x64)
Not
Supported
Not
Supported
Not
Supported
Not
Supported
Supported
Red Hat ES/AS Linux 3 (x86/x64) Supported
Support
Possible
Support
Possible
Supported
Not
Supported
10.2
Red Hat ES/AS Linux 4 (x86/x64) Supported
(10g R2)
Support
Possible
Support
Possible
Supported
Not
Supported
11g R1
SUSE Linux Enterprise 9 (x86/
x64)
Supported
Support
Possible
Support
Possible
Supported
Not
Supported
SUSE Linux Enterprise 10 (x86/
x64)
Supported
Supported
Support
Possible
Supported
Not
Supported
RS6000 AIX 5L (64-Bit)
Supported
Supported
Support
Possible
Supported
Not
Supported
PA-RISC 2.x HPUX 11i
(11.11, 11.23) (64-bit)
Supported
Supported
Support
Possible
Supported
Not
Supported
Solaris 9 (SPARC 64-bit)
Supported
Support
Possible
Supported
No Vendor
Support
Not
Supported
Windows 2003
Not
Supported
Not
Supported
Not
Supported
No Vendor
Support
Supported
Not
Supported
Not
Supported
Not
Supported
No Vendor
Support
Support
Possible
Red Hat Enterprise Linux ES 3, 4 Supported
Support
Possible
Supported
No Vendor
Support
SUSE Linux Enterprise Server 9
Support
Possible
Supported
No Vendor
Support
10.1
Windows XP
(10g R1)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Supported
Not Supported
Not Supported
Not
Supported
Generated on: 3/28/08
Page: 434
Confidential.
Knowledge Base: BACKUP
Red Hat Enterprise Linux ES 3, 4 Supported
Supported
Supported
No Vendor
Support
SUSE Linux Enterprise Server 9
Supported
Supported
Supported
No Vendor
Support
Red Hat Enterprise Linux AS 3
Support
Possible
Support
Possible
Support
Possible
No Vendor
Support
Windows XP, 2003
Not
Supported
Not
Supported
Not
Supported
No Vendor
Support
9.2
•
•
•
•
Not
Supported
Not
Supported
Supported
Supported: DS-Client supports backup / restore of Oracle server.
Support Possible: Asigra did not perform backup / restore tests on these
platforms, but there should not be any technical limitations.
Not Supported: Oracle server backup / restore is not supported.
No Vendor Support: Oracle client used by DS-Client to backup / restore
Oracle server is not supported by vendor.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 435
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Oracle Database Servers using Windows DS-Client
For offline database backup / restore, the operations and requirements are the same as File
System Backup and Restore. You can use the ’Pre/Post’ function to Stop/Start Oracle Server
before/after backup and restore. (If your database is in NOARCHIVE mode, then you must
perform offline backup of the database.)
The following requirements must be met in order to perform online backup / restore of Oracle
Database Servers.
General Requirements
• The user who performs Oracle Backup / Restore should have knowledge about the Oracle database file
structure and instance management.
• The DB Administrator / Backup Operator must know the name of the Service when creating a new backup
set. (You cannot browse the database(s) for names, therefore you must know the exact name in advance.)
• The credentials used for backup / restore of the Oracle database must have the sysdba privilege.
• You can not use an IP address to specify a computer for backup / restore. Only the computer name is
allowed.
DS-Client Computer Requirements
• Windows XP / 2003 / VISTA.
• Oracle Client must be installed. It must be the same version as the Oracle Server you want to backup. If you
want to backup different versions of Oracle servers, you must install each corresponding version of Oracle
client on the DS-Client computer. (If you are using both 9i and 10g Oracle clients on the DS-Client computer, make sure 10g is not the first path in the ‘PATH’ environment variable.)
• You must configure the ’Net service Name’ for this Oracle Client to connect to each Oracle Server you want
to backup or restore. If the Oracle Instance is a shared server, set the Connection Type as "Dedicated
Server".
• Recovery Manager (RMAN) utility must be installed.
• To backup / restore Oracle 9i and 10g, you must manually copy recover.bsq to
%ORACLE_HOME%\RDBMS\ADMIN directory on DS-Client computer. Please see Oracle bug #2421470. You can
find recover.bsq on the Oracle 9i Server in the %ORACLE_HOME%\RDBMS\ADMIN directory.
Oracle Server Requirements
• [32-Bit Windows Platforms] orasbt.dll must be copied to the target Oracle Server's computer. Place it in
the path \%SYSTEMROOT%\SYSTEM32 (System Root path). You can find this file in the DS-Client installation
directory.
• [64-Bit Windows Platforms] orasbt_x64.dll must be copied to the target Oracle Server's computer. Rename
it to orasbt.dll, then place it in the path \%SYSTEMROOT%\SYSTEM32 (System Root path). You can find this
file in the DS-Client installation directory.
• Oracle Instance must be running in "ARCHIVELOG MODE" (this allows on-line backup of the database).
• Set the CONTROL_FILE_RECORD_KEEP_TIME initialization parameter to slightly longer than the period (in
days) between backups of the whole Oracle database (all tablespaces, control files, and archive logs).
• RMAN has a limitation of how many archived logs can be backed up at one time. Increase the "redo log file"
size to reduce the number of archived logs.
• If you are using DS-Client Buffer or DS-Client Pipe as the dump path for backup, make sure both the "OracleServiceXXXX" and "Oracle TNSListener" services use the "administrator" account.
Backup Requirements
• The Oracle database should be in Open state when you perform the online backup.
• In order to perform full or alternate restore of an Oracle database, the backup must be a full Oracle database backup (all tablespaces, archived log files, and control file). In addition, you must have a backup of
the password file and the init file.
• The password file (e.g.c:\oracle\ora92\database\pwd<instance>.ora) and the init file (e.g. c:\oracle\admin\<instance>\pfile\init.ora) should be backed up in a File System backup set.
• You do not need to place online tablespaces in backup mode when performing backups.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 436
Confidential.
Knowledge Base: BACKUP
Restore Requirements
There are the following requirements and limitations:
• To restore the Control File, you must start the database in nomount (started) state.
• To restore Tablespaces without the Control File, you must start the database in mount state. Otherwise,
you must change the tablespaces offline.
• Tablespaces can be restored, however the logs will be applied to the present (unless DBPITR is performed).
This means they will not be "as when backed up".
• The control file should only be restored when performing DBPITR (Database Point In Time Recovery). After
restoring, the database will be opened with the "RESETLOGS" option. By doing this, you will not be able to
restore any tablespaces backed up after that point in time (unless you restore the control file).
• When performing a DBPITR, all the files backed up in that particular session must be restored.
• For full restore to the original location, the requirements are the same as for Alternate Location Restore,
except the ’target computer’ is the original computer.
• [Oracle 10g only] Before performing a DBPITR, if the backup and flash_recovery_area have different reset
log times, you must rename the flash_recovery_area directory. After performing the restore, you should
shutdown and manually restart the Oracle database (see Oracle Note: 286964.1).
Alternate Location Restore Requirements
The Oracle Server (target restore server) must satisfy the requirements listed in the sections above.
In addition, the following apply for Alternate Restore:
1.The backup must be a full Oracle database backup. You must also have a backup of the password file and the
init file (this will be in a File System backup set).
2.The target restore computer must have an Oracle database service Instance of the same name.
3.The target restore computer must have the same tablespace path as the original backup (this can be created
when setting up the database).
• This is because of Oracle limitations and specifications. All information about file structure is recorded in
the Control File and the Oracle Database as a whole.
4.Restore the (File System) backup of the password file and the init file to the alternate computer. This is a
separate backup set of the password file and the init file from the original backup computer.
5.Restore the full Oracle database backup.
6.If you choose a different dump path, only dump files are restored to that path. You must use RMAN to restore
your Oracle database manually.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 437
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Oracle Database Servers using Linux DS-Client
For offline database backup / restore, the operations and requirements are the same as File
System Backup and Restore (You can use the ’Pre/Post’ function to Stop/Start Oracle Server
before/after backup and restore.).
The following requirements must be met in order to perform online backup / restore of Oracle
Database Servers.
General Requirements
• The user who performs Oracle Backup / Restore should have knowledge about the Oracle database file
structure and instance management.
• The DB Administrator / Backup Operator must know the name of the Service when creating a new backup
set. (You cannot browse the database(s) for names, therefore you must know the exact name in advance.)
• The credentials used for backup / restore of the Oracle database must have the sysdba privilege.
DS-Client Computer Requirements
• DS-Client must be running on a supported Linux platform listed in the Oracle Database Server Support
Matrix.
• Oracle Client must be installed on the machine running the DS-Client (this must be a full installation created from the Oracle Installer). It must be the same version as the Oracle Server to backup.
• You must configure the ’Net service Name’ for this Oracle Client to connect to each Oracle Server you want
to backup or restore.
• If the Oracle Instance is a shared server, set the Connection Type as "Dedicated Server" using Net Manager
(Oracle 9).
• Recovery Manager (RMAN) utility must be installed.
• To backup / restore Oracle 9, you must manually copy recover.bsq to $ORACLE_HOME/rdbms/admin directory on DS-Client computer. Please see Oracle bug #2421470. You can find recover.bsq on the Oracle 9
Server.
• The remote Oracle database server hostname must be configured in /etc/hosts file on the Linux DS-Client
computer.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 438
Confidential.
Knowledge Base: BACKUP
Oracle Server Requirements
• Oracle Instance should be running in "ARCHIVELOG MODE" (this allows on-line backup of the database).
• Set the CONTROL_FILE_RECORD_KEEP_TIME initialization parameter to slightly longer than the period (in
days) between backups of the whole Oracle database (all tablespaces, control files, and archive logs).
• RMAN has a limitation of how many archived logs can be backed up at one time. Increase the "redo log file"
size to reduce the number of archived logs.
• Oracle Server should be a certified product. For example, Oracle 10.2 for Red Hat Enterprise Linux AS/ES 4,
SuSE SLES 10, or Solaris 10 (64-bit).
• To use DS-PIPE for backup and restore, a library file must be copied to $ORACLE_HOME/lib on the Oracle
server. This file must correspond to the Oracle server’s platform. The files are found in the DS-Client
installation directory:
libobk.so
[for Linux 32-bit Oracle database]
Copy to $ORACLE_HOME/lib on 32-bit Linux Oracle Server.
libobk-64.so
[for Linux 64-bit Oracle database]
Copy to $ORACLE_HOME/lib on 64-bit Linux Oracle Server
and make a soft link "ln -s libobk-64.so libobk.so".
libobk.a
[for AIX Oracle database]
Copy to $ORACLE_HOME/lib on AIX Oracle server.
libobk.sl
[for HPUX Oracle database]
Copy to $ORACLE_HOME/lib on HPUX Oracle server.
libsbt64.so
[for Solaris 64-bit Oracle database]
Copy to $ORACLE_HOME/lib on Solaris 64-bit Oracle server
and make a soft link "ln -s libsbt64.so libobk.so".
libsbt32.so
[for Solaris 32-bit Oracle database]
Copy to $ORACLE_HOME/lib on Solaris 32-bit Oracle server
and make a soft link "ln -s libsbt32.so libobk.so".
Backup Requirements
• The Oracle database should be in Open state when you perform the online backup.
• In order to perform full or alternate restore of an Oracle database, the backup must be a full Oracle database backup (all tablespaces, archived log files, and control file). In addition, you must have a backup of
the password file and the init file.
• The init file (e.g. admin/<instance>/pfile/init<instance>.ora) and password file (e.g. $ORACLE_HOME/dbs/
orapw<instance>) should be backed up in a File System backup set. A backup of the password file is necessary for any full or alternate restore of the Oracle database.
• You do not need to place online tablespaces in backup mode when performing backups.
• For Oracle backup using NFS protocol, you must supply the user account of ’root’ for the network credentials.
Restore Requirements
There are the following requirements and limitations:
• To restore the Control File, you must start the database in nomount (started) state.
• To restore Tablespaces without the Control File, you must start the database in mount state. Otherwise,
you must change the tablespaces offline.
• Tablespaces can be restored, however the logs will be applied to the present (unless DBPITR is performed).
This means they will not be "as when backed up".
• The control file should only be restored when performing DBPITR (Database Point In Time Recovery). After
restoring, the database will be opened with the "RESETLOGS" option. By doing this, you will not be able to
restore any tablespaces backed up after that point in time (unless you restore the control file).
• When performing a DBPITR, all the files backed up in that particular session must be restored.
• For full restore to the original location, the requirements are the same as for Alternate Location Restore,
except the ’target computer’ is the original computer.
• [Oracle 10g only] Before performing a DBPITR, if the backup and flash_recovery_area have different reset
log times, you must rename the flash_recovery_area directory. After performing the restore, you must
shutdown and manually restart the Oracle database (see Oracle Note: 286964.1).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 439
Confidential.
Knowledge Base: BACKUP
Alternate Location Restore Requirements
The Oracle Server (target restore server) must satisfy the requirements listed in the sections above.
In addition, the following apply for Alternate Restore:
1.The backup must be a full Oracle database backup. You must also have a backup of the password file and the
init file (this will be in a File System backup set).
2.The target restore computer must have an Oracle database service Instance of the same name.
This is to simplify the process of recovery. You must modify the initial file manually if you use a different
Instance name.
3.The target restore computer must have the same tablespace path as the original backup (this can be created
when setting up the database).
• This is because of Oracle limitations and specifications. All information about file structure is recorded in
the Control File and the Oracle Database as a whole.
4.Restore the (File System) backup of the password file and the init file to the alternate computer. This is a
separate backup set of the password file and the init file from the original backup computer.
5.Restore the full Oracle database backup.
6.If you choose a different dump path, only dump files are restored to that path. You must use RMAN to restore
your Oracle database manually.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 440
Confidential.
Knowledge Base: BACKUP
Backup / Restore of MySQL Database Servers
Creation Date: December 08, 2007
Revision Date: December 10, 2007
Product:
DS-Client
Summary
This article covers various backup/restore issues for MySQL database backup sets.
The following requirements must be met in order to perform backup / restore of MySQL Database
Servers.
General Requirements
1. The user who performs PostgreSQL backup / restore should have knowledge
about the MySQL database structure.
DS-Client Computer Requirements
1. DS-Client backs up MySQL Server using the MySQL utilities ‘mysqldump’ and ‘mysql’.
The DS-Client’s mysqldump and mysql utilities must be compatible with the MySQL
version running on the source machine (MySQL server).
2. The following requirements depend on the type of DS-Client you are using:
• Windows DS-Client: The mysql utility must be listed in the PATH
environment variable of the DS-Client computer. (If you must edit this
variable, stop and restart the DS-Client service after making the change.)
• Linux DS-Client: The mysql utility must be listed in the PATH environment
variable of user ’root’ on the DS-Client computer.
• Mac DS-Client: The path to the mysql utility must be added to the following
file on the DS-Client computer:
/etc/rc.common
Connecting to MySQL using non-standard Ports
In order to backup a MySQL Server that is using non-standard ports, you must specify the port
number when creating the MySQL backup set.
For Windows DS-Clients:
1. You must specify the port numbers when creating the MySQL backup set.
• Sets Menu > New Backup Set. Select MySQL backup type and click Next.
• In the “Select a MySQL Server to backup” screen, you must specify the IP
address of the server and the port number in the Path field, in the following
format:
\\IP_address:Port_Number
•
For example, if you want to connect to a MySQL instance at IP address
10.20.30.111 using the port number 3310, you would type the following line
into the Path field:
\\10.20.30.111:3310
Note:
If you do not specify a port number, Windows DS-Client will use “3306” as a default.
For Linux / Mac DS-Clients:
1. You can specify the port numbers when creating the MySQL backup set:
• Sets Menu > New Backup Set. Select MySQL backup type and click Next.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 441
Confidential.
Knowledge Base: BACKUP
•
In the “Select the source for this backup set” screen, select “Ask for database
credentials”.
• When the credentials screen appears, you will be able to enter the port
number that the MySQL Server is configured to use.
2. You can also change the port number by editing the backup set properties (Backup
Set Properties > Connection Options > Ask for database credentials: Port Number).
How to display the MySQL backup set type in the New Backup Set Wizard
If you do not see the MySQL backup set type option when you open the New Backup Set Wizard
(Sets Menu > New Backup Set), your DS-Client may not be configured to support it. Make sure the
following requirements are met:
For Windows DS-Client:
• MySQL client software is installed.
• The folder that contains the MySQL utilities (such as: mysqldump.exe and
mysql.exe) is in the PATH environment variable of the DS-Client computer.
To verify if the path is included, launch a command window on DS-Client
computer, and in the command prompt, run the command ‘path’.
For Linux DS-Client:
• MySQL client software is installed.
• The folder that contains the MySQL utilities (such as: mysqldump and mysql)
is in the search PATH of the DS-Client. To verify, edit the /etc/init.d/dsclient
and in the line PATH, make sure the folder is listed.
For Mac DS-Client:
• MySQL client software is installed.
• The folder that contains the MySQL utilities (such as: mysqldump and mysql)
is in the search PATH of the DS-Client. The path to the mysql utility should be
added to the following file on the MAC DS-Client computer: /etc/rc.common.
See also
“MySQL Database Backup (Windows DS-Client)” on page 106
“MySQL Database Backup (LINUX DS-Client)” on page 108
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 442
Confidential.
Knowledge Base: BACKUP
Backup / Restore of DB2 Database Servers
Creation Date: December 24, 2004
Revision Date: January 30, 2008
Product:
DS-Client (LINUX)
DB2 Database Server Support Matrix
Check the Matrix for supported DB2 Server Versions, and on which platform to install Linux DSClient in order to backup and restore:
DB2 Server
Linux DS-Client
Version
Red Hat
ES/AS Linux 4
Red Hat
ES/AS Linux 5
Solaris 10 (UltraSPARC)
Supported
Supported
Support Possible
Supported
AIX 5L
Supported
Supported
Support Possible
Supported
9.1
8.2
with
FixPak14
8.1
Platform
SUSE Linux
Enterprise 9
SUSE Linux
Enterprise 10
HP-UX PA-RISC 11i v2
Supported
Supported
Support Possible
Supported
Red Hat Enterprise Linux 4 (x86/x64)
Supported
Supported
Support Possible
Supported
Red Hat Enterprise Linux 5 (x86/x64)
Supported
Supported
Support Possible
Supported
SUSE Linux Enterprise Server 9
Support Possible
Support Possible
Support Possible
Support Possible
SUSE Linux Enterprise Server 10 (x86/x64)
Supported
Supported
Support Possible
Supported
Solaris 10 (SPARC 64-bit)
Supported
No Vendor Support
Support Possible
Supported
Solaris 9 (SPARC 64-bit)
Supported
No Vendor Support
Support Possible
Supported
Red Hat ES/AS Linux 3 (x86/x64)
Supported
No Vendor Support
Support Possible
Supported
Red Hat ES/AS Linux 4 (x86/x64)
Supported
No Vendor Support
Support Possible
Supported
SUSE Linux Enterprise 9 (x86/x64)
Supported
No Vendor Support
Support Possible
Supported
SUSE Linux Enterprise 10 (x86/x64)
Supported
No Vendor Support
Support Possible
Supported
RS6000 AIX 5L (64-bit)
Supported
No Vendor Support
Support Possible
Supported
PA-RISC 2.x HPUX 11i (11.11, 11.23) (64-bit)
Supported
No Vendor Support
Support Possible
Supported
Solaris 9
Supported
No Vendor Support
Support Possible
Supported
Red Hat Enterprise Linux ES 3
Supported
No Vendor Support
Support Possible
Supported
SUSE Linux Enterprise Server 8, 9
Supported
No Vendor Support
Support Possible
Supported
Red Hat 7.2, 7.3, 8
Support Possible
No Vendor Support
Support Possible
Support Possible
Red Hat Enterprise Linux AS/ES 2.1
Support Possible
No Vendor Support
Support Possible
Support Possible
SUSE Linux Enterprise Server 7
Support Possible
No Vendor Support
Support Possible
Support Possible
United Linux 1.0
Support Possible
No Vendor Support
Support Possible
Support Possible
Matrix Legend:
• Supported: DS-Client supports backup / restore of DB2 server.
• Support Possible: Asigra did not perform backup / restore tests on these
platforms, but there should not be any technical limitations.
• Not Supported: DB2 server backup / restore is not supported.
• No Vendor Support: DB2 client used by DS-Client to backup / restore DB2
server is not supported by vendor.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 443
Confidential.
Knowledge Base: BACKUP
Backup / Restore of DB2 Database Servers (Linux DS-Client)
The following requirements must be met in order to perform backup / restore of DB2 Database
Servers.
General Requirements
• The user who performs DB2 backup / restore should have knowledge
about the DB2 database structure and instance management.
• The DB Administrator / Backup Operator must catalog the remote node and
database name before creating a new backup set. You cannot browse the
database(s) for names, therefore you must know the exact name in advance.
• The credentials used for backup / restore of the DB2 database must have the
SYSADM, SYSCTRL, or SYSMAINT authority.
• For DB2 Version 8, there is a DB2 bug (#JR20798). You must make sure the
fixpak number is the same on both DB2 client and DB2 Server.
DS-Client Computer Requirements
• DS-Client must be running on Red Hat ES/AS Linux 4/5, or SUSE Linux
Enterprise 9/10.
• DB2 Client must be installed on the machine running the DS-Client.
• [DB2 v.9.1 only] You must specify the DB2 Client library directory on the DSClient. This is done in the DS-Client Configuration screen’s Advanced Tab
(See “DS-Client Advanced Configurations” on page 40.):
1. DS-User > Setup Menu > Configuration. The DS-Client configuration screen appears.
2. Click on Advanced. From the Name drop-down list, select “DB2 Client Library
Directory”.
3. In the Value Field, enter the path where the DB2 Client libraries are located on this
DS-Client (e.g. “/opt/ibm/db2/V9.1/lib64”).
4. Click Apply.
•
5. Stop and start the DS-Client service / daemon.
The DB2 node and database must be cataloged in order for the DB2 Client to
connect to each DB2 Server you want to backup or restore.
DB2 Server Requirements
• DB2 Server should be a certified product.
Backup Requirements
•
•
•
•
•
The DB2 database must not be in use when you perform an offline backup.
Otherwise an error will be reported.
When you create a DB2 backup set, in the "Select the source for this backup
set" screen, you must specify the DB2 server hostname or type its IP address
in "Path" field. This must be the same as the one used in the catalog
command.
Linux DS-Client should have read and write privileges to access the
transaction log directory on the DB2 database computer (for example
~db2inst1/db2inst1/NODE0000/SQL00005/SQLOGDIR/).
Online backups are only available for databases configured with either
logretain or userexit enabled.
The backup set must specify that the backup is online or offline, as
determined by the DB2 database configuration settings. (DO NOT CHANGE
THIS PROPERTY. If you change this DB2 configuration, make a new backup
set with the new option setting.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 444
Confidential.
Knowledge Base: BACKUP
•
It is recommended that the online option setting not be changed for a demand
backup. If it is changed, you must make a record of the change and the date
(manually on paper or other format), so that the information is available if a
restore is performed.
Restore Requirements
•
•
The DB2 database must not be in use when you perform the restore. This
requirement applies to all DB2 backup sets (whether configured for online or
offline backup).
The DB2 database must be configured for online or offline restore. This
setting must match the Backup Set Properties > Options setting that was used
for the backup.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 445
Confidential.
Knowledge Base: BACKUP
Backup / Restore of PostgreSQL Database Servers
Creation Date: November 08, 2006
Revision Date: June 26, 2007
Product:
DS-Client (LINUX)
Summary
This article covers various backup/restore issues for PostgreSQL database backup sets.
The following requirements must be met in order to perform backup / restore of PostgreSQL
Database Servers.
General Requirements
1. The user who performs PostgreSQL backup / restore should have knowledge
about the PostgreSQL database structure.
2. Configure each PostgreSQL database to be able to connect to other PostgreSQL
instances:
• For PostgreSQL 7.x: Enable TCP/IP connection. In <pg_data_path>/
postgresql.conf, uncomment the line “tcpip_socket=false” and set the option
to true:
tcpip_socket = true
•
For PostgreSQL 8.x: In <pg_data_path>/postgresql.conf, add the line
“listen_addresses='*' as follows:
# CONNECTIONS AND AUTHENTICATION
listen_addresses='*'
where <pg_data_path> is the path to the configuration files (usually "/var/lib/pgsql/
data" for the free installation from www.postgresql.org, or "/usr/local/pgsql/data" for
the commercial package from www.commandprompt.com.
DS-Client Computer Requirements
• The psql and pg_dump utilities must be listed in the PATH environment
variable of the user 'root' on the DS-Client computer.
• The DS-Client computer's psql and pg_dump utilities must be compatible
with the PostgreSQL version running on the source machine (PostgreSQL
server).
• Configure the PostgreSQL database on the DS-Client computer to be able to
connect to other PostgreSQL instances as described in the General
Requirements above.
PostgreSQL Server Requirements
• PostgreSQL Server should be a certified product.
• Configure each target PostgreSQL database to be able to connect to other
PostgreSQL instances (to perform backup and restore) as described in the
General Requirements above.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 446
Confidential.
Knowledge Base: BACKUP
Restore Requirements
•
•
The PostgreSQL database must not be in use when you perform the restore.
This requirement applies to all restores (to original or to alternate location).
The PostgreSQL Server where you are restoring must be compatible with the
version of the PostgreSQL Server that was backed up. This is only an issue if
the target restore server is different (Alternate Restore Location), or has been
upgraded since the backup. In general, backups of databases residing on an
older DB instance can be restored on a newer DB instance (but not the other
way around).
See also
“PostgreSQL Database Backup (LINUX DS-Client)” on page 113
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 447
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Windows 2000
Creation Date: April 10, 2001
Revision Date: March 21, 2008
Product:
DS-Client
Summary
This article covers various Windows 2000 issues.
Encrypted Files
Encrypted files in Windows 2000 may experience Backup / Restore problems in versions prior to
SP 3. To avoid these potential errors, upgrade your Windows 2000 computers to SP3.
Windows 2000, SP1, and SP2 have the following known problems (from MSDN):
• Q307306: EFS Backup Functions May Not Work on Computers That Are
Running Windows 2000.
• Q303873: File Creation on an NTFS Volume May Not Work Even If You Have
the SeRestorePrivilege
System State
The System State can only be backed in its entirety. It contains the Registry (like 98/NT backups),
as well as other items that must be handled differently than normal files.
The following are components of the System State (there may be less, depending on your version
or if the component is not activated):
• Active Directory (You must have the same user account on both DS-Client
computer and backup server.)
• Boot and System Protected Files
• Certificate Services Database
• Cluster Database
• COM+ Class Registration Database
• Registry
• SysVol
Machine and user Crypto Key are not backed up as part of the System State. However they could
be backed up as part of the File System Backup. This problem is being addressed. In order to fully
protect a Windows 2000 computer, make sure that the entire system drive is backed up in the
same backup set as the System State.
Services Database
This contains databases that are not included in the System State, which still need to be treated in
a similar manner to be successfully backed up.
For a complete backup of a Windows 2000 computer, you should include the Services Database.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 448
Confidential.
Knowledge Base: BACKUP
Special Options For Windows 2000 only
Backup data in
Remote Storage
Windows 2000 has the functionality (if enabled) to migrate infrequently accessed data
from the local hard drive to directly attached tape libraries. The local disk usage is
reduced by replacing the file with a link (shortcut).
This is a Backup Set option that can be enabled or disabled. If enabled, all the data in
Remove Storage represented by the link will be backed up. If disabled, only the link
(shortcut file) will be backed up.
Backup Single
Instance Store file
data
Windows 2000 has an optional service 'Single Instance Store' to handle multiple copies
of the same file on the computer. If enabled, local disk usage is reduced by placing one
copy of the file in the Single Instance Store, with links (shortcuts) in all associated
directories.
If the Single Instance Store Service has been enabled on the Windows 2000 computer,
you should configure the backup set with this option.
Junction points are file links to other directories. If enabled in the backup set options,
DS-Client will backup directories (all data) represented by the junction point. If disFollow junction points
abled, backup only the link (shortcut).
Note: junction points that are mounted FAT or FAT32 volumes are not supported.
Overwrite Junction
Point
Overwrites any junction point(s) of the same name when restoring. Option to enable or
disable.
Limitations
If you upgrade a backup computer to Windows 2000, you must create a new backup set
immediately (since your existing backup set will not include the System State).
Error Messages
Some error messages might appear in the DS-Client computer's log(s), which occur as a normal
result of backing up Windows 2000.
" DCOM had error "Class not registered" from the computer <<COMPUTER_NAME>> when
attempting to activate the server: {XnnXnXnn-XXnn-nnXX-Xnnn-nnXnXnnnnnXn} " This happens
if you create a new backup set for Windows 2000, and try to list all items in the System State. The
error is reported because the DS-Client is trying to locate installed services for backup, and
Windows 2000 reports this error to DS-Client.
Restore Limitations
Restoring Encrypted Files with Streams to Alternate Location: You will get error messages if
you restore to the local computer by browsing the network. Use "My Computer" as the restore
destination instead.
Restoring System State - Cluster Quorum
The Cluster Quorum is protected as part of the System State backup and restore. There are
different scenarios for a restore process, and you may have to perform some manual actions after
a successful restore. Please read this entire section carefully before starting the restore process.
Microsoft Knowledge Base articles related to this subject are: 257905, 224999, 245762, and
258078.
You may need to manually load the cluster quorum. In this case you will need a tool named
dsclusrs.exe from Asigra. The tool can be found \winnt\cluster\Asigra directory after you
successfully restore the cluster quorum.
To manually load disk quorum, you must run "dsclusrs.exe –f <quorum drive letter>". For example,
if the quorum disk drive letter is e:, then run "dsclusrs.exe –f e".
Determine the type of cluster restore you are going to perform:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 449
Confidential.
Knowledge Base: BACKUP
You are performing restore on the same hardware (the disk signature of the quorum and
resource disks are the same).
1.1 The cluster nodes are not domain controllers
• In this scenario DS-Client will take care of the whole process. If you are
restoring only one node or all of them, DS-Client will attempt to restore the
cluster quorum if the "load cluster quorum" option is selected in the DS-User
Restore Wizard. If you turn off this option, the data will be copied to
\winnt\cluster\Asigra, and you have to manually load it by using the
dsclusrs.exe tool.
1.2 The cluster nodes are domain controllers
• In this scenario you have to boot the target node(s) into "Directory Services
Restore Mode".
You are performing total disaster restore (including hardware changes).
2.1 The cluster nodes are not domain controllers
• If you are restoring both nodes, when installing the operating system, follow
the same instructions as during the cluster installation (make sure that all
nodes have seen the shared disks and have the same drive letters as before).
Restore all nodes one by one, while keeping the others down. You can
restore all nodes simultaneously, but make sure that they are not attached to
the shared disks. At the end of a successful restore, shutdown all nodes and
attach them to the shared disk(s). Power them up one by one.
• When you reboot the first node, the cluster service may fail to start due to the
hardware changes (e.g. If you changed the quorum disk). This means you
must manually load the quorum using the dsclusrs.exe tool.
• After you successfully load the quorum, the cluster service can be started. If
you changed the resource disks, the resource disks will be offline in the
cluster administrator view. In order to fix this problem you have to find out the
new signature and edit the registry. Start "regedt32" and go to
HKEY_LOCAL_MACHINE > Cluster > Resources and locate the resource
disk. Under Parameters you will see the Signature. This is the signature the
cluster service expects to see. To find out what is the current signature, go to
HKEY_LOCAL_MACHINE > System > MountedDevices and locate the drive
letter of the resource disk (e.g. If your resource disk is F, you should see
something like "\DosDevices\F..." of type REG_BINARY). Please note that
the signature here is stored in little endian format. If you have 78563412, the
signature would be 12345678. You must enter this number for the Signature
under the Cluster > Resources > GUID > Parameters.
• Once the correct signature is entered, you can restart the cluster service. If
you have troubles with the service, please check the Microsoft Knowledge
Base articles mentioned above. The correct quorum data would be located
under \winnt\cluster\Asigra. This is the content of the quorum disk.
2.2 The cluster nodes are domain controllers
• Please read the DS-Client Knowledge Base article titled “Bare Metal Restore
of Windows 2000 / 2003” on page 489. It explains how to handle domain
controller restores. We recommend you restore the primary domain controller
first. This way, you will avoid problems with Active Directory (AD).
• If the target server does not have AD, make sure the "Load Cluster Quorum"
option in the DS-User Restore Wizard is not selected, then start the restore. If
the target server already has AD, you must boot in "Directory Services
Restore Mode".
• After the reboot (in both cases), you must manually load the quorum data
using the dsclusrs.exe tool from Asigra.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 450
Confidential.
Knowledge Base: BACKUP
•
You may also need to fix the cluster service as described in 2.1 above.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 451
Confidential.
Knowledge Base: BACKUP
Backup / Restore of E-Mails (using DS-MLR)
Creation Date: November 3, 2005
Revision Date: February 06, 2008
Product:
DS-Client (Windows) with DS-MLR Service (DS-Recovery Tools)
Summary
NOTE: From v.7.0, the DS-MLR Service is bundled with the DS-Recovery Tools installation.
This article covers Backup and Restore issues for E-Mail message backup sets (using DS-MLR).
• “DS-MLR Backup / Restore Support Matrix” on page 453
• “Using DS-MLR with Microsoft Exchange Server E-Mails” on page 455
• “Using DS-MLR with Microsoft Outlook E-Mails” on page 455
• “Using DS-MLR with Lotus E-Mails” on page 455
• “Using DS-MLR with GroupWise E-Mails” on page 456
• “Selective Backup of E-Mails” on page 456
• “Selective Restore of E-Mails” on page 456
• “Troubleshooting / FAQ / Error Messages” on page 457
DS-Message Level Restore (DS-MLR) is a solution to backup E-Mails from MS Exchange Server,
MS Outlook, Lotus Notes / Domino Server and GroupWise at the individual message level.
• DS-MLR is part of the DS-Recovery Tools Module that must be enabled from
the DS-System (by your Service Provider).
• DS-MLR is a Windows service. For a list of supported platforms, see “DSMLR Installation & Setup” on page 328.
• DS-MLR searches for E-Mails based on a user defined filter, then it
transforms each E-Mail into a data stream and passes this stream to DSClient for processing (for backup to DS-System).
• During backup, DS-Client scans all items and only backs up the new or
changed items. Changed items will be processed as delta and only the
changes will be sent to DS-System.
• E-Mails are saved (along with any attachments) as individual objects on DSSystem.
• The DS-MLR service must be installed and running as follows:
•
MS Exchange
Install DS-MLR on the MS Exchange Server. (For Clustered MS Exchange Servers,
DS-MLR must be installed and running on each node of the cluster.)
MS Outlook
Install DS-MLR on the computer with MS Outlook.
Lotus Domino
Install DS-MLR on the Lotus Domino Server.
Lotus Notes
Install DS-MLR on the computer with Lotus Notes.
GroupWise
Install DS-MLR on the computer with GroupWise client.
The DS-MLR Service Account has some special requirements. See “DS-MLR
Installation & Setup” on page 328.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 452
Confidential.
Knowledge Base: BACKUP
DS-MLR Backup / Restore Support Matrix
This Matrix shows the objects DS-MLR can backup and restore:
MS Exchange Server
Object Type
Calendar
Contacts
Sub Type
Backup / Restore of individual E-Mails
Appointment
Supported
All day event
Supported
Meeting request
Supported
Recurring Appointment
Supported
Recurring Event
Supported
Recurring Meeting
Supported
Contacts (*1)
Supported
Distribution List (*2)
Supported
Deleted Items
Supported
Drafts
Supported
Inbox
Incoming E-Mails – with/without attachment.
Supported
FW E-Mails – with/without attachment.
Supported
Reply E-Mails - with/without attachment.
Supported
Journal
Supported
Notes
Supported
Outbox
Supported
Sent Items
Tasks
Supported
Tasks
Supported
Request Tasks
Supported
Public folder
Supported
MS Outlook
Object Type
Calendar
Contacts
Sub Type
Backup / Restore of individual E-Mails
Appointment
Supported
All day event
Supported
Meeting request
Supported
Recurring Appointment
Supported
Recurring Event
Supported
Recurring Meeting
Supported
Contacts
Supported
Distribution List
Supported
Deleted Items
Supported
Drafts
Supported
Incoming E-Mails – with/without attachment.
Inbox
Supported
FW E-Mails – with/without attachment.
Supported
Reply E-Mails - with/without attachment.
Supported
Journal
Supported
Notes
Supported
Outbox
Supported
Sent Items
Supported
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 453
Confidential.
Knowledge Base: BACKUP
Tasks
Tasks
Supported
Request Tasks
Supported
Public folder
Supported
Lotus
Object Type
Mail
Sub Type
Backup / Restore of individual E-Mails
Drafts
Supported
Sent
Supported
Inbox
Supported
Folders
Supported
Follow-Up
Supported
Junk Mail
Calendar
Supported
Supported
To Do
Supported
Contacts
[Lotus Notes only]
Supported
Personal Journal (*3)
[Lotus Notes only]
Supported
Trash
Not Supported
Views
Tools
Not Supported
Archive
Not Supported
Rules
Not Supported
Stationery
Not Supported
GroupWise
Object Type
Sub Type
Backup / Restore of individual E-Mails
Cabinet
Supported
Calendar
Supported
Checklist
Not Supported
Contacts
Not Supported
Documents
Not Supported
Mailbox (*4)
Incoming E-Mails – with/without E-Mail attachment
Supported
FW E-Mails
Supported
Reply E-Mails
Work in progress
Supported
Not Supported
• Supported: DS-MLR can backup / restore this type of E-Mail object.
• Not Supported: DS-MLR does not support this type of E-Mail object.
(*1) If the service account is not a member of the Domain Admins group and is not an
Exchange Full Administrator, DS-MLR can backup Contacts, but the restored
Contacts cannot be seen in the Outlook Address Book.
(*2) If the service account is not a member of the Domain Admins group and is not an
Exchange Full Administrator, DS-MLR cannot backup Distribution Lists.
(*3) Personal Journal may require some configuration (See “Using DS-MLR with Lotus EMails” on page 455.).
(*4) GroupWise supports E-Mails if the body size is no more than 32K (kilobytes).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 454
Confidential.
Knowledge Base: BACKUP
Using DS-MLR with Microsoft Exchange Server E-Mails
DS-MLR supports backup and restore of individual E-Mails from the following Microsoft Exchange
objects:
• Storage group
• Mailbox Store / Public Folder Store
• Users
• User Folders
For each backup or restore request, DS-MLR checks if the user is a member of the Domain
Admins group or is an Exchange Full Administrator, and if the service account has the "Receive
As" privilege:
• If yes, DS-MLR will proceed using the service account and the user will be
able to see all mail boxes.
• If no, DS-MLR will proceed using the user’s credentials (from the Backup Set
Properties > Connection Tab).
Using DS-MLR with Microsoft Outlook E-Mails
If you encounter any problems, read through the section “Troubleshooting / FAQ / Error
Messages” on page 457.
• With DS-MLR you can backup the PST file while someone is using it.
However, this will only work if that logged on user is the same Windows user
account as the one used by the DS-MLR service.
• If you have configured MS Outlook to use a .PST file on a remote machine,
remember that the DS-MLR service must always be installed on the MS
Outlook computer.
• For MS Outlook configured for Exchange profiles, the E-Mails are sitting on
the Exchange server. To access those E-Mails, the DS-MLR service account
needs the "Receive As" privilege on that Exchange server. Otherwise, DSMLR will return an access denied error. (The DS-MLR service account must
be recognized on the Exchange server.)
Note: Using DS-MLR to back up an MS Outlook Exchange profile is not recommended. In such
a situation, it is better to install DS-MLR on the Exchange Server itself. Then, you can use
DS-MLR to backup any of the Exchange mailboxes.
• You can restore backed up E-Mails to their original location or to an alternate
location.
Using DS-MLR with Lotus E-Mails
•
•
•
•
•
•
For backup of Lotus Notes / Domino Server, the DS-MLR Service Account
must be a local administrator.
You can restore backed up E-Mails to their original location or to an alternate
location.
For alternate location restores: you can only restore a directory to the
‘<username>\Folders’ directory. This is a Lotus limitation.
For backup of Personal Journal: the Journal must already be created,
otherwise the option does not appear in the New Backup Set Wizard.
For restores of Personal Journal: make sure the Journal database exists in
destination machine, otherwise the restore will fail.
By default, the name of the Journal database is “journal.nsf”. If the name is
different (for example: Myjournal.nsf), then you must add the following line to
the notes.ini, which is located under Lotus\Notes:
JOURNAL=Myjournal.nsf.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 455
Confidential.
Knowledge Base: BACKUP
Using DS-MLR with GroupWise E-Mails
•
•
•
•
•
For backup of GroupWise Servers, the DS-MLR Service Account must be a
local administrator.
DS-MLR currently supports E-Mails whose body size is no more than 32K.
You can restore backed up E-Mails to their original location or to an alternate
location.
Make sure the GroupWise client is accessible. Test this by verifying you can
send and receive E-Mails through it without problems. Otherwise, you will get
a MAPI error when you try to create a GroupWise backup set.
DS-MLR can work with GroupWise folders that contain up to 65535 E-Mails.
The reason is because DS-MLR calls GroupWise Object API Folder>get_Messages() and this function returns an exception when the target
folder contains more than 65535 E-Mails. This number may vary in different
versions of GroupWise (65535 is the number for GroupWise 6.5). If the
backup folder contains more than 65535 E-Mails, the folder will be backed up
with no items in it (i.e. it will be empty).
Selective Backup of E-Mails
If you want to backup specific E-Mails from specific folders (instead backing up all of them), the
following filters are available when configuring a backup set:
1. Exclude button (Select Directories/E-Mails for Backup screen):
• When you create or edit a backup set, you can exclude specific objects. For
example: you can add a Storage Group/Mailbox, then exclude specific users
from backup. This filters at the folder-level.
2. Regular Expression (Select Directories/E-Mails for Backup screen):
• When you create or edit a backup set, you can use the “RegEx” button to
define a regular expression that can exclude objects at any level. You must
know the Regular expression syntax. For example, if you have 1000 users in
the mailbox store and you do not want to backup any “Deleted Items” folders,
you can add the Regular Expression “.*\\Deleted Items” (without quotes). This
saves you from manually excluding all 1000 folders using the Exclude button.
3. Filter (Specify backup item options screen):
• This screen allows you to filter E-Mails at the individual message-level (you
can ‘filter for’ or ‘filter out’). Multiple filters can be created and applied to the
same backup set.
Selective Restore of E-Mails
•
•
You can restore backed up E-Mails to their original location or to an alternate
location (as long as the alternate location computer has a DS-MLR service
installed and running).
You can manually select backed up E-Mails to restore, or you can use filters
to perform selective restore.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 456
Confidential.
Knowledge Base: BACKUP
Troubleshooting / FAQ / Error Messages
MS Exchange
Question / Problem
You get the error ‘System 0x80550053’ in the DS-Client Event Log.
1.
Explanation
DS-MLR is backing up an Exchange Public Folder that is also a Replication Folder.
Solution / Workaround
Add the public folder into the Replication List on the Exchange Sever.
MS Outlook
Question / Problem
The backup fails with the message: "DS-MLR could not open the specified MS-Outlook store."
Explanation
This is due to a Microsoft bug that only occurs for the following:
2.
• German Windows 2003, and
• Outlook 2003 with a .PST file configured on a remote mapped drive, and
• Backup of Outlook E-Mail messages using DS-MLR.
Solution / Workaround
Instead of using a mapped drive (e.g. F:) for the .pst file, use a UNC path (a path in the form
\server\share\directories\filename.pst). The DS-MLR service logon account must have full rights to the
UNC path.
3.
Question / Problem
Can I backup an Outlook PST file that is open?
Explanation
Only if the current logged on user is the same user as the DS-MLR service account.
Solution / Workaround
N/A
4.
Question / Problem
Can I backup an Outlook profile that is connecting to an Exchange mailbox?
Explanation
There are two kinds of MS Outlook profiles: Exchange and Internet.
Solution / Workaround
• For Internet Profiles, the E-Mails are downloaded from the E-Mail server (Exchange, etc.) and stored
in the local PST file. DS-MLR can read those E-Mails.
• For Exchange profiles, the E-Mails are sitting on the Exchange server. To access those E-Mails, the
DS-MLR service account needs the “Receive As” privilege on that Exchange server. Otherwise, DSMLR will return an access denied error.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 457
Confidential.
Knowledge Base: BACKUP
5.
Question / Problem
An MS Outlook backup fails with the message: "The Microsoft Exchange Server computer is not available.
Either there are network problems or the Microsoft Exchange Server computer is down for maintenance."
Explanation
If you confirm the Exchange Server is running properly, and that there are no network problems, this
may be a problem with your MS Outlook profile configuration.
There are two kinds of MS Outlook profiles: Exchange and Internet. For Exchange profiles, MS Outlook
must supply the correct username and password for the desired mailbox. This problem may occur if the
DS-MLR computer is not in the same domain as the Exchange server and/or the DS-MLR service account is
not a Domain Admin for the Exchange server’s domain.
Solution / Workaround
• Save the username and password of the mailbox in Outlook with the option “Remember my password”.
• NOTE: Using DS-MLR to back up an MS Outlook Exchange profile is not recommended. In such a
situation, it is better to install DS-MLR on the Exchange Server itself. Then, you can use DS-MLR to
backup any of the Exchange mailboxes.
See Also
“E-Mail Messages (DS-Recovery Tools)” on page 114
“DS-MLR Installation & Setup” on page 328
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 458
Confidential.
Knowledge Base: BACKUP
Backup Comparison: Microsoft Exchange Server vs.
Message Level Restore
Creation Date: July 19, 2007
Revision Date: July 19, 2007
Product:
DS-Client (Windows) with DS-MLR Service (DS-Recovery Tools)
Summary
NOTE: From v.7.0, the DS-MLR Service is bundled with the DS-Recovery Tools installation.
This article gives comparisons for when you might protect a Microsoft Exchange Server with an
Exchange Server database backup set, with DS-MLR (message level restore), or with both.
Microsoft Exchange Server database backup set
Restoring a backup of an Exchange database will roll-back the whole Exchange Server to that last
successful backup time (unless you manually apply the transaction logs). This solution is best for
large scale recovery situations (e.g. disasters, server failure, etc.).
If you only need to recover one or two E-Mails, the down-time may be a consideration against
restoring the entire database.
DS-MLR backup set
The benefit of message-level restore is the very precise “granularity” of the restore item. Restoring
an individual message or mailbox is much faster than rolling back an entire database to the last
backup.
Since DS-MLR treats each E-Mail object as a separate backup item, it can be somewhat slower
when it has to backup many small E-Mails.
DS-MLR on:
MS Exchange Server
This configuration allows you to perform message-level backups from all mailboxes on
the MS Exchange server.
MS Outlook
The main point is to provide message-level backups of the local .PST file. This is for an
MS Outlook installation configured with an “Internet” profile (a profile that downloads
all E-Mails to the local computer’s .PST file).
• Though it is possible to backup an MS Outlook Exchange profile (an Outlook profile
configured to read E-Mails that reside on an MS Exchange server), in such a situation it would be better to install DS-MLR on the Exchange Server itself (see above).
Both types of backup sets
The only consideration is cost (duplication). Otherwise, you can take advantage of the strengths of
both.
See Also
“Backup / Restore of Microsoft Exchange Server” on page 424
“Backup / Restore of E-Mails (using DS-MLR)” on page 452
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 459
Confidential.
Knowledge Base: BACKUP
Backup / Restore of System i Server
Creation Date: February 16, 2006
Revision Date: February 21, 2008
Product:
DS-Client
Summary
This article covers the following System i Server issues:
• “Unix DS-Client issues” on page 460
• “DS-Client performance considerations” on page 460
• “Configuring the System i Server” on page 461
• “Services Required on the System i Server” on page 461
• “System i Server Backup Checklist” on page 462
• “System i Server Disaster Recovery” on page 462
• “Known System i Server restore issues:” on page 463
Unix DS-Client issues
Windows DS-Client is recommended for backups of System i Server because it uses IBM iSeries
Access to communicate with the System i Server.
Unix DS-Client uses FTP to communicate with the System i Server, and it does not support
backup of the system info (user profiles and the configuration).
DS-Client performance considerations
If you create System i Server backup sets with the "Individual obj." option selected, the following
performance considerations apply:
1. The backup performance will be affected.
2. If the saved library contains a large number of small objects, the backup performance
will be further significantly affected.
3. If you only wish to restore certain objects from the backup set, this option will improve
the restore performance. If you plan to restore the entire library, do not to use this
option.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 460
Confidential.
Knowledge Base: BACKUP
Configuring the System i Server
The following configurations must be made on the System i Server before backups / restores can
be performed.
1. Create a special user on the System i Server for the purpose of backup. Do not use
this user for any other purpose. This user must also have:
• the user class *SECADM on its user profile
• the special authorities *SECADM *ALLOBJ *JOBCTL
• the *SAVSYS special authority if a backup of the system info is required
You can change the above parameters using the following command:
===> CHGUSRPRF USRPRF(user_name) USRCLS(*SECADM) SPCAUT(*SECADM *ALLOBJ
*JOBCTL)
2. In order to exchange data between a System i Server and the DS-Client, the folder
DSBUFFER and one or more subfolders must be created in the "root" IFS system. To
create these folders from the command prompt, type the following command(s):
===> MD DIR('/DSBUFFER')
===> MD DIR('/DSBUFFER/folder_name')
3. Create two libraries on the System i Server: LIBIN and LIBOUT. These are the
locations where DS-Client creates the save files (the System i Server equivalent of a
database dump file). To create these libraries you can use the following commands:
===> CRTLIB LIB(LIBIN)
===> CRTLIB LIB(LIBOUT)
The LIBIN and LIBOUT libraries are used as a buffer to transfer save files from or to
the System i Server. In addition, these libraries could be used by the System i Server
administrator to locate a save file for a manual restore (in case the "Restore only
dump file" option is checked, or on unsuccessful completion of a restore process).
4. [Windows DS-Clients only] Install iSeries Access for Windows on the DS-Client
computer using the following installation program:
\\<System i Server>\QIBM\ProdData\Access\Windows\Install\Image\Setup.exe
Refer to your iSeries Access for Windows documentation for further instructions.
5. DSBUFFER share: In order to create and execute backup sets, the DSBUFFER folder
must be shared (with read/write permissions). You can manage the DSBUFFER share
in the iSeries Navigator or System i Server Operations Navigator.
6. Firewall: If there is a firewall between the DS-Client computer and the System i Server
to backup, the ports 139, 449 as well as the ports between 4400 and 4407 must be
opened.
Services Required on the System i Server
The System i Server must be running the TCP/IP jobs. They can be started with the STRTCP
command. To start the TCP application server jobs individually, you can use the STRTCPSVR
command with a corresponding parameter.
• For Windows DS-Clients, the Netserver is required. This can be started using
the command STRTCPSVR SERVER(*NETSVR).
• For Unix DS-Clients, the FTP TCP/IP server is required. This can be started
using the command STRTCPSVR SERVER(*FTP).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 461
Confidential.
Knowledge Base: BACKUP
System i Server Backup Checklist
The following checklist can be used to quickly verify if an System i Server machine is properly
configured for ASIGRA Televaulting Backup.
General checklist
(Windows) DS-Client computer: verify iSeries Access is installed
System i Server: Login as QSECOFR or a user with equivalent rights to perform the following checklists
Backup user checklist
Run the following command:
===> DSPUSRPRF USRPRF(USERNAME)
Verify user class *SECADM
Verify special authorities *SECADM *ALLOBJ *JOBCTL
If you need to backup the System i Server system information, verify special authority *SAVSYS
Buffer folder checklist
Verify DSBUFFER is shared with read/write permissions using System i Server Operations Navigator
or iSeries Navigator on the DS-Client PC
Run the following command:
===> WRKLNK OBJ('/DSBUFFER')
Verify at least one folder exists
Libraries checklist
Run the following command:
===> WRKLIB LIB(LIB*)
Verify libraries LIBIN and LIBOUT exist
Firewall checklist
Verify ports 139, 449, 4400-4407 are open (Perform only if there is a firewall between the System i
Server and the DS-Client computer.)
System i Server Disaster Recovery
The following section explains how to perform an System i Server disaster recovery given the
following scenario:
A backup of the System i Server’s Operating System is made on tape. Your Windows
DS-Client has backups of the System i Server’s data and System Info.
1. Perform the following manual steps to get the System i Server running:
• Repair or obtain a replacement System i Server machine.
• Restore the LIC from your Full Tape Backup (The PTF level of the original
system must be restored on the backup machine).
• Restore the i5/OS.
2. Configure the following networking services on the System i Server:
• Client Access
• TCP-IP
• The Host servers
3. Perform the configurations described in section “Configuring the System i Server” on
page 461. When your are finished, the System i Server should be able to
communicate with the DS-Client.
4. From DS-Client (DS-User > Restore Wizard), restore the System i Server System
Info:
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 462
Confidential.
Knowledge Base: BACKUP
• Restore the user profiles
• Restore the configuration
5. Once the System i Server’s operating system and system info are restored, you may
restore the user data using ASIGRA Televaulting. Once user data is restored, you
must restore authority. (See “Known System i Server restore issues:” on page 463.)
Known System i Server restore issues:
1. User profiles:
• Restored user profiles have no passwords. The passwords must be set up
again manually by the administrator.
• Authority for named objects owned by other users cannot be restored
automatically. It must be restored manually from the save file delivered during
the restore process.
Note: This limitation is for other users only, not for the object owners.
• The group profile parameter of the user profiles must be re-configured
manually (only in case the defaults were changed).
2. The contents of the queues are empty (e.g. there are no spool files or jobs waiting for
execution).
See Also
“System i Server Backup” on page 119
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 463
Confidential.
Knowledge Base: BACKUP
Backup / Restore of Virtual Machines using Windows
DS-Client and VCB
Creation Date: January 04, 2008
Revision Date: March 27, 2008
Product:
DS-Client (Windows)
Summary
Windows DS-Client can perform Virtual-Machine-level backup and restore of VMWare servers.
This means the backup can be performed without the significant manual steps described in the
Knowledge Base article “Backup of VMWare (host-side backup)” on page 418.
This only works for VMWare ESX servers.
Prerequisites
DS-Client is using the VMWare Consolidated Backup (VCB) to backup and restore virtual
machines on VMWare ESX servers with two custom-made applications (vcbBrowse.exe &
vcbrun.exe).
VCB can be downloaded from the VMWare site. VCB needs the Microsoft .NET Framework 2.0 to
be installed on the DS-Client machine.
After installing VCB, create a directory on the local hard disk and copy the following files that are
provided with the DS-Client: vcbrun.exe and vcbBrowse.exe:
• The "vcbBrowse.exe" file is a program which helps you to select the virtual
machines you would like to backup and will create the xml file needed by the
vcbrun.exe program.
• The "vcbrun.exe" file is an application that uses VCB to backup virtual
machines.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 464
Confidential.
Knowledge Base: BACKUP
Steps to backup a virtual machine
1. Run vcbBrowse.exe and connect to the VMWare ESX server with Administrator
credentials:
2. Select the VCB destination directory where the virtual machines files will be exported
along with some parameters:
• Monolithic file (which is off by default). If set, the disk will be exported into a
single (monolithic) file.
• Flat disk (which is off by default). If set, the disk is exported as a "flat" disk
with no optimizations.
3. Select the virtual machines which you wish to backup.
4. Press the Generate XML button to create the xml file and specify the name of the file.
The file should be created into the same directory where the vcbrun.exe program
exists.
5. Create a File System backup set for the VCB destination directory using the full UNC
name (not “My Computer”).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 465
Confidential.
Knowledge Base: BACKUP
6. In the New Backup Set Wizard’s “Set Properties Options Tab“, click “Pre/Post” and
configure the following Pre/Post commands to run:
You can specify some parameters for vcbrun.exe as:
• xml to specify the name of the xml file. Default is the "vcbrun.xml" if nothing is
typed.
• log to specify if you need a log for troubleshooting. By default it will be put in
C:\WINDOWS\system32 with the name "vcblog.txt".
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 466
Confidential.
Knowledge Base: BACKUP
Steps to restore a virtual machine
1. To restore a virtual machine, you must first restore the backup set to an alternate
location.
2. Copy the restored files and directories with WinSCP (or equivalent program) to the
VMWare ESX server storage.
3. Connect using a console to the VMWare ESX server and run the command
vcbRestore.
4. To restore the virtual machine to the original location you must specify some
parameters, such as:
• the machine name which will perform restore,
• the credentials,
• the source directory for the restore (which is the directory where you copied
the resulted files from the DS-Client restore).
The following is an example of the command to use:
vcbRestore -h localhost -u username -p password -s vcb-backup/
source_directory
Note:
Be sure the existing virtual machine is shutdown.
5. To restore to an alternate location you must edit the catalog file for every virtual
machine you want to restore.
• More details are specified in the "Virtual Machine Backup Guide" document
from the VMWare site.
See Also
“VMWare Backup (LINUX DS-Client)” on page 124
“Backup / Restore of VMWare (at Virtual Machine-level)” on page 468
“Backup of VMWare (host-side backup)” on page 418
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 467
Confidential.
Knowledge Base: BACKUP
Backup / Restore of VMWare (at Virtual Machine-level)
Creation Date: January 16, 2008
Revision Date: March 27, 2008
Product:
DS-Client (Linux)
Summary
Linux DS-Client can perform Virtual-Machine-level backup and restore from VMWare ESX
servers. This means the backup can be performed without the significant manual steps described
in the Knowledge Base article “Backup of VMWare (host-side backup)” on page 418.
This only works for VMWare ESX servers.
General Requirements
•
The user who performs VMWare ESX server backup / restore should have
knowledge about the VMWare ESX server infrastructure.
DS-Client Computer Requirements
1. On the Linux DS-Client computer, modify the /etc/hosts file.
• Add a line containing the hostname and IP address of each VMWare ESX
Server you want to backup or restore. For example:
ESX5
10.10.10.105
VMWare ESX Server Requirements for SSH (ESX versions 3.0.1 & 3.0.2 only)
ESX versions 3.0.1 and 3.0.2 are backed up using the SSH protocol. For these versions, you must
perform all these steps on every VMWare ESX Server you want to backup or restore.
1. Create a backup user with shell access.
2. Grant this user access to the virtual machine files. (By default only ‘root’ has access to
the VM data, therefore you must grant this user permission to ‘sudo’ commands as
‘root’.)
• Open the file “/usr/sbin/visudo”
• Add the line “<user> ALL=(root) /usr/bin/python”, where <user> is the name of
the backup user.
• Save this file.
See Also
“VMWare Backup (LINUX DS-Client)” on page 124
“Backup of VMWare (host-side backup)” on page 418
“Backup / Restore of Virtual Machines using Windows DS-Client and VCB” on page 464
“VMWare Considerations” on page 469
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 468
Confidential.
Knowledge Base: BACKUP
VMWare Considerations
Creation Date: March 27, 2008
Revision Date: March 27, 2008
Product:
DS-Client (Linux)
Summary
This article describes various VMWare backup and restore considerations. It should be read
before performing backups of VMWare servers.
• “Alternate Location Restore” on page 469
• “Backup of Virtual Machines uses snapshots” on page 469
• “Virtual Machines with the same name” on page 470
Alternate Location Restore
The paths that are shown in the DS-User for virtual machines are the same as the ones available
in the Virtual Infrastructure Client. When performing restores, the paths must match the legal path
for a virtual machine to be created in the Virtual infrastructure Client.
From a practical perspective, this means the path is always of the form:
<data-center-name>\<vm>\<path-to-vm>
Trying to restore into a path that is not valid will result in SOAP errors during the restore. When
restoring to alternate locations, always make sure that the path in the "Truncate" area is a valid
path for Virtual Machines.
In addition, you should not change the Virtual Machine name when performing alternate restores.
Attempting to change the name will restore all the files to the VMWare server, however the
registration of the virtual machine will fail (see “Virtual Machines with the same name” on
page 470).
To summarize:
• When connecting to ESX through the Virtual Center, the alternate restore
path must be:
“data center”\“vm”\“folder-name”
•
When connecting directly to the ESX Host, the alternate location restore
path must be:
“datacenter”\“vm”\“vm-name”
Backup of Virtual Machines uses snapshots
Backup of VMWare uses snapshots in order to unlock locked disks for backup. As a result, any
disks that cannot be unlocked by a snapshot (e.g. independent disks or raw disks) cannot be
backed up while the virtual machine is running. Backup and restore of Virtual Machines that are
using independent or raw disks is not supported.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 469
Confidential.
Knowledge Base: BACKUP
Virtual Machines with the same name
Restoring two Virtual Machines on the same server with the same name, does not work.
When restoring a Virtual Machine, the VM name is contained in the backed up VM names. As
such, when performing restores, the DS-Client will use this (backed up) virtual machine name to
find configuration settings and perform virtual machine registrations.
Do not try to change the virtual machine names when performing alternate location restores. Any
such name changes will not take effect and may cause the restore to fail.
What you can do is change the folder to which a virtual machine will be restored.
See Also
“VMWare Backup (LINUX DS-Client)” on page 124
“Backup of VMWare (host-side backup)” on page 418
“Backup / Restore of Virtual Machines using Windows DS-Client and VCB” on page 464
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 470
Confidential.
Knowledge Base: BACKUP
Backup / Restore of XenSource (at Virtual Machinelevel)
Creation Date: January 18, 2008
Revision Date: March 27, 2008
Product:
DS-Client (Linux)
Summary
Linux DS-Client can perform Virtual-Machine-level backup and restore from XenSource servers.
Backup
The following backup issues must be considered:
• The Virtual Machine must be stopped.
• No incremental backups can be performed. Each backup session will send a
unique, full master backup for each item.
• The backup wizard can only list VMs / templates with unique names. If you
have VMs or templates with the same name, you must use XenCenter to
make all names unique before you can backup.
Restore
The following restore issues must be considered:
• The Virtual Machine cannot be overwritten. A new VM with the same name
will be restored.
• Virtual Machines with the same name will be ignored.
• The duplicate VMs can be un-installed through the XenCenter GUI.
• The duplicate templates cannot be removed.
See Also
“XenSource Backup (LINUX DS-Client)” on page 126
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 471
Confidential.
Knowledge Base: BACKUP
Backup / Restore of SharePoint Servers
Creation Date: January 18, 2008
Revision Date: January 18, 2008
Product:
DS-Client
Summary
This article describes the SharePoint items that can be backed up and restored.
SharePoint Server Support Matrix
Check the Matrix for supported SharePoint Server Versions:
SharePoint Item
Windows DS-Client
Linux DS-Client
Document Library
Supported
Supported
Form Library
Supported
Supported
Default Wiki Page Library
Supported
Supported
Wiki Page Library - New Web Part
Not Supported
Not Supported
Picture Library
Supported
Supported
Report Library
Supported
Supported
Translation Management Library
Supported
Supported
Data Connection Library
Supported
Supported
Slide Library
Supported
Supported
Shared Documents
Supported
Supported
Announcements
Supported
Supported
Default Layout for Contacts
Supported
Supported
Contacts Information - List Settings
Not Supported
Not Supported
Contacts Information - New Column
Supported
Not Supported
Contacts Information - Personal Views
Not Supported
Not Supported
Custom Lists
Supported
Supported
Discussion Board
Supported
Supported
Calendar
Supported
Supported
Tasks
Supported
Supported
Links
Supported
Supported
Survey
Supported
Supported
Pages
Supported
Not Supported
Sties and Workspaces
Supported
Supported
Web Part Pages
Not Supported
Not Supported
Personal Sites
Supported
Supported
Personal Sites - My Profile
Not Supported
Not Supported
KPI Lists
Supported
Supported
Matrix Legend:
• Supported: DS-Client supports backup / restore of this SharePoint item.
• Not Supported: DS-Client does not support backup / restore of this item.
See Also
“MS SharePoint Server (DS-Recovery Tools)” on page 123
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 472
Confidential.
Knowledge Base: BACKUP
Block-Level Resume
Creation Date: October 17, 2005
Revision Date: February 20, 2008
Product:
DS-Client
Summary
If the backup is interrupted (e.g. the connection to DS-System is lost), DS-Client will attempt to
reconnect for a specified number of times (DS-User Menu > Configuration > Parameters >
Scheduled backups) in order to resume the backup.
Block-Level Resume allows the scheduled backup to continue the backup from the last successful
file block backed up in the session. The benefit increases with the size of the file being backed up.
(For example: without this feature, backup of a large file that is interrupted because of a slow /
poor connection would have to restart from the beginning of the file.)
Block-Level Resume applies to:
• Big files (files larger than 100MB).
• Scheduled backups.
For Windows DS-Client:
This solution applies to File System backup sets, and to other backup sets that use the DS-Client
Buffer (See “DS-Client Buffer” on page 378.):
• File System backup sets.
• Permissions backup sets.
• SQL backup sets using DS-Client buffer.
• Exchange backup sets using DS-Client buffer.
• Oracle backup sets using DS-Client buffer.
• E-Mail backup sets using DS-Client buffer.
• System i Server backup sets using DS-Client buffer.
For Linux DS-Client:
File System backup sets can resume at block-level for the following backup set types:
• Local File System
• UNIX-SSH
• NFS
• Samba
Note:
When Block-Level Resume does not apply, the resume will occur at file-level.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 473
Confidential.
Knowledge Base: BACKUP
Continuous Data Protection (Backup Set Option)
Creation Date: July 31, 2006
Revision Date: January 18, 2008
Product:
DS-Client
•
•
•
•
•
•
•
•
•
“Summary” on page 474.
“Details” on page 474.
“Continuous Data Protection Requirements” on page 475.
“Features and Limitations” on page 475.
“CDP with other Activities” on page 476.
“CDP Backup Sets that are Scheduled” on page 477.
“Bandwidth considerations (catch-up, queueing, granularity):” on page 477.
“Reconnection:” on page 477.
“Switching a backup set from CDP to non-CDP” on page 478.
Summary
Users often want their data to be protected as soon as it is in its final state. This means that
scheduling backups weekly (or even daily) may not be sufficient, because data may not be backed
up before the machine has a problem. Although hourly backups can provide a more robust backup
strategy, they may consume too much system resources because a complete file system scan is
required. Word processing or spreadsheet files are some examples of when users would like to
have their data protected as soon as it is possible (or after a very small interval of time): once the
document is saved to disk, it will be backed up by DS-Client and sent off-site.
“Continuous Data Protection” is a backup solution that continuously monitors the changes on the
target server and backs up the changes as soon as they are detected. It differs from the normal
“point-in-time” backup - it is continuous data protection. It also differs from replication or mirroring,
which only keep a snapshot of the latest image. Instead, “Continuous Data Protection” will also
keep intermediate changes and be able to recover images from a specific time.
Details
Once a “Continuous Data Protection” backup is started (on demand or scheduled), the DS-Client
continuously monitors the changes happening on the target backup server. As soon as a change
happens, DS-Client will immediately backup the changes to the DS-System. DS-Client can also be
configured with Local Storage for fast recovery purposes.
It is not mandatory to backup a whole server with “Continuous Data Protection”. Like normal file
system backup sets, customers can select specific parts of a server (any combination of share
level, directory level, and file level filters). Extended Regular Expressions can be used to define
complicated selections.
The Retention feature can help you to manage the amount of online generations stored on the DSSystem.
• For more information, see “About Retention Rules” on page 67.
In case the continuous backup is interrupted for any reason (by demand, hardware / software
failure, network problems, target server not available, etc.), in the next backup (including the very
first backup), the process will re-initialize and a full scan will be performed from the beginning.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 474
Confidential.
Knowledge Base: BACKUP
Continuous Data Protection Requirements
•
•
•
•
Supports File System Backups of Windows or UNIX servers.
Supports MS Exchange E-Mail backups (using DS-MLR and Windows DSClient).
Supports pure file system backup items only. (System Status and Services
Database are not supported, since they cannot be managed like pure files.)
Works with all other DS-Client features, except “Use Buffer” and “Pre-Scan”.
They are not available because they conflict with the logic of “Continuous
Data Protection”.
Features and Limitations
1. A regular “point-in-time” backup process stops once all the backup items have been
processed. The “Continuous Data Protection” process does not have a natural
“finished” state. Once started (by schedule / on demand), the “Continuous Data
Protection” process will not stop until one of the following conditions occurs:
• A demand stop is issued (i.e. click “Stop”).
• The scheduled time limit is reached.
• It is suspended by conflicting activities. (See “CDP with other Activities” on
page 476.)
• It runs out of retry connect times to DS-System (including restart backup
scenarios).
• Some other unexpected stop condition (Exceptions, failed to connect to
target, etc.).
2. “Windows 2000/2003 options” support with “Continuous Data Protection”:
• “Follow Junction Point” is NOT supported because DS-Client cannot be
notified of changes that happen inside the junction point.
• “Backup data in Remote Storage” is supported. However, like normal backup,
if the data on the remote storage is changed but not the placeholder,
DS-Client cannot detect the change.
• “Backup Single Instance Store file data” is supported.
3. When migrating a “Continuous Data Protection” set, the new target server must meet
the same requirements (See “Continuous Data Protection Requirements” on
page 475.).
4. A normal backup set can be changed to a “Continuous Data Protection” set, if it
satisfies all the conditions mentioned above . The Backup Options screen will only
allow you to select Continuous Data Protection if this is true.
5. Even with the “Continuous Data Protection” process, the same file cannot be backed
up more than one time in the same second. “Continuous Data Protection” is designed
to support changes down to the second.
• For data that changes very often, CDP can be configured to wait a specified
amount of time from the last change to a file before backing it up.
6. File Change Detection is configurable at the backup set level.
• Windows Built-in File Monitoring (Windows only): Interfaces with Windows
Operating System functionality for notification of file changes.
• File Alteration Monitor (UNIX only): Similar to the Windows Built-in File
Monitoring. Interfaces with UNIX Operating System functionality for
notification of file changes.
• Generic Scanner (UNIX only): Loops the scanning function from regular
backup sets. (This can be used if the File Alteration Monitor is not available.
This permits CDP of any file data at the expense of a higher I/O load.)
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 475
Confidential.
Knowledge Base: BACKUP
•
MLR E-Mail Monitoring (Windows only): Monitoring included with the DSMLR service installation.
7. Windows DS-Clients can only perform CDP if the target backup machine is supported
(Windows NT 4.0 or later). It cannot support servers that are ‘simulated’ as Windows
machines (e.g. using SAMBA to backup a unix machine).
8. CDP with BLM (Infinite Generations) will start Archiving activities as needed. While an
archiving activity is in progress, the BLM will deny access to the package that is
currently open for activities like Browse, Create Restorable Image, Retention, etc. The
DS-System will stop the current archiving activity after 5 minutes of inactivity, and restart a new one if needed.
9. The Process Window for CDP backup sets always shows the current data transfer
rate. (For regular backup sets, this number is the average transfer rate achieved since
the start of the backup.)
CDP with other Activities
Some activities are handled differently when interacting with CDP backup sets. Each CDP backup
set has on/off settings to suspend the backup for scheduled Retention, Validation, and BLM
(Backup Set Properties > Options Tab: Continuous Data Protection).
• If the suspend setting is “off”, the other (scheduled) activity will fail to run with
an error.
• If the suspend setting is “on”, (or if you run an on demand activity), DS-Client
will suspend the CDP and resume or restart after the other (scheduled / on
demand) activity finishes.
Suspend CDP, then resume
• Restore
• BLM Request
• Validation (without errors)
Suspend CDP, then restart a new CDP
• Synchronization
• Retention
• Delete
• Validation (with errors)
Daily Admin / Weekly Admin
The strategy is configurable (DS-User > Setup Menu > Configuration > Parameters Tab: CDP
Strategy).
• Skip: Admin will skip any running CDP backup sets
• Suspend: Admin will suspend any running CDP backup sets, then restart
them once the Admin is finished.
CDP must not be running
The CDP backup set must not be in use if you run any of the following activities (you will not be
allowed to proceed until the CDP backup is stopped):
• Assisted Delete (If a CDP backup is running, that backup set will be skipped)
• Remove Backup Set
• Disc/Tape Request
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 476
Confidential.
Knowledge Base: BACKUP
CDP Backup Sets that are Scheduled
A backup schedule can include the following tasks:
1. Perform Backup
2. Enforce Retention
3. Perform Validation
4. Perform BLM
For regular backup sets, tasks 1-4 will run in sequence.
If the schedule applies to a CDP backup set, tasks 2-4 are handled differently. The schedule will
run those tasks in the following sequence, then the CDP backup will resume / restart:
1. Perform Backup: A full scan and backup of the changed items is performed once, then
2. Enforce Retention: Suspend CDP, enforce retention, then restart a new CDP
3. Perform Validation:
• If validation completed without errors, suspend CDP, then resume.
• If validation completed with errors, suspend CDP, then restart a new CDP.
4. Perform BLM: Suspend CDP, perform BLM, then resume
5. After the last task is run, the CDP backup is restarted / resumed.
Note:
The next day, when the CDP backup reaches the same scheduled start time, DS-Client will
force a full scan of all files/folders in the CDP backup set’s backup items.
Bandwidth considerations (catch-up, queueing, granularity):
•
•
If network bandwidth is slow, DS-Client queues the list of changed files. The
backup is performed later, as network resources permit, using the latest
change to the queued file. This means less granularity (dynamic adjustment
to granularity).
If there are too many queued changes, a pre-scan of the entire backup set will
be performed.
Reconnection:
•
Both demand and scheduled CDP backup sets will use the reconnection
settings from DS-Client Configuration > Parameters Tab: Scheduled backup
section.
Unix DS-Client with File Alteration Monitor
• If the DS-Client cannot access a backup item’s parent folder when the backup
starts, DS-Client will re-check if it can be accessed every 5 minutes.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 477
Confidential.
Knowledge Base: BACKUP
Switching a backup set from CDP to non-CDP
In order to switch a CDP backup set to a non-CDP backup set the following steps must be taken:
1. If a CDP backup session for that backup set is in progress, it must be stopped.
2. Select that backup set in the DS-User Backup Sets Tab.
3. Right-click > Properties > Options. In the Set Properties Options Tab screen, uncheck
“Continuous data protection”.
4. Click Apply, then OK close the Backup Set Properties screen.
See Also
“Backup Set Options - Continuous Data Protection” on page 79
“About Retention Rules” on page 67.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 478
Confidential.
Knowledge Base: BACKUP
Memory Requirements for DS-Client During
Incremental Backup Using Delta Algorithm
Creation Date: August 17, 2004
Revision Date: January 18, 2008
Product:
DS-Client
Summary
This article describes the memory requirements for DS-Client when performing incremental
backup files using the Delta algorithm.
Details
Processing files with Delta algorithm is very resource intensive (CPU, memory) and DS-Client
needs to have enough memory in order to successfully complete. The memory requirements are
about 0.25% from the size of the files processed at a given time (please note that a backup activity
could process more than one file at once). For example, if DS-Client is processing a 100GB file, it
will require 3 unfragmented memory blocks totalling about 0.25GB or about 250MB of memory.
Sometimes the memory may become fragmented and DS-Client may not be able to allocate the
necessary amount; in such scenarios DS-Client will report "Out of memory" exceptions.
Here are a few things you can do if you encounter this situation:
• Add more physical memory.
• On a DS-Client backing up a big amount of data (either big files, or a big
number of files, or both), SQL Server and the DS-Client service use most of
that computer’s memory. Restarting these services will release some memory
otherwise cached and it will reduce the memory fragmentation.
• MS SQL Server uses as much memory as it is allowed, therefore limiting this
amount may be helpful for the other processes on that computer.
Delta processing of large files (up to 4 TB) on DS-Clients
DS-Clients running on 32-bit Operating Systems support Master/Delta processing for files
between 32 KB and 512 GB size. DS-Clients running on 64-bit support Master/Delta processing
for files between 32 KB and 4 TB size.
IMPORTANT NOTE: DS-Client will require a sufficient amount of RAM in order to process any
large file. The raw processing overhead in RAM of a single such file is about 0.2-0.5% of the file
size for the 32-bit DS-Client and 0.3-1% of the file size for the 64-bit DS-Client.
For example:
• To protect a 1 TB file, the 64-bit DS-Client will require the amount of
RAM+SWAP to be 1% x 1TB = 10GB for delta processing (about 0.3 x 1TB =
3GB of RAM minimum recommended).
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 479
Confidential.
Knowledge Base: BACKUP
Stop Backup (DS-User Initiated) DS-Client Registry
Settings
Creation Date: February 9, 2004
Revision Date: February 9, 2004
Product:
DS-Client
Summary
This article describes the behaviour when a user manually stops a backup set (from the DS-User).
Description
When user stops a backup set, DS-Client is still waiting for the file confirmation.
• A DWORD value WaitConfirmation is in the DS-Client computer registry. This
is the time out value when waiting for file confirmation. The default value is 60
seconds (if this value does not exist).
• If DS-Client still did not receive all confirmations when the time out is reached,
DS-Client will disconnect from DS-System and mark the backup set out of
sync.
• In the above scenario for Exchange backup sets, DS-Client will not send the
"retrieve deleted/overwritten generations" and the "Delete last session"
request.
• The next synchronization will correct the problem caused by disconnection.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 480
Confidential.
Knowledge Base: BACKUP
Tape Converter - Troubleshooting
Creation Date: November 12, 2007
Revision Date: November 12, 2007
Product:
DS-Client (Windows)
Summary
This article provides some additional information about using the Tape to BLM Converter feature.
It is assumed that the Tape Libary is installed and properly configured. If the DS-Client does not
recognize the Tape Library, it is most likely not properly configured.
Troubleshooting
If a tape library is not recognized:
• Try restarting the DS-Client computer.
1. If after installing the drivers for the Tape Library, the Library cannot be seen under
"Computer Management / Storage / Removable Storage / Libraries", go to:
"My Computer / Properties / Hardware / Device Manager / Tape Drive"
2. Click on properties. If there is a message that you must restart the computer after
installing the drivers, click OK and you will be prompted to restart the computer.
3. After you reboot, the Tape Library should be visible under Libraries in Computer
Management.
IMPORTANT NOTE ABOUT CHANGING TAPES
The DS-Client Tape Converter depends on Windows to interface with the Tape Drives. Therefore,
you must change tapes in a way that Windows will always be aware of your changes.
To change a tape:
• Open the Tape Drive door, and take a tape out from its slot.
• Close the Tape Drive door. Let Windows perform its inventory, and the
removed tape will be marked as off-line.
• Open the Tape Drive door again, and put the new tape in the empty slot.
• Close the Tape Drive door. Windows will identify the new tape.
• After Windows finishes its identification of the Tape, you must click Refresh in
the Tape Conversion Wizard to update the DS-Client’s list from the Tape
Library’s memory.
See Also
“Tape Conversion to BLM” on page 224
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 481
Confidential.
Knowledge Base: RESTORE
Knowledge Base: RESTORE
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 482
Confidential.
Knowledge Base: RESTORE
Alternate Location Restore of Microsoft Exchange
Server 2000 / 2003 (mailbox recovery)
Creation Date: November 11, 2002
Revision Date: February 26, 2008
Product:
DS-Client (Windows)
Summary
Please read this whole article first before starting the recovery procedure (to an alternate
Exchange Server).
Details
In order to perform a successful restore to an alternate location (different server) several
conditions must be met:
1. The recovery server must be installed in a different Active Directory (AD) forest than
the original server.
• The target Exchange server for the restore must be the same version and
service pack as the Exchange server that was backed up.
2. The Organization name, the administrative group name, the Storage groups and their
stores, and the file locations must be the same as on the original server. If the
organization name and/or the administrative group name is not the same, you can use
a tool called "legacydn". The tool can be found on the service pack CD in the directory
\server\support\utils\i386\LegacyDn. Read the text file that comes with the tool for
more information. If you use this tool to rename, you may have to restart "Exchange
System Manager".
• By default, the installation of Exchange 2000 / 2003 server creates the
mailbox and public folder stores. These are normally called "Mailbox store
(SERVER_NAME)", "Public folder store (SERVER_NAME)". Make sure the
recovery server has the same store names as the original server. You can
rename the stores using "Exchange System Manager": Right-click on each
store and select rename. If the location of the database directories and log file
directories is not the same as on the original server, change it here at this
stage.
3. The recovery server must have an account member of the administrative group that
exists on the DS-Client computer. You can either create an account on the recovery
server, or you can create an account on the DS-Client computer that matches the
name and password of the administrator account.
4. The DS-Client computer must be able to resolve the fully qualified domain name of the
recovery server. Since the recovery server will be on a different Domain (different AD),
you can set the DS-Client NIC’s DNS settings to point to the recovery server. (Do not
forget to change it back to the original settings once the restore is completed.)
5. Dismount all the stores. Right click on each store and locate the database and
streaming database locations. Using Windows Explorer, delete all the files from these
directories. In step 2, you made the location of the database and logs the same; if you
have AD users with mailboxes, you may have to delete these mailboxes. Using
"Active Directory users and computers" right click on the users, and select "Exchange
tasks" > delete mailbox (remember all these actions are to be performed on a test/lab
server). In "Exchange System Manager" click on the server and in the left pane right
click on each storage group and select "Properties". This gives you the location for the
logs. Delete them using Windows Explorer. Mount all the stores. Ignore the warning
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 483
Confidential.
Knowledge Base: RESTORE
for the missing database files and click "Yes" on it. If you get any errors mounting the
stores, resolve them before going further. Usually if you had to rename stores or
organizations, you have to restart all Exchange services. At this point you should be
able to mount all stores without any problems. Right click on each store, select
"Properties" and click on the "Database" tab. Select "This database can be overwritten
by a restore" checkbox.
6. Once the above conditions are met, you can start the restore from DS-User. In the
restore wizard, change the location from "Original location" to "Alternate location", and
click on [>>]. Browse and select the recovery server. Check "Ask for network
credentials". Once you have selected the server, double click on it or click on the
"Select" button. You will be prompted to type a user name and a password. Use the
same one from step 3 above. Keep all the rest of the settings unchanged and click
"Finish".
Note:
If you get errors during the restore, it is likely that some of the conditions (1 to 5 above)
were not met.
Once the restore is completed without errors you can perform a mailbox recovery if you want.
Mailbox Recovery
The mailbox recovery involves the following steps:
1. Create an Active Directory user account, but do not mailbox-enable the user account.
None of the naming for the account needs to match the account that was previously
linked to the mailbox.
2. In Exchange System Manager, locate the Mailboxes object under the database
object, and then right-click the Mailboxes object to run the Mailbox Cleanup Agent. In
the Mailboxes list, make sure that a red X is displayed next to the mailbox that you
want to recover. This indicates the mailbox is not connected to an Active Directory
user.
3. Right-click the mailbox that you want to recover, and then click Reconnect. A list of
Active Directory accounts is displayed, and you can connect the mailbox to the
account that you just created for the mailbox.
See Also
“Backup / Restore of Microsoft Exchange Server” on page 424
“Alternate Location Restore of Microsoft Exchange Server 2007 (mailbox recovery)” on page 485
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 484
Confidential.
Knowledge Base: RESTORE
Alternate Location Restore of Microsoft Exchange
Server 2007 (mailbox recovery)
Creation Date: February 20, 2007
Revision Date: February 02, 2008
Product:
DS-Client (Windows)
Summary
Please read this whole article first before starting the recovery procedure (to an alternate
Exchange Server).
If the DS-Client service (application) is not installed on the same computer as the Exchange 2007
server, the following steps must be performed before you can restore:
1. You must copy the following files from the DS-Client computer to the
<Operating_System_path>\sysWoW64 directory on the Exchange 2007 server:
address.dll,
cdoexm.dll,
escprint.dll,
ese.dll,
exchmem.dll,
glblname.dll and
pttrace.dll
Note:
<Operating_System_path> is the path where the Operating system was installed (by
default C:\Windows).
2. For 32-bit DS-Clients, the files are found in the folder:
<Operating_System_path>\system32\
For 64-bit DS-Clients, the files are found in the folder:
<Operating_System_path>\sysWoW64\
3. Register the cdoexm.dll file on the Exchange Server computer by opening a command
line window and running the following command:
regsvr32 "<Operating_System_path>\sysWoW64\cdoexm.dll"
Details
In order to perform a successful restore to an alternate location (different server) several
conditions must be met:
1. You can perform recovery on individual databases and storage groups or on all
databases on a particular server. The recovery server must be installed in a different
Active Directory (AD) forest than the original server.
• The target Exchange server for the restore must be the same version and
service pack as the Exchange server that was backed up.
2. The Organization Configuration, the Server Configuration, the Recipient
Configuration, the Storage groups and their mailbox databases, and the file locations
must be the same as on the original server.
• By default, the installation of Exchange 2007 server creates the mailbox and
public folder stores. These are normally called "Mailbox Database", and
"Public Folder Database". Make sure the recovery server has the same
Mailbox Database names and Public Folder Database names as the original
server. You can rename the stores using "Exchange Management Console":
Right-click on each database and select Properties. If the location of the
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 485
Confidential.
Knowledge Base: RESTORE
3.
4.
5.
6.
database directories and log file directories is not the same as on the original
server, change it here at this stage. Right-click on each store and select
"Move Storage Group Path".
The recovery server must have an account member of the administrative group that
exists on the DS-Client computer. You can either create an account on the recovery
server, or you can create an account on the DS-Client computer that matches the
name and password of the administrator account.
The DS-Client computer must be able to resolve the fully qualified domain name of the
recovery server. Since the recovery server will be on a different Domain (different AD),
you can set the DS-Client NIC’s DNS settings to point to the recovery server. (Do not
forget to change it back to the original settings once the restore is completed.)
Dismount all the stores. Right click on each store and locate the database locations.
Using Windows Explorer, delete all the files from these directories. In step 2, you
made the location of the database and logs the same; if you have AD users with
mailboxes, you may have to delete these mailboxes. Using "Exchange Management
Console" under Recipient Configuration right click on the users, and select Remove.
• Delete all logs using Windows Explorer. Mount all the stores. Ignore the
warning for the missing database files and click "Yes" on it. If you get any
errors mounting the databases, resolve them before going further.
• Right click on each mailbox database or public folder database, select
"Properties" and click on the "General" tab. Select "This database can be
overwritten by a restore" checkbox.
Once the above conditions are met, you can start the restore from DS-User. In the
restore wizard, change the location from "Original location" to "Alternate location", and
click on [>>]. Browse and select the recovery server. Check "Ask for network
credentials". Once you have selected the server, double click on it or click on the
"Select" button. You will be prompted to type a user name and a password. Use the
same one from step 3 above. Keep all the rest of the settings unchanged and click
"Finish".
Note:
If you get errors during the restore, it is likely that some of the conditions (1 to 5 above)
were not met. Once the restore is completed without errors you can perform a mailbox
recovery if you want.
Mailbox Recovery
The mailbox recovery involves the following steps:
1. Create an Active Directory user account, but do not mailbox-enable the user account.
None of the naming for the account needs to match the account that was previously
linked to the mailbox.
2. Using Exchange Management Shell, connect the mailbox database you want to
recover to the user account that you just created in AD.
See Also
“Backup / Restore of Microsoft Exchange Server” on page 424
“Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox recovery)” on
page 483
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 486
Confidential.
Knowledge Base: RESTORE
Restoring Microsoft Exchange 2007
Creation Date: February 02, 2008
Revision Date: February 02, 2008
Product:
DS-Client (Windows)
Summary
If the DS-Client service (application) is not installed on the same computer as the Exchange 2007
server, the following steps must be performed before you can restore:
1. You must copy the following files from the DS-Client computer to the
<Operating_System_path>\sysWoW64 directory on the Exchange 2007 server:
address.dll,
cdoexm.dll,
escprint.dll,
ese.dll,
exchmem.dll,
glblname.dll and
pttrace.dll
Note:
<Operating_System_path> is the path where the Operating system was installed (by
default C:\Windows).
2. For 32-bit DS-Clients, the files are found in the folder:
<Operating_System_path>\system32\
For 64-bit DS-Clients, the files are found in the folder:
<Operating_System_path>\sysWoW64\
3. Register the cdoexm.dll file on the Exchange Server computer by opening a command
line window and running the following command:
regsvr32 "<Operating_System_path>\sysWoW64\cdoexm.dll"
There are two restore scenarios:
• “Restoring WITHOUT a Recovery Storage Group” on page 488
• “Restoring WITH a Recovery Storage Group” on page 488
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 487
Confidential.
Knowledge Base: RESTORE
Restoring WITHOUT a Recovery Storage Group
If no Recovery Storage Group currently exists on the MS Exchange 2007 Server:
1. From the Exchange Management Console: Enable the option "this database can be
overwritten by a restore" for the target restore database.
2. From DS-User: Open the restore wizard for the intended Exchange Server backup
set.
3. Select the option "restore to original location" and any other desired options, then start
and complete the restore.
Restoring WITH a Recovery Storage Group
If a Recovery Storage Group currently exists on the MS Exchange 2007 Server:
1. From the Exchange Management Console > Toolbox > Database Recovery
Management > Manage Recovery Storage Group:
• Make sure the Recovery Storage Group has the exact name "Recovery
Storage Group" on the target Exchange Server.
• Add the database you intend to restore to the Recovery Storage Group, then
set it to “allow overwrites”.
2. From DS-User: Open the restore wizard for the intended Exchange Server backup
set.
3. When you reach the "Select database restore location" screen, a pop-up message
appears:
"Recovery Storage Group was found on target Exchange Server. The selected
Exchange Database will be restored to Recovery Storage Group."
• This confirms the restore location.
• Proceed with the restore.
4. Mount the restored database in the Recovery Storage Group.
5. From Exchange Management Console > Toolbox > Database Recovery
Management: Use the merge option that is available.
See Also
“Backup / Restore of Microsoft Exchange Server” on page 424
“Alternate Location Restore of Microsoft Exchange Server 2000 / 2003 (mailbox recovery)” on
page 483
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 488
Confidential.
Knowledge Base: RESTORE
Bare Metal Restore of Windows 2000 / 2003
Creation Date: February 11, 2003
Revision Date: November 05, 2007
Product:
DS-Client
Summary
Bare Metal Restore is a restore process when the whole machine is being restored. Usually this
type of restore is performed after a complete hardware failure or hardware upgrade.
You must have backed up the machine’s System State and Services Database.
Microsoft recommends using the same hardware for the destination machine.
• You can restore Windows 2000/2003 machines to different hardware.
• Restoring a Windows NT4 machine to different hardware is not possible
(unless some initial preparations are made). However, if the differences are
minor (e.g. different SCSI controller, NIC) the restore may be successful.
Switching between different computer types (ACPI to standard computer type and vise versa) is
not allowed. For more information you can check Microsoft’s knowledge base article number
237556.
1. Determine your computer type:
Before starting the restore you can check your computer type. Here is how you can determine your
computer type.
Click Start, point to Settings, click Control Panel, and then double click System.
Click the Hardware tab, and then click Device Manager to view what is listed under the computer
branch.
Here are the descriptions of the computer types and the associated hal.dll:
• ACPI Multiprocessor PC – halmacpi.dll
• ACPI Uniprocessor PC – halaacpi.dll
• Advanced Configuration and Power Interface (ACPI) PC – halacpi.dll
• MPS Multiprocessor PC – halmps.dll
• MPS Uniprocessor PC – halapic.dll
• Standard PC – hal.dll
• Compaq SystemPro Multiprocessor or 100% Compatible – halsp.dll
There are other types available but that would require Hardware vendor specific installation
(involving customized hal.dll).
2. Restoring from one computer type to another:
In some cases it is necessary to perform bare metal restore to a machine of different type. In this
case after successful restore, after the reboot you will not be able to start your machine.
Regardless what backup software you are using the result would be the same – your computer
would not start properly or at all.
ASIGRA Televaulting software has a solution for this problem:
• In the last screen of the restore wizard, DS-Client will ask you if you want it to
save some files in order to preserve them. If you answered yes, they will be
saved with an extra extension called asigra-date-time. The files are – hal.dll,
ntoskrnl.exe, ntkrnlpa.exe, kernel32.dll, ntdll.dll, win32k.sys, winsrv.dll,
setup.log (in \WINNT\repair directory), and boot.ini.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 489
Confidential.
Knowledge Base: RESTORE
•
•
•
•
•
•
•
•
•
•
•
After the restore is finished, you are prompted to reboot the target computer.
Do so.
If your computer boots normally, no intervention is required. If your computer
does not boot, or crashes, you have to follow the steps outlined below:
Reboot the computer from the Windows 2000 installation CD, and start a
repair process using the recovery console.
Once you have the command prompt, change to the system32 directory (by
typing cd system32), and type dir *.*.asigra*
You should see the 7 saved files. Copy each one of them to their original
name. For example if you have hal.dll.asigra-022403-0800, you should type
copy hal.dll.asigra-022403-0800 hal.dll. Confirm the overwrite and continue
with the rest of the files.
Type cd dllcache. Type dir *.*.asigra*. You may see 2 more files. Copy them
to their original names.
Change to the root of C:\ drive by typing cd \
Type dir *.*.asigra*. You will see one file. Copy it to the original name
(boot.ini).
Change to C:\WINNT\repair by typing cd \winnt\repair. If your
%SystemRoot% is located on a different drive or has a different name,
change to the proper location.
Type dir *.*.asigra*. You will see one file. Copy it to the original name
(setup.log). You will need this file in case you need to perform repair.
After successfully copying all the files type exit, which would reboot the
machine. Boot normally, and your machine should be up and running.
There would be a rebuild of the plug and play database, and you may be prompted to provide
drivers for the new hardware found. Follow the instructions on the screen. When prompted to
reboot, select NO and finish installing all drivers. Set the TCP/IP details for your network
adapter(s).
Now you have to fix your computer type. If you did not check the computer type of the destination
machine (the one that you are restoring to), you can find out the type by checking the properties of
the hal.dll. Open your Windows explorer and go to %SystemRoot%\system32 (%SystemRoot% is
usually located in C:\WINNT). Locate the file hal.dll with the extra asigra extension. It could be
something like hal.dll.asigra-022403-0800. Right click on it and select properties. Click on the
"Version" tab, and from "Item name" select "Internal name". In the "Value" field you would see the
original file name. In step 1 above there is a description for each computer type and its
corresponding hal.dll.
Now you have to change your computer type to the right one (if it is not already so). Click Start,
point to Settings, click Control Panel, and then double click System. Click the Hardware tab,
and then click Device Manager to view what is listed under the computer branch. Right click on
the computer type, select Properties, and select "Driver" tab. Click on "Update driver" button. Click
on "Display a list of the known drivers for this device so that I can choose a specific driver" radio
button and click "Next". Select the right model for your computer (the one that you discovered by
checking the original hal.dll properties) and click "Next". Finish and when prompted to reboot do
so.
3. Restoring Active Directory in a multiple server tree.
Active directory is part of the System State and can be restored only as a System State restore.
System State would restore the registry as well. You can perform 2 types of AD restore – normal
and authoritative. The AD objects restored through normal restore, would be overwritten by the AD
replication. The restored objects would have their original "update sequence number". These
USNs are used by the replication process to detect and propagate AD changes among the servers
in the tree. Because of this the restored data would look old to the AD replication and the data
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 490
Confidential.
Knowledge Base: RESTORE
would never get replicated. In fact the replication process would overwrite it. When is the normal
(nonauthoritative) restore useful? It is good for single server trees, or when you want to restore the
registry, but not to overwrite the Active Directory.
However in case you need to restore an older version of the Active Directory (but not older than 60
days), you have to perform an authoritative restore. Below is a description of each restore type:
Authoritative restore - Select "Authoritative restore" in the last screen of the Restore Wizard. This
will perform authoritative restore of both AD and FRS.
The following list of requirements must be met before you perform an authoritative FRS restore:
a) The FRS service must be disabled on all downstream partners (direct and transitive).
b) Events 13553 and 13516 have been logged in the FRS event log.
c) The computer that is configured for the authoritative restore is configured to be
authoritative for all the data.
d) All other partners in the replica set must be reinitialized with a non-authoritative
restore.
To reinitialize the partners with a non-authoritative restore, stop the FRS service,
configure the BurFlags registry key, and then restart the FRS service. To do so:
• Click Start, and then click Run.
• In the Open box, type cmd and then press ENTER.
• In the Command box, type net stop ntfrs.
• Click Start, and then click Run.
• In the Open box, type regedt32 and then press ENTER.
• Locate the following subkey in the registry:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\NtFrs\Param
eters\Backup/Restore\Process at Startup
• In the right pane, double click BurFlags.
• In the Edit DWORD Value dialog box, type D2 and then click OK.
• Quit Registry Editor.
• Perform this on every partner.
After rebooting the machine you just restored, start the FRS service on all the partners by typing
"net start ntfrs" in the command box. They will synchronize from the restored machine.
Normal restore - default - "Authoritative restore" is NOT selected. This will perform nonauthoritative restore for both Active Directory and NTFRS.
You can still perform Non-authoritative restore with DS-Client and then manually run ntdsutil.
However this would not work if you are performing bare metal restore where the destination for
restore doesn't have AD. If this is the case, let DS-Client perform authoritative restore. DS-Client
is running several activities that you can not perform when running manually ntdsutil.
Note:
After successful restore you should reboot the machine. Once the machine is restarted the
plug and play database is reinitialized and most probably you will be prompted for a
reboot. Please do not reboot immediately, wait and make sure the Active directory and
FRS are synchronized.
Please note that replication may take some time before the restored data would be propagated. If
you are testing authoritative restore – please note that objects added to the AD after the backup,
would not be removed from AD after the authoritative restore. For more information see
Microsoft’s knowledge base article 216243.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 491
Confidential.
Knowledge Base: RESTORE
4. Restoring Active Directory on a server that is not the PDC when the PDC is
missing.
There are some scenarios when you have to restore AD on a domain controller when the PDC is
missing. In this case there are several steps that should be performed in order to get the AD in
100% running condition.
If the destination machine is a domain controller already, you have to boot into Directory Services
Restore Mode. If the destination machine is a stand-alone Windows 2000/2003 computer you can
start the restore immediately.
Select "Authoritative restore" in the last screen of the Restore Wizard. This will perform
authoritative restore of both AD and FRS.
After successful restore of the System State reboot the computer when prompted. Please note
that you may have to perform the steps outlined above in case you are restoring to different
computer type.
There are a few articles from Microsoft describing the whole process:
• 216498 - HOW TO: Remove Data in Active Directory After an Unsuccessful
Domain Controller Demotion
• 248410 - Error Message: The Account-Identifier Allocator Failed to Initialize
Properly
• 234790 - HOW TO: Find Servers That Hold Flexible Single Master Operations
Roles
• 223787 - Flexible Single Master Operation Transfer and Seizure Process
Outlined below is the whole process described step by step.
4.1. Login to the restored machine (after the normal reboot) and start a command prompt.
Start ntdsutil:
• Type "domain management"
• Type "connections"
• Type "connect to server ServerName" (where ServerName is your current
computer name)
• Type "quit"
• Type "select operation target"
• Type "list roles for connected server"
You should get information about what roles where associated with the server.
• Type "list sites" and note the number for the site you are dealing with
• Type "select site #" (where # is your site number. e.g. 0, 1, ...)
• Type "list domains in site" and note the domain number
• Type "select domain #" (where # is your domain number. e.g. 0, 1, ...)
• Type "list servers in site" and note the number for the missing PDC
• Type "select server #" (where # is your server number. e.g. 0, 1, ...)
• Type "list naming contexts" and note the number for the CN=Configuration
• Type "select naming context #" (where # is your naming context number.
e.g. 0, 1, ...)
• Type "quit"
• Type "quit"
• Type "roles" and you will be at the "fsmo maintenance:" prompt.
Now you must "seize" all 5 rows. ntdsutil will attempt to "safe transfer" the roles, but the transfer
will fail since the PDC is missing. Just ignore the errors, because seizure will succeed:
• Type "seize domain naming master"
• Click "Yes" at the pop up message
• Type "seize infrastructure master"
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 492
Confidential.
Knowledge Base: RESTORE
•
•
•
•
•
Click "Yes" at the pop up message
Type "seize PDC"
Click "Yes" at the pop up message
Type "seize RID master"
Click "Yes" at message prompting you to synchronize and "Yes' to confirm the
operation
• Type "seize schema master"
• Type "quit"
• Type "quit" to exit ntdsutil
4.2. Now you have to delete all references to the missing server. This could be
accomplished using "ADSI edit". This utility is free and is located on the Windows
2000 Server installation CD. It is in \support\tools. Just install the tools.
Start ADSI Edit. If you launch ADSI edit immediately after logon, you may receive an error that the
domain does not exist. Wait a minute or so and try again.
• In "Domain NC..." folder, expand until you reach "OU=Domain Controllers".
Locate the missing server and delete it. Redo the delete if you get an error or
partial delete.
• In "Configuration Container...", expand until you reach CN=Sites,
CN=SiteName - CN=Servers. Locate the missing server and delete it.
The last step is to set the Global catalog. In "Active Directory Sites and Services" expand the
site all the way down until you reached NTDS settings for the server that you restored. Right click
on "NTDS Settings" select "Properties", check "Global Catalog", click "Apply", and close this dialog
box.
4.3. Now you are ready to reboot. Reboot the server.
4.4. Examine all the logs for any errors. You should not have any errors. If this is not the
case you may have incompatible hardware or device drivers. Usually the error would
give you an indication what the problem is and you must be able to solve them.
4.5. Your server is now ready.
Note:
If there are no other domain controllers to synchronize with, you will have problems. For
an explanation of how to fix this, refer to the next paragraph 5 (Restoring Active Directory
from a multi server to a single server environment, or when the rest of the domain
controllers are missing).
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 493
Confidential.
Knowledge Base: RESTORE
5. Restoring Active Directory from a multi server to a single server
environment, or when the rest of the domain controllers are missing:
You will have SAM errors if other domain controllers are missing. If you do not plan to ever start
the other controllers, then you should remove them from Active Directory. Use ADSI Edit as
explained in step 4 above.
From "Active Directory Sites and Services" delete "Connection" from NTDS Settings.
After Service Pack 3, the FSMO role holder would not assume its FSMO role unless it had
successfully completed at least one sync. Microsoft changed this in order to avoid multiple FSMO
owners in a domain, and to prevent the Domain Controller from issuing duplicate RIDs.
As described in the previous steps if you seize the RID Master role it will not become authoritative
until it synchronizes with another DC.
During disaster recovery where you restore only one domain controller from backup, or when you
remove domain controllers from AD, you may get "The account-identifier allocator failed to
initialize properly..." errors in the System log. The error would be from source SAM and Event ID
16650. Dcdiag may report problems with RID Manager or corrupted data.
There are 2 solutions:
a) You can restore another domain controller, or
b) You can delete the replication links
In case you want to keep only one domain controller, you have to delete the replication links,
otherwise the domain controller is not fully operational.
Here are the instructions for deleting the replication links:
1. You need to use the repadmin tool. It is part of the "Windows 200 Support tools". The
installation of the tools is located in \SUPPORT\TOOLS on the Windows 2000 CD.
2. Open a command prompt and type "repadmin /showreps /v"
3. You need to find out the "guid-based-dns-name of replica partner", which is displayed
after "Address:" of the deleted partner.
4. Here is an extract from repadmin:
-----------------------------------C:\>repadmin /showreps /v
Default-First-Site-Name\SPEEDYNT4
DSA Options : IS_GC
objectGuid
: a089478f-cffb-409f-b74b-addb83a6e93e
invocationID: a089478f-cffb-409f-b74b-addb83a6e93e
==== INBOUND NEIGHBORS ======================================
CN=Schema,CN=Configuration,DC=spdnt4,DC=local
Default-First-Site-Name\TR1
DEL:b91cd853-6af0-4c3a-9586-b5dcc8f489f7 (deleted DSA) via RPC
objectGuid: a48650dc-8ed0-4363-8c25-b41553f9248d
Address: a48650dc-8ed0-4363-8c25-b41553f9248d._msdcs.spdnt4.local
ntdsDsa invocationId: 8994f8c1-f71e-454c-ad3a-17b119621381
WRITEABLE SYNC_ON_STARTUP DO_SCHEDULED_SYNCS
USNs: 3518/OU, 3518/PU
------------------------------------
5. In the example above, the FQDN is spdnt4.local and the "guid-based-dns-name of
replica partner" is "a48650dc-8ed0-4363-8c25-b41553f9248d._msdcs.spdnt4.local"
6. The restored server is called SPEEDYNT4 and the deleted partner - TR1.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 494
Confidential.
Knowledge Base: RESTORE
7. Now you can delete the replicas. The syntax is:
repadmin /delete <naming context> <restored server name> <guid-based-dnsname of replica partner> /localonly
8. <naming context> would be for the Schema, Configuration and Domain.
10. In our example to delete the links for the schema we would type:
repadmin /delete CN=Schema,CN=Configuration,DC=spdnt4,DC=local
speedynt4.spdnt4.local a48650dc-8ed0-4363-8c25b41553f9248d._msdcs.spdnt4.local /localonly
11. To delete the links for Configuration we would type:
repadmin /delete CN=Configuration,DC=spdnt4,DC=local
speedynt4.spdnt4.local a48650dc-8ed0-4363-8c25b41553f9248d._msdcs.spdnt4.local /localonly
12. To delete the links for Domain we would type:
repadmin /delete DC=spdnt4,DC=local speedynt4.spdnt4.local a48650dc-8ed04363-8c25-b41553f9248d._msdcs.spdnt4.local /localonly
13. You must reboot the server after deleting all the replication links.
14. Check the System Log after the reboot to make sure there are no errors from source
SAM.
6. Common mistakes:
•
•
•
Slow clients logins
Misconfigured DNS, DHCP
If the missing server is your PDC, and also your main DNS and DHCP server,
your client computers may experience slow logins or errors when trying to
login to the domain. If you are using fixed IP addresses, make sure the clients
DNS settings are correct. Check your DHCP server for proper settings.
See also
•
•
•
“Backing up Windows for Bare Metal Restore (BMR)” on page 401.
“Bare Metal Restore of Windows XP” on page 496.
“Important Notes for Bare Metal Restore” on page 497.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 495
Confidential.
Knowledge Base: RESTORE
Bare Metal Restore of Windows XP
Creation Date: September 17, 2004
Revision Date: November 05, 2007
Product:
DS-Client
Summary
Bare Metal Restore is a restore process when the whole machine is being restored. Usually this
type of restore is performed after a complete hardware failure or hardware upgrade.
Details
The Windows XP Service Pack 2 disables some services, and removes or replaces some others.
If performing a Bare Metal Restore on top of a basic Windows XP installation, those services
disabled by XP Service Pack 2 may be enabled and the ones removed by the same Service Pack
may still be found after the restore is completed.
We have an open case with Microsoft to resolve this issue. Until we provide a fix, even though the
conflicts described above can be manually resolved, we recommend applying the following
workaround:
• When a Bare Metal Restore is needed, install first Windows XP on the
destination machine, apply the Windows XP Service Pack 2 and then start the
full restore.
See also
•
•
•
“Backing up Windows for Bare Metal Restore (BMR)” on page 401.
“Bare Metal Restore of Windows 2000 / 2003” on page 489.
“Important Notes for Bare Metal Restore” on page 497.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 496
Confidential.
Knowledge Base: RESTORE
Important Notes for Bare Metal Restore
Creation Date: November 05, 2007
Revision Date: November 05, 2007
Product:
DS-Client (Windows)
Summary
Bare Metal Restore is a restore process when the whole machine is being restored. Usually this
type of restore is performed after a complete hardware failure or hardware upgrade.
This article explains the following:
• “No Bare Metal Restore of 32-bit Operating System to 64-bit is possible” on
page 497.
No Bare Metal Restore of 32-bit Operating System to 64-bit is possible
You cannot perform a Bare Metal Restore of a 32-bit Operating System (OS) to a 64-bit OS. This
is because there are significant differences between 32-bit and 64-bit operating systems, even if
they are from the same version of Microsoft Windows.
For example, the 64-bit Windows 2003 OS contains both the 64-bit compiled modules and most
of the 32-bit compiled modules for backwards-compatibility. Microsoft put a great deal of effort to
have 32-bit applications run transparently on the 64-bit OS. Those 32-bit modules are located
under a special folder in the 64-bit OS (not under the regular one you would find on a 32-bit OS).
Restoring the 32-bit files over the regular location would overwrite 64-bit modules and render the
system inoperable.
Similarly, the 64-bit Windows 2003 registry database contains both 64-bit specific and 32-bit
specific keys. Therefore a registry backup from a 32-bit OS would be missing the 64-bit specific
keys, and restoring to a 64-bit OS would overwrite the existing 64-bit keys with 32-bit ones,
rendering the computer un-bootable. Moreover, the 64-bit OS cannot use 32-bit drivers at all.
The list of differences goes on and on, therefore you cannot bare metal restore a 32-bit OS over a
64-bit one. The only option is to perform bare metal restore of a 32-bit OS over a 32-bit OS, or to
perform bare metal restore of a 64-bit OS to a 64-bit OS.
See also
•
•
•
“Backing up Windows for Bare Metal Restore (BMR)” on page 401.
“Bare Metal Restore of Windows 2000 / 2003” on page 489.
“Bare Metal Restore of Windows XP” on page 496.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 497
Confidential.
Knowledge Base: RESTORE
Restoring Files from a specific time
Creation Date: April 30, 1997
Revision Date: April 11, 2002
Product:
DS-Client
Summary
In some cases, you may wish to restore an older version of a backed up file. (e.g. If you discover
that files after a certain date are corrupted, or if you wish to restore a project that requires files from
the same backup session. The number of generation on-line depends on the backup set option
settings, as well as the number of backups performed and the frequency of changes to the backup
file.)
Details
The following dialogs are accessible from the Restore Wizard. (The path to get to the dialog is
shown in parentheses beneath the dialog title.)
Select by Generation
Restore menu > Restore Now > Show Files > File Info
• Highlight the desired generation of the file from the list and click on Select.
•
The Restore Wizard returns to the Select Files and Directories Tab, with your selection
market with a checkbox.
The directory list refreshes automatically to show files backed up at the time
of the selected generation.
Select by Backup Time
Restore menu > Restore Now > Advanced
Note
1. When you select a specific file generation, the display is changed to reflect only the backed up data
from that selected generation.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 498
Confidential.
Knowledge Base: RESTORE
Restoring Locked Files on Windows
Creation Date: July 28, 1997
Revision Date: February 27, 2008
Product:
DS-Client (Windows)
Summary
The DS-Client software can be instructed to restore locked files when the destination server is a
Windows NT / 2000 / XP / 2003 or VISTA computer. This feature is vital when restoring operating
system files that are locked and cannot be restored in any other way (e.g. most of the operating
system kernel files). Restoring locked files is accomplished by restoring the file with a temporary
name and registering the file with the operating system to replace the original on the next system
boot.
Procedure to Restore a Locked File
Locked files are restored by registering a replace operation with the operating system, which will
occur on the next system boot. On Windows, this information is stored in the registry.
There are two ways the locked file can be replaced with the restored file:
Method
Explanation
Restore file with a
temporary name
('dsbN.tmp', where N is a system generated number) and instruct the operating system to replace the original with the temporary file on the next system boot.
Rename the original
file
(to 'dsrN.tmp', where N is system generated number), restore file to original name
and instruct operating system to remove temporary file on the next system boot. This
option allows you to restore files that must be loaded by the operating system before
the process of replacing registered files takes place. The drawback of this method is
the computer may become unbootable if the process of renaming and registering
locked files is interrupted or not completed successfully.
Restoring Locked Files to a FAT Partition
On a FAT partition, you should consider the following behavior when restoring locked files:
1. A restore with no special options selected will register locked files for replacement on
reboot. It is strongly recommended that you use this method.
2. A restore with Use Buffer or Save Restore options selected might be able to
immediately overwrite some locked files. In some cases (e.g. databases, services),
these locked files will be overwritten AGAIN when the parent application is closed.
Note:
It is safer to restore WITHOUT the Use Buffer or Save Restore options.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 499
Confidential.
Knowledge Base: RESTORE
Special Warning Regarding Restoring Locked Files with the Rename Option
When using the Rename Option, you must ensure a complete and successful restore session.
1. Open the Event Log for that restore session
2. If there is at least one Event # 32 "The process cannot access the file because it is
being used by another process", then a successful restore MUST end with the
message "N locked files were registered for restore".
3. If you do not see this message, do not reboot the computer. Re-run the restore until
you see that message.
4. Once you have had a successful restore session, you must reboot your computer to
complete the restore process.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 500
Confidential.
Knowledge Base: RESTORE
Restoring NetWare Servers (4.x and 5.0)
Creation Date: July 14, 1999
Revision Date: March 21, 2002
Product:
DS-Client
Summary
In order to perform a bare metal restore of a NetWare server, some requirements must be met.
Since the DS-Client does not backup the DOS partition on the servers, the latest support pack
must be installed prior to restore. (If the latest SP is not cumulative, you must apply each SP
sequentially from the first SP.) This will update the DOS partition with the latest changes made
prior to backup.
If you have LAN, DSK or any other drivers stored on the DOS partition, you must have them on the
NetWare partition. Otherwise, they will not be backed up.
Details
To execute a full NetWare server restore:
1.
Install the NetWare server (this includes disk and LAN drivers), so the DS-Client can
see it on the network. Install the NetWare licenses.
2.
During the installation, you must provide the same NDS tree, and the same server
context, otherwise the DS-Client will not be able to restore (DS-Client cannot perform
an alternate restore of NDS).
3.
Apply the latest NetWare support pack. You can omit this step for NetWare 4.x
servers. However, it is necessary for NetWare 5.x servers because NDS will fail to
load if it is not in synch with the rest of the modules in NetWare 5.x.
4.
There are two scenarios when you perform a full restore: A) single server NDS tree,
and B) multiple server NDS tree. Novell claims that for multiple server environments,
you do not need to restore the NDS. The restored server will be able to pull NDS
updates from the rest of the servers. However, in mass disasters (or when emulating a
mass disaster) you may need to perform a full NDS restore to all of the servers.
5A. Scenario A - NDS tree with a single server.
5.1.1. Restore only NDS in a single session. This step is necessary because the NDS
object(s) must exist prior to applying trustee assignments.
5.1.2. Add Name Space (if any).
5.1.3. Restore the file system in the next session, then reboot the server (see Note 3).
5B. Scenario B - NDS tree with multiple servers.
5.2.1. Restore only NDS on the master replica in a single session.
5.2.2. Add Name Space (if any).
5.2.3. Restore the file system on the master replica in the next session (see Note 3).
5.2.4. Install the rest of the servers. When asked for the NDS tree name - select the
existing one and connect to the master replica.
5.2.5. Add Name Space (if any).
5.2.6. Restore the file system on the rest of the servers (see Note 3).
Notes
1. When doing a full file system restore you may encounter some errors. They will be recorded in the
DS-Client Logs. Once the restore is completed, check the Activity and Event Logs. If there were
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 501
Confidential.
Knowledge Base: RESTORE
any errors, perform a restore for each of the files that had errors. This is a known problem and ASIGRA is working with Novell to resolve it.
2. If you had more than one NDS partition, you must reconfigure it manually.
3. If you encounter "The network name cannot be found" when trying to restore, this means the NetWare SERVER has been rebooted too many times. This has caused the NetWare CLIENT on the
DS-Client computer to cache too much data. This can be fixed by either performing a "login" to a
NetWare server, or rebooting the DS-Client computer.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 502
Confidential.
Knowledge Base: RESTORE
Restoring NetWare Servers (5.1 and higher with NDS 8)
Creation Date: June 14, 2001
Revision Date: January 10, 2003
Product:
DS-Client
Summary
In order to perform a bare metal restore of a NetWare 5.x server (NDS 8), the following
requirements must be met.
Details
•
If you did not use DOSFAT.NSS (or any other tools) to backup the DOS
partition, the latest support pack must be installed prior to restore.
To execute a full NetWare server restore after hardware failure you must:
1. Install the NetWare server. Install the NetWare licenses. In NetWare 5.1 the "admin"
account does not have rights to backup the licenses. Unless you granted these rights
manually, the backup of NDS will not contain the licenses. However Novell does this
on purpose.
2. During the installation, you must provide the same NDS tree, and the same server
context, otherwise the DS-Client will not be able to restore (DS-Client cannot perform
an alternate restore of NDS).
3. Apply the latest NetWare support pack. This step is necessary because NDS will fail
to load if it is not in synch with the rest of the modules in NetWare 5.x. If you backed
up the DOS partition, you can restore it, and in this case there's no need to apply the
support pack.
There are two scenarios when you perform a full restore:
• Scenario A - NDS tree with a single server.
1. Restore only NDS in a single session. This step is necessary because the NDS
object(s) must exist prior to applying trustee assignments.
2. Add Name Space (if any).
•
3. Restore the file system in the next session, and then reboot the server (see Note 3).
Scenario B - NDS tree with multiple servers.
1. Restore only NDS on the master replica in a single session.
2. Add Name Space (if any).
3. Restore the file system on the master replica in the next session (see Note 3).
4. Install the rest of the servers. When asked for the NDS tree name - select the existing
one and connect to the master replica.
5. Add Name Space (if any).
6. Restore the file system on the rest of the servers (see Note 3).
Note:
Novell claims that for multiple server environments, you do not need to restore the NDS.
The restored server will be able to pull NDS updates from the rest of the servers.
However, in mass disasters (or when emulating a mass disaster) you may need to perform
a full NDS restore to all of the servers.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 503
Confidential.
Knowledge Base: RESTORE
Certificate Server
At the end of NDS restore you must perform some extra steps because of the inability to restore
the certificate server. According to Novell there is no way of backing up and restoring the
certificate server. This is done on purpose. To get around this problem you have to remove the
certificate server first and then to reinstall it:
1. After successful restore of NDS you must delete the following items using
ConsoleOne:
• All certificates
• the SAS object
• everything in the Security container (You may want to check TID 10056795
from http://support.novell.com - especially if you have a Multi-Server
environment).
2. Run "NREPAIR.NLM". This utility can be downloaded from http://support.novell.com.
This utility is the only way to remove the certificate server and properly initialize NICI:
• Follow the prompts from the screen
• After successful removal, mount the Certificate Server Installation CD
• Install the certificate server through the GUI
3. After steps 1 & 2 are complete, your server will have the proper NDS. The only
exception would be any previously used certificates that are no longer valid. As it was
mentioned earlier this is done on purpose. You can test the functionality of the
certificate server by trying to create a new server key.
Note: From now on the version of NDS that you restored will no longer be good since the
certificate server and all the certificates are different. (i.e. you should backup NDS
immediately after completing the restore.)
4. After applying all the necessary steps you can start restoring the file systems. You
MUST unselect from SYS volume \SYSTEM\NICI subdirectory because it contains
information related to the previous version of the certificate server and NICI. If you fail
to remove this directory from the restore process, you will have to clean the
certificates again and run NREPAIR, and then reinstall the certificate server.
Notes
1. When doing a full file system restore you may encounter some errors. They will be recorded in the
DS-Client Logs. Once the restore is completed, check the Activity and Event Logs. If there were
any errors, perform a restore for each of the files that had errors. This is a known problem and ASIGRA is working with Novell to resolve it.
2. If you had more than one NDS partition, you must reconfigure it manually.
3. If you encounter "The network name cannot be found" when trying to restore, this means the NetWare SERVER has been rebooted too many times. This has caused the NetWare CLIENT on the
DS-Client computer to cache too much data. This can be fixed by either performing a "login" to a
NetWare server, or rebooting the DS-Client computer.
4. After restoring NDS, CIFS may not function. This limitation is not only exhibited by DS-Client, but
also SMS Backup. In order to fix CIFS, follow the directions described in Novell Support Knowledge base - TID 10071043. Basically all you have to do is recreate the login sequence.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 504
Confidential.
Knowledge Base: RESTORE
Troubleshooting Full Server (file system and registry)
restores
Creation Date: March 25, 1999
Revision Date: February 6, 2004
Product:
DS-Client
Summary
Because of the way Microsoft (and most other software providers) install their programs, a
problem may occur if a computer's file system and Registry are restored.
Details
When Microsoft (and most other software providers') software is installed on a computer, the
Windows 8.3 filename is used in the Registry. Some programs make associations with the file
extensions, thereby allowing the program to launch automatically when and associated file is
double clicked.
Windows 8.3 filenames appear with first few characters of the long filename, followed by the tilde
(~) and a number (e.g. MICROS~4). This method allows long file names to be limited to eight
characters, while remaining unique.
The problem is that the Windows 8.3 name is assigned chronologically (i.e. based on the order in
which program files were installed on the computer). However, when the DS-Client restores files,
the Windows 8.3 name may be different because files can be restored in a different order than
they were originally installed.
For example, the folder 'Microsoft Image Composer' might have originally had the 8.3 name
'MICROS~2' (since there may be several folders with long folder names, beginning with Microsoft).
Upon restoration of the file system, it is possible that the 8.3 name could be something else (e.g.
MICROS~5), depending on the order that it was restored to the computer by the DS-Client.
If such a problem exists on the restored computer, it will appear when you try to open a file by
double clicking on it. You will get a "Program Not Found" error dialog, prompting you to specify the
location of the program that will launch the selected file. (For more info see Microsoft Knowledge
Base article 240240.)
Resolution
ASIGRA has a solution for this problem that is applied automatically for Windows 2000 and higher
(Windows 2000 / XP / 2003).
In the "Program Not Found" dialog, simply click the Locate button, and respecify the source
program. The exact program name will be listed in the dialog. You can perform a filename search
in the event you cannot remember where the source program is located.
If the work around does not help, you may have to reinstall the failed program.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 505
Confidential.
Knowledge Base: RECOVERY
Knowledge Base: RECOVERY
The Knowledge Base contains articles on specific areas of DS-Client operation.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 506
Confidential.
Knowledge Base: RECOVERY
Disaster Restores
Creation Date: November 4, 1997
Revision Date: December 6, 2005
Product:
DS-Client
•
•
See “Recovering the DS-Client Database” on page 508
See “Disc/Tape” on page 213
Summary
The DS-Client service is designed to perform automated backups to an off-site location. This
approach requires an adequate communication link between the DS-Client and the DS-System.
If a customer site needs to restore a large amount of data (due to a server crash or other disaster),
the communication link between the DS-Client and the DS-System may not allow the restore
process to be completed in a reasonable amount of time. In these cases, customers can use the
Disc/Tape feature to have the required data written to media and shipped to their physical location.
This can be done from the DS-Client, or by their ASIGRA Televaulting service provider.
Performing a Disaster Restore
The steps described here are general and assume that your network is functioning properly.
Depending on your situation, you may need to do more things.
1. You need the DS-Client.
• If the DS-Client computer was destroyed, see “Recovering the DS-Client
Database” on page 508
• To reduce your down time, you can ask your ASIGRA Televaulting Service
Provider to write the required data to Disc/Tape media (snapshot of latest
generation only). This must be done for each backup set you need.
(Otherwise, you can perform the Disc/Tape request with DS-User after the
DS-Client computer is recovered.)
2. DS-System copies all requested files to the to Disc/Tape media.
3. Disc/Tape media is shipped to the DS-Client’s physical location.
4. The required data is restored from Disc/Tape media attached to the DS-Client (or
through the LAN).
Note
1. The data on Disc/Tape media is encrypted.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 507
Confidential.
Knowledge Base: RECOVERY
Recovering the DS-Client Database
Creation Date: March 18, 1999
Revision Date: October 10, 2007
Product:
DS-Client
Summary
The DS-Client database contains the settings for backup sets, logs, and schedules. ASIGRA
Televaulting has incorporated a DS-Client database recovery feature to speed up recovery if the
DS-Client computer is destroyed, or if its database is somehow otherwise destroyed.
The Delta database contains delta information for all files. If this database is not recovered, the
next backup will force DS-Client to send a new Master file (full file). This will add a considerable
amount of backup time to the next backup. If you restore the Delta database as well as the DSClient database, this will add to the time required to Recover (especially if the databases are
large).
In order to use this feature, your DS-Client must have been configured to backup its own database
(see: Setup > Configuration > Parameters Tab - Database Options > DS-Client database backup).
In other words, there must be a backed up DS-Client database on the DS-System to recover (this
is the default setting).
The recovered database will show data up to the time it was last backed up. Note it is quite
possible that the recovered database is slightly out of synch with the actual 'up-to-the-last-minute'
backups, therefore you should immediately run a Weekly Admin. to synchronize the recovered
database with the actual DS-System storage.
If you do not have a DS-Client database backup, you will have to recover each backup set on the
DS-System individually. However, you will be unable to recover the backup schedules or any of
the logs. (See “Recovering 'Orphaned' Backup Sets” on page 510.)
Recovery Steps
If the DS-Client computer was destroyed, you must:
• Assemble the hardware required for the replacement DS-Client computer and
install the Operating system.
• If you must replace the database software, make sure you install the same
version.
Note: It is possible to recover the database from an MS SQL Server 2000 instance to an MS SQL
Server 2005 instance, but you cannot recover from 2005 to 2000. However, it is best to
recover to the same exact instance version to minimize the chance of problems.
• You must also recreate the user accounts (including the DS-Client account),
and then
• Reinstall the DS-Client software to the computer.
• Recover the DS-Client database(s).
To recover the DS-Client database(s):
1. Start the DS-Client Service and run DS-User.
2. From the Setup Menu, select System Activities. The System Activities Administration
dialog box appears.
3. Click Repair. The Repair DS-Client dialog box appears.
4. Select either "DS-Client database" or "DS-Client & delta database".
5. Click OK. A recovery message appears, instructing you to restart the DS-Client
service.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 508
Confidential.
Knowledge Base: RECOVERY
6. Stop and Restart the DS-Client service. The recovered Database will become active
upon restart.
7. Run a Weekly Admin. process to ensure that the recovered DS-Client database data
is not missing any backup sets. If it is, perform a backup set recovery. (See:
“Recovering 'Orphaned' Backup Sets” on page 510)
8. Follow the steps to Take Ownership of each backup set (see: Change Backup Set
Ownership in the DS-User Guide).
Notes
1. If you have reinstalled the Windows operating system on the DS-Client computer
being recovered:
• The Security IDs (SIDs) of the users you create will be different from those in
the recovered DS-Client database (even if they are the same name, the SIDs
are unique for each instance a user is created).
• You must change ownership of the backup sets to the new user: See “Change
Backup Set Ownership” on page 147.
• In the Select User dialog, you will see two users of the same name (because
the DS-Client searches by SID). Select the lower one - the current user is
closest to the bottom of the list.
2. Do not create any new backup sets before you have recovered the DS-Client's
database.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 509
Confidential.
Knowledge Base: RECOVERY
Recovering 'Orphaned' Backup Sets
Creation Date: March 18, 1999
Revision Date: March 14, 2008
Product:
DS-Client
Summary
If you encounter the following Event Log errors: "Backup Set not found in Backup Log", it means
the Admin process encountered differences when it checked the DS-Client's database against the
actual backup data on the DS-System. This means the backup data exists on the DS-System, but
the backup set is missing from the DS-Client's database.
These 'orphaned' backup sets can still be recovered by having the DS-Client reconstruct the
backup set catalogs from the DS-System information. Orphaned backup sets must be recovered
individually.
However, recovering an orphaned backup set does not recover its configuration information (i.e.
Computer Name, Connect As, Backup Schedule...). This information must be re-specified to the
DS-Client database by performing the Migration process.
Recovery Steps
Follow these steps to recover a backup set (Perform these steps for each backup set individually):
1. From the Setup Menu, select System Activities > Repair. The Repair DS-Client dialog
box appears.
• Select the Orphaned backup sets radio button.
2. Click OK. The Backup Set Recovery dialog box appears.
3. Select a backup set from the list. (When recovering a backup set, your current login
credentials are used to assume ownership of the backup set. This means your current
login ID will be the owner of all the recovered sets.)
4. Click OK to begin the process. The Synchronization Window appears as the backup
set is synchronized with the DS-System's on-line storage.
5. Continue for as many backup sets there are to recover (i.e. until the list is empty).
6. Once the backup set is recovered, you may perform restores immediately. (To
backup, see the following section on Migration.)
Migration
In order to resume backups, you must re-specify some of the backup set's configuration
information (i.e. Network Provider, Computer Name, Connect As, Backup Items, and Backup
Schedule information). Do this by Migrating or by manually changing the necessary settings.
The easiest method is to migrate the backup set:
1. From the Backup Sets Tab, click on a set to highlight it.
2. Right-click to pop up the options menu.
3. Click on Migrate. The Migrate Backup Set Wizard appears, prompting you to select
the new network/share path.
4. Browse through the network/node to specify the new path you want to migrate this
backup set.
5. Check the Ask for Network Credentials box if you want to specify the credentials to the
new network resource.
5a. If you use the Ask for Network Credentials checkbox, the Enter Network Credentials
dialog box appears. Enter the User name, source server (if applicable), and password
to connect with the selected network/node.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 510
Confidential.
Knowledge Base: RECOVERY
6. Once connected to the new network/node, the Migrate Backup Set Wizard switches to
match the source/destination share.
7. Double Click on the corresponding Destination Cell to show all of the available shares
on the selected node.
8. Select the share where the files have been moved and click Next >.
9. The specified backup items in the Selected Files for Backup Section will remain,
however the share path will change according to the destination share selected in the
previous tab.
10. Make sure that the path of the migrated files is correct. Otherwise, errors will occur.
You may add more files, or leave this dialog unchanged.
11. Click Next >, when you are finished changing/specifying backup items. The Backup
Item Options tab appears.
12. Select the options, as you would a normal backup set. Depending on which network
you have migrated to, you may see more or less backup options than previously
available for this backup set.
13. Click Finish to complete the migration. The Backup Sets dialog box returns. If you
open to the migrated backup set, you will see any changes to the network, node, and/
or provider.
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 511
Confidential.
Knowledge Base: RECOVERY
Restoring the MS SQL Database Server MASTER
Database (MS SQL 7.0 and up)
Creation Date: May 28, 1999
Revision Date: April 24, 2007
Product:
DS-Client (Windows)
Summary
If you need to restore an MS SQL Server's MASTER database, you need to perform some
additional steps in order to ensure a successful restore.
• See “SQL Server 7.0 & SQL Server 2000” on page 512.
• See “SQL Server 2005 & SQL Server 2005 Express” on page 513.
Note:
This article describes restoring the MS SQL Server MASTER Database for any instance,
except the DS-Client’s MS SQL database.
SQL Server 7.0 & SQL Server 2000
1. Use the MS SQL Setup program to rebuild the master database. You must rebuild
using the same MS SQL Server version, character set and sort order as the master
database dump that will be reloaded.
2. Restart MS SQL Server in single-user mode using the sqlservr command.
• Stop MS SQL Server if it is already running.
• From a command prompt, type:
<path_to_executable>\sqlservr
[-sinstance_name] -c -m
where
You can find the <path_to_executable> by viewing the Properties for this MS SQL Server Instance in Windows Services
-sinstance_name
Specifies the MS SQL Server Instance Name that you wish to
start in single-user mode.
• When starting an instance of SQL Server, you must use the
sqlservr application in the appropriate directory for that
instance. For the default instance, run sqlservr from the
\MSSQL\Binn directory. For a named instance, run sqlservr
from the \MSSQL$instance_name\Binn directory.
• NOTE: If you are starting a default (un-named) instance,
skip this switch (type <path_to_executable>\sqlservr -c -m).
-c
Starts MS SQL Server independent of the Windows NT Service
Control Manager.
-m
Specifies the single-user mode.
3. Use ASIGRA Televaulting DS-Client to restore the master database directly into the
restored instance.
Note:
When the load of the master database is complete, the server automatically shuts itself
down. You can restart the MS SQL Server normally (from Enterprise Manager or SQL
Server Service Manager). The SQL Server instance will start in multi-user mode.
4. Restore the msdb database and the rest of the databases, if applicable.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 512
Confidential.
Knowledge Base: RECOVERY
SQL Server 2005 & SQL Server 2005 Express
1. Use the MS SQL Setup program to rebuild the master database. You must rebuild
using the same MS SQL Server version, character set and sort order as the master
database dump that will be reloaded.
2. Stop the SQL Server, if it is running.
3. Open the Registry on the SQL Server computer (use regedt32.exe).
For 32-bit instances running on 32-bit Operating Systems & 64-bit instances
running on 64-bit Operating Systems:
• Browse for the following path:
HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft SQL
Server\InstanceNames\SQL
•
•
•
You will find a list of all SQL instances installed on that machine.
Locate the name of the Instance you want to start in single-user mode in the
”Name” field. The “Data” field will contain a map of this Instance on the
computer.
Browse for the following path:
HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft SQL Server\<DATA
VALUE>\MSSQLServer\Parameters
For 32-bit instances running on 64-bit Operating Systems:
• Browse for the following path:
HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft\Microsoft SQL
Server\SQLServer\InstanceNames\SQL
•
•
•
You will find a list of all SQL instances installed on that machine.
Locate the name of the Instance you want to start in single-user mode in the
”Name” field. The “Data” field will contain a map of this Instance on the
computer.
Browse for the following path:
HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft\Microsoft SQL
Server\<DATA VALUE>\MSSQLServer\Parameters
4. Add a new registry Value at the end of the list. Give it a Value Name of SQLArgn,
where n in an incremental number of 1 over the current maximum. Make the Data
Type “REG_SZ”, and for the string value enter -m.
5. Restart MS SQL Server in single-user mode using the Windows Services regular
Start command.
6. Use ASIGRA Televaulting DS-Client to restore the master database directly into the
restored instance. When the load of the master database is complete, the server
automatically shuts itself down.
7. Delete the registry Value “SQLArgn“ that you added in step 4. Now you can restart the
MS SQL Server normally (from Enterprise Manager or SQL Server Service Manager).
8. Restore the msdb database and the rest of the databases, if applicable.
See also
“MS SQL Server Database Backups” on page 93
“Restore MS SQL Server Backups” on page 180
“MS SQL Server Backup Sets (Alternate Location Restore)” on page 200
“Backup / Restore of Microsoft SQL Server” on page 429
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. 1986-2008 All Rights Reserved. Confidential.
DS-Client User Guide
v.8.0 [Revision Date: March 28, 2008]
© Asigra Inc. 1986-2008 All Rights Reserved.
Generated on: 3/28/08
Page: 513
Confidential.