DLOAdminGuide en
DLOAdminGuide en
TM
Option 7.5
Administrator’s Guide
For Windows
Disclaimer
The information contained in this publication is subject to change without notice. Symantec Corporation makes no
warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability
and fitness for a particular purpose. Symantec Corporation shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the furnishing, performance, or use of this manual.
Legal Notice
Copyright © 2013 Symantec Corporation. All rights reserved.
Symantec and the Symantec Logo, NetBackup, Veritas, and LiveUpdate are trademarks or
registered trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other names may be
trademarks of their respective owners.
This Symantec product may contain third party software for which Symantec is required
to provide attribution to the third party (“Third Party Programs”). Some of the Third Party
Programs are available under open source or free software licenses. The License Agreement accompanying the Software
does not alter any rights or obligations you may have under those open source or free software licenses. Please see the
Third Party Legal Notice Appendix to this Documentation or TPIP ReadMe File accompanying this Symantec product for
more information on the Third Party Programs.
The product described in this document is distributed under licenses restricting its use, copying, distribution, and
decompilation/reverse engineering. No part of this document may be reproduced in any form by any means without
prior written authorization of Symantec Corporation and its licensors, if any.
The Licensed Software and Documentation are deemed to be commercial computer software as defined in FAR 12.212
and subject to restricted rights as defined in FAR Section 52.227-19 “Commercial Computer Software - Restricted
Rights” and DFARS 227.7202, “Rights in Commercial Computer Software or Commercial Computer Software
Documentation”, as applicable, and any successor regulations. Any use, modification, reproduction release,
performance, display or disclosure of the Licensed Software and Documentation by the U.S. Government shall be solely
in accordance with the terms of this Agreement.
Symantec Corporation
350 Ellis Street
Mountain View, CA 94043
www.symantec.com
Third-Party Copyrights
Douglas C. Schmidt and his research group at Washington University and University of California, IrvineCopyright
citation.
ACE (TM) is copyrighted by Douglas C. Schmidt and his research group at Washington University and University of
California, Irvine,
Copyright (c) 1993-2002, all rights reserved.
Maarten Hoeben
ReportCtrl.h 2.0.1
Ronald L. Rivest
Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved.
License to copy and use this software is granted provided that it is identified as the “RSA Data Security, Inc. MD5
Message-Digest Algorithm” in all material mentioning or referencing this software or this function.
License is also granted to make and use derivative works provided that such works are identified as “derived from the
RSA Data Security, Inc.MD5 Message-Digest Algorithm” in all material mentioning or referencing the derived work.
RSA Data Security, Inc. makes no representations concerning either the merchantability of this software or the
suitability of this software for any particular purpose. It is provided “as is” without express or implied warranty of any
kind.
These notices must be retained in any copies of any part of this documentation and/or software.
Wei Dai
Compilation Copyright (c) 1995-2003 by Wei Dai. All rights reserved.
This copyright applies only to this software distribution package as a compilation, and does not imply a copyright on any
particular file in the package.
The following files are copyrighted by their respective original authors, and their use is subject to additional licenses
included in these files.mars.cpp - Copyright 1998 Brian Gladman.
All other files in this compilation are placed in the public domain by Wei Dai and other contributors.
I would like to thank the following authors for placing their works into the public domain:
Joan Daemen - 3way.cpp
Leonard Janke - cast.cpp, seal.cpp
Steve Reid - cast.cpp
Phil Karn - des.cpp
Michael Paul Johnson - diamond.cpp
Andrew M. Kuchling - md2.cpp, md4.cpp
Colin Plumb - md5.cpp, md5mac.cpp
Seal Woods - rc6.cpp
Chris Morgan - rijndael.cpp
Paulo Baretto - rijndael.cpp, skipjack.cpp,
square.cpp
Richard De Moliner - safer.cpp
Matthew Skala - twofish.cpp
Permission to use, copy, modify, and distribute this compilation for any purpose, including commercial applications, is
hereby granted without fee, subject to the following restrictions:
1. Any copy or modification of this compilation in any form, except in object code form as part of an application
software, must include the above copyright notice and this license.
2. Users of this software agree that any modification or extension they provide to Wei Dai will be considered public
domain and not copyrighted unless it includes an explicit copyright notice.
3. Wei Dai makes no warranty or representation that the operation of the software in this compilation will be error-free,
and Wei Dai is under no obligation to provide any services, by way of maintenance, update, or otherwise. THE
SOFTWARE AND ANY DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT EXPRESS OR IMPLIED WARRANTY
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL WEI DAI OR ANY OTHER
CONTRIBUTOR BE LIABLE FOR DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
4. Users will not use Wei Dai or any other contributor's name in any publicity or advertising, without prior written
consent in each case.
5. Export of this software from the United States may require a specific license from the United States Government. It is
the responsibility of any person or organization contemplating export to obtain such a license before exporting.
6. Certain parts of this software may be protected by patents. It is the users' responsibility to obtain the appropriate
licenses before using those parts.
If this compilation is used in object code form in an application software, acknowledgement of the author is not required
but would be appreciated. The contribution of any useful modifications or extensions to Wei Dai is not required but
would also be appreciated.
Stac Electronics
Copyright (C) Stac Electronics 1993, including one or more U.S. patents No. 4701745, 5016009, 5126739 and 5146221
and other pending patents.
Chapter 6 Troubleshooting
Using DLO with other Products .............................................................................................................................. 297
Symantec Storage Exec .................................................................................................................................... 297
WinCVS .............................................................................................................................................................. 297
Windows XP Service Pack 2 ............................................................................................................................ 298
Troubleshooting the DLO Administration Console ............................................................................................. 298
Troubleshooting the Desktop Agent ...................................................................................................................... 302
Remote DLO Agent and Push Install Maintenance Server ................................................................................. 305
Troubleshooting the Dedupe Server ...................................................................................................................... 306
Chapter 7 Accessibility
Keyboard Navigation and Shortcuts in DLO ........................................................................................................ 311
General Keyboard Navigation within the GUI ..................................................................................................... 312
Keyboard Navigation within Dialog Boxes ................................................................................................... 312
Tabbed Dialog Boxes ........................................................................................................................................ 313
List Boxes ........................................................................................................................................................... 313
Keyboard Shortcuts .......................................................................................................................................... 314
Support for Accessibility Settings ................................................................................................................. 315
Note: Symantec DLO product is intended to provide file-level protection for desktop
user data and is not intended to provide a full system backup.
14
Symantec Desktop and Laptop Option
DLO Components
DLO Components
DLO contains the following components:
■ DLO Administration Server
■ DLO Dedupe Server
■ DLO Administration Console
■ DLO Database
■ DLO Maintenance Server
■ DLO Agent (Desktop Agent)
Dedupe Server
The Dedupe Server is web service hosted on Tomcat Web Server. It maintains the
Global Hash Table and helps the Agent in identifying the data that already exists in
the Dedupe Storage Location.
The Dedupe Server can also be installed on the same server where the other DLO
components are installed.
Note: Automated User Assignments are not used if users are manually added to DLO.
15
Symantec Desktop and Laptop Option
DLO Components
■ Add users manually to DLO. Instead of using Automated User Assignments, you
can manually add users to DLO and assign a profile and DLO Storage Location to
them. This is particularly useful when network shares already exist for user data
storage. Users can be added individually or multiple users can be added at the
same time by importing them from a list.
■ View history log files, receive alerts, and restore files to a desktop from the
Administration Console.
■ Configure and manage Dedupe Server.
DLO Database
The DLO Database has two components: Configuration database and Dedupe
database.
■ DLO Configuration Database: DLO configuration database contains details
related to the deployment of DLO components. For example, where the database
is installed (on a remote machine or on the host), where the maintenance server
exists, and so on.
■ Dedupe Database: Dedupe database is the data store used by Dedupe Server for
persisting the Dedupe related configuration and the Global Hash Table.
The Dedupe database is always installed on the same server as the DLO
Configuration database in all the supported configurations of the DLO
Configuration database.
Desktop Agent
The Desktop Agent resides on the desktops and laptops that you want to protect. The
desktop user’s level of interaction with the Desktop Agent can vary depending on
how the Administrator has configured the profile assigned to the user. The Desktop
Agent may run in the background, automatically protecting files. Alternatively,
desktop users with full access to the Desktop Agent interface can do the following:
■ Schedule backups
■ Select which types of files to back up
■ Restore files
16
Symantec Desktop and Laptop Option
DLO Components
Related Topics:
“Configuring DLO” on page 72
“About DLO Profiles” on page 84
“About Backup Selections” on page 102
“About DLO Storage Locations” on page 121
“About Automated User Assignments” on page 129
“Configuring Dedupe Server” on page 73
17
Symantec Desktop and Laptop Option
DLO Components
■ BackupExec-DLO 2010 R3
■ NetBackup DLO 6.1 MP7
For any existing customers with previous release of DLO (NetBackup DLO or
BackupExec DLO) apart from the versions mentioned above, it will be a stepped
upgrade support. That is, customers should first upgrade the existing version of DLO
to Symantec DLO 7.0, and then upgrade to Symantec DLO 7.5. For more information,
see “Upgrading to Symantec DLO 7.5” on page 50.
IPv6 Support
DLO supports versions 4 and 6 of the Internet Protocol (IP), which are
commonly referred to as IPv4 and IPv6. You can use IPv4 and IPv6 in backup and
restore networks. Support for IPv6 is dependent upon operating system support for
the protocol, as well as proper network configuration.
Lotus Notes
DLO provides support to Lotus Notes version 8.5.3.
BitLocker Support
DLO provides support to volumes that run Windows BitLocker Drive Encryption.
Item Description
Domains and Active The DLO Administration Server, DLO Dedupe Server, and DLO
Directory Storage Locations must be in a Windows Domain or Active
Directory. Computers running the Desktop Agent can be outside a
Windows Domain or Active Directory, but they must authenticate
with the domain or directory to access the DLO Administration
Server or Storage Locations.
Item Description
Domain/User Any user with local administrative rights can install the Symantec
Credentials DLO components.
In case the user account does not have the privileges, the
administrator should grant local administrative rights to the user.
Note: While installing the DLO database, and if the “Remote DB
Install” option is selected, then the user account must have local
administrative rights on the remote computer where SQL server is
installed.
Item Description
Database Selection By default DLO installs its own instance of SQL Server 2008 R2
Express SP1. DLO can also be manually configured to use an
existing SQL Express 2005, SQL Server 2008, SQL Server 2005, or
SQL Server 2008 R2.
Time Synchronization All computers running the DLO Administration Console or the
Desktop Agent should be set to a common time. This can be
accomplished by configuring the Windows Time Synchronization
service on the network. See www.microsoft.com for more
information.
Item Description
■ Microsoft Windows 2003 Server SP2 (32-bit, 64-bit, and R2)
Operating system
■ Microsoft Windows 2008 Server SP2 (32-bit, 64-bit)
■ Microsoft Windows 2008 Server R2 SP1
■ Microsoft Windows Server 2012
Note: Ensure that the operating system is updated with the latest
service packs, to be able to install the DLO Administration Server.
The Desktop Agent is not supported on any Windows Server class
operating system.
CPU 2 x 1.5 GHz 32/64-bit
Disk space 500 MB hard disk space required after Microsoft Windows is
installed.
Item Description
Operating system
■ Microsoft Windows 2003 Server SP2 (32-bit, 64-bit, and R2)
■ Microsoft Windows 2008 Server SP2 (32-bit, 64-bit)
■ Microsoft Windows 2008 Server R2 SP1
■ Microsoft Windows Server 2012
Recommended: Windows 2008 Server R2, 64-bit
Note: Ensure that the operating system is updated with the latest
service packs, to be able to install the Dedupe Server.
CPU Quad core 64-bit
Disk space 500 MB hard disk space required after Microsoft Windows is
installed.
23
Symantec Desktop and Laptop Option
Before You Install
Item Description
Item Description
Item Description
SQL Server 2008 R2 On a 32-bit machine, the new local SQL Server 2008 R2 instance
Express SP1 will be located at C:\Program Files (x32)\Microsoft SQL
Server\ MSSQL10_50.DLO for DLO Database, and
C:\Program Files (x32)\Microsoft SQL Server\
MSSQL10_50.DEDUPE for Dedupe database.
On a 64-bit machine, the new local SQL Server 2008 R2 instance
will be located at C:\Program Files (X86)\Microsoft SQL
Server\ MSSQL10_50.DLO for DLO database and C:\Program
Files (X86)\Microsoft SQL Server\
MSSQL10_50.DEDUPE for Dedupe database.
Existing SQL Server The DLO Database and Dedupe database will be stored on an
instance existing SQL Server 2005, SQL Server 2008, or SQL Server 2008
R2 Express instance on this computer. Select an instance from the
list provided.
Remote DB Install The Symantec DLO console and SQL server are installed on two
different machines. While installing DLO, provide the IP address
or host name of the machine where SQL is installed. The DLO
database is installed on the remote machine.
Note: Named pipes must be enabled on the machine where the
SQL server is installed.
After enabling the named pipes, restart the SQL server and SQL
server browser services. These services must be running with the
domain admin credentials. Also, the computer browser services
must be running.
Make sure that you provide the same user account credential that
was used to install the SQL server, else the DLO Administration
Console fails to launch.
11 Click Next.
12 Enter the account credentials, which will be used to create DLO Storage
Locations and network user data folders. This account should be a domain
27
Symantec Desktop and Laptop Option
Installing the Symantec Desktop and Laptop Option
account that has local administrative rights on computers where backup data
must be stored. See “Domain/User Credentials” on page 20.
13 Click Next.
14 Click Install to begin the installation.
15 When the installation is complete, click Finish.
Note: After installing the DLO components, to verify the status of the Dedupe Server,
type the following URLs in your browser.
http://<dedupeserver_ip_or_hostname>:8080
https://<dedupeserver_ip_or_hostname>:8443
If the Dedupe Server is active, then the following message is displayed: Dedupe
Server Status: (20159) Active.
If there is no response from Dedupe Server, then it indicates that the Dedupe Server
is not initialized, and one of the reasons could be that the database connection is
down.
You can choose one of the following methods to deploy the Desktop Agent from the
Desktop Agent install share to the desktop computer.
Deployment Description
Method
E-mail Send a hypertext link to the install files or include the install files as
an attachment.
Logon scripts Create a file that includes commands for installing the Desktop
Agent. Then assign the script to the User Properties for the
employees who need to use DLO. The commands are executed
automatically when the user logs on to the network. For more
information about logon scripts, refer to your Microsoft Windows
documentation.
Microsoft Systems Use this automated system to distribute the Desktop Agent install
Management Server set to the desktop computers, which then initiate the installation.
(SMS) For more information about SMS, refer to your Microsoft
documentation.
Related Topics
“Installing the Desktop Agent” on page 247.
29
Symantec Desktop and Laptop Option
Installing the Symantec Desktop and Laptop Option
Desktop Agent Modify the /qf term to change the interface that the Desktop
installation interface Agent user sees during installation of the Desktop Agent.
/qf
The full user interface is displayed, and a cancel button
is provided.
/qb
A basic progress dialog is displayed and the cancel
button is enabled.
/qb!
A basic user interface displayed. There is no cancel
button.
/qn
The installation will be silent installation.
Set the Default Media DEFAULTMEDIASERVER specifies the media server to which
Server the Desktop Agent will attach after installation.
Launch the Desktop The LAUNCHCLIENT option specifies whether or not the
Agent Desktop Agent should be launched immediately following
installation.
To launch immediately, set LAUNCHCLIENT=”1”
To prevent immediate launch, set LAUNCHCLIENT=”0”
LAUNCHCLIENT “1”
TRANSFORMS “1033.mst”
Push Install Desktop Agent and Push Install DLO Maintenance Server
You can install either the Desktop Agent or the Maintenance Server on a remote
machine using the push install feature.
32
Symantec Desktop and Laptop Option
Installing the Symantec Desktop and Laptop Option
Prerequisites
To push-install DLO Desktop Agent to a computer that runs Symantec Endpoint
Protection (SEP) version 11.0 or later, you must configure SEP to share files and
printers. The file and printer sharing feature is turned off by default.
From the DLO Administration Console, you can install the following on remote
computers:
■ DLO Desktop Agent
■ DLO Maintenance Server
Note: You can either push-install multiple Desktop Agents or Maintenance Servers
at a time, but you cannot combine both the options.
Note: To push install Desktop Agent on to a Windows 8 Agent machine, the remote
registry services should be enabled and started on that machine.
To push install Desktop Agent and push install DLO Maintenance Server on
remote computers
1 Launch the DLO Administration Console.
2 On Tools, select Install Agents and maintenance services on remote computers
and click Next.
3 On Install Agent/Maintenance Server to Remote Computers > Select
Component to select any of the following components:
■ Agent - To push-install the Desktop Agent from the administration server
to remote computers.
■ Maintenance - To push-install the DLO Maintenance Server from the
administration server to remote computers.
4 Click Add.
5 In Manual Entry of Remote Computer Name, type the following:
■ Name/IP Address: Enter the computer name or IP address of the remote
computer.
■ Domain Name: Enter the domain name of the remote computer.
■ Browse: Click Browse. In Select Computer, choose the required remote
computer and click OK.
33
Symantec Desktop and Laptop Option
Installing the Symantec Desktop and Laptop Option
The Name/IP Address and Domain Name is updated. Also, Remote Computer
Logon Credentials is displayed with the selected computer name and domain
name.
6 Click OK.
7 In Remote Computer Logon Credentials, type the following:
■ User Name: Enter the user name for an account that has administrator
rights on the remote computer.
■ Password: Enter the password for an account that has administrator rights
on the remote computer.
■ Domain Name: The domain name is displayed based on the domain name
you have entered in Manual Entry of Remote Computer Name.
■ Use this user name and password when attempting to connect to
additional computers during the installation: Select this option if you
want to use the same user name and password during the next installation.
By default, this option is not selected.
8 Repeat steps 4 to 6 for every remote computer for which you want to push-install
the options.
9 You can also import the list of IP addresses of remote computers. To import the
list, do the following:
■ On Install Agent/Maintenance Server to Remote Computers > Remote
Computer Selection window, click Import Computers.
34
Symantec Desktop and Laptop Option
Installing the Symantec Desktop and Laptop Option
■ Select the specific .txt file that contains all the IP addresses of remote
computers.
Note: To generate a .txt file that contains the list of Desktop Agent machines,
run the DLOCommandu.exe -ListMachines command. For more information,
see “-ListMachines command” on page 236.
To remove the remote Desktop Agent or Maintenance Server from the list
1 Select the remote Desktop Agent or the Maintenance Server.
2 Click Remove.
A Confirmation Window is displayed with the message: ‘Do you want to Delete:
<Component>’.
3 Click Yes.
The component is deleted from the list.
Related Topics
“Checking Data Integrity” on page 35
“-SetRecoveryPwd command” on page 222
“-EmergencyRestore command” on page 222
restoration. This verification is applicable only to the user specific data in the DLO
Storage Locations, and not for the shared data in the Dedupe Storage Locations.
When Desktop Agents are upgraded, they will automatically perform a data integrity
check. When the DLO Administration console is opened, it identifies Desktop Agents
that have not been checked for integrity. If any are found, a dialog will open stating
that one or more computers have not yet been validated by the Data Integrity
scanner and ask if they should be scanned.
Permanently remove previously Select this check box to cause all previously
quarantined data quarantined data to be deleted.
Quarantine data encrypted with Select this check box to quarantine all files with
outdated keys outdated keys. If this option is not checked, data is
scanned without being quarantined. After data is
quarantined, the Desktop Agent backs up a new version
of the file with the correct encryption key.
Include computers that have Select this check box to force all data to be rescanned,
already been validated even if it has previously been validated.
4 Click Start.
5 Review the scan results.
If the scan identified data encrypted with outdated keys but you did not choose
to quarantine the data, you can run the scan again after setting advanced
options to quarantine this data.
6 Click Next.
7 Click Finish.
Related Topics
“Setting a Recovery Password” on page 35
“-SetRecoveryPwd command” on page 222
“-EmergencyRestore command” on page 222
37
Symantec Desktop and Laptop Option
Post Installation Tasks
Change DLO service account Select to change the DLO service account
information information.
User name Type the user name for the account to be used.
Limited Restore
The purpose of the limited restore feature is to prevent restoration of data to an
alternate location by unauthorized users. By default, DLO administrators cannot
restore a desktop user’s files to an alternate location, providing an additional level of
data security. A DLO administrator can be granted full restore privileges, which
allows the administrator to restore data to an alternate location. When a DLO
39
Symantec Desktop and Laptop Option
Post Installation Tasks
User name Type the name of the user that must be assigned with
administrative rights. Use the format
DomainName\UserName
Grant administrator full Select this check box to allow this DLO administrator full
restore privileges restore privileges, including the ability to restore desktop
user data to an alternate location.
7 Click OK twice.
Note: When the Use domain groups to manage access to network user data
folders option is selected, domain groups are listed on the Administrator
Account Management dialog. When this option is not selected, individual user
accounts are once again listed. If you change from one type of account
management to another, the previous settings are retained for future use. For
example, if you have a list of individual DLO administrators and then you
change your configuration to use domain groups instead, the list of individual
accounts is saved and will once again be used if the Use domain groups to
manage access to network user data folders option is not selected.
41
Symantec Desktop and Laptop Option
Post Installation Tasks
5 Click OK twice.
Note: Changes to Global Settings take place immediately and apply globally to all
Desktop Agents. Changes to the default profile and backup selection settings apply
only to new profiles and backup selections and do not affect those that already exist.
6 Set the profile user settings options as explained in “Profile User Settings
options” on page 93.
7 In the Properties pane, under New Profile Defaults, click Schedule.
8 Set the profile schedule options as explained in “Profile User Settings options”
on page 93.
9 In the Properties pane, under New Profile Defaults, click Options.
10 Set the profile options as explained in “Additional Profile tab options” on
page 98.
Item Description
Disable
All Desktop Agents Select this check box to prevent all Desktop
Agents from backing up.
Incremental backups of Outlook PST Select this check box to prevent the incremental
files backup of Microsoft Outlook PST files for all
users.
See “Backing up Outlook PST Files
Incrementally” on page 265 for more
information.
Incremental backups of Lotus Notes Select this check box to prevent the incremental
mail files backup of Lotus Notes files for all users.
See “Backing up Lotus Notes NSF Files
Incrementally” on page 267 for more
information.
Reports
Generate reports in HTML format Select this option to display reports in HTML
format.
Generate reports in XML format Select this option to display reports in XML
format.
Generate reports in XLS format Select this option to display reports in XLS
format.
Other
Time to auto-refresh Administration Enter the time in minutes. After the specified
Console time, the Administration Console is
automatically refreshed.
The default value is 1 minute.
44
Symantec Desktop and Laptop Option
Post Installation Tasks
Item Description
Time to delay Desktop Agent startup Select this check box and enter the number of
after user logs in seconds to delay the start of the Desktop Agent
after the user logs in. The Desktop Agent start is
only delayed if this check box is selected and the
Desktop Agent is started from the Start menu.
The default value is 30 seconds.
Storage Threshold
Desktop Agent low disk error threshold Enter a value. Desktop Agent stops writing to
the desktop user data folder when the available
disk space drops below this level, and an error
message is displayed.
The default value is 3 %
Desktop Agent low disk warning Enter a value. A warning is displayed when the
threshold available disk space on the Desktop Agent drops
below this value.
The default value is 5%.
Network Storage low disk warning Enter a value. A warning is displayed when the
threshold available disk space on the network storage
drops below this value.
The default value is 5%.
Desktop Agent low quota warning Enter a value. A warning is displayed when the
threshold available disk quota on the Desktop Agent drops
below this value.
The default value is 10%.
For example, if the desktop user data folder is
limited to 30 MB and the low quota warning
threshold is set at 10%, a quota warning is
displayed when less than 3 MB space is available
on the Desktop Agent.
45
Symantec Desktop and Laptop Option
Post Installation Tasks
Item Description
Network Storage low quota warning Enter a value. A warning is displayed when the
threshold available disk quota on the network storage
drops below this value.
The default value is 10%.
For example, if the network user data folder is
limited to 100 MB and the low quota warning
threshold is set at 10%, a quota warning is
displayed when less than 10 MB space is
available on the network user data folder.
5 In the Properties pane under Global Settings, click Desktop Agent Intervals.
6 Set the Desktop Agent interval defaults. Table 1-6 describes the options.
Option Description
How long to wait before retrying the Enter the number of minutes DLO waits
backup of a previously busy file before it retries the backup of previously
busy file.
If the wait time is reduced, Desktop Agent
computers spend more CPU time and disk
I/O trying to backup files if they are busy. If
the time is set higher, files are backed up less
frequently. The recommended default is 5
minutes.
How long to wait before retrying the Enter the number of minutes to wait before
backup of a previously failed file retrying the backup of a file that previously
failed to back up.
If the wait time is reduced, Desktop Agent
computers spend more CPU time and disk
I/O trying to backup files that previously
failed to back up. If the time is set higher,
files are backed up less frequently. The
recommended default is 60 minutes.
46
Symantec Desktop and Laptop Option
Post Installation Tasks
Option Description
How long to retain backups of files Enter the number of days to retain backups
that have been removed from backup of files that have been removed from backup
selections selections.
Increasing the retention time causes the
files to be left on the server for a longer time
after they have been removed from the
backup selection. Setting a shorter retention
time provides more space in the backup
folders, but reduces the time during which
users can restore files that have been
removed from the backup selections. The
recommended default is 30 days.
Minimum time between postings of Enter the number of hours to wait between
the same alert postings of the same alert.
When there is a recurring alert, it is
displayed only once during the specified
time interval. If the time is set too low, the
alert log can fill up with multiple postings of
the same alert. The recommended default is
24 hours.
Minimum time between closing a job Enter the number of minutes to wait
log and starting a new one between closing a job log and starting a new
one.
When the time between job logs is reduced,
more job logs appear. The recommended
default is 30 minutes.
47
Symantec Desktop and Laptop Option
Post Installation Tasks
Option Description
Minimum time between checking for Enter the number of minutes between
changes to Lotus Notes e-mail files checks for changes to Lotus Notes files.
A lower time results in more CPU time and
disk I/O is used to determine if Lotus Notes
files have changed. The recommended
default is 30 seconds.
Time during which Desktop Agents Enter the number of minutes during which
randomly respond to restart requests the Desktop Agents will randomly respond
to restart requests.
When a large number of Desktop Agents are
restarted, for example when network user
data folders are moved, the Desktop Agents
are restarted randomly over a specified
period of time. This prevents the potential
for overloading DLO by starting a large
number of Desktop Agents at the same time.
The recommended default is 30 minutes.
7 In the Properties pane under Global Settings, click User Activity Settings.
8 Set the User Activity Settings defaults.
Enable user activity Check Enable user activity restrictions to determine how
restrictions DLO will perform tasks when users are interacting with
their desktop computers. User activity is based on typing
and mouse movement.
Limit network bandwidth Enter the maximum network bandwidth that DLO will use
usage to when the user is interacting with the desktop computer.
Restrictions will be removed Enter the number of seconds of user inactivity after which
when there has been no user DLO will no longer restrict jobs.
activity for x seconds
48
Symantec Desktop and Laptop Option
Post Installation Tasks
Maximum scanner items per Scanner items per second limits the number of items
second processed per second during a file system scan. File
system scans occur during the first backup of a desktop
computer, after an abnormal system shutdown, or if the
change journal is truncated. This setting reduces the
impact of the scan on the desktop computer while the user
is active.
Interval Select the time to check for updates. The specific options
available will vary with the frequency selected.
3 On computers that run the Desktop Agent from outside the firewall, create the
following registry key as a DWORD value if it does not exist and set the
DBUseTCP flag to 1:
HKCU\Software\Symantec\Symantec DLO\Client\DBUseTCP or
HKLM\Software\Symantec\Symantec DLO\Client\DBUseTCP
4 Set the DBTcpPort on the computers modified in steps 2 and 3 to the port
number you set in step 1.
5 Restart the modified computers.
Note: After changing the values in the context.xml file, you must restart the
Dedupe Server.
If you are running SQL Server as a named instance and you are not using a specific
TCP/IP port number in your connection string, then you must enable the SQL Server
Browser service to allow for remote connections.
To configure a SQL server to listen on a specific TCP port, refer to the instructions at
http://msdn.microsoft.com/en-us/library/ms177440(v=sql.105).aspx
6 Select the Install Dedupe Administration Service Feature check box and click
Next.
51
Symantec Desktop and Laptop Option
Updating Symantec DLO
any hot fixes or service packs that are installed on the media server. When
LiveUpdate installs updates on the Symantec DLO media server, it also determines if
computers on which the Remote DLO Agent for Windows Systems have the latest
updates. You can push-install or manually install those updates to Symantec DLO
Remote Agents. Symantec Live Update will take care of the Dedupe Server update.
You can use the LiveUpdate Administrator utility with LiveUpdate. The LiveUpdate
Administrator utility allows an administrator to modify LiveUpdate so that network
users can download program and virus definition updates from an internal server
rather than going to the Symantec LiveUpdate server over the Internet.
Go to
ftp://ftp.symantec.com/public/english_us_canada/products/symantec_scan_engine
/5.1/manuals/LuAdmin.pdf
Note: Command line option does not work for Windows Vista and later. In this case,
you can use either the first or second option.
To upgrade Desktop Agents from the DLO Administration Console using the
command-line interface
1 Update the DLO Administration Server as explained in the update
documentation.
2 From the command line on the DLO Administration Server, change to the DLO
installation directory.
Default installation directory:
Example C:\Program Files\Symantec\Symantec DLO
3 Run DLOCommandu.exe with the update option to add the configuration file and
make note of the ID number returned when this command is run:
DLOCommandu -update -add -f
“DLOAgent\update_7.5\DLOAgentUpdate_NBU.ini”
Note: If the configuration file has been moved or renamed, you will need to
specify the full path and file name in the command above.
Sample output:
ID=3
Name=7.5 Update
Updates Symantec DLO Desktop Agent to 7.5
Version=7.5
PromptUser=Yes
ExitAfterLaunch=No
Build=7.50.25a
srcPath=\\a2symms14907\DLOAgent\update_7.5
cmdName=AutomatedAgentUpgrade.exe
cmdArgs=
cmdPath=%DOWNLOADDIR%
4 Run DLOCommandu.exe with the publish command to make the update
available to Desktop Agent users.
DLOCommandu -update -publish -UI y -U UserName
DLOCommandu -update -publish -UI y -P ProfileName
The y indicates the ID number returned when the add command was run in
step 3. Using an asterisk in place of UserName or ProfileName will
publish the update to all users.
When this command is executed, it will return a list of all users targeted for
update. Users will be updated the next time the Desktop Agent application
is started.
55
Symantec Desktop and Laptop Option
Updating Symantec DLO
Related Topics
“DLO Command Line Interface Management Tools” on page 209
■ A DLO Client (Leave NBUP).VPK file that contains instructions and an executable
to upgrade the system to DLO and leave NBUP installed but increment the
version number so that it appears NBUP was upgraded.
2 Next, uninstall the existing DLO Administration Server and the DLO Database
component.
3 Upgrade to Symantec DLO by using the Remote DLO Database Installation
option, during installation.
Note: If you have installed Symantec DLO 7.0 with remote database setup, then while
upgrading to Symantec DLO 7.5, select the “Remote DLO Database Installation”
option.
Similarly, for BE-DLO 2010 R3 with the remote database setup, select the “Remote
DLO Database Installation” option while migrating to Symantec DLO 7.5.
Option Description
Note: While doing migration, make sure that the SQL service is running under
domain admin credentials, else the database connection fails.
While doing migration, you can select BE SQL database instance (“XYZ”) or local SQL
database instance, or local database instance shipped by Symantec DLO or any other
pre-existing SQL database instance. After migration you will not be able to launch
DLO from the BE console.
We recommend that you DO NOT select the “Remote DLO Database” option, to avoid
loss of data.
1 Run the DLO 7.5 setup.exe on the BE-DLO installed machine to start the
installation wizard.
Figure 1-5 Install Agents and Maintenance Services on Remote Computers option
Option 2:
Using the remote desktop connection, access the remote machine where DLO Agent
is installed. Run the setup.exe that is within the DLO Agent folder.
C:\Program Files\Symantec\Symantec DLO\DLO Agent\setup.exe
61
Symantec Desktop and Laptop Option
BackupExec (BE)-DLO Migration
Note: If BE-DLO Agent does not respond to the profile changes when it is not yet
migrated to Symantec DLO version of Agent, then update BE-DLO Agent to Symantec
DLO Agent.
Note: This machine should have been selected as the remote database (DB) even
while installing BE. Otherwise, this migration process will fail.
Note: Ensure that you complete this process, otherwise Symantec DLO
installation will fail, and the following error message is displayed: “Symantec
DLO cannot be installed on the same machine as the Backup Exec DLO Console is
clustered”.
2 During unclustering, ensure that you select the database to overwrite the data
that was stored in the original install path (default - C:\Program
Files\Symantec\Backup Exec\Data) with the data from the shared disk
location (where DLO Database files are hosted.)
Note: Also, while unclustering BE-DLO by using the wizard, two pop-up dialogs
appear:
To confirm if the data from the shared disk should be removed
To confirm if the data should be available to the local node
Click Yes in both the cases.
This will ensure that the database files are copied back to the original install
path.
3 In case you do not select the database, then manually copy the BE_DLO.mdf
and BE_DLO.ldf files from the shared disk folder to the new location where
Symantec DLO is being installed. C:\Program Files\Symantec\Symantec
DLO\Data.
4 Continue with the Symantec DLO installation.
63
Symantec Desktop and Laptop Option
BackupExec (BE)-DLO Migration
Table 2-1 shows the information available in the System Summary view.
Item Description
Last Backup Result Summarizes the completion status of the last operation
performed on each computer protected by DLO. Totals
are provided for the number of computers that
completed the last job successfully, with errors, with
warnings, or for which the last job was cancelled.
Alert Summary
Active Alerts Lists alerts that have not been cleared by the DLO
administrators and have not yet been removed by the
alert grooming process.
Server Summary
Server Enter the name of the DLO Administration Server you want to
connect to, or select a server from the drop-down menu.
User name Type the user name for an account with administrator access to the
DLO Administration Server.
3 Click OK.
Related Topics
“Managing Administrator Accounts” on page 37
Ensure that your virtual environment meets all the hardware requirements and the
recommendations that VMware specifies. Hardware that VMware does not support
may cause unknown issues.
For example, DLO may not function correctly if your virtual machine hardware does
not support VMware. See the VMware documentation for information on supported
configuration.
Configuring DLO
For DLO to back up user data, you must set up these options in the following order:
1 Add a Dedupe Server, and configure the Dedupe Storage Pools and Dedupe
Storage Locations. For more information, see “Adding Dedupe Server” on
page 73.
2 Create a profile, which determines what files are backed up, when the files are
backed up, and the level of interaction the desktop user has with the Desktop
Agent. For more information, see “About DLO Profiles” on page 84.
3 Create Storage Locations where user data will be stored on the network. DLO
requires an individual user data folder on the network for each desktop user. If
Storage Locations are used, they will automatically create network user data
folders for each new Desktop Agent user. If network data storage folders already
exist for each user, they can be added to DLO individually or many users can be
imported at one time using a list. For more information, see “About DLO Storage
Locations” on page 121 and “Managing Desktop Agent Users” on page 149.
4 Create an Automated User Assignment to automatically assign a DLO Storage
Location and profile to new users, or configure new users manually. For more
information, see “About Automated User Assignments” on page 129.
3 If you want the Configuration Wizard to display each time the DLO
Administration Console is started, select Always show this wizard at startup
check box.
Related Topics
“About DLO Storage Locations” on page 121
“About Automated User Assignments” on page 129
“Managing Desktop Agent Users” on page 149
Field Description
Name Enter a name for the Dedupe Server. This is just for
identification purpose.
Server Host Name/IP Enter the host name or IP address where the Dedupe
Server is installed.
HTTP Port Enter the HTTP port number of the Dedupe Server host.
This port will be used by the DLO components to connect
to the Dedupe Server. Default value is 8080.
HTTPS Port Enter the HTTPS port number of the Dedupe Server host.
This port will be used by the DLO components to connect
to the Dedupe Server. Default value is 8443.
5 Click OK.
75
Configuring the Desktop and Laptop Option
Configuring Dedupe Server
Note: After adding Dedupe Server, you can verify the status of the Dedupe Server.
Type the following URLs in your browser.
http://<dedupeserver_ip_or_hostname>:8080
https://<dedupeserver_ip_or_hostname>:8443
If the Dedupe Server is active, then the following message is displayed: Dedupe
Server Status: (20159) Active.
If there is no response from Dedupe Server, then it indicates that the Dedupe Server
is not initialized, and one of the reasons could be that the database connection is
down.
Note: The name of the Dedupe Storage Pool is a just logical name used to
identify the group of Dedupe Storage Locations.
6 Click Add.
The Dedupe Storage Pool is created, and a confirmation message appears.
76
Configuring the Desktop and Laptop Option
Configuring Dedupe Server
Note: At least one Dedupe Storage Pool must be created first before creating and
adding a Dedupe Storage Location.
Before adding a Dedupe Storage Location, the DLO administrator should create a
shared folder on the system where DLO Administration Console is installed, and
grant access rights to specific users.
Field Description
Encryption Type Select the encryption type from the drop-down list.
AES_256 is recommended. This encryption algorithm
is to used to encrypt the data in the Dedupe Storage
Locations.
Enable Compression This option is selected by default. Clear the check box
to disable compression. If enabled, data in the Dedupe
Storage Locations will be stored in compressed format.
78
Configuring the Desktop and Laptop Option
Configuring Dedupe Server
Field Description
User Name Enter the name of the domain user that has read-write
(RW) access to the shared folder. This user name has to
be a non- administrator account.
8 Click Add.
A confirmation message appears, indicating that the Dedupe Storage Location is
created successfully.
Note: After configuring the Dedupe Server, creating Dedupe Storage Pools, and
Dedupe Storage Locations, you can create new DLO Storage Locations and assign
these Dedupe Storage Locations. For existing DLO Storage Locations, you should
first assign the specific Dedupe Storage Locations and then enable Dedupe for that
profile. For more information, see “Creating DLO Storage Locations” on page 123.
79
Configuring the Desktop and Laptop Option
Configuring Dedupe Server
Note: You can change the storage path for a Dedupe Storage Location. After
changing the path, you should move all the data in the previous path to the new
storage path.
Changing Credentials
You should change the credentials when the password used to create the Dedupe
Storage Location has been changed, or when the user account has expired.
Note: As long as the Dedupe Storage Location is active (listed in the DLO
Administration Console), admin should not delete any data in the Dedupe Storage
Location. Deleting this data will lead to corrupted backups for the users of the
Dedupe Storage Pool to which this Dedupe Storage Location belongs. One of the
scenarios where the administrator would delete the data in the Dedupe Storage
Location is when a specific user is deleted or migrated to some other Dedupe Storage
Pool. Even in this scenario, the administrator should not delete the data within the
Dedupe Storage Location.
Note: A Dedupe Storage Location cannot be deleted if it is being used by any of the
DLO Storage Locations.
5 To set the maintenance schedule, enter the time in the Timeout field.
6 Click Start.
7 To change the configuration, select the required encryption type from the Hash
Algorithm field.
8 Enable HTTP communication to server for faster backup: Select this check box if
required.
9 To add admin users, click Add.
10 In the Add Admin Users window, enter the user name in this format: domain
name\user name.
11 Click Add.
A confirmation message appears, indicating that the operation was successful.
Syntax
Schedule the Maintenance Window
DdAdminCU.exe -ScheduleMaintenance |-SCM <DedupeServerName>
<HTTPS PortNumber> <Maintenance Timeout Value> [-i]
Command Options
Option Description
Item Description
Profile Name Type the name of the new profile that you want to create. The profile
name cannot contain any of the following characters:
\”@#$%^&*()=+|/{}[]’
Enable Profile Profiles are enabled by default. To disable the profile, clear this check
box.
86
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Note: To enable Dedupe backup for a profile, the Dedupe Server must
be installed and added to the DLO configuration. Otherwise, the
Enable Dedupe option is disabled in the Profile Properties window.
For more information, see “Configuring Dedupe Server” on page 73.
Storage Limits
Limit network Limits the disk space available on the network to store DLO backup
user data folder files and type the amount of space you want to use for storage.
to (MB)
87
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Enable desktop Enables the use of the desktop user data folder.
user data folder When Enable desktop user data folder is selected, files are copied to
the desktop user data folder first, and then they are copied to the
network user data folder from the desktop user data folder. This is
true even when DLO is configured to keep zero revisions in the
desktop user data folder.
When Enable desktop user data folder is not selected, files are
copied straight to the network user data folder from the original
location.
Advantages of enabling the desktop user data folder:
■ Offline protection is provided because revisions can be stored
locally as well as on the network.
■ Because files are more quickly saved to the local computer than
to the network, the time a file is held open for backup is
reduced.
Advantages of disabling the desktop user data folder:
■ If local revisions are not required, this option will prevent
backup files from being stored in the desktop user data folder.
No revisions are saved in the desktop user data folder even if
backup selections specify that a certain number of revisions
should be stored locally.
■ Works well for desktop users with very limited disk space.
■ When the DLO administrator disables the desktop user data
folder or the number of revisions retained in this folder is set to
zero, DLO will still create empty place holders in the desktop
user data folder. The place holders can be seen in the Desktop
User data folder, but contain no data. They indicate which files
and folders have been backed up and saved to the network user
data folder.
88
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Limit desktop Limits the disk space available to store DLO backup files.
user data folder
to A percentage of the total disk space (%)
Select this option and enter a percentage to limit the amount of disk
space used for storing backup files in the desktop user data folder to
a percentage of the local drive.
A size (MB)
Select this option and enter a size in MB to limit the desktop user
data folder to a specific maximum size.
Note: While limiting available disk space for the desktop user data
folder can prevent overloading of the desktop hard drive, backups
can fail to run if the desktop user data folder space limit is reached.
My Default The default desktop user data folder path is the user’s local
Desktop User application data path. To override this location for newly deployed
Data Folder Path Agents, select the Override default desktop user data folder path
check box, and type the new path.
Note: These options are disabled if no Agents with DLO versions prior to 6.1 MP3
are registered.
89
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Limit network Limiting the bandwidth for DLO data transfer is a means
bandwidth usage to to manage the trade-off between backup speed vs. the
(KB/sec) impact of backups on the local computer, network, and
server. The default limit is meant to be a conservative
setting to minimize the impact of backups, but many
factors come into play, such as network speed,
connection type, the amount of data backed up and the
total number of computers backing up to DLO.
If computer performance is not impacted, but DLO data
transfer is slow, a higher bandwidth setting may be more
suitable. If computer performance is noticeably
impacted during backups, a lower value will reduce the
impact of backups on computer performance, but
backups will take longer to complete.
Select the Limit network bandwidth usage to (KB/sec)
check box, and enter a specific maximum bandwidth
setting to control the rate at which data is sent to the
network user data folder.
Data transfer is only limited when data is written to the
network user data folder, not when it is written to the
desktop user data folder. Data transfer is not limited
during the incremental backup of Outlook PST files or
Lotus Notes NSF files.
90
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Yield bandwidth to Enables DLO to reduce data transfer over the network
other programs when other applications on the desktop computer are
transferring data. DLO automatically resumes normal
data transfer rates when other applications are not using
this resource.
The yield bandwidth option monitors network traffic on
the desktop computer. If DLO is using more than 90% of
the total current traffic, DLO is not throttled. When DLO
traffic drops below 90% of the total network traffic on
the desktop, and total traffic is over 60% of the
maximum traffic seen on the connection, then DLO
throttles itself to use only the otherwise unused portion
of the connection. For example, if there was 70% total
usage, DLO will throttle itself to 30% of maximum.
Item Description
No network Select this option to disable all network throttling for this
throttling category.
Limit network Select this option and then select a specific percent of
bandwidth usage to available network bandwidth to control the rate at which data
is sent to the network user data folder.
Item Description
Limit usage to Select this option and enter a specific maximum bandwidth
setting (in KB/sec) to control the rate at which data is sent to
the network user data folder.
Data transfer is only limited when data is written to the
network user data folder, not when it is written to the desktop
user data folder. Data transfer is not limited during the
incremental backup of Outlook PST files or Lotus Notes NSF
files.
Yield bandwidth to This option enables DLO to reduce data transfer over the
other programs network when other applications on the desktop computer are
transferring data. DLO resumes normal data transfer rates
when other applications are not using this resource.
Disable network Select this option to not use the network for backups.
backup This option is generally used for the low bandwidth network
category. When network backups are disabled, files do not get
backed up to the network user data folder. However, backups to
the local user data folder still occur.
8 On the Restore Throttling tab, select the appropriate options for each of the
three network bandwidth categories: Low bandwidth setting, Medium
bandwidth setting, and High bandwidth setting.
Item Description
No network Select this option to disable all network throttling for this
throttling category.
Limit network Select this option and then select a specific percent of available
bandwidth usage network bandwidth to control the rate at which data is sent to
to the network user data folder.
Item Description
Limit usage to Select this option and enter a specific maximum bandwidth
setting (in KB/sec) to control the rate at which data is sent to the
network user data folder.
Data transfer is only limited when data is written to the network
user data folder, not when it is written to the desktop user data
folder. Data transfer is not limited during the incremental
backup of Outlook PST files or Lotus Notes NSF files.
Yield bandwidth This option enables DLO to reduce data transfer over the
to other programs network when other applications on the desktop computer are
transferring data. DLO resumes normal data transfer rates when
other applications are not using this resource.
9 From the Backup Selections tab, select the backup selections that you want to
apply to users of this profile.
You can add, modify, and delete backup selections for a profile from this dialog
box. When a new backup selection is created, it is available for selection in all
profiles. Changes made to a backup selection in one profile will impact all other
profiles that use the backup selection. Similarly, when a backup selection is
deleted, the change impacts all profiles that use the backup selection. For more
information, see “About Backup Selections” on page 102.
10 From the User Settings tab, select the appropriate options.
Note: When a user is given the option to change any of the following settings,
the new settings will apply only to that user and not to other users assigned to
the same profile.
93
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Desktop Agent display Select one of the following options to determine the
settings desktop user’s level of interaction with the Desktop Agent:
■ Display the complete interface. Select this option to
enable desktop users to access all Desktop Agent
options.
■ Display only the status. Select this option to enable
desktop users to view the status of backup jobs. With
this option, desktop users cannot change settings for
the Desktop Agent or access any options other than
the status.
Desktop users can right-click the system tray icon to
open the status view or exit the program.
■ Display only the system tray icon. Select this option
to display the Desktop Agent icon in the system tray
in the lower right corner of the screen.
Desktop users can right-click the system tray icon to
exit the program.
■ Do not display anything. Select this option to run the
Desktop Agent in the background. The desktop user
cannot view the Desktop Agent.
Restore data When selected, users in this profile can restore their
backed up files.
For more information, see “Restoring Files Using the
Desktop Agent” on page 286.
94
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Add user-defined Enables users in this profile to create and modify backup
backup selections selections. This option does not allow users to modify
backup selections made by the DLO administrator in the
profile.
Modify profile backup Enables users in this profile to modify backup selections
selections created by the DLO administrator for the profile. For more
information, see “About Backup Selections” on page 102
or “Modifying Backup Selections in the Advanced View”
on page 264.
Customize backup Enables users in this profile to modify the revision policy
selection revision settings. Users cannot change these settings if this option
policy settings is not selected. For more information, see “Backup
Selection Revision Control Dialog Box” on page 261.
Move local user data Enables users in this profile to move the local user data
folder folder to a new location. For more information, see
“Moving the Desktop User Data Folder” on page 273.
95
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Synchronize files Enables users in this profile to synchronize data across all
of their computers that run the Desktop Agent.
For more information, see “Synchronizing Desktop User
Data” on page 277.
Customize local disk Enables users in this profile to limit the amount of disk
quota space that can be used to store backup files in the desktop
user data folder.
For more information, see “Setting Customized Options”
on page 271.
Cancel scheduled or Enables users in this profile to cancel both scheduled and
manual jobs manually initiated jobs. Scheduled jobs will run again at
the next scheduled time. Manual jobs must be restarted
manually.
For more information, see “Suspending or Cancelling a
Job” on page 283.
Suspend jobs Enables users in this profile to suspend jobs for a specified
amount of time. For more information, see “Suspending or
Cancelling a Job” on page 283.
Disable Desktop Agent Enables users in this profile to disable the Desktop Agent
from the tray icon. They will also have the ability to
re-enable the Desktop Agent once it has been disabled.
Work Offline Enables users in this profile to set the Desktop Agent to
work offline. For more information, see “Changing your
Connection Status” on page 251.
96
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Suppress errors and Prevents error and warning messages from being
warnings displayed when a user is not interacting with the Desktop
Agent.
When user goes offline, Enter the time after which a user will automatically go
automatically go back back online after they have manually placed the Desktop
online after Agent in an offline state.
When user suspends a Enter the time after which a job will be resumed or the
job or disables the Desktop Agent enabled after the user suspends a job or
Desktop Agent, disables the Desktop Agent.
automatically resume
or enable after
11 On the Schedule tab, select the appropriate options. Table 2-7 describes the
options.
Item Description
Run backups
Whenever a file Select this option to back up files whenever they change.
changes
On NTFS drives, backups will occur automatically whenever a file
changes. For FAT drives, you must enter a backup interval in the Back
up changed files every field.
When initiated by Select this option to enable desktop users to determine when to back
the user up their files.
97
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Logout/Restart/Shutdown options
Prompt user to run job Select this option to display a prompt and ask the user
if a backup should be run before proceeding with the
logout, restart, or shutdown.
Run job immediately Select this option to back up waiting files without
prompting before proceeding with a logout, restart or
shutdown.
Run job at next login Select this option to run a backup job when the user
logs in the next time.
Run as scheduled Select this option to run the backup job according to a
schedule when the user is logged out.
12 If you selected Edit schedule in the previous step, select the appropriate options,
and click OK. Table 2-8 describes the options.
Item Description
Run on these days Select the days on which you want to back up files.
98
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Run once at Select this option to run a single backup on the days
you selected at the time specified.
Run every Select this option to run backups at the specified time
interval on the days you selected.
Until If you selected Run every, select the end of the time
interval over which you want backups to begin.
Start backup jobs over a period of Select this option to stagger start times for backup
jobs. Rather than starting all backup jobs at exactly
the time indicated, DLO will distribute the start times
over the specified interval to better distribute the
demands on the server and network.
Note: Events such as file copies, file grooms, errors and warnings are logged by
DLO and can be viewed as discussed in “Monitoring Alerts on the DLO
Administration Console” on page 177.
Item Description
Keep log files for a minimum Specify the minimum number of days to keep log files.
of (days) Log files will not be deleted until they are at least as
old as specified.
Item Description
After minimum number of Enter the maximum combined size of all log files to be
days, delete oldest log files retained before the oldest log files are deleted.
when combined size exceeds
Note: You may have more than the specified number of
(MB)
MB of log files stored if none of the log files is as old as
specified in the Keep log files for a minimum of (days)
setting.
Logging options
Log groom messages Select this check box to create logs for grooming
operations.
Log information messages Select this check box to create logs for all backup
for backup operations.
Log warning messages Select this check box to create logs for all operations
that generate warnings.
Mail options
Enable incremental backups Select this check box to enable incremental backups of
of Outlook PST files Microsoft Outlook Personal Folder (PST) files.
Incremental backups must be enabled to allow PST
files to be backed up while they are open.
If this option is not selected, PST files that are
configured in Outlook will be fully backed up each time
the PST file is saved, which generally occurs when
Outlook is closed.
When Outlook PST files are backed up incrementally,
only one revision is maintained regardless of the
number of revisions set in the backup selection.
Enable VSS Backups of Select this check box to enable VSS backups of
Outlook PST Files after Microsoft Outlook Personal Folder (PST) files.
every 30 minutes
Note: This feature is applicable to 6.1 MP5 or later
versions of DLO Agent.
100
Configuring the Desktop and Laptop Option
About DLO Profiles
Item Description
Enable incremental backups Select this check box to enable incremental backups of
of Lotus Notes e-mail files Lotus Notes e-mail files. Additional configuration may
be necessary. For more information, see “Backing up
Lotus Notes NSF Files Incrementally” on page 267.
When Lotus Notes NSF files are backed up
incrementally, only one revision is maintained
regardless of the number of revisions set in the backup
selection.
14 Click the Connection Policies tab to disable or limit backups for specific
connection types. Click Add to create a new connection policy.
Table 2-10 describes the options available to configure the policy.
Item Description
Connection Type
Item Description
Disable network backup Select this option to prevent users from backing up to
the network user data folder. Backups will continue to
the desktop user data folder.
Disable network backup for Select this option to prevent users from backing up files
files greater than larger than a specified size based on the connection type.
Enter a files size in KB.
Limit network bandwidth Enter a value in KB/sec to restrict the usage of network
usage to bandwidth to the specified value.
Enforce policy according to Select this option to enable the connection policy to
scheduled window apply only during the specified period of time.
Click Schedule to set the time during which the policy
will be in affect. Schedules can be set to run weekly or
for a specific date range.
15 Click OK.
Related Topics
“About Backup Selections” on page 102
“Monitoring Alerts on the DLO Administration Console” on page 177
“Modifying Desktop Agent Settings” on page 268
Copying a Profile
When you create a new profile, we recommend that you begin with a copy of an
existing profile with a configuration similar to that required for the new profile. You
can then modify the copy as required, to meet the needs of a new group of desktop
users.
To copy a profile
1 On the DLO navigation bar, click Setup.
2 In the Settings pane, click Profiles.
3 Right-click on the profile you want to copy.
4 Click Copy.
5 Type a name for the new profile.
6 Type a description of the new profile.
102
Configuring the Desktop and Laptop Option
About Backup Selections
7 Click OK.
Modifying a Profile
Profiles can be modified as required to meet the changing needs of user groups.
Note: Modifications to a profile will cause users of that profile to cancel jobs, load
settings, restart backup engines and scan their backup selection tree.
To modify a profile
1 On the DLO navigation bar, click Setup.
2 In the Settings pane, click Profiles.
3 In the Results pane, select the profile you want to modify.
4 In the Task pane, under General Tasks, click Properties.
5 To enable Dedupe, on the General tab, select the Enable Dedupe check box.
Note: If any of the users associated with this profile uses a DLO Storage Location
without Dedupe Storage Location, then the Dedupe option cannot be enabled for
those users.
In case you want to enable Dedupe again after some days, then the list of
users associated with this updated profile is checked. If any user has a Storage
Location without a Dedupe Storage Location defined, then a message prompts you to
define a Dedupe Storage Location for that specific user.
Backup selections are easily customized to meet a wide variety of needs. With in each
backup selection you can do the following:
■ Specify the path to be backed up
■ Choose to include or exclude subfolders, file types, or specific folders
■ Set the number of revisions retained for each file in the backup selection, the
frequency with which they are saved, and instructions on how long to retain
backup files
■ Configure the backup selection to transfer only the changed portions of files
■ Compress or encrypt the files for transmission and storage
■ Specify how long to retain backup files after the source files are deleted
Caution: Symantec strongly recommends that you consider disk space when
choosing backup selections for desktops and laptops. A large number of local copies
may cause the Desktop Agent user's computer to run out of disk space. For example,
you may want to avoid selecting entire drives for backup or synchronization.
Related Topics
“Default Backup Selections” on page 103
“Removing Default Backup Selections from a Profile” on page 104
“Adding a Backup Selection” on page 105
“Defining General Backup Selection Properties” on page 106
“Including and Excluding Files or Folders from a Backup Selection” on page 107
“Revision Control” on page 108
“Setting Options for a Backup Selection” on page 111
“Using DLO Macros in Backup Selections” on page 112
“Modifying a Backup Selection” on page 114
“Deleting Backup Selections” on page 117
Item Description
Notes Files (Multi-user) Lotus Notes data for multiple user install
Notes Archive (Multi-user) Lotus Notes archive for multiple user install
Notes Files (Single-user) Lotus Notes data for single user install
Notes Archive (Single-user) Lotus Notes archive for single user install
Outlook 2010 PST Files Outlook 2010 PST files in default location
Notes (ver. 8 and above) Files Notes (ver. 8 and above) data for single user install
(Single-user)
Notes (ver. 8 and above) Archives Notes (ver. 8 and above) archive for single user
(Single-user) install
Note: Backup selections assume applications are using default paths. If custom paths
were used during installation or modified thereafter, you will need to customize the
backup selections to insure they work properly. See “Modifying a Backup Selection”
on page 114 for more information.
Item Description
Folder to back up
Type a folder name Select this option to add a specific folder to the backup
selection. Type the path to the folder, including the
folder name. For example, to add a folder named
MyData on drive C, type C:\MyData.
Select a pre-defined folder Select this option to choose a pre-defined folder from
the list provided.
Include subfolders Select this option to also back up all subfolders in the
specified directory. This option is selected by default.
3 Click OK.
107
Configuring the Desktop and Laptop Option
About Backup Selections
Related Topics
“DLO Default Settings” on page 41
“Configuring Global Exclude Filters” on page 134
Item Description
Filter Type the name of the file or the folder that you want to
include or exclude. You can use wildcards.
For example, type *.mp3 to either include or exclude
all files with the file extension .mp3, or type
unimportant.txt to include or exclude all files in
the backup selection with this specific file name.
Click Extensions to select a predefined filter to either
include or exclude all files with a given file extension.
6 Click OK.
Revision Control
Revisions are versions of a file at a specific point in time. You configure revision
settings when you create a backup selection. When a file is changed and backed up,
DLO stores a new revision. DLO will store and maintain a specific number of
revisions for all files in a backup selection. Because backup selections are configured
separately, the number of revisions retained in each backup selection can vary.
When the number of revisions is exceeded, DLO removes the oldest revision,
maintaining only the specified number of revisions in the Desktop and network user
data folders.
You can limit the number of revisions retained in a given period of time. If you are
working on a document and backing it up frequently, all of your revisions could
potentially be just a few minutes apart. By specifying that you want to retain only
two revisions every 24 hours, at least 120 minutes apart, you can retain older
revisions for a longer period of time. While some intermediate versions will not be
retained, it does support situations in which returning to an older revision is needed.
Another consideration in determining the number of revisions to retain is the
amount of storage space required to store the data. The amount of space required for
109
Configuring the Desktop and Laptop Option
About Backup Selections
File Grooming
The Desktop Agent grooms revisions based on backup selection settings and does
this as new revisions are created. The oldest revision is deleted when a new revision
is created that exceeds the limit. See step 2 on page 109 for revision control settings.
Maintenance grooming is the process of removing backups of deleted files. It occurs
at most once every 24 hours. Maintenance grooming occurs during the first backup
that runs after 24 hours have passed since the last maintenance grooming.
Item Description
Number of revisions
110
Configuring the Desktop and Laptop Option
About Backup Selections
Item Description
Desktop user data folder Type the number of revisions to keep in the desktop
user data folder for each file in the backup selection.
Network user data folder Select the number of revisions to keep in the network
user data folder for each file in the backup selection.
Revision Age
Discard all revisions in the Enter the number of days after which all revisions in
desktop user data folder the desktop user data folder will be deleted.
older than
Note: The most recent revision will not be discarded.
111
Configuring the Desktop and Laptop Option
About Backup Selections
Item Description
Discard all revisions in the Enter the number of days after which all revisions in
network user data folder the network user data folder will be deleted.
older than
Note: The most recent revision will not be discarded.
Note: For Dedupe enabled profile, Delta File Transfer option is selected by default,
and is applicable only for non-PST files. For PST files, Delta File Transfer parameters
are forcibly applied whether the option is selected or not selected.
Item Description
Delta File Transfer Each time a file is backed up, only the part of the file
that has changed is transferred and stored in the
network user data folder. In addition, delta file
transfer uses compression. Enabling this option
requires that you have installed and configured a
maintenance server. See“Adding a New Maintenance
Server” on page 117 for more information.
112
Configuring the Desktop and Laptop Option
About Backup Selections
Item Description
When source files are deleted, delete the backed up files from the:
Desktop user data folder after Indicate the number of days after which DLO will
delete all file versions from the desktop user data
folder after the source file has been deleted from the
desktop.
Network user data folder after Indicate the number of days after which DLO will
delete all file versions from the network user data
folder after the source file has been deleted from the
desktop.
%CURRENTUSERPRINTHOOD% The Printers directory for the user who is logged on.
%CURRENTUSERDESKTOP% The Desktop directory for the user who is logged on.
%CURRENTUSERRECENT% The Recent Files directory for the user who is logged
on.
The following additional pre-defined folder macros are available for selection in the
backup selection dialog box.
Table 2-17 Macros for pre-defined folders in the Backup Selection dialog
Note: When you enter a path that uses a macro, a backslash is automatically added
immediately following the macro. For example, if you type
%LOCALFIXEDDRIVES%\Documents, an extra backslash is added and it appears as
“x:\\Documents” in the Desktop Agent backup selection advanced view. It does not
show at all in the Desktop Agent backup selection Standard view. The correct way to
type this macro is %LOCALFIXEDDRIVES%Documents. This properly resolves to
x:\Documents.
Note: The Type a folder name field in the General tab is grayed out in this view.
If the path in this field is longer than the display, hold the curser over the path
for a moment to display the entire path.
7 Click OK to indicate that you read the message stating that modifying this
backup selection will change all profiles that are using this selection.
8 Change the backup selection as described in the following topics:
“Defining General Backup Selection Properties” on page 106
“Including and Excluding Files or Folders from a Backup Selection” on page 107
“Setting Revision Control for a Backup Selection” on page 109
“Setting Options for a Backup Selection” on page 111
9 Click OK twice.
Note: For Dedupe enabled profiles, Delta File Transfer option is applicable only for
non-PST files. For PST files, Delta File Transfer parameters are forcibly applied
whether the option is selected or not selected.
Working Offline
Delta File Transfer is only used to transfer and store backup files on in the network
user data folder. Backup files stored in the Desktop User Data Folder are not stored
using deltas. If a Desktop Agent user is working offline, the local revisions are stored
in their entirety in the desktop user data folder. When the user is once again working
online, Delta File Transfer is used to transfer data to the network user data folder.
116
Configuring the Desktop and Laptop Option
About Backup Selections
is changed to Delta, all new backup selections will use Delta compression by default.
See “DLO Default Settings” on page 41 for more information.
Related Topics
“Backup Selection options” on page 111
2 From the DLO Console, on the DLO navigation bar, click Setup.
3 In the Task pane, under Manage Tasks, click Maintenance servers.
4 Click Add.
5 Navigate to the computer where the maintenance server is installed.
6 Select this computer.
7 Click OK.
Note: The entry for the default maintenance server cannot be deleted from the
Administration Console.
Similarly, once you add a maintenance server from the Administration Console, you
must install the maintenance server software on the computer to begin maintenance
processes.
5 Click Edit.
6 Select the file server you want to reassign.
7 Click Reassign.
8 Select the new maintenance server from the drop-down menu.
9 Click OK three times.
SAN X
FAT32 volume, you may see duplicate entries in the Restore and Restore Search
screens. If duplicates do appear, you can select either file to restore.
Once created, Storage Locations cannot be modified, but they can be deleted if there
are no users or Automated User Assignments assigned to them. You can move users
to new Storage Locations. For more information, see “Moving Desktop Agent Users
to a New Network User Data Folder” on page 154.
Note: If you receive errors when creating Storage Locations, verify that the login
account for the service named MSSQL$DLO has sufficient rights to create directories
and change permissions for the Storage Locations. Use the Windows Service Control
Panel to change the login account for the MSSQL$DLO instance. You can avoid these
problems if you specify a domain account when you install DLO.
Note: After you create Storage Locations, you cannot modify them.
Item Description
Storage Location name Type a name for the new DLO Storage Location. The
name cannot contain any of the following characters:
\”@#$%^&*()=+|/{}[]’
125
Configuring the Desktop and Laptop Option
About DLO Storage Locations
Item Description
Dedupe Storage Location Select a Dedupe Storage Location from the drop-down
list. For more information about how to add a Dedupe
Storage Location, see “Adding a Dedupe Storage
Location” on page 76.
4 Click OK.
Case 1
3 Make sure that the volume desired to be used for DLO has been assigned a drive
letter on the remote storage location or NAS device.
4 Create a new DLO Storage Location as explained in the section “Creating DLO
Storage Locations” on page 123. Use the Browse feature to select a location on
the computer where the DLO Storage Location should be created. This will insure
that the path and the DLO service account are valid.
Case 2
The DLO administration service does not run as an administrator level user, but the
DLO administration groups have been assigned the appropriate permission levels on
a pre-existing share.
Note: Do not click the Browse buttons at any point while creating the DLO
Storage Location because using the Browse feature will cause the process to fail.
8 Storage Locations manually created when the DLO Admin Service does not have
full administrator rights to the server hosting the DLO Storage Location cannot
be deleted from the DLO Administration Console. Attempting to do so will result
in an error.
9 To manually remove the DLO Storage Location:
a Move or delete all users in the DLO Storage Location.
b Manually remove the DLO Storage Location share and folder from the
server.
c Delete the DLO Storage Location from the DLO Administration Console.
Note: When a DLO Storage Location is created using an existing share on a remote
computer and DLO does not have full computer rights, the DLO Storage Location
cannot be deleted from the DLO Administration Console. To remove the DLO Storage
Location, first delete the DLO Storage Location share and then delete the DLO
Storage Location from the DLO Administration Console.
Related Topics
“Managing Desktop Agent Users” on page 149
“Modifying Automated User Assignments” on page 132
“Deleting Automated User Assignments” on page 133
128
Configuring the Desktop and Laptop Option
About Dedupe Storage Locations
■ After the Dedupe Storage Location is associated with a DLO Storage Location,
and a deduped backup is performed, in case the Dedupe Storage Location should
be moved, then make sure to use the -MigrateSL command.
■ The Dedupe Storage Location user should have the “Allow log on locally” policy
set in the domain controller group policy object. To set this policy, do the
following:
■ After logging on locally with domain admin account, run gpmc.msc (Group
Policy Management).
■ Double-click the Domain name.
■ Expand <Group Policy Objects> and right-click <Default domain
controllers policy>.
■ Click Edit.
■ Expand <Computer Configurations> <Policies> <Windows Settings>
<Security Settings> <Local Policies> <User Rights Assignment>.
■ Right-click <Allow log on locally> and click Properties. Change as required.
■ Run gpupdate and wait for the confirmation: "user policy update has
completed succesfully" (default gpupdate without switches should only
apply the changes).
Note: If a user is added manually to DLO, a Storage Location and profile are selected
by the DLO administrator. The Automated User Assignment will not be used. For
more information, see “Managing Desktop Agent Users” on page 149.
Automated User Assignments are assigned to desktop users based either on their
domain and group, or using Active Directory settings. Because users may match the
criteria for more than one Automated User Assignment, the Automated User
Assignments are prioritized. When the Desktop Agent is run for the first time, the
Desktop Agent user’s domain and group credentials are checked against those of the
Automated User Assignment starting with the highest priority assignment. When a
match is made, the share and profile specified in that Automated User Assignment
are assigned to the new user.
130
Configuring the Desktop and Laptop Option
About Automated User Assignments
Modifying Automated User Assignments does not affect users who have already
been configured. Only new users configured with the Automated User Assignment
will use the new settings.
3 Or in the Settings pane, right-click Automated user assignment and select New
User Assignment.
The New User Assignment window appears.
4 Select the appropriate options as described in the following table.
Item Description
User Assignment
User assignment Type a name for the Automated User Assignment. The Automated
name User Assignment name cannot contain the following characters:
\”@#$%^&*()=+|/{}[]’
Assign using Domain Select this option to match Desktop Agent users to Automated
and Group User Assignments based on their domain and group.
Domain Select the domain to which this Automated User Assignment will
apply.
Group Select the group to which this Automated User Assignment will
apply.
Assign Using Active Select this option to match Desktop Agent users to Automated
Directory User Assignments based on Active Directory settings.
Configure Click the Configure button to configure the User Assignment using
Active Directory. See step 5 below for information on configuring
the Active Directory settings.
Storage Location/Profile
Storage Location Select a Storage Location to be assigned to the users in the selected
domain and group.
Note: When you select a profile that has Dedupe enabled, make
sure that the Storage Location associated to this profile has a
Dedupe Storage Location defined. If it is not defined, then you will
not be able to create an automated user assignment.
132
Configuring the Desktop and Laptop Option
About Automated User Assignments
5 If you chose to use Active Directory to configure the User Assignment in step 4,
configure the Active Directory settings as follows:
Table 2-22 Active Directory Object Dialog
Item Description
All objects in this directory Select this option to apply the connection policy to
all objects in the specified directory.
Only the objects in this directory Select this option to apply the connection policy
that match the criteria below only to those objects in the specified directory that
match the criteria entered.
6 Click OK.
Related Topics
“Moving Desktop Agent Users to a New Network User Data Folder” on page 154
“Modifying Desktop Agent User Properties” on page 152
Caution: Adding a global exclude will cause all previous backups matching the global
exclude to be deleted.
Item Description
6 Click OK.
7 To edit a global exclude filter, click Edit and configure as described in the step 5.
8 To delete a global exclude filter, click the filter to be deleted and click Delete.
Click Yes to delete the filter or No to cancel.
9 Click OK.
136
Configuring the Desktop and Laptop Option
Configuring Global Exclude Filters
Note: E-mail global excludes does not apply for VSS based PST backups.
Item Description
Attachment file type The filter determines which attachment file types will be
excluded from backup by the global exclude.
Mail folder name Type the name of the mail folder you would like to
exclude from backup.
6 Click OK.
7 To edit a global e-mail filter, click the filter you want to change. Click Edit and
configure as described in table 2-24, “Add Global E-mail Exclude Filter Dialog”.
8 To delete a global e-mail filter, click the filter to be deleted and click Delete.
Click Yes to delete the filter or No to cancel.
9 Click OK.
Note: Compression global excludes is not applicable for Dedupe enabled backups.
Item Description
Item Description
5 Click OK.
6 To edit a global exclude filter, click the filter you want to change. Click Edit and
configure as described in the “Add Global Compression Exclude Filter Dialog”
table above.
7 To delete a global exclude filter, click the filter to be deleted and click Delete.
Click Yes to delete the filter or No to cancel.
8 Click OK.
Note: Encryption global excludes is not applicable for Dedupe enabled backups.
4 To add a new encrypted file global exclude, click Add and configure as follows.
Table 2-26 Add Global Encryption Exclude Filter Dialog
Item Description
5 Click OK.
6 To edit a global encryption exclude filter, click the filter you want to change.
Click Edit and configure as described in table 2-26, “Add Global Encryption
Exclude Filter Dialog”.
7 To delete a global encryption exclude filter, click the filter to be deleted and click
Delete.
Click Yes to delete the filter or No to cancel.
8 Click OK.
Note: Delta File Transfer global excludes is not applicable for Dedupe enabled
backups.
140
Configuring the Desktop and Laptop Option
Configuring Global Exclude Filters
Note: Files and Folders backed up using Delta File Transfer are also compressed
with standard compression. If a file is in a backup selection that uses Delta File
Transfer, but is excluded from Delta File Transfer using a global excludes filter,
it is still compressed with standard compression unless it is also excluded from
standard compression using another global excludes filter.
3 To exclude files greater than a specific size from Delta File Transfer, select the
Exclude all files greater than check box and enter a size in KB.
4 To exclude files smaller than a specific size from Delta File Transfer, select the
Exclude all files less than check box and enter a size in KB.
5 To add a new Delta File Transfer global exclude, click Add and configure as
follows.
Table 2-27 Add Global Delta File Transfer Exclude Filter Dialog
Item Description
6 Click OK.
141
Configuring the Desktop and Laptop Option
Configuring Global Exclude Filters
7 To edit a global Delta File Transfer exclude filter, click the filter you want to
change. Click Edit and configure as described in table 2-27, “Add Global Delta
File Transfer Exclude Filter Dialog”.
8 To delete a global Delta File Transfer exclude filter, click the filter to be deleted
and click Delete.
To delete the filter, click Yes, and to cancel, click No.
9 Click OK.
Related Topics
“About Backup Selections” on page 102
“Configuring Global Exclude Filters” on page 134
Macro Folder
%TEMP% The temp directory for the user who is logged on.
Macro Folder
%WEBTEMP% The web cache for the user who is logged on.
How to find the port number for a particular named instance of SQL Server
1 Click Start > Programs > Microsoft SQL Server > Configuration Tools > SQL
Server Configuration Manager.
2 Expand SQL Server Network Configuration and select Protocols for <instance
name>.
3 Right-click TCP/IP and select Properties.
4 In the TCP/IP Properties window, select the IP Addresses tab.
The port used by the SQL Server instance can be found either in the TCP
Dynamic Ports for a dynamic port, or in the TCP Port for a static port.
5 You can also find the port number using the registry entry:
HKLM\Software\Microsoft\Microsoft SQL Server\<name of the
instance>\MSSQLServer\SuperSocketNetLib\TCP
Table 2-30 Special considerations for installing Symantec DLO on remote computers
Item Description
Table 2-30 Special considerations for installing Symantec DLO on remote computers
Item Description
IPv6 Support
Deploying Dedupe Server on IPv6 Network
To deploy the Dedupe Server on IPv6 network, the attribute value of the protocol for
the different connector elements must be modified in the server.xml file.
The server.xml file is located at this path:
C:\Program Files\Symantec\Symantec DLO\Dedupe
\Tomcat\conf\server.xml
Modify the following lines in the file:
Change the protocol’s attribute value in the following lines:
1 Existing attribute value for protocol:
<Connector connectionTimeout="20000" port="8080"
protocol="HTTP/1.1" redirectPort="8443" server=" "/>
Change to:
<Connector connectionTimeout="20000" port="8080"
protocol="org.apache.coyote.http11.Http11Protocol"
redirectPort="8443" server=" "/>
2 Existing attribute value for protocol:
<Connector SSLEnabled="true" SSLProtocol="TLS"
clientAuth="false" keystoreFile="dedupeserver.jks"
keystorePass="dedupeserver" maxThreads="200" port="8443"
147
Configuring the Desktop and Laptop Option
IPv6 Support
protocol="org.apache.coyote.http11.Http11NioProtocol"
scheme="https" secure="true" server=" "/>
Change to:
<Connector SSLEnabled="true" SSLProtocol="TLS"
clientAuth="false" keystoreFile="dedupeserver.jks"
keystorePass="dedupeserver" maxThreads="200" port="8443"
protocol="org.apache.coyote.http11.Http11Protocol"
scheme="https" secure="true" server=" "/>
3 Existing attribute value for protocol:
<Connector port="8009" protocol="AJP/1.3"
redirectPort="8443"/>
Change to:
<Connector port="8009"
protocol="org.apache.coyote.ajp.AjpProtocol"
redirectPort="8443"/>
After you modify the values in the server.xml file, restart the Dedupe Server.
148
Configuring the Desktop and Laptop Option
IPv6 Support
Chapter 3
Managing and Monitoring
DLO
This section contains the following topics:
■ “Managing Desktop Agent Users” on page 149
■ “Managing Desktop Computers” on page 156
■ “Restoring Files and Folders from the DLO Administration Console” on page 162
■ “Monitoring DLO Job Histories” on page 171
■ “Monitoring Alerts on the DLO Administration Console” on page 177
■ “Configuring Alerts for Notification” on page 183
■ “Configuring Recipients for Notification” on page 187
■ “DLO Reports” on page 200
■ “Backup and Recovery of DLO Servers and User Data” on page 166
■ “About DLO and Clusters” on page 204
Related Topics
“About Automated User Assignments” on page 129
“Adding a Single Desktop User to DLO” on page 151
150
Managing and Monitoring DLO
Managing Desktop Agent Users
“Importing Multiple Users who have Existing Network Storage” on page 152
“Viewing a List of Desktop Agent users” on page 156
“Modifying Desktop Agent User Properties” on page 152
“Enabling or Disabling DLO Access for a Desktop User” on page 153
“Deleting a User from DLO” on page 153
“Moving Desktop Agent Users to a New Network User Data Folder” on page 154
To manually create network user data folders and set security attributes
1 Create or locate a network share on the computer where backup files will be
stored.
2 Right-click the share you created in step 1, and then select Properties.
3 Click the Sharing tab.
4 Verify that Share this folder is selected.
5 Click Permissions.
6 Select the following permissions for user Everyone: Full Control, Change, Read
7 Click OK.
8 Click the Security tab.
9 Click Advanced.
10 Verify that the Inherit from parent the permission entries that apply to child
objects check box is not selected.
11 Add Administrator and Everyone and give them full control permissions.
12 In this share, create a data folder for each user who will use this DLO Storage
Location, or verify that a data folder already exists.
13 Right-click the data folder for a user.
14 Select Properties.
15 Select Security.
16 Verify that the Inherit from parent the permission entries that apply to child
objects check box is not selected.
151
Managing and Monitoring DLO
Managing Desktop Agent Users
17 Add Administrator and the user who will be assigned to the user data folder to
the share permission list.
18 Set full permission for Administrator and the user.
Item Description
Enable User Select this option to enable this user to use the Desktop Agent, or
clear it to prevent the user from using the Desktop Agent.
Profile Select the profile that you want to assign to this user.
Item Description
Network user data folder Select this option and type the path or browse to an existing
network user data folder where this desktop user’s backup files will
be stored. This must be an existing folder, and the security
attributes must be set for the folder according to your
organization’s needs. For example, determine which users can
access the folder.
Note: A DLO Storage Location is not required when an existing
network share is used as the network user data folder.
Storage Location Select this option to choose an existing Storage Location. The
network user data folder for the new user will be placed in this
Storage Location.
Item Description
Enable User Select this option to enable this user to use the Desktop Agent, or clear it
to prevent the user from using the Desktop Agent.
network user data folder This is the location where the user’s backup files are to be stored. It
cannot be modified. To move a user to a new location, see “Moving
Desktop Agent Users to a New Network User Data Folder” on page 154.
Note: If you delete a user from the DLO Administration Console without first
uninstalling the Desktop Agent from the user’s desktop, the Desktop Agent on
that user's computers will close automatically.
To move one or more Desktop Agent users to a new network user data folder
Note: When the transfer is complete, each affected Desktop Agent will shut down
and then automatically restart within a 30 minute window.
Item Description
User Lists the domain and user name of the selected user or users.
Destination
Move the user data folder to Select this option to choose an existing Storage Location from the
an existing Storage drop-down list. A new network user data folder will be created in the new
Location Storage Location for each user who is moved.
Move the contents of the Select this option to specify a new Storage Location. Type the path in the
user data folder to an box provided, or click Browse and navigate to the new location. A new
alternative location network user data folder will be created in the new Storage Location for
each user who is moved.
Item Description
Use Profile schedule Select this option in the drop-down menu to use the scheduling options
specified in the profile.
Use customized schedule Select this option in the drop-down menu to specify a customized
schedule that differs from the profile schedule.
Run jobs
157
Managing and Monitoring DLO
Managing Desktop Computers
Item Description
Whenever a file changes Select this option to back up files whenever they change.
On NTFS drives, backups will occur automatically whenever a file
changes. For FAT drives, you must enter a backup interval in the Back up
changed files every field.
According to a schedule Select this option to back up files according to a customized schedule.
Click Edit schedule to configure the backup schedule. The backup
schedule is configured in step 12 of “Creating a New Profile” on page 85.
Manually Select this option to require that the DLO Administrator or desktop user
initiate backups manually.
Automatically run jobs Select this option to begin a backup after the desktop user logs on to the
when logging on computer.
Automatically run jobs Select this option to begin a backup when the desktop user logs off the
when logging off computer.
6 To modify computer options, click the Options tab and configure the computer
options as described in the following table.
Item Description
Use Profile options Select this option in the drop-down menu to use settings specified in the
profile.
Use customized options Select this option in the drop-down menu to specify settings that differ
from the profile options.
Limit disk space usage on Select this check box to limit disk space usage on the desktop computer.
my computer to To limit the usage to a percent of drive space, select % and type the
maximum percentage of drive space to use.
To limit the usage to a specific size, select MB and type the maximum
number of MB to use on the local drive.
Item Description
Keep log files for a Type the minimum number of days to keep log files. Log files will not be
minimum of (days) deleted until they are at least as old as specified.
Note: Log files will not be deleted until their combined size exceeds the
setting for the combined size of all log files, which is discussed below.
After minimum number Type the maximum combined size of all log files to be retained before the
of days, delete oldest log oldest log files are deleted.
files when combined size Note: You may have more than the specified number of MB of log files
exceeds (MB) stored if none of the log files are as old as specified in the keep log files
for a minimum of (days) setting.
Logging options
Log groom messages Select this check box to create logs for grooming operations.
Log information Select this check box to create logs for all backup operations.
messages for backup
Log warning messages Select this check box to create logs for all operations that generate
warnings.
Mail options
Enable incremental Select this check box to enable incremental backups of Microsoft Outlook
backups of Outlook PST Personal Folder (PST) files. Incremental backups must be enabled to allow
files PST files to be backed up while they are open.
If this option is not selected, then PST files that are configured in Outlook
will be fully backed up each time the PST file is saved, which generally
occurs when Outlook is closed.
When Outlook PST files are backed up incrementally, only one revision is
maintained regardless of the number of revisions set in the backup
selection.
Item Description
Enable incremental Select this check box to enable incremental backups of Lotus Notes e-mail
backups of Lotus Notes files. Additional configuration may be necessary. See “Backing up Lotus
email files Notes NSF Files Incrementally” on page 267.
When Lotus Notes NSF files are backed up incrementally, only one
revision is maintained regardless of the number of revisions set in the
backup selection.
7 To view the computer backup folders, click the Backup Folders tab.
8 To modify the computer backup selections, click the Backup Selections tab.
See “Adding a Backup Selection” on page 105. Profile backup selections are not
listed, and can only be modified directly in the profile as described in “Modifying
a Backup Selection” on page 114.
9 To view synchronized selections for a computer schedule, click the Synchronized
Selections tab.
Synchronized selections can only be viewed from the Administration Console.
They are configured on the Desktop Agent as described in “Synchronizing
Desktop User Data” on page 277.
10 To view and modify connection policies, click the Connection Policies tab.
Profile defined connection policies can only be modified in the profile. See
“Customizing Connection Policies” on page 274.
Item Description
Occurs Select the frequency of occurrence. Selections include on a specific date and
weekly.
6 Click OK.
Note: DLO can overwrite a file which is in use by staging the file to be restored when
the desktop computer restarts. Using this feature requires that the currently logged
on user of the desktop computer has administrative rights on the desktop computer.
Alternatively, the file can be restored by first closing the application which is using
the file, or by restoring the file to an alternate location.
Note: When a desktop user deletes an original file, the backup files are retained
until they are deleted by the file grooming process. If an original file has been
deleted, but backup files are still available, the icon for the file in the restore
view will have a small red ‘x’ to indicate the deletion of the original file. See “File
Grooming” on page 257 for more information.
7 In the Task pane, under Restore Tasks, click Restore files to open the Restore
dialog.
163
Managing and Monitoring DLO
Restoring Files and Folders from the DLO Administration Console
Item Description
Restore destination
Restore to original computer Select this option to restore the selected files or folders to the
computer from which they were originally backed up.
Restore to original folder Select this option to restore the file or folder to its original
location.
Redirect the restore to an Select this option to restore the file or folder to a different location
alternate folder on the original desktop.
Click Browse to browse to the folder where you would like to
restore the file.
Restore to an alternate Select this option to restore the selected items to a network or
computer local drive on a computer other than the one from which they were
originally backed up.
Redirect the restore to a Select this option to restore the data to a selected folder on an
folder on an alternate alternate computer.
computer
Stage this user data on an Select this option to migrate user data to a new computer. See
alternate computer for a “Migrating a Desktop User to a New Computer” on page 155 for
new DLO installation more information.
Preserve folder structure Select this check box to restore the data with its original directory
structure intact. If you clear this option, all data (including the
data in subdirectories) is restored to a single folder in the path you
specify.
164
Managing and Monitoring DLO
Restoring Files and Folders from the DLO Administration Console
Item Description
Restore Options
If file already exists: Select Do not overwrite to cancel the restoration of files that
already exist in the destination folder.
Select Prompt to be prompted before overwriting the file if it
already exists in the destination folder.
Select Overwrite to overwrite the file without prompting if it
already exists in the destination folder.
Restore deleted files Select this option if you want to restore files even though the
original files have been deleted.
Preserve security attributes on Select Preserve security attributes on restored files to preserve
restored files security information in restored files.
You may need to uncheck this box to successfully restore a file if
the source file security conflicts with the destination security.
Unchecking this option causes the security information to be
removed from the restored file.
9 Click OK.
10 In the Restore Summary dialog box, review the selected restore settings, and do
one of the following:
■ Click Print to print a copy of the restore summary
■ Click Restore to continue with the restore
11 Click OK when the restore job completes.
3 In the Task pane, under Restore Tasks, click Search for files to restore.
4 Select the appropriate options as described in the following table.
Table 3-8 Search Dialog Box Options
Item Description
Search for file names with this text Type all or part of the name of the file or folder you want to
in the file name find. Wildcard entries are accepted, for example *proj.doc.
Modified Select this option to search for files that were modified during a
specific time frame, and then select the time frame.
Today Select this option to search for files modified on the current
calendar day.
Within the past week Select this option to search for files modified in the last
calendar week.
Between Select this option to search for files modified during a range of
days.
Of the following type Select this check box to select a file type from the list provided.
Of the following size Select this check box and then enter information as follows:
■ Select from equal to, at least, or at most in the first
drop-down menu
■ Type a file size
■ Select KB, MB, or GB
5 Click Search.
6 In the Results pane, check the items to be restored.
In some cases the Restore Search view may contain duplicate entries for the
same file. If this occurs, you can select either file to restore and receive the same
outcome.
7 Click Restore.
8 Select the appropriate options as outlined in “Restoring Files and Folders from
the DLO Administration Console” on page 162.
9 Click OK.
166
Managing and Monitoring DLO
Backup and Recovery of DLO Servers and User Data
Note: If a user account that does not have administrator privileges is used to
restore data, then open the command prompt by selecting the Run as
Administrator option, and then run the command. Else, the files will not be
restored.
Case 1
A non-system disk on the administration server fails or is otherwise corrupted.
Case 2
The administration server's system hard drive fails, or the server’s computer needs
to be replaced with a new computer then the recovery procedure is as follows:
Note: This process is applicable to the setup where only DLO components are
installed and configured.
170
Managing and Monitoring DLO
Backup and Recovery of DLO Servers and User Data
You can use Symantec DLO to back up the DLO Storage Locations, network user data
folders, and the DLO database.
To back up Desktop Agent user data, create a backup job and include the DLO Storage
Location or network user data folder in the backup selection. To restore Desktop
Agent user data from DLO, restore the data from DLO to a DLO Storage Location or
network user data folder, and then use the DLO Administration Console to restore
data to the desktop user data folder.
To back up the DLO database, use the -backup command as described in “DLO
Database Maintenance” on page 238 to create a copy of the database, and then create
a backup job in DLO to back up this copy of the database. Use the -restore
command to restore the database from a specific backup file.
Note: This recovery process is applicable to the setup where the DLO and Dedupe
components are installed and configured together.
When a DLO Admin server is configured with a Dedupe Server, the following
components form a single logical entity in time.
■ DLO configuration database
■ Dedupe Server database files
■ DLO file data in file server
■ Dedupe Storage Location data
Hence, the backup and restore of these components should be performed together at
a single logical point in time (PIT).
PIT across all the components requires the data writes to be stopped on all the
components. The data writes can be stopped by disconnecting the individual
components from the network or the Dedupe Server can be switched to maintenance
mode by scheduling a Maintenance Window from the DLO Administration Console.
Backup
■ Schedule a Maintenance Window with sufficient time out for backing up all
components. If backup time cannot be estimated in advance, then a time out of
‘9999’ minutes can be specified.
■ Back up all the components and tag them together for easy identification of the
same Point in Time for all the components.
■ Stop the Maintenance Window from the DLO Administration Console.
171
Managing and Monitoring DLO
Monitoring DLO Job Histories
Restore
In case of a disaster, data of all the components should be restored to a suitable
logical PIT backup.
To restore the data, follow these steps:
1 Shut down the Dedupe Server if it is running.
2 Restore all components data to the same logical Point in Time.
3 Run the following command:
DDAdminCU.exe -ConfirmDR <HTTPS Port Number>
4 Start the Dedupe Server.
It is recommended to follow this procedure for backup and restore operations, and
thus prevent data loss or any issue related to data integrity.
the Desktop Agent and provides the summary of information as described in the
following table.
Item Description
User The user name of the user who is logged on to the desktop that generated the
message.
Last Backup Result The outcome of a completed backup, for example, Success, Warnings, Failed,
Cancelled.
For descriptions of possible backup outcomes, see “DLO System Summary
options” on page 70.
Profile The name of the Profile to which the desktop user who is logged on to the desktop
belongs.
For more information on profiles, see “About DLO Profiles” on page 84
Backup Mode The backup mode specified in the profile. Backup modes include:
■ Continuous: The backup occurs whenever a file changes
■ Scheduled: The backup occurs according to a schedule
■ Manual: The backup occurs when initiated by the desktop user
Desktop Data Folder The current size of the desktop user data folder.
Size
Network Data Folder The current size of the network user data folder.
Size
Network Data Folder The location of the network user data folder.
Path
The Job History pane displays information as described in the following table.
Item Description
Status The current status of the job, such as active, completed, completed with
errors, completed with warnings, cancelled, or failed.
173
Managing and Monitoring DLO
Monitoring DLO Job Histories
Item Description
Files Protected (Desktop) The number of files copied to the desktop user data folder during the job.
Size Protected (Desktop) The total bytes of data copied to the desktop user data folder during the job.
Files Protected (Network) The number of files copied to the network user data folder during the job.
Size Protected (Network) The total bytes of data copied to the network user data folder during the job.
Errors The number of errors, if any, that were generated during the job.
Item Description
List all jobs Lists history logs for all jobs that have run on the selected
desktop. These may include backup, synchronization,
restore, or move user jobs.
List backup jobs only Lists history logs only for backup jobs that have run on the
selected desktop.
List restore jobs only Lists history logs only for restore jobs that have run on the
selected desktop.
174
Managing and Monitoring DLO
Monitoring DLO Job Histories
4 To filter job history logs based on alerts received, select one or more of the
following options.
Table 3-12 Selections to Filter Job Histories Based on Alerts Received
Item Description
Show successful jobs Lists history logs for all successful jobs on the selected
desktop.
Show jobs with warnings Lists history logs for all jobs that generated warnings on the
selected desktop.
Show jobs with errors Lists history logs for all jobs that generated errors on the
selected desktop.
Show cancelled jobs Lists history logs for all jobs that were cancelled on the
selected desktop.
5 To set a time frame for filters to be displayed, select one of the following options.
Item Description
Show last 24 hours Lists history logs that have been generated in the last 24
hours, and that meet all other filtering criteria.
Show last 7 days Lists history logs that have been generated in the last 7 days,
and that meet all other filtering criteria.
Show all Lists all history logs that also meet all other filtering
criteria.
5 To filter the results, select the appropriate options as described in the following
table.
Item Description
All log files Select this option to show all log entries in the log file viewer.
Current log file Select this option to search only those log entries in the
current log file.
With timestamp Select this check box to search only those log entries within
a specified time period. The options include:
■ Today: Show only log files that were created today
■ Within the last week: Show all log files created in the
last week
■ Between dates: Show all log files created between the
dates entered
176
Managing and Monitoring DLO
Monitoring DLO Job Histories
Item Description
Of the following type Select this check box to show only logs of the indicated type.
The available selections will vary depending on the log file,
but may include the following:
■ Backup
■ Restore
■ Move User
■ Maintenance
■ Dedupe
With File names Select this check box to enter a file name, or file type.
containing Wildcard entries are supported.
Example: *gold.doc
Note: When using wildcards you must use the ‘*’ wildcard.
For example, *.tmp will return all results with the .tmp
extension while .tmp will return only files explicitly named
.tmp.
Limit search to Select this check box to limit the log files displayed to one of
the following types of log entries:
■ Informational entries only
■ Error and warning entries only
■ Error entries only
■ Warning entries only
■ Local data folder entries only
■ Local data folder error entries only
■ Network data folder entries only
■ Network data folder error entries only
6 Click Search.
7 Double-click a log entry to view additional details.
8 Click Close.
2 In the Task pane, under General Tasks, click Search log files to display the log
file viewer.
3 Set filtering options as discussed in step 5 on page 175.
4 Click Search.
5 Double-click a log entry to view additional details.
6 Click Close.
Note: “Backup/Restore complete” alerts cannot be filtered. If you enable these alerts,
they are generated each time a backup or restore job completes.
Active alerts that are older than a specified number of days are cleared and moved
into the alert history. The alerts in the history will be deleted if they have been
cleared for more than a specified number of days.
If an alert is manually cleared, it is moved into the alert history. Deleting an alert
manually removes it permanently.
178
Managing and Monitoring DLO
Monitoring Alerts on the DLO Administration Console
You can set up DLO to notify recipients when alerts occur. See “Configuring Alerts
for Notification” on page 183 for more information.
The following table describes the alert types.
Informational Notifies you that an expected action has occurred, such as the
successful completion of a backup or restore job.
Errors
A backup job has A backup job has completed, but errors were generated.
completed with errors
A restore job has A restore job has completed, but errors were generated.
completed with errors
Desktop user data folder The volume containing the desktop user data folder is
disk space full full. There is insufficient free disk space to back up the
current file. The file will be copied directly to the
network user data folder.
Desktop user data folder The specified disk storage limit was reached when
storage limit has been attempting to add a new revision to the desktop user
reached data folder.
179
Managing and Monitoring DLO
Monitoring Alerts on the DLO Administration Console
File name, directory name, Indicates either a storage system problem that requires
or volume label syntax is attention, or a file name denied by SRM software. If the
incorrect. latter, these files should be added to DLO’s global exclude
list. See “Configuring Global Exclude Filters” on
page 134 for more information.
Network user data folder The volume containing the network user data folder is
disk space full full. There is insufficient free disk space to back up the
current file.
Network user data folder The specified disk storage limit was reached when
storage limit has been attempting to add a new revision to the network user
reached data folder.
Unable to configure the A new user has connected, but for an unknown reason,
Desktop Agent cannot be configured properly.
Suspend backup and alert The backup job has been suspended because of a
administrator on throttling failure.
throttling failure
Warnings
A backup job has A backup job has completed, but warnings were
completed with warnings generated.
A restore job has A restore job has completed, but warnings were
completed with warnings generated.
A restore job has not A restore job was submitted, but an hour has passed and
completed in 1 hour the restore job is not complete.
A restore job has not A restore job was submitted, but 12 hours have passed
completed in 12 hours and the restore job is not complete.
A restore job has not A restore job was submitted, but 24 hours have passed
completed in 24 hours and the restore job is not complete.
Desktop user data folder The amount of stored backup data in a user’s desktop
approaching storage limit user data folder is approaching the specified size limit.
Desktop user data folder The volume containing the desktop user data folder is
disk space low running low.
180
Managing and Monitoring DLO
Monitoring Alerts on the DLO Administration Console
Evaluation period daily This reminder specifies the number of days remaining in
reminder the evaluation period for the Symantec Desktop and
Laptop Option.
Evaluation period has The DLO evaluation period has expired. A license is
expired required to continue to use DLO.
Network user data folder The amount of stored backup data in a user’s network
approaching storage limit user data folder is approaching the specified size limit.
Network user data folder The volume containing the network user data folder is
disk space low running low.
Informational
A restore job has been A restore job was initiated from the DLO Administration
queued Server.
PST file was skipped A PST file on the desktop computer was not backed up
because it is not because it was not configured in Microsoft Outlook.
configured in Outlook
User was configured A new user connected and was successfully configured.
Configuring Alerts
To configure alerts
1 On the DLO navigation bar, click Alerts.
2 In the Task pane, under Alert Tasks, click Configure alerts.
3 Select the alerts you want to receive, and clear the check boxes for the alerts you
do not want to receive.
4 To send notification to recipients when the selected alerts are generated, do the
following:
Note: Alerts must be configured for notification before selecting recipients. See
“Configuring Alerts for Notification” on page 183 and “Configuring Recipients
for Notification” on page 187 for more information.
■ Select one or more alerts from the list. To select multiple alerts, click one
item and press <Ctrl> or <Shift> while clicking the other items
■ Check the Send notification of selected alert to recipients check box
■ Click Recipients
■ Select the recipients to receive notification of the alerts
■ Click OK
5 Click OK.
182
Managing and Monitoring DLO
Monitoring Alerts on the DLO Administration Console
Note: Alerts that are older than a specified number of days are cleared and
moved into alert history.
3 To filter alerts by type, select one or more options from Active Alerts View
Filters or Alert History View Filters in the task pane as described in the following
table.
Table 3-17 Active Alerts View Filters
Item Description
4 To view the properties of an alert, right-click the alert in the Active Alerts or
Alert History list and select properties.
5 If a log file is associated with the alert, a link is provided to the log file. Click this
link to view the log file.
6 Click Close to close the Alert Information dialog.
3 From the alert list, select one or more alerts that you want to clear.
4 In the Task pane, under Alert Tasks, do one of the following:
■ Select Respond to clear only the selected alerts
■ Select Respond OK to all to change the status of all alerts to cleared
Item Description
SMTP mail server Type the name of an SMTP mail server on which you
have a valid user account. DLO will not check the
server name or the email address for validity.
Sender Name Type the name of the user from whom the
notification message will be sent.
Sender email address Type the email address of the user from whom the
notification message will be sent.
The email address should contain a name that
identifies the user to the mail server, followed by an
at sign (@) and the host name and domain name of
the mail server. For example,
[email protected].
4 Click OK.
Related Topics
“Configuring Recipients for Notification” on page 187
185
Managing and Monitoring DLO
Configuring Alerts for Notification
Note: If you install Outlook after installing DLO, you must stop and restart the DLO
Administration Service for MAPI email notification to work and to save the MAPI
configuration settings.
Item Description
Mail server name Type the name of the Exchange server. You must use
an Exchange server to which the DLO service account
has access.
Mailbox name of sender Type the mailbox from whom the notification message
will be sent, for example, John Smith. The name
appears in the From field in the message and does not
require a full address.
4 Click OK.
Related Topics
“Configuring Recipients for Notification” on page 187
186
Managing and Monitoring DLO
Configuring Alerts for Notification
Item Description
Notes client directory Type the path of the directory in which the Notes
client is located.
Mail password Type the password that enables you to connect to the
Notes client.
Confirm mail password Re-type the password that enables you to connect to
the Notes client.
4 Click OK.
Related Topics
“Configuring Recipients for Notification” on page 187
Item Description
Select a modem for Select a modem from the list. Only modems
sending pages that are recognized in Windows appear in
the list.
4 Click OK.
Related Topics
“Configuring Alerts for Notification” on page 183
188
Managing and Monitoring DLO
Configuring Recipients for Notification
Item Description
Enable Select this check box to activate this notification method for
the recipient.
Address Type the email address of the person to whom the notification
message will be sent. For example, [email protected].
Notify me a Type the total number of notifications that can be sent to the
maximum of x recipient for all alerts that are generated within a specified
times within y number of minutes. After the specified number of
minutes notifications have been sent, additional notifications are not
sent until the specified minutes have been reached. The
maximum number of minutes you can set is 1440, which is
the number of minutes in a day.
Reset the Select this check box to enter the number of minutes that
notification must be reached before the notification limits are reset. When
limits after x the time limit has been reached, the number of notifications
minutes that are sent is reset to zero.
Item Description
Enable Select this check box to activate the option and configure the
length of time the recipient is available for notification.
Schedule Enables you to select the days and times when notifications
can be sent to the recipient. For more information, see
“Scheduling Notification for Recipients” on page 198.
8 Click OK.
Item Description
Item Description
Reset the notification Select this check box to enter the number of minutes
limits after x minutes that must be reached before the notification limits
are reset. When the time limit has been reached, the
number of notifications sent is reset to zero.
8 Click OK.
Item Description
Enable Select this check box to activate this notification method for
the recipient.
Reset the Select this check box to enter the number of minutes that
notification limits must be reached before the notification limits are reset.
after x minutes When the time limit has been reached, the number of
notifications sent is reset to zero.
Enable Select this check box to activate the option and configure
the length of time the recipient is available for notification.
Schedule Enables you to select the days and times when notifications
can be sent to the recipient. For more information, see
“Scheduling Notification for Recipients” on page 198.
Item Description
Enable Select this check box to activate this notification method for the
recipient.
Carrier Phone Type the area code and phone number to access the paging
service provider’s modem. The paging service number may be
different from the number you enter to manually send a page.
Country/region Enter the country or region name and country code in which the
name and code pager is located.
Pager Pin Type the pager identification number provided by the paging
service provider. You will have a pin if you use TAP services and
in most cases, the number is the last seven digits of the pager’s
phone number.
Advanced Enables you to configure additional settings for the pager. For
more information about the options, see “Advanced Pager
Information dialog box” on page 193.
Notify me a Type the total number of notifications sent to the recipient for
maximum of x times all alerts generated within the specified number of minutes.
within y minutes After the specified number of notifications have been sent,
additional notifications are not sent until the specified minutes
have been reached. The maximum number of minutes that can
be set is 1440, which is the number of minutes in a day.
Reset the Select this check box to enter the number of minutes that must
notification limits be reached before the notification limits are reset. When the
after x minutes time limit has been reached, the number of notifications sent is
reset to zero.
193
Managing and Monitoring DLO
Configuring Recipients for Notification
Item Description
Enable Select this check box to activate the option and configure the
length of time the recipient is available for notification.
Schedule Enables you to select the days and times when notifications can
be sent to the recipient. For more information, see “Scheduling
Notification for Recipients” on page 198.
7 Click Advanced to configure advanced pager setup options and select the
appropriate options as described in the following table.
Item Description
Pager Configuration
Message Length Type the maximum number of characters you want to use for
messages. The number is determined by the paging service
provider.
Retries Type the number of times you want the paging service
provider to retry the page. The number is determined by the
paging service provider.
Pager type
Numeric Select this option if you are configuring a pager that accepts
only numbers.
Alpha-numeric Select this option if you are configuring a pager that accepts
letters and numbers.
Modem
Configuration
Modem Baud Rate Select the speed of the modem. The speeds that appear are
limits set by the paging service; select the appropriate speed
regardless of the modem speed rating.
Data bits, Parity, Select the communication protocol. In most cases, you should
Stop bit use the Windows default.
194
Managing and Monitoring DLO
Configuring Recipients for Notification
8 Click OK to save the settings in the Advanced Pager Information dialog box, and
then click OK to save the pager configuration settings.
Item Description
Port Enter the SNMP port number. The default SNMP port
is 162.
Reset the notification Select this check box to enter the number of minutes
limits after x minutes that must be reached before the notification limits are
reset. When the time limit has been reached, the
number of notifications sent is reset to zero.
Item Description
6 Click OK.
7 Click Close.
Note: If the target computer has Internet pop-up advertisement blocking software
installed, the Net Send notification message will not display.
Item Description
Name Type the name of the recipient for whom you are configuring
the notification.
Target Computer or User Type the name of the computer or user to whom you are
Name sending the notification. You should enter a computer rather
than a user because the Net Send message will fail if the user
is logged off the network.
All Computers Select All Computers to send the notification to all the
computers in the network.
196
Managing and Monitoring DLO
Configuring Recipients for Notification
Item Description
Notify me a maximum of x Type the total number of notifications sent to the recipient
times within y minutes for all alerts generated within the specified number of
minutes. After the specified number of notifications have
been sent, additional notifications are not sent until the
specified minutes have been reached. The maximum number
of minutes that can be set is 1440, which is the number of
minutes in a day.
Reset the notification Select this check box to enter the number of minutes that
limits after x minutes must be reached before the notification limits are reset.
When the time limit has been reached, the number of
notifications sent is reset to zero.
Enable Select this check box to activate the option and configure the
length of time the recipient is available for notification.
Schedule Select the days and times when notifications can be sent to
the recipient. For more information, see “Scheduling
Notification for Recipients” on page 198.
5 Click OK.
Item Description
Name Type the recipient for whom you are configuring the
notification. You cannot use a fax printer device to receive
the notification.
Target Printer Select the name of the printer to which the notification
message will be sent.
Notify me a maximum of x Type the total number of notifications sent to the recipient
times within y minutes for all alerts generated within the specified number of
minutes. After the specified number of notifications have
been sent, additional notifications are not sent until the
specified minutes have been reached. The maximum number
of minutes that can be set is 1440, which is the number of
minutes in a day.
Reset the notification Select this check box to enter the number of minutes that
limits after x minutes must be reached before the notification limits are reset.
When the time limit has been reached, the number of
notifications sent is reset to zero.
Enable Select this check box to activate the option and configure the
length of time the recipient is available for notification.
Schedule Select the days and times when notifications can be sent to
the recipient. For more information, see “Scheduling
Notification for Recipients” on page 198.
Item Description
To add members to the Select recipients from the All Recipients list, and then
group click Add to move them to the Group Members list.
To remove members from Select recipients from the Group Members list, and
the group then click Remove to move them to the All Recipients
list.
6 Click OK.
The new group can be added to other groups.
Note: To access the Recipient Properties dialog box, click Recipients from the Tools
menu. Click New to create a new recipient or select an existing recipient and then
click Properties.
2 Click Schedule.
199
Managing and Monitoring DLO
Configuring Recipients for Notification
Item Description
Include work days Clear the Include work days check box to exclude
Monday through Friday from 8 A.M. to 6 P.M.
Note: You can select any combination of Include work days, Include weeknights,
or Include weekends, or click any single hour of the chart to select or clear that
hour.
4 Click OK.
Removing Recipients
You can delete recipients that do not want to receive notification messages; however,
the recipient is permanently removed upon deletion. If you want to keep the
recipient, but do not want the recipient to receive notifications, clear the Enable
check box in the recipient properties.
To remove a recipient
1 From the Tools menu, click Recipients.
2 Select the recipient you want to delete, and then click Remove.
3 Click OK.
4 You can start the job after configuring the new recipients or edit recipient
properties or select other options from the Properties pane.
DLO Reports
DLO provides a variety of reports that show detailed information about your DLO
operations. These reports can be viewed from the DLO Console or generated and
saved using the new report command (see “-Report command” on page 226).
When you generate a report, you can specify filter parameters for the data that you
want to include in the report. The filters that are enabled are specific to each report.
You can use the DLO global settings to set the default report format. The default
formats are only used by the reports viewed from the console. See “Changing Default
Global Settings” on page 42 for more information.
If the default report format is set as PDF and Adobe Acrobat is installed on the
system, reports are displayed in Adobe Portable Document Format (PDF). If Adobe
Acrobat is not detected, the reports are displayed in HTML format.
201
Managing and Monitoring DLO
DLO Reports
Active Alerts by Computer A list of all currently active alerts sorted by computer
name.
Active Alerts by User A list of all currently active alerts from all computers
sorted alphabetically by Desktop Agent user name.
Alert History A chronological list of alerts that have been sent by all
computers in the past.
Alert History by Computer A list of alerts that have been sent by all computers in
the past, sorted by computer name.
Alert History by User A list of alerts that have been sent by all computers in
the past, sorted by Desktop Agent user name.
Failed Backup by Computer A list of computers that have a failed status for the last
backup, sorted by computer name.
Failed Backup by User A list of computers that have a failed status for the last
backup, sorted by Desktop Agent user name.
Note: Only the last backup result is stored in the DLO
database, so it is only possible to report the last
backup result for each desktop computer and not a
complete history of failed jobs.
Last Backup Status A chronological list of the last backup status for all
Desktop Agent computers.
Last Backup Status by A list of the last backup status for all Desktop Agent
Computer computers, sorted by computer name.
202
Managing and Monitoring DLO
DLO Reports
Last Backup Status by User A list of the last backup status for all Desktop Agent
computers, sorted by Desktop Agent user name.
Storage Consumption per This report shows the storage consumption used (in
User MB) per user on the Network User Data folder.
Last Backup Status by This report displays backup failures, successes, and
Profile warnings for machines and is grouped by profile name.
No Backups This report shows the machines that have not been
backed up in the past X days.
The value for days is specified using the days filter.
Only those machines whose last completed backup
time is greater than X days are displayed.
If no days filter is specified, all the cancelled and failed
backup jobs are displayed.
Backups Status Dashboard This report shows the status of all clients associated
with a storage location. The report provides the total
number of backup successes, warnings, cancellations,
and errors for the associated clients.
Related Topics
“Changing Default Global Settings” on page 42
“Viewing Report Properties” on page 203
“Running a Report” on page 202
Running a Report
When you run a report, you can specify filtering criteria to determine which items
will be included in the report. After the report is generated, only the items that
match the entered criteria appear in the report. If no criteria are entered, all
available entries are included in the report.
To run a report
1 On the navigation bar, click Reports.
2 On the Reports pane, select the report you want to run.
3 In the Task pane, under Reports Tasks, click Run report now.
203
Managing and Monitoring DLO
DLO Reports
4 Select the appropriate filters for the data you want to include in the report from
the following available filters. Some of these filters are disabled depending on
the report selected.
Item Description
User Select this filter to create a report for a specific desktop user,
and then enter the user’s name.
Profile Select this filter to create a report for a specific profile, and
then enter a profile name.
5 Click OK to run the report. The report can be printed or saved before it is closed.
6 Click OK to close the report.
Item Description
Item Description
Subject The version of the product for which the report was
created.
File name The file name of the report template. Report templates
are specified in Report Definition Language (RDL) and
are structured XML schemas that specify the report
definition.
Creation Date The date the report was installed on the system.
4 Click OK.
■ DLO clusters can be configured on Microsoft Windows Server 2003, 2008, 2008
R2, and 2012 majority node configurations. However, there must be a shared disk
in the configuration for DLO to share the database files between the nodes.
■ The controlling node and designated failover nodes must be online when
installing Admin DLO server into the cluster.
■ A unique IP address and a unique network name are required for configuring
DLO service on a MSCS cluster.
■ While configuring DLO service on a MSCS cluster, it is mandatory that the user
executing the DLO Cluster configuration utility from the active node must be the
owner of the shared disk and the active node.
■ Use the domain admin account for DLO services on all nodes in the cluster. If
nodes in a cluster use DLO and have different accounts, change the services to
use the domain admin account.
■ While clustering the machine using domain user account, which is part of
domain admin group, then provide additional rights/privileges to this user
account on the “Computer” container in Domain Controller for performing
cluster operations. The user account should have the following privileges:
■ Create Computer Object
■ Read All Properties
If the user is added to a different group other than the domain admin group,
then provide the above two privileges to this specific user or group. Also, this
user should be a local administrator on the computers that will be part of
cluster. For more information, refer to the Microsoft Technet link.
http://blogs.technet.com/b/askcore/archive/2010/06/02/rights-needed-for-use
r-account-to-create-a-cluster-name-object-cno-on-windows-server-2008-r2-fail
over-cluster.aspx
b In Select a network adaptor card for this node, or use the default - select
the public option.
Note: Ensure that you select the shared disk drive only.
Unclustering DLO
Pre-requisites for Unclustering DLO
Before unclustering DLO, ensure that you complete the following tasks:
207
Managing and Monitoring DLO
About DLO and Clusters
Note: After unclustering DLO, ensure that you change the Dedupe Server’s host
name to the local host name. For more information about editing the Dedupe Server
details, see “Modifying Dedupe Server” on page 79.
Pre-requisites
Before unclustering DLO, ensure that you complete the following task.
1 From the DLO 7.5 installer package, extract the binaries (DLOClusconfig.exe
and DLOCluster.dll) from the clusterpatch.zip file.
2 Replace the DLO 7.0 cluster binaries with the extracted binaries, only on the
machine where DLO will be unclustered.
The binary files are located at this path:
C:\Program Files\Symantec\Symantec DLO\DLOClusconfig.exe.
and
C:\Program Files\Symantec\Symantec DLO\DLOCluster.dll.
Note: The default installation directory for Symantec DLO version 7.0 and later is:
C:\Program Files\Symantec\Symantec DLO
If Symantec DLO is upgraded from a previous version, it will remain in the original
installation directory. Previous versions of DLO used the following default
installation directories:
C:\Program Files\VERITAS\NetBackup DLO
C:\Program Files\Symantec\NetBackup DLO
Remote server options allow you to specify the name of the remote server on which
you want to run a command. You can also enter your username and password if
required.
Remote server options are described in the following table.
Option Description
-DBDataFile <db data file> Specifies the name of the database data file on the
remote server. The default value is DLO.mdf
-DBLogFile <db log file> Specifies the name of the database log file on the
remote server. The default value is DLO_log.mdf
Commands in Detail
See the following topics for detailed information on available commands:
■ “-AssignSL command” on page 211
■ “-EnableUser command” on page 212
■ “-ChangeDB command” on page 213
■ “-ChangeServer command” on page 214
■ “-KeyTest command” on page 215
■ “-ListProfile command” on page 216
■ “-ListSL command” on page 217
■ “-ListUser command” on page 218
■ “-LogFile command” on page 218
■ “-Update command” on page 219
■ “-EmergencyRestore command” on page 222
211
DLO Command Line Interface Management Tools
Commands in Detail
-AssignSL command
The –AssignSL command is used to assign a new to existing users when the
existing DLO Storage Location is no longer available. The new DLO Storage
Location must be managed by the same DLO Administration Server.
Caution: If the existing DLO Storage Location is accessible, use the -MoveUser
command to move users to a new DLO Storage Location. See “Moving Desktop
Agent Users to a New Network User Data Folder” on page 154 for more
information.
Desktop Agent users can be assigned to new DLO Storage Locations based on
User account name, profile name, profile ID, DLO Storage Location, DLO Storage
Location ID, and File server.
The Desktop Agent that is being moved will be disabled until the administration
server is notified that the move is complete.
Note: This command does not move the user’s data. To assign a new DLO
Storage Location to existing users and move the associated data, use the
“-MigrateDomain command” on page 227.
212
DLO Command Line Interface Management Tools
Commands in Detail
Syntax:
DLOCommandu –AssignSL –NI [–A | –F | –P | –PI | –S | –SI |
–U]
Note: Wildcard matches (*) are permitted in profile, Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-2 –AssignSL Options
Option Description
–NI <new SLID> The -NI option is used to specify the name of the new
Storage Location.
–PI <profile ID> Assigns a new Storage Location to users with given
profile ID.
–SI <SL ID> Assigns a new Storage Location to users with the given
Storage Location ID.
Examples:
DLOCommandu –AssignSL –NI DLO_SL02 –A
DLOCommandu –AssignSL –NI DLO_SL03 –U mmouse
-EnableUser command
The -EnableUser command is used to enable or disable a user.
Use this command if you want to force the desktop computer to refresh from the
DLO Administration Server.
213
DLO Command Line Interface Management Tools
Commands in Detail
Syntax:
DLOCommandu -EnableUser [–E | –D] [–A | –F | –P | –PI | –S |
–SI | –U]
Note: Wildcard matches (*) are permitted in profile, Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-3 –EnableUser Command Options
Option Description
–PI <profile ID> Enables or disables users that are assigned to the
specified profile.
–U <user> Enables or disables only the user with the specified user
name.
Examples:
DLOCommandu –EnableUser –E –A
DLOCommandu –EnableUser –D –U mmouse
-ChangeDB command
This command is used to change the existing database to another DLO database.
214
DLO Command Line Interface Management Tools
Commands in Detail
Syntax:
DLOCommandu –ChangeDB –DBServer <DB server name> -RemoteDB
-DBInstance <DB instance name> -DBName <DLO database name>
-DBDataFile <DLO data file name> -DBLogFile <DLO log file>
Command options
Option Description
-RemoteDB The name of the remote database server. Use this option
when the DLO Administration Server and the DLO
database server are installed on different machines.
-ChangeServer command
The -ChangeServer command is used to reassign users to another DLO
Administration Server.
Each desktop user must back up data to a network user data folder that is
managed by the same administration server to which the user is assigned. If a
matching automated user assignment is available on the new DLO
Administration Server, the user is automatically assigned a profile and Storage
Location. If a matching automated user assignment is not available, the user can
be manually configured.
When a Desktop Agent user is reassigned from one administration server to
another, the user’s current profile settings and existing backup files are not
moved. They remain on the original file server.
Syntax:
DLOCommandu –ChangeServer –M <DLO Administration Server> [ –A | –F
<file server> | –P <profile name> | –PI <profile id> | –S <SL name>
| –SI <SL id> | –SP <SL path> | –U <user> ]
215
DLO Command Line Interface Management Tools
Commands in Detail
Note: Wildcard matches (*) are permitted in profile, Storage Location, and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-4 –ChangeServer Command Options
Option Description
–F <file server> Switches users with Storage Locations on the named file
server.
Examples:
DLOCommandu –ChangeServer –M sunshine –P Desktop*
DLOCommandu –ChangeServer –M sunshine –SP \\moonlight\EngDept
DLOCommandu –ChangeServer –M sunshine –SP
\\moonlight\EngDept\Enterprise–MNoel
-KeyTest command
The -KeyTest command scans network user data to identify encrypted data
that cannot be restored with the current encryption key.
Syntax:
DLOCommandu –KeyTest
216
DLO Command Line Interface Management Tools
Commands in Detail
Command options
The following options can be used independently or in combination.
Option Description
-f The -f option forces a full scan for all users even if the data has
already been validated.
Examples:
Scan all data, even if it has been previously DLOCommandu –keytest -f -quar
validated, to identify unrestorable data.
Quarantine unrestorable data.
-ListProfile command
The -ListProfile command is used to list profiles of Desktop Agent users.
Syntax:
DLOCommandu –ListProfile [–A | –P ]
Note: Wildcard matches (*) are permitted in profile, Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
217
DLO Command Line Interface Management Tools
Commands in Detail
Command options
Table 4-6 –ListProfile Command Options
Option Description
Examples:
DLOCommandu –ListProfile –A
DLOCommandu –ListProfile –P <yourprofile>
-ListSL command
The -ListSL command is used to list the DLO storage locations.
Syntax:
DLOCommandu –listsl [–A | –F | –S ]
Note: Wildcard matches (*) are permitted in profile, Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-7 –ListSL Command Options
Option Description
Examples:
DLOCommandu –listsl –A
DLOCommandu –listsl –F yourserver
DLOCommandu –listsl –S yourSL
218
DLO Command Line Interface Management Tools
Commands in Detail
-ListUser command
The -ListUser command is used to list by All, file server, profile name, profile
ID, DLO Storage Location name, DLO Storage Location ID, or user name.
Syntax:
DLOCommandu –listuser [–A | –F | –P | –PI | –S | –SI | –U]
Note: Wildcard matches (*) are permitted in profile, Storage Location, and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-8 –ListUser Command Options
Option Description
–F <file server> Lists settings for users with storage locations on the
named file server
Examples:
DLOCommandu –listuser –A
DLOCommandu –listuser –P yourprofile
DLOCommandu –listuser –U mmouse
DLOCommandu –listuser –U m*
-LogFile command
The -LogFile command allows administrators to change the path or name of
the LogFile. And, since every command overwrites the LogFile, to track all
events (logs), you must change the path\name of the next LogFile to retain older
versions.
219
DLO Command Line Interface Management Tools
Commands in Detail
The default path is the “\Logs” folder under the installed path:
C:\Program Files\Symantec\Symantec DLO\Logs
If DLO was upgraded from a previous version, the original directory structure is
used. The default path for the “\Logs” folder in previous releases was:
C:\Program Files\VERITAS\NetBackup DLO\Logs
Syntax:
–LogFile <path\file>
Note: Wildcard matches (*) are permitted in profile, Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Command options
Table 4-9 –LogFile Command Options
Option Description
Examples:
DLOCommandu –logfile test.log
DLOCommandu –logfile “c:\test.log”
-Update command
The -Update command is used to list, add, remove, and publish Desktop Agent
updates. See “Updating Symantec DLO” on page 51 for detailed information on
updating the Desktop Agent software.
Syntax:
DLOCommandu –update [–list | –add | –remove | –publish]
220
DLO Command Line Interface Management Tools
Commands in Detail
Subcommands:
The following subcommands allow you to list, add, remove or publish updates. See
“Command options” on page 221 for a description of the available options for each
command.
–List [-A|–UI <update ID>] Lists settings for previously used updates.
–Remove [-UI <update ID>|–A] Removes a file or files from the update list.
–Publish [-R] –UI <update ID> [–P Makes the specified updates available to
<profile name>|–PI <profile ID>|–U users. Users can be identified by using the
<user>] following options:
-P Profile name
–PI Profile RecordID. To obtain the profile
RecordID, run the -listprofile command.
–U User name
221
DLO Command Line Interface Management Tools
Commands in Detail
Command options
Table 4-11 –Update Command and Sub-Command Options
Option Description
–A Updates all
–R Designates to un-publish
Note: Wildcard matches (*) are permitted in profile, DLO Storage Location and user
names.
Quotation marks are required around names if the name contains a space or
colon.
Examples:
◆ To list published updates:
Lists settings for all published updates
DLOCommandu -update -list -A
To list details of a specific update:
DLOCommandu -update -list -UI <updateID>
◆ To add a file to the update list and assign it an ID number
Prepares an update file to be published and assigns it a unique Record ID
number. The Record ID number is returned when the following command is
executed:
DLOCommandu -update -add -f cntlfile.txt
◆ To publish an update to make it available to Desktop Agents
Makes updates available to users. You can specify whether to make this
available to all users, specific users, or users in a profile. You can also use
wildcards to specify profile and user names.
To publish an update for a profile:
DLOCommandu -update -publish -UI <updateID> -P <profile
name>
222
DLO Command Line Interface Management Tools
Commands in Detail
-EmergencyRestore command
The -Emergency Restore command uses the DLO administrator’s recovery
password to restore user data that would otherwise be unavailable if the DLO
database is damaged or corrupted. The recovery password must be known to
execute this command. The data will be restored to the specified location in the
original data structure, but it will no longer be encrypted. See “Setting a
Recovery Password” on page 35 for more information.
Syntax:
DLOCommandu –EmergencyRestore <usersharepath> -W <recovery
password> -AP <destination path>
Command options
Table 4-12 –EmergencyRestore Command Options
Option Description
-AP <destination path> Specifies the path to which data will be restored
-SetRecoveryPwd command
The -SetRecoveryPwd command is used to change the recovery password,
which enables you to retrieve encrypted data that would otherwise be lost if the
DLO database is damaged or corrupted. The -SetRecoveryPwd command now
updates the password for existing users as well as new users.
223
DLO Command Line Interface Management Tools
Commands in Detail
Once set, this recovery password can only be changed using the DLO command
line interface tools.
See “Setting a Recovery Password” on page 35 for more information.
Syntax:
DLOCommandu –SetRecoveryPwd <password>
-NotifyClients command
The -NotifyClients command forces the Desktop Agents to refresh the profile
settings immediately, or the next time the Desktop Agent connects if it is offline.
Syntax:
DLOCommandu –notifyclients
-InactiveAccounts command
The -InactiveAccounts command is used to list and delete accounts that have
not been used in a specified number of days.
-RenameDomain command
The -RenameDomain command is used after a Windows NT domain has been
renamed. Running the -RenameDomain command changes each Desktop Agent
user’s record to reflect the new domain name and changes the path for the network
user data folder. It also notifies each Desktop Agent of the change.
Syntax:
DLOCommandu –RenameDomain <OldDomainName> <NewDomainName>
-RenameMS command
The -RenameMS command is used when an administration server has been renamed.
Running the -RenameMS command updates the installation share, DLO Storage
Location paths and network user data folder paths. It also notifies each Desktop
Agent of the change.
Syntax:
DLOCommandu –RenameMS <OldServerName> <NewServerName>
-LimitAdminTo command
The -LimitAdminTo command limits administration of DLO to the specified group
or user.
Syntax:
DLOCommandu –LimitAdminTo -NAU <domain\NewAdminName>
DLOCommandu –LimitAdminTo -NAU <domain\NewAdminGroup>
225
DLO Command Line Interface Management Tools
Commands in Detail
Command options
Table 4-13 -LimitAdminTo Command Option
Option Description
-IOProfile command
The -IOProfile command enables a profile to be exported from one DLO
Administration Server, and then imported to another administration server. An
option is also provided to import global settings.
Note: When a profile is imported, it does not initially have any users assigned to it, so
there is no immediate impact. When global settings are imported, they immediately
apply to all Desktop Agent users assigned to the server.
◆ To export a profile:
DLOCommandu –C <master server name> -IOProfile -DBF <export
file name> -E <profile name>
This exports the requested named profile (-E) from the specified server (-C) into
the named file (-DBF). It is not necessary to specify the master server name with
the -C option if the profile is on the same server where the command is run.
◆ To import a profile:
DLOCommandu –C < server name> -IOProfile -DBF <export file
name>
This imports the profile in the given file (-DBF) into the named server (-C.)
◆ To import the console settings for DLO administrator account management in
addition to the profile, use the IPRCS option as follows:
DLOCommandu –C < server name> -IOProfile -DBF <export file
name> -IPRGCS
◆ To import the global settings in addition to the profile, use the IPRGS option as
follows:
DLOCommandu –C < server name> -IOProfile -DBF <export file
name> -IPRGS
226
DLO Command Line Interface Management Tools
Commands in Detail
-Report command
This command generates and saves one of the predefined DLO reports. To generate a
report you must specify the name of the .rdl file associated with the report.
For a list of all available reports and their corresponding .rdl file names, use the
“-ListReport command” on page 227 or use the file name available when selecting
Reports > report_name > Properties from the DLO Console UI.
Any filter criteria and the output path where the report is stored are optional.
The report format is also optional. By default the report is generated and saved in
PDF. The default report format in the DLO global settings is not used by this
command.
Syntax:
DLOCommandu -Report -RDL <RDL File Name> [-O <Output Path>]
[-FC <Computer Name>] [-FU <User Name>] [-FD <Days>] [-T
<PDF | HTML | XML | XLS>]
Command options
Table 4-14 -Report Command Option
Option Description
-RDL <RDL File Name> The name of the .rdl file associated with the required
report. Report templates are specified in Report
Definition Language (RDL).
An RDL file name is required.
Examples:
DLOCommandU -Report -RDL DLOactiveevents_en.rdl -FD 3 -FC MyDesktop -O
C:\DLOReports -T PDF
227
DLO Command Line Interface Management Tools
Commands in Detail
This sample command generates a report of the Active Alerts for the machine
named MyDesktop in the past 3 days and stores the report in C:\DLOReports
folder.
For unique report identification, generated reports have a name which is the
.rdl file name appended by a time stamp. The time stamp includes year, day,
month, hours and minutes.
In this example, if the command is executed at 10.28 AM on 25 May 2012, it
generates the report file in the folder C:\DLOReports, with the name as
DLOactiveevents_en_201225051028.pdf.
-ListReport command
This command lists all of the reports available in DLO and the names of the
corresponding RDL files. The command does not accept any options.
Use this command to determine the RDL file name used as input to the
“-Report command” on page 226.
Syntax:
DLOCommandu -ListReport
-MigrateDomain command
This command is used to migrate a user from an old domain to a new domain in
trust.
Syntax:
DLOCommandu -MigrateDomain -OD <OldDomainName> -ND <NewDomainName> -U
<UserName>
Command options
Table 4-15 -MigrateDomain Command Option
Option Description
-ChangeProfile command
This command is used to change the profile assigned to the user(s). Here multiple
users can be assigned with the same profile.
228
DLO Command Line Interface Management Tools
Commands in Detail
Syntax:
DLOCommandu -ChangeProfile -NP|-NPI [-A|-F|-P|-PI|-S |-SI|-U]|-UF
Note: Wildcard '*' match is permitted in profile, Storage Location, and user names.
Quotations around name are required if name contains a space or colon.
Command options
Table 4-16 Change Profile Command Options
Options Descriptions
-NPI <new SL path> Fully qualified UNC path to new network user data folder
-F <file server> Migrate users with storage locations on the named file server
-UF <text file name> Migrate user listed in the given text file.
Note: While running the above command, the text file should be
placed in the path C:\Program Files\Symantec\Symantec
DLO.
Examples:
DLOCommandu -ChangeProfile -NP newprof -A
-MigrateUserSL command
This command migrates an existing DLO user's NUDF from one storage location to
another location. Users are moved to the new storage location along with their data.
A storage location should be a CIFS-based network user data folder. A CIFS-based
network user data folder can be present on a Windows server and on certified NAS
devices that support CIFS.
Users are disabled during a migration until the client computer is notified that the
migration is complete. On successful migration, the DLO client automatically
restarts, the user is enabled and their profile is updated to point to the new storage
229
DLO Command Line Interface Management Tools
Commands in Detail
location. User’s data is not deleted from the old storage location. This deletion of
data needs to be done manually.
The command also monitors and reports on the progress of the migration (the
Migration status report). The command logs the operation updates and progress in a
log file and also displays the progress in a command window.
The following user status is used to show user’s NUDF migration to a new storage
location.
Data Migration in This message shows the status of the user when the user’sNUDF
progress migration to a new storage location is in progress.
In case the migration process is specifically interrupted, the user
status remains as Data Migration in Progress.
See “What happens if the migration process fails or is
interrupted?” on page 230. On successful migration the user is
enabled and their profile is updated to point to the new storage
location. User’s data is not deleted from the old storage location.
This deletion of data needs to be done manually.
Desktop Agent users can be migrated to new network storage locations based on the
following filter options:
■ User account name
■ Profile name
■ Profile ID
■ Storage location
■ Storage location ID
■ File server name
A new network storage location (the -NI or -NP options) and one of the eight filter
options for the user must be specified.
Syntax:
DLOCommandu -MigrateUserSL [-NI <new SL id>|-NP <new SL path>] [-A|-F
<file server>|-P <profile name>|-PI <profile id>|-S <SL name>|-SI <SL
id>|-U <user>|-UF <text file path>]
Note: Wildcard '*' match is permitted in profile, Storage Location, and user names.
Quotations around name are required if name contains a space or colon.
To get a list of all storage locations use the -ListSL command.
230
DLO Command Line Interface Management Tools
Commands in Detail
Command options
Table 4-17 Migrate USer SL Command Options
Options Descriptions
-A All users
-F <file server> Users with storage locations on the named file server
Examples:
The following examples show you how to use the command options:
DLOCommandu -MigrateUserSL -NI DLO_SL02 -A
DLOCommandu -MigrateUserSL -NI DLO_SL03 -U SUS\mmouse
Case 1
Migration process fails due to issues such as data size mismatch on the source
and destination administration servers.
If the migration process fails due to issues like network outage, the partially
migrated files are deleted from the new storage location. Any new backups are stored
in the original storage location. All the data needs to be recopied again.
231
DLO Command Line Interface Management Tools
Commands in Detail
The migration procedure must be followed again to migrate the NUDF to another
storage location.
Case 2
Migration process is specifically interrupted.
If you interrupt the migration process with a kill command or a system shutdown,
the user status appears as Data Migration in Progress. The status of the computer
user is also disabled. The partially migrated files remain on the new storage location.
In this case, this user and the respective computers must be enabled using the DLO
Administration Console. The partially migrated files should also be removed from
the new storage location.
The migration procedure must be followed again to migrate the NUDF to another
storage location.
-MigrateUser command
This command migrates single or multiple users from one Administration Server to
another Administration Server. The user’s data can now be accessed from the
destination Administration server. All user-specific settings such as customized
backup selection and policies are migrated along with the user.
The command also monitors and reports on the progress of the migration (the User
Migration Status Report). The command logs the operation updates and progress in a
log file.
The user that is migrated is disabled until the client computer is notified that the
migration is complete. Upon successful migration, the DLO client automatically
restarts and connects to the new Administration Server.
The following are the status messages for user migration:
User Migrated Indicates the status of the user on the source administration
server after the user is successfully migrated.
User Migration in Indicates the status of the user on the source administration
progress server while the user is migrated.
If the migration process is specifically interrupted, the user
status appears as User Migration in Progress.
232
DLO Command Line Interface Management Tools
Commands in Detail
DLO Versions The source and the destination administration servers must have
the same DLO versions and same patch levels.
Shared Clients The user that is migrated must not share the client computer
with any other user.
Dedupe Server The source and destination Dedupe Servers must be on the same
domain or on a trusted domain.
Dedupe Storage Pools On the destination administration server, configure the same
Dedupe Storage Pool that is present on the source administration
server.
The name of the Dedupe Storage Pools on the destination
administration server must be exactly the same as the Dedupe
Storage Pools on the source administration server.
Note: Wildcard '*' match is permitted in profile, Storage Location, and user
names.
Quotations around name are required if name contains a space or colon.
To get a list of all storage locations, use the -ListSL command.
234
DLO Command Line Interface Management Tools
Commands in Detail
Command options
Options Descriptions
-F <file server> Migrate users with storage locations on the named file server
-UF <text file path> Migrate users listed in the given text file.
Options Descriptions
Case 1
Migration process fails due to issues such as network outage.
In a multiple-user migration process, only one user is migrated at a time.
A rollback operation occurs if the migration process fails due to the following issues:
■ Network outage
■ Sharing of the client computer by multiple users during the migration
In these cases, the following takes place:
■ Migrated users are not affected. These users are successfully migrated to the
destination administration server. The status for these users appears on the
source administration server as User Migrated.
■ Users that are not migrated still exist on the source administration server. See
the migration procedure in the preceding sections to migrate these users to the
new administration server.
■ Users that were in the process of migration are affected. A rollback operation
follows and the particular user on the source administration server rolls back to
its previous status (Enabled/Disabled). Also, the user profile points only to the
source administration server.
The migration procedure must be followed again to migrate this user to the new
administration server.
Case 2
Migration process is specifically interrupted:
In a multiple-user migration process, only one user is migrated at a time.
If the migration process is specifically interrupted say by issuing a kill command or
system shutdown, the following takes place:
236
DLO Command Line Interface Management Tools
Commands in Detail
■ Migrated users are not affected. These users are successfully migrated to the
destination administration server.
■ Users that were not migrated still exist on the source administration server. See
the migration procedure to migrate these users to the new administration server.
Users in the process of migration are affected. The status for this particular user
appears on the source administration server as User Migration in Progress. The
computers and the users of those computers are also disabled. The user and the
respective computers for that user must be enabled on the source administration
server by using the DLO Administration Console. Then, migrate the user with the
migration procedure.
-ListMachines command
This command lists all the DLO Agent machines that are connected to the DLO
Administration Console.
Syntax:
DLOCommandu -ListMachines |-v | -v <product version>
If you do not specify any parameters, by default, all machines connected to the
current DLO Administration
console is displayed at the command prompt.
To store the list in a file, provide a file name when you run the command.
DLOCommandu -ListMachines <file path>
Example DLOCommandu -ListMachines > C:\MachineList.txt
Optional parameters
Options Descriptions
-DeletePendingUser command
The -DeletePendingUser command deletes only those users that are in the
“DeletePending” state. This command does not delete the users’ NUDF data.
Syntax
DLOCommandu -DeletePendingUSer [-U]
237
DLO Command Line Interface Management Tools
DLO Command Line Interface Database and License Tools
Note: Wildcard ‘*’ match can be used with user name. Quotations around the user
name are required if the name contains a space or colon.
Option Description
Server
-server <computername>
Use this command to specify the computer on which DLO command-line functions
will take affect. You must have sufficient privileges on the specified computer to
perform functions remotely.
Example DLODBUtils -server server1 -backup
Verbose
-verbose
Use this command to turn on verbose mode and display additional detail when DLO
command-line operations are performed.
Example DLODBUtils -verbose -backup
238
DLO Command Line Interface Management Tools
DLO Command Line Interface Database and License Tools
Check database
-check
This command performs a consistency check of the DLO database. If there are any
consistency errors, you should run the Repair Database command. See “Repair
database” on page 239.
Backup database
-backup -dir <backup directory>
This command allows you to back up the DLO database to a specified directory.
Example DLODBUtils -backup -dir "c:\backups\DLODatabase"
IDR
This command copies and recovers DLO Intelligent Disaster Recovery (IDR) MSDE
database files.
-setupidr
Makes a copy of the MSDE database files.
Example DLODBUtils -setupidr
-idr
Restores the MSDE database files saved with the -setupidr command. The
computer must be restarted following the execution of this command to make
the changes effective.
Example DLODBUtils -idr
Restore database
-restore -databasefile
This command restores the database from a specific backup file.
Example DLODBUtils -restore -databasefile
"c:\backup\DLO.bak"
Routine Maintenance
The following commands are used to perform routine maintenance. The options
outlined in “Command Line Options” on page 237 may be used with these
commands.
Compact database
-compact
Compresses the database by removing a database’s unused space.
Example DLODBUtils -compact
Rebuild index
-rebuildindex
Rebuilds the index for the DLO database.
Example DLODBUtils -rebuildindex
Repair database
-repair
Repairs the DLO database
Example DLODBUtils -repair
Groom alerts
-groomalerts days
Removes alerts older than a specified number of days.
Example DLODBUtils -groomalerts 5
Database Management
Attach database
The attach command makes the DLO database available to the database engine.
Note: Exclusive database access is required to run the -attach command. Stop the
DLO Administration Service before running this command and then restart the
services after running the command.
-attach -datafile <database file name> -logfile <database log file name>
Example DLODBUtils -attach -datafile "c:\backup\DLO.mdf"
-logfile "c:\backup\DLO.ldf"
240
DLO Command Line Interface Management Tools
DLO Logging Command Line Interface Tool
Detach database
Note: Exclusive database access is required to run the -detach command. Stop the
DLO Administration Service before running this command and then restart the
services after running the command.
License Management
These command-line tools enable license management from the command line.
List licenses
-list
Lists current DLO licenses.
Example DLOLicenseCLI.exe -list
Add licenses
-add <license key>
Adds the specified license key.
Example DLOLicenseCLI.exe -add <license key>
Delete licenses
-delete <license key>
Deletes the specified license key.
Example DLOLicenseCLI.exe -delete <license key>
Syntax
DLOLoggingu -E <DLO component Executable name> [Options [-L |
-LS]]
241
DLO Command Line Interface Management Tools
DLO Logging Command Line Interface Tool
Note: In a distributed DLO environment, the DLO Logging command-line tool will be
deployed in each machine where individual DLO component is installed.
Options Descriptions
-E
This option is used to specify the DLO component’s executable name for
which logging is to be enabled.
Example: To enable logging for DLO console component, specify
DLOConsoleu.exe as parameter for the -E option.
DLOLoggingu -E “DLOConsoleu.exe”
It is mandatory to specify the DLO component’s executable name. Else, the
command execution will not proceed.
-L
This option is used to specify the logging level with which the logging should
be enabled. Specify one of the following parameters along with the -L option.
■ Verbose (V): In this level, all Errors, Warnings, Traces and Function
Entry/Exit traces are printed.
■ Common (C): In this level, only Errors, Traces and Warnings are printed
to the log file.
■ Disable (D): In this level, all warnings and errors are printed to log files.
This value is set as default if no logging is specified in the command
line.
If you do not specify any parameter for this option, then by default logging
level is set to Disable, that is “D”.
Example: DLOLoggingu -E “DLOConsoleu.exe”
-LS
This option enables to specify the size of the log files.
Note: The value specified with this option is common for all the DLO
components for which logging will be enabled. This value will not set the log
size for individual DLO component.
If no log size is specified while running this utility for the first time, then the
default log size will be considered as 10 MB.
Example: DLOLoggingu –E “DLOAdminsvcu.exe” –L “V”
Once the log size is set, this value remains the same until you explicitly
change the log size using this option again.
242
DLO Command Line Interface Management Tools
Symantec DLO Log Gather Tool
Note: After you run the DLOloggingu command, for the new changes to take effect,
ensure that you restart or relaunch the DLO console, DLO client and the DLO
services for which logging is enabled.
Example
To enable verbose logging for DLO Administration service, run the following
command:
DLOLoggingu –E “DLOAdminsvcu.exe” –L “V” –LS “20”
After executing this command, restart the DLO administration service for the new
changes to take effect.
Note: DLOGatherU.exe gathers product logs from Symantec DLO 7.0 onwards.
Note: The tool also depends on DLODBUtils.exe to collect the DB backup, and
DLOCommandu.exe to collect information about users, profiles, and computers.
Therefore, check whether the machine on which DLO is installed is 32-bit or 64-bit,
and then run the appropriate version of the tool on that machine.
4 Enter the path of the directory or click Browse to select the output directory
where the gathered logs should be saved.
5 In the Additional files to gather field, enter the file names or click Browse to
select the additional files to be gathered.
6 Click Add Files.
7 Click Gather to start collecting the selected logs.
Once the process is completed, a file is created in the selected output directory in the
following format: IncidentNumber_MachineName_CurrentTime.cab
Troubleshooting
When you are using Windows 2003 server, the operating system logs of installed
applications that will be stored in the installed_apps.txt file is empty.
Solution
In Windows 2003 server, you must install the WMI Windows Installer Provider.
1 In the Windows Control Panel, select Add or Remove Programs.
2 Select Add/Remove Windows Components.
3 In the Windows Components Wizard, select Management and Monitoring Tools
and then select Details.
4 In the Management and Monitoring Tools dialog box, select WMI Windows
Installer Provider.
5 Click OK.
6 Click Next.
7 Follow the instructions in the wizard.
The Garbage Collection tool tries to accomplish as much as possible in the specified
duration, and exits once the time limit is reached. If the job is not completed in the
specified duration, then the tool continues the job from where it was stopped in the
previous run.
If the garbage collection process completes before the specified duration, then the
tool immediately exits, and the Dedupe Server resumes with backup and restore
operations.
The administrator can do regular scheduling of garbage collection by using the
Windows Task Scheduler.
Your profile determines the level of interaction between you and the Desktop Agent.
The administrator may also configure the Desktop Agent to run without a user
interface, with a fully functional user interface, or somewhere in between.
Item Description
Item Description
Note: You must have administrative rights to the desktop on which you want to
install the Desktop Agent. If you need to restart the desktop during installation, you
must use the same administrator login again to ensure that the installation
completes successfully.
Note: If you connect to the administration server with one set of credentials, and
then attempt to connect to the server with a different set of credentials,
authentication may fail. Restart the computer to reconnect.
When new information is available for the Desktop Agent, the Desktop Agent
receives a notification of this new information and retrieves it. This will happen, for
example, when settings or synchronized files change or if a software update is
available. The Desktop Agent and the DLO Administration Server do not contact
each other directly.
Caution: If you attempt to connect to a server using characters in the share name
that do not exist on the code page for the local system, the connection will fail. Code
pages map character codes to individual characters, and are typically specific to a
language or group of languages.
249
Administering the Desktop Agent
Configuring the Desktop Agent
Note: For information on resetting accounts that have been disabled for Desktop
Agent operation, see “To reset dialogs and account information” on page 251.
Item Description
Use this account Select this option to enable the Desktop Agent to run
when you are using the account under which you are
currently logged on.
User name Enter the user name for an account that is authorized for
Desktop Agent operation.
Domain Type the domain for the account to be used for Desktop
Agent operation.
251
Administering the Desktop Agent
Configuring the Desktop Agent
Item Description
Save my password Select this option to have DLO save and use this
password in the future to automatically authenticate to
the media server or storage location in the event of an
authentication failure.
Disable this account Select this option to prevent the Desktop Agent from
running when you are using the account under which
you are currently logged on.
3 Click OK.
■ Files are not transferred to the network user data folder. Pending files remain in
the pending files list with a status of “Pending network”
■ Job logs are not copied up to the network user data folder
■ Alerts are not posted to the DLO Administration Server
Note: The DLO Administrator sets a maximum time after which the Desktop Agent
will automatically be returned to the online mode, assuming a network connection is
available.
Item Description
Menu bar The menu bar appears across the top of the screen. To display a menu, click the
menu name. Some menu items are not available until an item is selected from
the console screen.
Tasks bar The Tasks bar appears on the left side of the Desktop Agent Console. To hide the
Tasks bar, from the View menu, select Tasks bar. Actions are initiated from the
Tasks bar, and these actions vary with the selected view.
Views menu The Views menu appears in the Tasks bar and enables you to navigate to the
following views:
Status Provides job status, lists pending jobs, and summarizes recent backup activity.
See “Viewing the Desktop Agent Status” on page 281 for more information.
Backup Enables you to define what data is protected by the Desktop Agent. See “Using
Selections the Desktop Agent to Back up Your Data” on page 256 for more information.
Synchronized Enables you to configure the Desktop Agent to maintain a user’s selected files
Selections and folders on multiple computers so that the most recent backed up version is
always available to the user. See “Synchronizing Desktop User Data” on
page 277 for more information.
Restore Enables the user to restore backed up data and search for backed up files. See
“Restoring Files Using the Desktop Agent” on page 286 for more information.
Tasks menu Actions are initiated from the tasks menu. These actions vary with the selected
view.
Tools menu
Note: To ensure that you have the latest status and settings at any time while using
the Desktop Agent, from the Tasks menu, click Refresh.
256
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
Caution: If you attempt to connect to a server using characters in the share name
that do not exist on the code page for the local system, the connection will fail. Code
pages map character codes to individual characters, and are typically specific to a
language or group of languages.
For information on backing up and restoring Microsoft Outlook PST files, see
“Backing up Outlook PST Files Incrementally” on page 265 and “Restoring Microsoft
Outlook Personal Folder Files” on page 289.
Select files that you want to protect from the Backup Selections view. Backup
selections are initially assigned by the administrator, but if the DLO administrator
has set your profile so that you can view the complete Desktop Agent and modify
settings, then you can choose your backup selections.
You can change Desktop Agent settings and backup selections when you are working
offline. The settings will be stored until you are once again working online, at which
time they are automatically transferred. If the administrator has also made changes
that conflict with the changes made on the Desktop Agent, the changes made by the
administrator will be used.
You can view and modify backup selections using two views: standard and advanced.
The standard view lists the contents of your local drives, allowing you to check off
files and folders to be backed up. It also uses default backup selection settings to add
new selections. The advanced view provides more configuration options for
selections.
A backup selection consists of:
■ A folder or list of folders
■ Criteria for the files to be included or excluded from the backup
■ Limits on the number of file revisions to retain
■ Settings for compression, backup file deletion, and encryption
Managing Revisions
Revisions are versions of a file at a specific point in time. When a file is changed and
backed up, DLO stores a new revision. DLO stores and maintains a specific number of
257
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
revisions for all files in a backup selection. Because each backup selection is
configured separately, the number of revisions retained can vary for different
backup selections.
When the number of revisions is exceeded, DLO removes the oldest revision,
maintaining only the specified number of revisions in the desktop and network user
data folders.
You can limit the number of revisions DLO retains in a given period of time. If you
are working on a document and backing it up frequently, all of your revisions could
potentially be just a few minutes apart. By specifying that you want to retain only 2
revisions every 24 hours, at least 120 minutes apart, you can retain older revisions
for a longer period of time. While some intermediate versions will not be retained, it
does support situations in which returning to an older revision is needed.
Another consideration in determining the number of revisions to retain is the
amount of storage space required to store the data. The amount of space required for
backups can be estimated by multiplying the number of revisions retained by the
amount of data protected.
Example If you are retaining three revisions of each file
and have 10 MB to back up, approximately 30 MB of
disk space will be required.
Although compression can improve the space utilization, it varies significantly with
file type and other factors.
File Grooming
The Desktop Agent grooms revisions based on backup selection settings and does
this as new revisions are created. The oldest revision is deleted when a new revision
is created that exceeds the limit.
Maintenance grooming is the grooming off of deleted files. It occurs at most once
every 24 hours. Maintenance grooming occurs during the first backup that runs after
24 hours have passed since the last maintenance grooming.
258
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
Note: Profile backup selections are those that were specified by the DLO
administrator in your profile. You cannot modify profile backup selections in the
Standard view. You can only modify the backup selections that you create on the
Desktop Agent. Profile backup selections are displayed in the Standard view with
gray check boxes. They can be modified in the Advanced view if the administrator
has granted you sufficient rights. See “Modifying Backup Selections in the Advanced
View” on page 264 for more information.
When you create new backup selections in the standard view, the default backup
selection settings are used. When you add new sub folders and files to the backup
selection using the standard view, these new backup selections will have the same
settings as the main folders.
In the Desktop Agent Backup Selection Standard view, files and folders are
represented in a tree view where users can select or deselect files and folders for
backup. When the check box next to a file or folder is grayed out, the selection was
defined by the administrator and can only be changed if the administrator has
granted this right in the profile definition. When a red 'X' appears in the check box
259
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
next to a file or folder, this item has been globally excluded from all backups by the
administrator and cannot be selected.
Note: To return to the last saved settings at any time, click Undo changes.
4 Click Save changes to save the new settings or Undo changes to return to the last
saved settings.
After clicking Save, previously backed-up selections that were not selected are
treated like deleted backup selections and will no longer be backed up. The
backup files for this selection will be deleted after the number of days specified
in the backup selection settings. The source files for the deleted backup
selection will not be deleted by the Desktop Agent.
Selected folders that were not previously selected are added to the backup
selections for this desktop.
Item Description
Item Description
Folder to back up
Type a folder name Select this option to add a specific folder to the backup
selection. Type the path to the folder, including the
folder name. For example, to add a folder named MyData
on drive C, type C:\MyData.
Select a pre-defined Select this option to choose a pre-defined folder from the
folder list provided.
Include sub folders Select this option to also back up all sub folders in the
specified directory. This option is selected by default.
5 From the Include/Exclude tab, select the appropriate options as described in the
following table.
Item Description
Include all file types Select this option to include all file types in this backup
selection.
Include and exclude only Select this option to include or exclude only specific files
the items listed below or file types.
6 To add a filter to the Include/Exclude list, verify that you selected Include and
exclude only the items listed below in step 5, and click Add Include or Add
Exclude.
7 If you selected Add Exclude, you will be notified that all previously backed up
files matching this exclude will be deleted from this backup selection. Click Yes
to continue or No to cancel.
261
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
Item Description
9 Click OK.
10 From the Revision Control tab, select the appropriate options for both the
Desktop and network user data folders as described in the following table.
Table 5-7 describes the options.
Item Description
Number of Revisions
desktop user data folder Type the number of revisions to keep in the desktop
user data folder for each file in the backup selection.
Item Description
network user data folder Select the number of revisions to keep in the
network user data folder for each file in the backup
selection.
Revision Age
Discard all revisions in the Enter the number of days after which all revisions in
desktop user data folder older the desktop user data folder will be deleted.
than Note: The latest revision will not be discarded.
Discard all revisions in the Enter the number of days after which all revisions in
network user data folder older the network user data folder will be deleted.
than Note: The latest revision will not be discarded.
263
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
11 From the Options tab, select the appropriate options as described in the
following table.
Item Description
Delta File Transfer If you choose Delta File Transfer, each time a file is backed
up, only the part of the file that has changed is transferred
and stored in the network user data folder. In addition, Delta
file transfer uses compression. Enabling this option requires
that the DLO administrator has installed and configured a
maintenance server.
Compression When you select compression, each time a file is backed up,
files in this backup selection will be compressed for data
transfer over the network and for storage in the Desktop and
network user data folders.
This affects files created after this feature is activated.
Previously stored files will not be compressed.
Delta File Transfer also uses compression.
Encryption Select this option to encrypt files for transfer and to store
files from this backup selection in an encrypted format in
the network user data folder.
This affects files transmitted and stored after this feature is
activated. Previously stored files will not be encrypted.
The AES (Advanced Encryption Standard) and a 256 bit key
length are used. If enabled, versions are stored without
encryption in the desktop user data folder, and encrypted in
the network user data folder. Transfer over the network is
encrypted.
When source files are deleted, delete the backed up files from the
desktop user data Indicate the number of days after which DLO will delete all
folder after file versions from the desktop user data folder after the
source file has been deleted from the desktop. The default
setting is 60 days.
network user data Indicate the number of days after which DLO will delete all
folder after file versions from the network user data folder after the
source file has been deleted from the desktop. The default
setting is 60 days.
Note: Outlook must be the default mail application to perform incremental backups
of Outlook PST files.
The following limitations should be considered when backing up Outlook PST files
incrementally:
■ Some of the DLO options are not used, even if they are enabled. These options
include Delta File Transfer, Compression, and Encryption.
DLO relies on Microsoft's Messaging Application Programming Interface (MAPI)
code to perform the actual backup of PST files. Using MAPI does not allow the
use of these DLO options during an incremental backup.
This is a limitation of the way the incremental backups are performed and is
normal behavior for backups of Outlook *.pst files. This limitation only applies
to incremental backups and does not apply to non-incremental PST backups.
■ When Outlook PST files are backed up incrementally, only one revision is
maintained regardless of the number of revisions set in the backup selection.
■ When you restore Microsoft Outlook PST files, the restored PST file will differ
from the original PST file as explained in Restoring Microsoft Outlook Personal
Folder Files on page 289.
■ Synchronized files cannot be backed up incrementally.
266
Administering the Desktop Agent
Using the Desktop Agent to Back up Your Data
■ When a DLO profile is configured to limit the bandwidth usage during data
transfer to the network user data folder, bandwidth is not limited during the
incremental transfer of PST files.
Related topics
“Setting Customized Options” on page 271
Note: If you do not intend to use Outlook as your default mail application, you can
disable the warning message about incremental backups in the Desktop Agent by
selecting Settings in the Views menu, and by clearing the enable incremental
backups of Outlook PST files check box in the Options tab.
Related topics
“Restoring Microsoft Outlook Personal Folder Files” on page 289
Note: When a DLO profile is configured to limit the bandwidth usage during data
transfer to the network user data folder, bandwidth is not limited during the
incremental transfer of Lotus Notes NSF files.
Lotus Notes must already be installed before the Desktop Agent is installed. If Lotus
Notes is installed after the Desktop Agent, you must run the Desktop Agent installer
again to repair the installation. Additionally, if Lotus Notes is open during the
Desktop Agent installation, Lotus Notes must be restarted.
Lotus Notes email files can only be backed up incrementally with DLO if the e-mails
have been archived. Once emails are archived, the resulting archive file can be
backed up incrementally. See the Lotus Notes documentation for information on
archiving e-mails.
To configure the Desktop Agent for incremental backup of Lotus Notes files
1 Verify that Lotus Notes was installed before the Desktop Agent was installed, or
that the Desktop Agent installer was run again after Lotus Notes was installed to
repair the installation.
268
Administering the Desktop Agent
Modifying Desktop Agent Settings
The Desktop Agent will continue to use settings specified in the profile until you
specifically elect to use customized schedules or options as described in “Changing
Backup Job Schedule Options” on page 269 and “Setting Customized Options” on
page 271.
You can change Desktop Agent settings and backup selections when you are working
offline. The settings will be stored until you are once again working online, at which
time they are automatically transferred. If the administrator has also made changes
that conflict with the changes made on the Desktop Agent, the changes made by the
administrator will be used.
Note: Changing settings on one Desktop Agent causes settings to be loaded on other
Desktop Agents that use the same authentication. This will cancel and restart any
running jobs.
Item Description
Use Profile schedule Select this option to use the scheduling options specified
in the profile.
Use custom schedule Select this option to specify a customized schedule that
differs from the profile schedule.
270
Administering the Desktop Agent
Modifying Desktop Agent Settings
Item Description
Run jobs:
Manually Select this option to run a backup only when you initiate
it.
Logout/Restart/Shutdown options
Prompt user to run job Select this option to display a prompt that asks if a
backup should be run before proceeding with the logout,
restart or shutdown.
Run job immediately Select this option to back up waiting files without
prompting before proceeding with a logout, restart or
shutdown.
Item Description
Run job as scheduled Select this option to proceed with a logout, restart or
shutdown and back up files according to the schedule.
Run job at next login Select this option to proceed with a logout, restart or
shutdown without prompting, and run a job the at the
next login.
Item Description
Use Profile options Select this option to use the scheduling options specified
in the profile.
Use customized options Select this option to specify a customized schedule that
differs from the profile schedule.
Item Description
Limit disk space usage Select this option to limit the amount of space used on
on my computer to: the computer to store backup files.
%
Select % to enter a percentage of the hard disk space
that can be used to store backup files.
MB
Select MB to enter the maximum number of megabytes
of disk space that can be used to store backup files.
Keep log files for a Specify the minimum number of days to keep log files.
minimum of (days) Log files will not be deleted until they are at least as old
as specified.
After minimum number of Enter the maximum combined size of all log files to be
days, delete oldest log files retained before the oldest log files are deleted.
when combined size
Note: You may have more than the specified number of
exceeds
MB of log files stored if none of the log files are as old as
specified in the Keep log files for a minimum of (days)
setting.
Logging options
Log groom messages Select this option to create logs for grooming operations.
Log information messages Select this option to create logs for all backup
for backup operations.
Log warning messages Select this option to create logs for all operations that
generate warnings.
273
Administering the Desktop Agent
Modifying Desktop Agent Settings
Item Description
Enable message level Select this check box to enable the configuration of DLO
incremental backups of for incremental backup of certain Lotus Notes NSF files.
Lotus Notes email files Additional steps may be necessary to insure backup of
these files. See “Backing up Lotus Notes NSF Files
Incrementally” on page 267 for more information.
To prevent the incremental backup of Lotus Notes files,
clear this check box.
4 In the Browse for folder dialog box, choose a new location for the desktop user
data folder.
5 Click OK.
6 When prompted to continue, click Yes.
7 Click OK.
One connection policy that matches a specific user or computer disables backups to
the network user data folder of all files over 500 KB. A second connection policy that
also matches the computer or user disables all backups to the network user data
folder. The second policy will be used because it is more restrictive to limit all
backups than just backups of large files.
Item Description
Connection Type
Disable network backup Select this option to prevent users from backing up to
the network user data folder. Backups will continue to
the desktop user data folder.
276
Administering the Desktop Agent
Modifying Desktop Agent Settings
Item Description
Disable network backup Select this option to prevent users from backing up files
for files greater than larger than a specified size based on the connection type.
Enter a file size in KB.
Limit network bandwidth Select this option and enter a value in KB/sec to restrict
usage to the usage of network bandwidth to the specified value.
Enforce policy according Select this check box to enable the connection policy to
to scheduled window apply only during the specified period of time.
Click Schedule to set the time during which the policy
will be in affect. Schedules can be set to run weekly or
for a specific date range.
3 If you selected Active Directory in step 2 above, configure the Active Directory
settings as described in the following table and click OK.
Item Description
All objects in this directory Select this option to apply the connection policy to
all objects in this directory.
Only the objects in this directory Select this option to apply the connection policy
that match the criteria below only to those objects in the directory that match the
specified criteria.
Note: A desktop must have the same owner and must be backed up with the
Desktop Agent to appear in the Synchronized Selections view. Only backed up
folders are available for synchronization.
Note: When a synchronized selection is deleted, the backup files are deleted in the
same manner as when source files are deleted. They will be groomed away after the
number of days specified in the backup selection.
1 Under Views in the Desktop Agent Tasks bar, click Synchronized Selections.
2 Click the Advanced View radio button.
3 Click the synchronization selection to be deleted.
4 Click Remove.
5 When prompted, if you want to delete the backup selection, click Yes to continue
or No to cancel.
281
Administering the Desktop Agent
Synchronizing Desktop User Data
Item Description
Show/Hide Pending Files Hides or displays pending files. This selection toggles
between Hide pending files and Show pending files when
you click the link.
Usage Summary
282
Administering the Desktop Agent
Synchronizing Desktop User Data
Item Description
Network Usage Displays the total amount of data stored in the network user
data folder for this computer.
Local Usage Displays the total amount of data stored in the desktop user
data folder on this computer.
Details This link is located just below the status summary and
provides detailed information on folder usage for user data.
For more information, see “Viewing Usage Details” on
page 283.
Note: The DLO administrator sets the maximum time after which a suspended job
will resume.
■ The disk space available on the network and desktop computer for storing your
data
■ An option to immediately delete old revisions and deleted files
■ Links to additional information and help
Note: The link to usage details is only available when the Desktop Agent is idle. It will
not be shown when a job is running.
Item Description
Usage
Item Description
Additional information
View last job log Click the button to open the Log File Viewer. For more
information on the log file viewer, see “Monitoring Job
History in the Desktop Agent” on page 290.
286
Administering the Desktop Agent
Restoring Files Using the Desktop Agent
Note: DLO can overwrite a file which is in use by staging the file to be restored
when the computer restarts. Using this feature requires administrative rights
on the Desktop Agent computer. Alternatively, the file can be restored by first
closing the application which is using the file, or by restoring the file to an
alternate location.
To restore data
1 Under Views in the Desktop Agent Tasks bar, click Restore.
2 In Show, select one of the following revision display options.
Item Description
Latest revision Only the latest file revision will be displayed and
available as a restore selection.
Revisions modified on If selected, enter a date and time after which revisions
or after will be displayed and available as restore selections, then
click OK.
Note: When you delete a file, the backup files are retained until they are deleted
by the file grooming process. If an original file has been deleted, but backup files
are still available, the icon for the file in the restore view will have a red ‘x’ to
indicate the deletion of the original file. See “File Grooming” on page 257 for
more information.
4 Click Restore.
288
Administering the Desktop Agent
Restoring Files Using the Desktop Agent
5 Select the appropriate options as described in the following table and then click
OK.
Table 5-17 Restore Dialog Box Options
Item Description
Restore to the original Select this option to restore files and folders to their
folders on this computer original location.
Redirect the restore to an Select this option to restore files and folders to an
alternate folder on this alternate folder on the same computer.
computer
Preserve folder structure Select this option to restore the data with its original
directory structure. If you clear this option, all data
(including the data in subdirectories) is restored to the
path you specify.
Options
Restore deleted files Select this option if you want to restore files even though
the source file has been deleted.
3 Select the appropriate options as described in the following table and then click
OK.
Item Description
Search for file names with this text Type all or part of the file name or folder you want
in the file name to find.
Within the past week Select this option to search for files modified in
the last calendar week.
Of the following type Select this check box to select a file type from the
list provided.
Of the following size Select this check box and then enter information
as follows:
■ Select from equal to, at least or at most in
the first drop-down menu
■ Type a file size
■ Select KB, MB, or GB
You can choose to view the backup history or restore history by selecting the
appropriate tab at the bottom of the History window.
Item Description
Files Transferred (Local) The total number of files transferred to the desktop
user data folder during the listed job.
Size Transferred (Local) The total number of bytes of data transferred to the
desktop user data folder during the listed job.
Files Transferred (Network) The total number of files transferred to the network
user data folder during the listed job.
This information is only available for the backup
history, not the restore history.
Size Transferred (Network) The total number of bytes of data transferred to the
network user data folder during the listed job.
This information is only available for the backup
history, not the restore history.
■ All logs with errors: History logs for all jobs that generated errors are
displayed.
■ Logs filtered by date: All logs generated after a specified date and time are
displayed. Enter the date and time after which logs are to be displayed in the
Filter by date dialog box and click OK.
4 Click the job history entry for which you want to view the history log.
5 To open the log file viewer, click View Log.
6 If required, click Save As to save the log file as a text file.
7 To exit the log file viewer, click Close.
Item Description
All log files Select this option to show all log entries in the log file
viewer.
Current log file Select this option to search only those log entries in the
current log file.
With timestamp of Select this check box to search only those log entries
within a specified time period. The options include:
Today: Show only log files that were created today.
Within the last week: Show all log files created in the last
week.
Between dates: Show all log files created between the
dates entered.
294
Administering the Desktop Agent
Monitoring Job History in the Desktop Agent
Item Description
Of the following type Select this check box to show only logs of the indicated
type. You may select one of the following types:
■ Backup
■ Restore
■ Move User
■ Maintenance
■ Error
■ Warning
With Filenames containing Select this check box and enter a filename, or file type.
Wildcard entries are supported.
Example: *gold.doc
Note: When using wild cards, you must use the ‘*’
wildcard. For example, *.tmp will return all results with
the .tmp extension while .tmp will return only files
explicitly named .tmp.
Filter
Informational entries only Select this option to display only informational entries.
Error and warning entries Select this option to display both error and warning
only entries.
Error entries only Select this option to display only error entries.
Warning entries only Select this option to display only entries for warnings.
4 Click Search.
5 To view detailed information for a log file entry, expand the tree view for the
entry and click the ‘+’ check box.
6 If required, click Save As to save the log file as a text file.
7 Click Close when finished.
Note: The user should have local administrator privileges or should log in with
domain administrator credentials to be able to perform the Agent repair installation.
Scenario Solution
Scenario Solution
WinCVS
When DLO runs concurrently with WinCVS, permission denied errors are sometimes
generated when checking out source. This error can be avoided by excluding any
directories named cvs using global excludes or backup selection excludes.
298
Troubleshooting
Troubleshooting the DLO Administration Console
Related topics
“Modifying Desktop Agent User Properties” on page 152
“Managing Desktop Agent Users” on page 149
“About Automated User Assignments” on page 129
“About DLO Profiles” on page 84
“Moving Desktop Agent Users to a New Network User Data Folder” on page 154
A desktop user ran the Desktop Agent and received an error indicating “Unable to configure the
Desktop Agent. No settings found for the current user and no automatic user assignments
match.” What does this indicate?
This message means that DLO could not find the user or an Automated User Assignment that
matched the user's domain and group.
Users are added to DLO either by an Automated User Assignment or by manually adding them.
In the first case, you use an Automated User Assignment that matches the user’s domain and
group. The Automated User Assignment assigns a profile and Storage Location to the Desktop
Agent and adds the user to DLO. Check that you have created Automated User Assignments that
match the domain and group to which the user belongs who is running the Desktop Agent.
You can also create an Automated User Assignment that covers all domains and all groups. This
method catches any users who might not match a more specific Automated User Assignment.
Such a “catchall” Automated User Assignment would typically be set to the lowest priority.
299
Troubleshooting
Troubleshooting the DLO Administration Console
The other option is to manually add users to DLO. This process requires that you assign a profile
and assign either a Storage Location or a user data folder to the new user.
Before running the Desktop Agent, be sure that the user has a matching Automated User
Assignment, or is added manually.
Related topics
“About Automated User Assignments” on page 129
When do I need a network user data folder, and when do I need a Storage Location?
Every Desktop Agent user must have a network user data folder, which is used to store backup
data. Storage Locations are locations on the network where network user data folders are
automatically created and maintained. They are not required if existing network shares are used
to store user data.
If you want DLO to automatically create network user data folders, use a Storage Location.
When new users are added to a Storage Location, network user data folders are automatically
created for them within the Storage Location.
Alternatively, if you would like to use existing network shares as network user data folders, or if
you want to create network user data folders manually, then do not use Storage Locations.
Related topics
“Configuring DLO” on page 72
I'm trying to create a Storage Location on a remote file server, and I am receiving an error
indicating the MSDE Database Instance for the Desktop and Laptop Option needs to have access
to the remote file server. What do I need to do?
To create Storage Locations on a remote file server, you must use an account that has
administrative rights on the remote file server. For details about creating the Storage Location,
see “Changing DLO Service Credentials” on page 37.
I manually added a new user and assigned the user to an existing Storage Location. I don't see a
new user data folder for the new user in this Storage Location. Isn't it supposed to create one?
User data folders are created only after the Desktop Agent is both installed on the desktop and
run by the new user.
How do I prevent a user from backing up data?
1 On the Navigation bar, click Setup. In the Settings pane, click Users.
2 Select the user you do not want to be able to perform backups.
3 Under General Tasks in the Task pane, select Properties.
4 Clear the Enable user check box.
5 Select OK.
The user's status will display as Disabled.
In a backup selection, I selected to encrypt or compress my user's data. However, data that has
already been backed up is not encrypted or compressed. Why is this?
300
Troubleshooting
Troubleshooting the DLO Administration Console
DLO does not retroactively apply changes to encryption and compression settings to user data
that is already backed up. Any data backed up after these settings have changed will use the new
settings.
I would like to prevent files of specific types from being backed up. How can I set up DLO to
always exclude files like *.mp3 or *.gho?
On the Tools menu, select Global Excludes. In this dialog box, you can add specific file types that
will be excluded in all backup selections for all profiles.
Backups do not seem to be running for all users, or specific files are not being backed up.
If backup jobs are not running for a group of users, check the profile for these users to verify
that backups are scheduled.
If specific files are not being backed up, review the backup selections in the profile to verify that
the files are selected for backup.
I just tried to restore a file, but it doesn’t appear to have been restored.
When restoring existing files to their original location, verify that you have selected Prompt or
Overwrite in the Restore dialog box to replace the file. If you select Do not overwrite, the file
will not be restored.
In a profile, I configured backup selections to encrypt files. Now I need to recover files for a user.
Do I need an encryption key to restore this data?
As an Administrator running the DLO Administration Console, you can redirect a restore of
encrypted user data to an alternate computer or location, and it will be decrypted during the
restore.
I would like to restore data to a user's computer, but that user is out of the office. Do I have to
wait until that user returns to the office before I can start the restore?
DLO can queue restore jobs to desktops. If the user is offline now, you can queue a restore job
through the Restore view in the DLO Administration Console.
Another option is to restore the data to an alternate location, such as the administration
computer or a network drive.
The History view in the DLO Administration Console doesn’t show the most recent backup for all
users.
The DLO Administration Console is automatically updated when a job runs, but not more than
once per hour.
I am not able to run either the -emergencyrestore, -migrateuser, or the -migrateSL command.
The error occurs because these commands should be run with a user account that has
administrator privileges.
If the user account does not have administrator privileges, then open the command prompt by
selecting the “Run as Administrator” option, and then run the specific command.
When I am clustering DLO Admin Service using domain user account, which is part of “Domain
Admin” group, the following error message is displayed: “This software will not run on a machine
that is not part of cluster.”
To resolve this issue, make sure that all the required rights/privileges are provided to this user
account or group. Also this user account should be local administrator on all computers that are
part of MSCS cluster or failover clustering.
For more information on configuring a user account for failover cluster, refer to the link:
http://technet.microsoft.com/en-us/library/cc731002%28WS.10%29.aspx
After installing DLO 7.5, when I migrate the DLO server from one domain to another domain, I am
unable to launch the DLO Administration Console.
SQL Server 2008 R2 that is shipped with DLO 7.5 does not support migration from one domain
to another domain.
When a BE 2012 or BE 2012 R2 product co-exists on the machine where DLO 7.5 is installed, and
when I try to launch the report from the DLO 7.5 Administration Console, a .rdl error occurs and
the report does not launch.
To resolve this issue, the DLORegKeySettingForReportU.exe must be run, which is now
available with DLO 7.5.
In a standalone setup, do the following:
Navigate to the product install path (example: C:\Program
Files\Symantec\Symantec DLO) and run the DLORegKeySettingForReportU.exe.
This tool resolves the .rdl error and you can launch the reports.
In a distributed environment setup, do the following:
On the DLO server machine, navigate to the path where DLO Administration service is installed
(example: C:\Program Files\Symantec\Symantec DLO), and run the
DLORegKeySettingForReportU.exe. This tool resolves the .rdl error and you can launch
the reports.
302
Troubleshooting
Troubleshooting the Desktop Agent
Any data backed up by a backup selection are eligible for synchronization. These backup
selections may be defined by the DLO Administrator in the profile or in a backup selection
created with the Desktop Agent.
I would like to share my synchronized data with my co-workers. How can I do this?
DLO does not provide functionality for sharing files between users. Synchronization is designed
to share files between a single user's computers.
DLO backup of Outlook PST files is slow during “Copying local” phase of the backup job.
When DLO performs a backup of an Outlook PST file, DLO copies the snapshot of the PST to the
Local User Data Folder (LUDF), and then it copies the file to the Network User Data Folder
(NUDF). During the first stage, the “Status” column in the Desktop Agent window displays the
status as “Copying local (x%)”. Sometimes, this “Copying local” phase can be very slow.
To find out if DLO is introducing a sleep mechanism, enable DLO Agent logging and capture the
slow backup job in the log.
Cause:
The “Copying local” phase can be slow due to one of the following reasons:
■ The PST file is very large. The snapshot still occurs on the entire PST file, even if it is only
doing a “Message level incremental”.
■ The local AntiVirus application may be slowing down the process. Try disabling AntiVirus
and observe the performance of the next backup job.
■ DLO may be doing disk throttling. DLO monitors the LogicalDisk Performance Counter
called “Current Disk Queue Length”. If the queue length exceeds 2 (default value of
2), DLO introduces a sleep mechanism during the “Copying local” phase of the backup jobs.
This is to prevent DLO from consuming disk cycles that other applications might need.
Example:
In the log file, look for lines such as:
diskthrottle.cpp(228) Read queue: 8.73956, sleeping for 2000ms
diskthrottle.cpp(228) Read queue: 4.50836, sleeping for 1254ms
diskthrottle.cpp(228) Read queue: 11.5639, sleeping for 2000ms
diskthrottle.cpp(228) Read queue: 3.54665, sleeping for 773ms
diskthrottle.cpp(228) Read queue: 2.85208, sleeping for 426ms
304
Troubleshooting
Troubleshooting the Desktop Agent
In the above example, it can be observed that DLO is introducing a sleep mechanism to prevent
over-throttling of the physical disk.
The average of the sum of the queue length above is 6.625. Rounding up = 7.
If logs suggest the performance delays are associated with disk throttling (as seen above) and
you have determined that it is alright for DLO to consume additional disk resources, these
registry adjustments will increase the threshold at which DLO engages disk throttling:
Note: DLO will divide the specified registry value by 10, so take the observed average queue
length and multiply by 10 to determine the value that you must implement in the registry.
1 Open regedit
2 Navigate to HKLM\Software\Symantec\DLO\3.0\Client.
3 Create a new DWORD value named DiskQueueLimit.
4 Type the value as 70 decimal.
5 Navigate to HKCU\Software\Symantec\DLO\3.0\Client.
6 Create a new DWORD value named DiskQueueLimit.
7 Type the value as 70 decimal.
8 Restart the Desktop Agent (do not just minimize and maximize it).
Note: The value of 70 was obtained by calculating the average read queue length during a slow
backup event and multiplying by 10. The value of 70 may not necessarily apply to all desktop
environments. Follow the logging example as explained above, to determine the average queue
length experienced on the problematic host, and apply the observed adjusted average to the
DiskQueueLimit registry key.
When I upgrade the Desktop Agent from 7.0 to 7.5 by using a different user account (instead of
the administrator account that was used to log on to the machine and install Desktop Agent 7.0
version), and when I try to access the existing desktop user data folder, the Desktop Agent goes
to disabled state with the following error: “Access denied. Failed to create recovery key.”
The error occurs because the user account may not have the privileges to access the existing
desktop user data folder.
To resolve this issue, follow these steps:
1 Right-click the desktop user data folder, and select Properties.
2 Select the Security tab and add the user account.
3 Click Apply.
The recovery key is created.
Before unclustering DLO from a cluster setup, the network user data folder (NUDF), DLO
database, and media server are moved from the virtual server disk to a local disk on the Desktop
Agent. After this process, when I launch the Desktop Agent, the following error message is
displayed: “Failed to load configuration settings”.
This error occurs because the DLO Administration server is down, and the notification has not
been updated in the Desktop Agent machine.
305
Troubleshooting
Remote DLO Agent and Push Install Maintenance Server
Note: This error may also occur for desktops and laptop users in a non-clustered setup.
To resolve this issue, manually update the registry keys of the NUDF, media server, and
database in the Desktop Agent machine.
1 Open Registry Editor.
2 Navigate to HKEY_LOCAL_MACHINE\Software\Symantec\DLO\Client.
3 Double-click the DefaultMediaServer, and change the name of the media server from
virtual server name to the host name of media server.
4 Navigate to HKEY_LOCAL_MACHINE\Software\Symantec\DLO\Client\UserShare
5 Double-click the user name and change the path of the network user data folder.
6 Navigate to HKEY_LOCAL_MACHINE\Software\Symantec\DLO\DB
7 Double-click the DBServer, and change the name of the database server from virtual
server to host name of DB server.
Note: Complete step 7 only when standalone DLO components are clustered. In case a
remote DB setup was used for clustering DLO, then step 7 is not required.
When I install Desktop Agent on a BitLocker enabled drive and later if I lock the drive and try to
launch the Agent, the following error message is displayed: “Access denied”.
To resolve this issue, unlock the drive and then launch the Agent.
Similarly, for NUDF and LUDF, ensure that you unlock the drive and then access the data.
The “Administration services are down” error is displayed after launching the console with
Remote DB.
You must ensure that ‘Symantec DLO SQL services’ and ‘SQL browser services’ on remote
database are started. If the error still persists, then start the ‘Symantec DLO administration
services’.
306
Troubleshooting
Troubleshooting the Dedupe Server
Change to:
<Connector connectionTimeout="20000" port="8181"
protocol="HTTP/1.1" redirectPort="8445" server=" "/>
2 Existing value:
<Connector SSLEnabled="true" SSLProtocol="TLS" clientAuth="false"
keystoreFile="dedupeserver.jks" keystorePass="dedupeserver"
maxThreads="1000" port="8443"
protocol="org.apache.coyote.http11.Http11NioProtocol"
scheme="https" secure="true" server=" "/>
Change to:
<Connector SSLEnabled="true" SSLProtocol="TLS" clientAuth="false"
keystoreFile="dedupeserver.jks" keystorePass="dedupeserver"
maxThreads="1000" port="8445"
protocol="org.apache.coyote.http11.Http11NioProtocol"
scheme="https" secure="true" server=" "/>
3 Existing value:
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
Change to:
<Connector port="8009" protocol="AJP/1.3" redirectPort="8445"/>
4 After changing the values in the server.xml file, add these port numbers in the firewall
exceptions.
5 Restart the Dedupe Server services.
Scenario 1:
While installing only the Dedupe Server on a machine, if I provide a different user account
(instead of the administrator account that was used to log on to the machine) for the SQL service,
307
Troubleshooting
Troubleshooting the Dedupe Server
I am not able to add the Dedupe Server and the following error message is displayed: “The
Dedupe details you have entered is invalid or there is no Dedupe Server running at the specified
location.”
Scenario 2:
While upgrading from Symantec DLO 7.0 to Symantec DLO 7.5, if I provide a different user
account for the SQL service, I am able to add Dedupe Server, but cannot manage the
Dedupe Server.
For these two scenarios, ensure that both SQL service and Dedupe Server service run with the
same user account.
To resolve this issue, follow these steps:
1 Change the Dedupe Server service’s user account to match the SQL service account.
2 To grant administrator rights to the user account that was used for SQL service, run the
following command.
Example
sqlcmd.exe -E -l 60 -S <SERVERNAME>\SQlEXPRESS -d DedupeDB -Q "EXEC
sp_addsrvrolemember 'testdomain\DBAdmin1', 'sysadmin'"
3 To update the dedupedb user_info table with the DLO administrator account, run the
following command:
sqlcmd.exe -E -S <SERVERNAME>\<INSTANCENAME> -l <TIMEOUT>-d DedupeDB
-Q "UPDATE user_info SET user_name='<DOMAIN\USERNAME>'"
Example
sqlcmd.exe -E -S A2SYMMD14906\SQLEXPRESS -l 60 -d dedupedb -Q
"UPDATE user_info SET user_name='<DOMAIN\USERNAME>'"
Options
-E: Uses a trusted connection instead of prompting for a password.
-l: The duration (in seconds) when the osql login is active.
-Q: Query.
Note: After adding the Dedupe Server, in case the user account does not have the privileges to
manage the Dedupe Server, then the following error message is displayed: “Could not
authenticate user.” In such a scenario, follow the same procedure to grant the administrator
rights.
On a Windows 2008 R2 machine, I have installed Symantec DLO 7.0 with administrator account.
While upgrading to Symantec DLO 7.5, if I use the domain administrator account, Dedupe
database is not getting attached, and the error message is displayed: “Unable to connect to
server. DLO Administration service is not running. Would you like to check the service credentials.”
To resolve this issue, follow these steps:
1 Log on to the Windows 2008 R2 machine using an administrator account. Example:
<domain>\administrator
2 Install the SQL Server and SQL instance using the same administrator account.
3 Install DLO 7.0 choosing existing SQL instance.
4 Add the domain user account (<domain>\<user name>) to local admin group.
308
Troubleshooting
Troubleshooting the Dedupe Server
5 Change the “SQL Server”, “SQL Agent” and “SQL Browser” services credentials to the
domain user account.
6 Set the SQL administrator role to the domain user by running the following command:
sqlcmd.exe -E -S <SERVERNAME>\<INSTANCENAME> -Q "EXEC
sp_addsrvrolemember 'testdomain\DBAdmin1','sysadmin'"
Example
sqlcmd.exe -E -S MachineName\SQLEXPRESS -Q "EXEC
sp_addsrvrolemember 'testdomain\DBAdmin1','sysadmin'"
7 Log off from the machine and log on with the domain user account.
8 Upgrade to DLO 7.5 by providing the domain user account in the “SQL Service Account”
and “DLO Administrator Account” screens.
The Dedupe database and all other components work properly.
In a remote DB scenario, the DLO server and DLO database machines are running with two
different login credentials. When I upgrade this remote DB setup from DLO 7.0 to DLO 7.5, I am
not able to configure the Dedupe Server and the following error message is displayed: “Failed to
authenticate server. Do you want to retry?”
To resolve this issue, manually add the user name to the “UserInfo” table in the Dedupe
database.
1 To add the domain user name to the DedupeDB user_info table, run the
following command:
sqlcmd.exe -E -S .\<INSTANECENAME> -d DedupeDB -Q "insert into
user_info values (5,'<DOMAINNAME\USERNAME>',NULL,1)"
2 Configure the Dedupe Server.
After installing the DLO components, how do I verify the status of the Dedupe Server?
Type one of the following URLs in your browser.
http://<dedupeserver_ip_or_hostname>:8080
or
https://<dedupeserver_ip_or_hostname>:8443
Response Remark
StoreSmart Dedupe Server Status: (20159) Dedupe Server is up and running after
Active installation.
StoreSmart Dedupe Server Status: (20157) Dedupe Server is up and running and
Garbage Collection In Progress GarbageCollection is in progress.
StoreSmart Dedupe Server Status: (20158) Dedupe Server is up and running and
Under Maintenance MaintenanceWindow is active.
If there is no response from the Dedupe Server, then it indicates that the Dedupe Server is not
initialized, and one of the reasons could be that the database connection is down. This issue will
309
Troubleshooting
Troubleshooting the Dedupe Server
I want to modify a Dedupe Storage Location but it is disabled in the DLO Administration Console.
You can modify the Dedupe Storage Location only when the Maintenance Window is scheduled.
For more information about scheduling the Maintenance Window see “Dedupe Server
Maintenance” on page 82.
When I try to initialize the Desktop Agent in offline mode I get an error 23522: “Dedupe Engine is
failed to initialize in offline mode.”
This error may occur if the metadata files are deleted from the local machine and the Desktop
Agent is initialized in offline mode. This issue is resolved when the Agent goes online.
310
Troubleshooting
Troubleshooting the Dedupe Server
Chapter 7
Accessibility
Symantec products meet federal accessibility requirements for software as defined
in Section 508 of the Rehabilitation Act:
http://www.access-board.gov/508.htm
Keyboard shortcuts are available for all graphical user interface (GUI) operations
and menu items. Symantec products are compatible with operating system
accessibility settings as well as a variety of assisting technologies. All manuals also
are provided as accessible PDF files, and the online help is provided as HTML
displayed in a compliant viewer.
The following topics explain the accessibility features and compliance in DLO:
■ “Keyboard Navigation and Shortcuts in DLO” on page 311
■ “General Keyboard Navigation within the GUI” on page 312
■ “Keyboard Navigation within Dialog Boxes” on page 312
■ “Keyboard Shortcuts” on page 314
■ “Support for Accessibility Settings” on page 315
While the controls described here are typically found in dialog boxes, they also can
occur in other contexts. The same navigation standards will apply.
CTRL+ PAGE UP Switches to the previous tab and displays the page.
RIGHT ARROR or When the focus is on a tab selector, chooses the next or previous tab in the current row
LEFT ARROW and displays the page.
List Boxes
List boxes display a column of available choices. Different types of list boxes are
available with additional navigation conventions:
■ Drop-down list boxes by default show only the selected item. A small button to
the right of the control shows a downward-pointing arrow. Select the arrow to
display more items from the list box. If there are more choices than can fit in the
preset list box area, a slider appears along the side of the list box. Show or hide
the list using ALT+DOWN ARROW, ALT+UP ARROW, or F4. The TAB key selects
an item.
■ Extended selection list boxes support selecting single items, blocks of items, or
combinations of the two. After selecting an item, hold down CTRL+navigation
keys to select or clear additional items or blocks of items.
314
Accessibility
General Keyboard Navigation within the GUI
Keyboard Shortcuts
All menu items can be selected by using accelerator or mnemonic keyboard
shortcuts. An accelerator is a key combination that provides shortcut access to a GUI
function. A mnemonic (sometimes referred to as a “hot key”) is a single-key
equivalent (used in combination with the ALT key) for selecting GUI components
such as menu items. The mnemonic “hot key” letter is underlined in the GUI.
Routine functions such as opening, saving, and printing files can be performed using
the standard Microsoft keyboard shortcuts. Other menu items are unique to DLO.
The following table lists the shortcut keys in the Desktop Laptop Option
Administration Console.
Table 7-2 Keyboard Shortcuts Unique to Backup Exec Desktop and Laptop Option Administration Console
ALT F The File menu expands. From the File menu, you can create new
profiles and Storage Locations, and add users.
ALT E The Edit menu expands. From the Edit menu, you can restore files,
search for files to restore, manage alerts, and delete items.
ALT V The View menu expands. From the View menu, you can change the
information that displays on the screen.
ALT N The Network menu expands. Use the Network menu to work with
administrator accounts, connect to the DLO Administration Servers
on the network, or to reconnect to a local DLO Administration Server.
ALT T The Tools menu expands. Use the Tools menu to set global excludes,
access all DLO wizards, and manage service credentials.
ALT W The Window menu expands. Use the Window menu to move to a new
window or view.
ALT H The Help menu expands.Use the Help menu to access documentation
and various Symantec web sites.
The following table lists the shortcut keys in the Desktop Agent:
ALT F The File menu expands. From the File menu, you can minimize or
exit the Desktop Agent.
ALT V The View menu expands. From the View menu, you can change the
information that displays on the screen.
315
Accessibility
General Keyboard Navigation within the GUI
ALT K The Tasks menu expands. Use the Tasks menu to run a job or refresh
the view.
ALT O The Tools menu expands. Use the Tools menu to reset dialog boxes
and accounts.
ALT H The Help menu expands. Use the Help menu to access the online
help for the Desktop Agent.
Select secondary menu items by opening the main menu and using the UP or DOWN
ARROW key until the required item is highlighted. Press the RIGHT ARROW key to
open a submenu, and ENTER to select your choice.
Keyboard shortcuts are not case-sensitive. Mnemonic keystrokes may be pressed
either sequentially or simultaneously. All menu items have mnemonics, but not all
menu items have accelerators.
Note: You can also set accessibility options through the Accessibility Wizard. On the
Start menu, select Programs, and then select Accessories. Select Accessibility, and
then select Accessibility Wizard.
Administrator
The user that configures DLO using the Symantec DLO Administration Console. This user must
have administrative rights to operate the console.
Authentication
The process of validating a user’s credentials.
Automated User Assignments
Rules that assign profiles and Storage Locations to a specified group of desktop users. Settings
are applied the first time a user runs the Desktop Agent.
Compression
A method of reducing data to expedite transmission time or storage volume.
Chunk
Uniquely identified data block.
Chunk Retrieval Information (CRI)
Location of data in the Dedupe Storage Location where it was written during backup. CRI is used
to read back the data during restore.
Chunk Signature
Hash value of the data block.
Dedupe Storage Location
A shared storage location on the network where data is stored.
Dedupe Storage Pool
Groups of Dedupe Storage Locations across which deduplication is performed.
DLO Administration Console
The administrator’s interface with the Desktop and Laptop Option.
DLO Backup Selection
The files and folders on a desktop or laptop that are selected for backup by the DLO
Administrator or desktop user.
DLO Database
The location where policy settings and status information are stored.
DLO File Server
The computer that hosts DLO Storage Locations.
Dedupe Database
Data store used by Dedupe Server for storing the configuration and Global Hash Table.
Delta File Transfer
Delta File Transfer is a compression process that allows only the changed portion of a file to be
transferred once the complete original file is backed up. Delta File Transfer reduces bandwidth
use and disk storage requirements.
Desktop Agent Install Share
318
Glossary
The network share where the Desktop Agent install files are located. This folder is set up on the DLO
Administration Server when DLO is installed, and facilitates the installation of the Desktop Agent on
desktops.
Desktop Agent
The DLO software that runs on desktop and laptop computers.
Desktop Agent Console
The user interface for the Desktop Agent software.
Encryption
A process used to ensure data security of files and folders on disk and during data transfer.
Global Hash Table
Table that maps data signature to CRI for the data that is stored in the Dedupe Storage Locations.
Open File Handling
The process by which files currently in use can be backed up.
Optimization
The process of reducing network traffic and file storage through technologies such as compression.
Profile
DLO settings configured by the administrator and that apply to users or groups of users.
Revision
A version of a file at a specific point in time.
Storage Location
A shared location on the network in which network user data folders and backup files are stored.
Synchronization
The process that maintains the most recent version of selected files and folders belonging to the same
user on multiple desktops. Synchronization is available for files and folders that are backed up by DLO.
Task
An accessible program function that varies with the view selected in the DLO Administration Console or
Desktop Agent console.
User
The person who operates the desktop or laptop computer on which the Desktop Agent is run.
User Data Folder
The folder in which user backup data is stored. There is a user data folder on each desktop that is
protected by the Desktop Agent, and one user data folder on the network for each Desktop Agent user.
User Name
The user name used for Windows authentication.
View
The main navigational interface in the DLO Administration Console.
Index
setting number to keep in DLO 109, 261 Desktop Agent backup selections 260
Search history log file option 176 DLO backup selections 107
Storage Location install
deleting 127 Desktop Agent
summary status 70 options 29
User Data Folder 121 installation
User Properties dialog box 152 silent 29
View history log file option 174
viewing users 156
dialog box, Move User 154
J
Distributed Configuration to Symantec DLO 61 job history
DLO Administration Console, restoring from 162 History view filters, setting in DLO 173
DLO Administration Server, connecting to 71 viewing in Desktop Agent 290
DLO Log Gather Tool 242 job monitor, DLO jobs, viewing 171
Domain/User Credentials 20
L
E License Management 240
e-mail Logging Command Line Interface Tool 240
configuring MAPI notification 185 Lotus Notes
configuring SMTP notification 183 back up nsf files 267
configuring VIM notification 186
Enable Dedupe 86 M
Enable Dedupe check box 102 macros, global excludes 141
encryption 164, 278, 300 maintenance mode 82
Encryption Type 77 MAPI e-mail notification method 185
encryption, backup selections, in DLO 111, 263 MAPI, configuring recipients 189
menus, described, Help 315
F -MigrateUser 231
file to add users in DLO, CSV 152 -MigrateUserSL 228
filters Migrating a Standalone BE-DLO 58
History view filters, setting in Desktop Agent Migrating BE-DLO Agent in Cluster Environment to
292 Symantec DLO 63
History view filters, setting in DLO 173 Migrating BE-DLO Agent to Symantec DLO 60
Migrating BE-DLO in a Cluster Environment to
Symantec DLO 62
G Migrating Users across Administration Servers 233
Garbage Collection Utility 243 Migration Status Report 230
global excludes modify a dedupe storage location 80
adding 134, 135, 136, 137, 138 Modifying a Dedupe Storage Pool 79
deleting 134, 135, 136, 137, 138 Move priority options in DLO 133
macros 141 Move User dialog box 154
glossary of terms 317
grooming
alerts 177
N
files 109 Net Send, configuring recipients 195
groups, configuring recipients 197 network user data folder, creating 150
notification, recipients 187
notifications
I configuring MAPI e-mail 185
include/exclude configuring pager 186
322 Index
S
P Schedule Maintenance Window 83
pager scheduling
configuring recipients 191 backup jobs in Desktop Agent 269
notification method 186 backup jobs in DLO 156
printer, configuring recipients 196 search
priority options in DLO, Move 133 log file history 176
priority, Automated User Assignment, changing 133 selections
Profile 84 Desktop Agent, backup 256
back up on log on/off option 156 DLO, backup 102
creating 84 service credentials, managing 37
edit schedule 97 set the maintenance schedule 82
logging options 98, 157 silent install 29
profile SMTP
copy 101 e-mail notification method 183
PST files, backing up 266 SNMP Trap
Push 31 configuring e-mail recipients 188
configuring recipients 194
R notifications 194
recipients storage limits for user data
configuring groups 197 Desktop Agent 271
configuring MAPI e-mail 189 Storage Location 121
configuring Net Send 195 deleting 127
configuring pager 191, 196 synchronization
configuring SMTP 188 create new sets 278
configuring SNMP Trap 194 delete synchronized folder 280
configuring VIM e-mail 190 overview 277
defined 187 Synchronized Selections view, in Desktop Agent 277
recovery password, setting 35
reports 200 T
running 202 Troubleshooting the Dedupe Server 306
viewing 200
Resetting Dialog Boxes and Account Information 251
Restore dialog box U
Desktop Agent 287 Unclustering DLO 206
restoring up on log on/off option in DLO, back 156
files, using Desktop Agent 286 Updating Symantec DLO with LiveUpdate 51
files, using DLO Administration Console 162 Upgrading DLO on a Microsoft Cluster Server 208
Index 323
V
viewing
Automated User Assignment properties 133
users in DLO 156
VIM
configuring recipients 190
e-mail notification method 186
W
wizard for DLO, configuration 72