NetBackup AdminGuide EntVault
NetBackup AdminGuide EntVault
for Windows
Release 7.5
Symantec NetBackup™ for Enterprise Vault™ Agent
Administrator's Guide
The software described in this book is furnished under a license agreement and may be used
only in accordance with the terms of the agreement.
Legal Notice
Copyright © 2012 Symantec Corporation. All rights reserved.
Symantec and the Symantec Logo 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 DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS,
REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO
BE LEGALLY INVALID. SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL
OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING,
PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINED
IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE.
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
http://www.symantec.com
10 9 8 7 6 5 4 3 2 1
Technical Support
Symantec Technical Support maintains support centers globally. Technical
Support’s primary role is to respond to specific queries about product features
and functionality. The Technical Support group also creates content for our online
Knowledge Base. The Technical Support group works collaboratively with the
other functional areas within Symantec to answer your questions in a timely
fashion. For example, the Technical Support group works with Product Engineering
and Symantec Security Response to provide alerting services and virus definition
updates.
Symantec’s support offerings include the following:
■ A range of support options that give you the flexibility to select the right
amount of service for any size organization
■ Telephone and/or Web-based support that provides rapid response and
up-to-the-minute information
■ Upgrade assurance that delivers software upgrades
■ Global support purchased on a regional business hours or 24 hours a day, 7
days a week basis
■ Premium service offerings that include Account Management Services
For information about Symantec’s support offerings, you can visit our Web site
at the following URL:
www.symantec.com/business/support/
All support services will be delivered in accordance with your support agreement
and the then-current enterprise technical support policy.
Customer service
Customer service information is available at the following URL:
www.symantec.com/business/support/
Customer Service is available to assist with non-technical questions, such as the
following types of issues:
■ Questions regarding product licensing or serialization
■ Product registration updates, such as address or name changes
■ General product information (features, language availability, local dealers)
■ Latest information about product updates and upgrades
■ Information about upgrade assurance and support contracts
■ Information about the Symantec Buying Programs
■ Advice about Symantec's technical support options
■ Nontechnical presales questions
■ Issues that are related to CD-ROMs, DVDs, or manuals
Support agreement resources
If you want to contact Symantec regarding an existing support agreement, please
contact the support agreement administration team for your region as follows:
The Enterprise Vault agent can also serve as a disaster recovery solution for data
that is archived with Enterprise Vault. Recovery of the archived data is not
dependent on the archive source, such as Exchange Server or a specific file system.
The NetBackup Enterprise Vault agent and its capabilities are provided as add-ons
to the NetBackup Windows client software. This agent is tightly integrated with
NetBackup and the Backup, Archive, and Restore interface. Thus, this manual
provides an overview of the Enterprise Vault agent functionality as it pertains to
NetBackup and the Backup, Archive, and Restore interface. Back up and restore
operations for the Enterprise Vault agent are identical to other NetBackup file
operations, except where noted.
Legend
Index
location
NetApp
Share
Partition Partition
1 2 Vault Store Partition 3 Vault Store Partition 1 Vault Store
database database database
NTFS NTFS
NetApp NTFS
Disk Share
Share Disk
The Enterprise Vault agent enables you to back up and restore the following
Enterprise Vault 8.0 or later components:
■ Enterprise Vault directory database
■ Enterprise Vault monitoring database
■ Enterprise Vault FSA Reporting database
■ Enterprise Vault auditing database
■ Enterprise Vault index location
For this release, NetBackup does not support any Enterprise Vault index
locations that are based on a mapped drive. If any index location in an
Introduction to NetBackup Enterprise Vault 15
About the Enterprise Vault Agent and the backup components
Enterprise Vault site is based on a mapped drive then there should not be any
backup selection that uses the EV_INDEX_LOCATION=EV Site Name directive.
■ Enterprise Vault archives (such as the open, closed, and ready partitions)
For this release, NetBackup does not support any Enterprise Vault partitions
that are based on a mapped drive. That applies to open, closed, and ready
partition components.
■ If an open partition is based on a mapped drive then there should not be
any backup selection that uses the EV_OPEN_PARTITION=Vault Store
Name (which contains that open partition) directive.
■ If a closed partition is based on a mapped drive then there should not be
any backup selection that uses the
EV_CLOSED_PARTITION=VaultStoreName (which contains that closed
partition) directive.
■ If a ready partition is based on a mapped drive then there should not be
any backup selection that uses the
EV_READY_PARTITION=VaultStoreName (which contains that ready
partition) directive.
Legend
Index
location
NetApp
Share
Partition Partition
1 2 Vault Store Partition 3 Vault Store Partition 1 Vault Store
database database database
NTFS NTFS
NetApp NTFS
Disk Share
Share Disk
Feature Description
Enterprise Vault backup The NetBackup Enterprise Vault agent supports full,
schedules differential-incremental, and cumulative-incremental
backups. These types of backups are configured in an
Enterprise Vault policy that the user creates through the
NetBackup Administration Console. The user can then
specify which Enterprise Vault components to backup by
selecting predefined directives in the backup policy.
Tight NetBackup integration Tight integration with NetBackup means the following:
Data management Enterprise Vault agent backups are saved to a wide variety
of storage devices that NetBackup supports.
18 Introduction to NetBackup Enterprise Vault
Enterprise Vault agent requirements
Feature Description
Restore operations An administrator who uses the Backup, Archive, and Restore
interface can browse Enterprise Vault backups and select
the ones to restore.
Local media server The Enterprise Vault agent supports the use of a local media
server as the primary media server during a backup.
However, the configuration of the local media server for
Enterprise Vault agent is different than what a NetBackup
configuration uses.
archived data, the Enterprise Vault agent uses Microsoft’s Common Internet
File System (CIFS) protocol to access the data.
■ Because this agent is installed with the NetBackup client software, you must
also install the client on any system that hosts an Enterprise Vault SQL
database.
■ Verify that Enterprise Vault is supported on your operating system.
■ At the time of this release, this version of the Enterprise Vault agent supports
Enterprise Vault 7.5 and later. Contact Support for information about
supporting future versions of Enterprise Vault.
See “ Verifying Enterprise Vault agent operating system compatibility”
on page 22.
20 Introduction to NetBackup Enterprise Vault
Enterprise Vault agent requirements
Chapter 2
About NetBackup
Enterprise Vault agent
installation requirements
This chapter includes the following topics:
2 Select the NetBackup Enterprise Server link under the Support for Top
Products title on the Web page .
3 Select Master Compatibility List under the Compatibility title on the Web
page .
The Web page refreshes and shows a list of compatibility documents. You
can refine your search to find a link to the appropriate document. (The
compatibility list documents are in PDF format. You must have Adobe Acrobat
Reader to view these documents.)
4 In the list of documents, click on the following link:
NetBackup (tm) x.x Database Agent compatibility.
For x.x, look for the most current release of NetBackup.
platform can be any Windows platform that NetBackup supports. For more
information, see the NetBackup Installation Guide.
■ The Enterprise Vault agent is a part of the NetBackup client software. The
NetBackup client software must be installed on every system that either hosts
Enterprise Vault SQL data or is an Enterprise Vault server. (If the Enterprise
Vault server is also a NetBackup server, the client software is installed along
with the NetBackup server software.)
■ Verify that you have the supported Windows and Enterprise Vault version.
■ Enterprise Vault 8.0 SP2 or higher on Windows 2003, 2008 (x86, AMD64) with
Windows registry changes applied.
To enable the NetBackup 6.5.4, 6.5.5, and 6.5.6 Enterprise Vault agent to detect
an MSCS clustered Enterprise Vault 8 SP2 server, add the following Windows
registry keys and String Values (type REG_SZ) on each cluster node:
■ For x86 MSCS clusters: If a key does not exist, create the following one:
HKEY_LOCAL_MACHINE\Software\KVS\Enterprise Vault\Admin\ConfigState
■ For x64 MSCS clusters: If a key does not exist, create the following one:
HKEY_LOCAL_MACHINE\Software\Wow6432Node\KVS\Enterprise
Vault\Admin\ConfigState
When the key is created, add the following string values:
■ "ClusVirtualServer"="virtual node name"
■ "ClusResourceGroup"="EV Resource Group name"
the nodes and virtual SQL server for the Enterprise Vault - NetBackup Master
Admin Console.
To add and configure the nodes and virtual SQL server
1 On the NetBackup Administration Console , expand Host Properties.
2 From the Actions menu, select Configure Client or click the Configure Client
icon.
The Choose Client dialog box is displayed as shown in the following figure:
3 Click Browse and select the required computer and click OK.
4 Click OK to exit the Choose Client dialog box.
26 About NetBackup Enterprise Vault agent installation requirements
Adding the Enterprise Vault agent license key
5 From the Host Properties list, select Clients. The available clients are
displayed.
6 Right-click the required client and select Properties. The Client Properties
dialog box is displayed as shown in the following figure:
For each node and cluster, configure the log on account to be the Enterprise Vault
Admin user.
Note: In a NetBackup cluster, add the key on each node where the NetBackup
server is installed.
Vault servers and the other site would contain NetBackup 7.5 Enterprise Vault
servers. If these two sites share a SQL server, then that server must run must
a version that is equal to or greater than NetBackup 7.5.
After you have finished the upgrade, more changes to the Enterprise Vault
configuration may be required. For example, if you upgraded the master, media,
and client servers to version 7.0 and you upgraded Enterprise Vault to version
8.0, then you must modify your backup policy to use Enterprise Vault 8.0 directives.
Table 2-1 shows the different versions of software that can be run within your
Enterprise Vault environment. The table also shows which variation of software
requires you to make additional changes after the upgrade completes.
7.0 7.0 8.0 You must modify all current NetBackup Enterprise
Vault policies to use the Enterprise Vault 8.0 or later
directive set.
See “Configuration changes required after Enterprise
Vault upgrade” on page 28.
http://entsupport.symantec.com/docs/323945
EV_DIR_DB EV_DIR_DB
EV_MONITORING_DB EV_MONITORING_DB
■ EV_OPEN_PARTITION=Vault Store
name
■ EV_CLOSED_PARTITIONS=Vault Store
name
■ EV_READY_PARTITIONS=Vault Store
name
Note: You must perform the following procedure for all of the Enterprise Vault
servers and the SQL servers in an Enterprise Vault site configuration.
Enter a client name in the Choose Client dialog box as shown in the following
figure and click OK.
5 In the left pane, expand Windows Client and click Enterprise Vault. The
Client Properties dialog box is displayed as shown in the following figure.
6 In the User name box, specify the user ID for the account that is used to log
on to Enterprise Vault (DOMAIN\user name).
7 In the Password box, specify the password for the account.
8 Click OK to save your changes.
■ An Enterprise Vault File System data backup for a non-UNC (Universal Naming
Convention) location.
Table 3-1 illustrates when snapshot is used.
The following list contains the additional notes that relate to a VSS-based snapshot
configuration:
■ The Enterprise Vault agent internally uses the VSS-based snapshot. Therefore,
every drive that has the Enterprise Vault data must have an ample amount of
free space for a VSS snapshot to be taken. A snapshot can fail if the amount
of free space on the selected drive is insufficient.
See “About the VSS_E_INSUFFICIENT_STORAGE snapshot error” on page 120.
■ With NetBackup 7.1 and later, the Enterprise Vault agent attempts to take as
many snapshots per snapshot job as possible. The maximum number of
snapshots that can occur during a single snapshot job is 64 which, is also the
default value. You can lower this value by adjusting the maximum number of
snapshots that can occur during a single snapshot job. The registry DWORD
value, MaxSnapshotPerJob controls the maximum number of snapshots. This
registry value is located under the registry key,
Software\VERITAS\NetBackup\CurrentVersion\Agents\EnterpriseVault\.
The default for the MaxSnapshotPerJob value is 64 snapshots per snapshot
job.
Enterprise Vault backup tries to use the media that is attached to the local system
as much as possible. However, because of parameters such as, resource inheritance
from the parent job, it is possible that the Enterprise Vault backup may not use
the local media server.
For the Enterprise Vault agent, local media server support is implicit and no
external setting can disable it. The NetBackup master server configuration for
local media server support does not have any effect on the Enterprise Vault
backups that use or do not use the local media.
For an Enterprise Vault backup to use the local media server, you need to make
some configuration changes. Refer to the following procedure for these changes.
To configure the local media for Enterprise Vault backup
1 First, configure the Enterprise Vault policy’s storage unit. To configure the
policy, open the existing Enterprise Vault policy.
2 From the Attributes tab, choose the Any Available option from the Policy
storage unit/lifecycle policy drop-down list.
3 Next, configure the storage units that belong to the local media server. To
configure the storage unit, open the Change Storage Unit dialog box and
ensure that the On Demand Only check box is deselected for the storage unit.
4 Finally ensure that the following media server entries exist in the Server
Properties of a host:
■ The master server must have entries for all media servers in Enterprise
Vault site.
■ Each media server in the Enterprise Vault site should have entries in their
properties for other media servers in the Enterprise Vault site.
■ All NetBackup clients (Enterprise Vault servers or Enterprise Vault-SQL
servers) should have entries in their properties for all the media servers
in the Enterprise Vault site.
■ Clients to be backed up
■ Backup selection
Before you create and run a backup policy, ensure that you set the value for the
following items in the Administration Console:
Before you create and run a backup policy, ensure that you set the value for
Maximum concurrent jobs and Maximum jobs per client options from the
Administration console.
The Maximum concurrent jobs option is available in the Storage Unit Settings
dialog box. The value under this option indicates the number of concurrent backup
jobs that can use a storage unit and directly affect the performance of the backup.
Symantec recommends that you change the value of this setting based on the
following:
■ Your Enterprise Vault configurations
■ Policy clients
■ Policy backup selections
■ Capability of the storage unit
The Maximum jobs per client option is available under the master server Host
properties (Global Settings). Symantec recommends that you change the value
based on your Enterprise Vault configuration and backup selections.
To back up an Enterprise Vault environment, create at least one Enterprise Vault
policy with the appropriate schedules. A configuration can have a single policy
that includes all clients or many policies, some of which include only one client.
See the NetBackup Administrator’s Guide, Volume I.
See “Adding a new Enterprise Vault policy” on page 38.
See “Adding schedules to an Enterprise Vault policy” on page 41.
See “Adding a client to a policy” on page 46.
4 In the Add a New Policy dialog box, in the Policy name field, type a unique
name for the new policy.
5 Uncheck the Use Backup Policy Configuration Wizard check box.
Note: By default, this option is checked. Uncheck this check box if you want
to manually create a new policy. If this check box is not unchecked, the Backup
Policy Configuration wizard appears and guides you through the backup
policy creation process.
6 Click OK.
7 On the Attribute tab of the Add a New Policy dialog box, select the
Enterprise-Vault policy type from the Policy type drop-down list.
The Enterprise Vault database agent policy type does not appear in the
drop-down list unless the master server has a license key for this database
agent.
8 Complete the entries on the Attributes tab.
9 Continue by adding additional policy information as follows:
■ Add schedules
See “Adding schedules to an Enterprise Vault policy” on page 41.
■ Add clients
See “Adding a client to a policy” on page 46.
■ Add Enterprise Vault directives to the backup selections list
40 Configuration
Enterprise Vault backup policy attributes
10 When you finish all of the schedule, client, and backup selections click, OK.
The policy is validated and created if it found to be valid. If the policy is not
valid the policy validation fails with a status 69 or 1800 error.
For more information about how to correct your policy or for more
information about the status errors, refer to the following sections.
See “Creating a backup selections list” on page 43.
See “Adding a client to a policy” on page 46.
Attribute Description
Policy type Determines the types of clients that can be in the policy. In some
cases policy type determines the types of backups that NetBackup
can perform on those clients. To use the Enterprise Vault agent,
you must define at least one policy of type that is Enterprise-Vault.
Note: If you use the command-line interface (CLI), the identifying
number for an Enterprise Vault agent policy type is 39.
Limit jobs per policy Limits the number of jobs that NetBackup performs concurrently
with this policy. Set this option to a number that is determined
by the backup selection and your Enterprise Vault configuration.
A single policy can result in multiple jobs. In addition, you can
run backups without using this option.
Configuration 41
Adding schedules to an Enterprise Vault policy
Attribute Description
Allow multiple data This attribute is enabled when the user creates an Enterprise Vault
streams policy. However, Enterprise Vault agent does not support the
multiple data streams feature.
See “About Enterprise Vault directives and what data they back up” on page 55.
for additional information on what types of data is backed up.
Full Backup Select this back up type to back up any Enterprise Vault
component. All Enterprise Vault directives support full backups.
User Backup This type of backup is not supported for Enterprise Vault.
User Archive This type of backup is not supported for Enterprise Vault.
Cumulative This backup type backs up the files that are specified in the
Incremental backup backup selections list that has changed since the last full backup.
All files are backed up if no previous Full backup has been done.
Cumulative incremental backups occur automatically according
to schedule criteria. A complete restore requires the last full
backup and the last, cumulative incremental backup.
Note the following about Cumulative Incremental backups:
Differential Select this backup type to only back up the changes that are
Incremental backup made to the data since the last full backup or previous
incremental backup.
Note: The Enterprise Vault entity names cannot begin with a space or end with a
space. Any Enterprise Vault entity name that uses this format is not supported.
NetBackup uses the same backup selection list for all of the clients that are backed
up according to the policy.
To create a backup selections list
1 In the Policy dialog box, click the Backup Selections tab.
2 Click New.
3 Click the directive icon that appears on the right in the Backup Selections
field.
4 From the Directive drop-down list in the Select Directive dialog box, select
the Ente4rprise Vault version that you have installed. The list of directives
that appear correspond to the version of Enterprise Vault you have installed.
The following is a list of naming conventions that apply to Enterprise Vault
directives:
■ NetBackup does not support the use of blank spaces either before or after
a component name. Directives that contain an equals sign have a variable
field that you can modify with a component name, such as EV site name
or EV vault store name. This component name cannot start with or end
with a blank space. The Enterprise Vault agent removes these spaces from
the backup selection.
■ Enterprise Vault supports blank spaces anywhere in the component name.
The Enterprise Vault agent cannot back up an Enterprise Vault component
whose name begins or ends with a blank space.
■ Enterprise Vault enables you to configure multiple vault store groups or
vault stores with the same name. However, NetBackup does not support
vault store groups or vault stores using the same name, if they share the
same directory database.
Enterprise Vault 7.5 or later, directive sets enable you to select one or more
directives. For example, you can select the EV_DIR_DB directive and the
EV_MONITORING_DB directive in a single backup policy.
Note: With Enterprise Vault 8.0 or later, you cannot use the EV_DIR_DB
directive with the EV_INDEX_LOCATION= and the EV_OPEN_PARTITION=
directives.
See “About Enterprise Vault directives and what data they back up”
on page 55.
Configuration 45
Creating a backup selections list
5 Click OK.
6 You can rename any directive by selecting the directive and clicking Rename.
7 Click OK when you have finished adding directives to the Backup Selections
list.
46 Configuration
Adding a client to a policy
Note: You can add only one client to a policy, multiple clients are not supported
in the same policy.
Client name Type the name of the client you want to add.
Hardware and operating Choose the applicable hardware and operating system
system of the client.
Configuration 47
Adding a client to a policy
Note: Enterprise Vault uses three terms to define quiescence. Those three terms
are read-only mode, backup mode, and quiescence. These terms are used
interchangeably in reference to Enterprise Vault.
For Enterprise Vault 7.5, the following applies when NetBackup quiesces Enterprise
Vault:
50 About features provided by Enterprise Vault for a backup provider
About quiescing and unquiescing Enterprise Vault services
■ Quiescence always happens at the Enterprise Vault server level. For example,
if only one vault store needs to be backed up, the entire Enterprise Vault server
is put into read-only mode.
■ Whenever an Enterprise Vault server is put into read-only mode, there are
four services that are put into read-only mode. The following list shows the
names of the Enterprise Vault services that are quiesced:
■ The Task Controller Service
■ The Storage Service
■ The Indexing Service
■ The Shopping Service
■ When an Enterprise Vault server is put into read-only mode, you can access
the data, however you cannot archive any data. Even if only one open partition
is backed up the archiving cannot not happen in any of the vault stores in the
Enterprise Vault server.
See “About quiescing and unquiescing Enterprise Vault services” on page 50.
In Enterprise Vault 8.0 or later a more granular method to quiesce Enterprise
Vault components is used.
See “About granular quiescence” on page 51.
■ EnableRestore
The locations of the Enterprise Vault registry keys are as follows:
■ HKEY_LOCAL_MACHINE\SOFTWARE\KVS\Enterprise Vault\Storage
■ HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KVS\Enterprise
Vault\Storage
Note: Incorrect use of the Windows registry editor may prevent the operating
system from functioning properly. You should be very careful when making
changes to a Windows registry. Only those who have experience with the registry
editor application should attempt to modify the registry. Symantec recommends
that you make a complete backup of the registry and workstation before you make
any registry changes.
■ HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KVS\Enterprise
Vault\NetBackup
The ability to set the backup mode at the vault store and Index location level
ensures that the following happens during a backup:
■ While one vault store is put into a backup mode, any other vault store in the
Enterprise Vault site can continue to archive. When the backup mode is set
on a vault store its content can be retrieved. However, the vault store cannot
archive new content until the backup mode is cleared.
■ When the backup mode is set for an index location backup, no new indexes
are created on that index location until the backup mode is cleared.
■ When NetBackup sets the backup mode, Enterprise Vault uses three services
internally. These services need to remain up on all Enterprise Vault servers
in the Enterprise Vault site during the backup. The following is a list of the
three Enterprise Vault services that must remain running during the backup:
■ Directory service
■ Storage service
■ Index service
If a backup job fails and the vault store or index location continues to be in backup
mode, you can use the Enterprise Vault Administration Console or the PowerShell
cmdlets to set and clear the backup mode for the following:
■ Vault stores
See the Symantec Enterprise Vault Administrator's Guide for additional
information.
■ Index locations
If you use the Enterprise Vault Administration Console, remember to refresh
the console before and after you set or clear the backup mode.
See the Symantec Enterprise Vault Administrator's Guide for additional
information.
Note: The Enterprise Vault 9.0 and later versions supports atomicity for quiescence.
The NetBackup Enterprise Vault agent resets the archive bit on the files that were
backed up in FULL and DIFFERENTIAL schedules.
A cumulative incremental backup does not reset the archive bit of an object that
is included for backup. In addition, if a cumulative-incremental backup is run
after a differential-incremental backup completes (and the archive bit is reset),
the cumulative-incremental backup does not include the files that were backed
up in the differential-incremental backup.
If the Enterprise Vault vault store is configured with the, Remove safety copies
after backup, option set, and the Enterprise Vault partition that is configured
with the Use the archive attribute setting for a backup, then the archive file
(safety copy) delete does not occur after a cumulative-incremental backup.
Chapter 5
Performing backups of
Enterprise Vault
This chapter includes the following topics:
Note: Symantec recommends that you create Enterprise Vault policies with the
directives that do not back up the same Enterprise Vault data. For example, an
Enterprise Vault 7.5 backup policy with the EV_SITE directive can back up the
same data as a backup policy with the EV_SERVER directive. In this case, running
the Enterprise Vault backup policy that is configured with the EV_SERVER
directive is not necessary.
Table 5-1 shows the Enterprise Vault 7.5 directives. With each of these directives
you can assume that a policy client is specified and each directive applies to full,
56 Performing backups of Enterprise Vault
About Enterprise Vault directives and what data they back up
Table 5-1 Enterprise Vault 7.5 directives and what they back up
EV_DIR_DB (directory database) The directory database is an SQL database that contains configuration
information.
EV_MONITORING_DB (monitoring The monitoring database is an SQL database that is associated with the
database) Enterprise Vault monitoring service. This database typically contains
performance and trend information about Enterprise Vault activities.
EV_INDEX_LOCATION (Enterprise Vault Use this directive to backup Enterprise Vault index locations. You can use
index locations) any backup schedule with this directive.
■ Use this directive to back up the index locations that are specific to
the Enterprise Vault server alias.
EV_VAULT_STORE (Enterprise Vault, An Enterprise Vault, vault store consists of one or more Partitions and
vault store ) the vault store database. The EV_VAULT_STORE directive enables you to
backup data of all vault stores that are specific to the Enterprise Vault
server alias.
■ Use this directive to back up the data that belongs to each vault store.
That includes all partitions and their corresponding vault store
databases.
■ The vault store database can be hosted on a different system.
EV_VAULT_STORE=EV Vault Store An Enterprise Vault, vault store consists of one or more Partitions and
name (Enterprise Vault, vault store ) the vault store database. Use this directive to back up a particular vault
store for a specific Enterprise Vault server that you defined in the policy.
Table 5-1 Enterprise Vault 7.5 directives and what they back up (continued)
EV_OPEN_PARTITIONS (open partition) Open and closed partitions store Enterprise Vault archives. They can be
and EV_CLOSED_PARTITIONS (closed present on NTFS file system or NAS devices. Each partition is in either an
partition) open state or a closed state. Use the closed partition directive to back up
all closed partitions present on the Enterprise Vault server alias. Use the
open partition directive to back up all open partitions present on Enterprise
Vault server A. In addition, when an open partition is backed up, the
corresponding vault store database is also backed up.
You can use any backup schedule with either of these directives.
For open partitions:
■ All open partitions that are hosted on the policy client along with the
corresponding vault store database are backed up.
■ Each backed up open partition is part of one vault store that is hosted
on the policy client.
For closed partitions:
■ All closed partitions that are hosted on the policy client are backed up.
■ Each backed up closed partition is part of one vault store that is hosted
on the policy client.
EV_VAULT_STORE_DB (Enterprise The Enterprise Vault, vault store database is an SQL database that can
Vault, vault store database ) contain metadata about the vault store and archived data.
■ All of the vault store databases that correspond to the vault stores that
the policy client hosts are backed up.
■ The vault store databases can be hosted on a different system.
58 Performing backups of Enterprise Vault
About Enterprise Vault directives and what data they back up
Table 5-1 Enterprise Vault 7.5 directives and what they back up (continued)
EV_VAULT_STORE_DB=EV Vault Store The Enterprise Vault, vault store database is an SQL database that can
name (Enterprise Vault, vault store) contain metadata about the vault store and archived data.
■ The Enterprise Vault vault store database of the specified Vault Store
name that is hosted on the policy client is backed up.
■ The vault store databases can be hosted on a different system.
■ This directive does not support multiple policy clients in the client list.
■ If Vault Store name is not specified, the job fails.
Note: The vault store name is the vault store name and not the vault
store database name.
EV_SERVER (Enterprise Vault server ) An Enterprise Vault server can consist of multiple Vault stores, multiple
index locations. Select this directive when you want to back up all of the
Enterprise Vault data that is a part of a particular Enterprise Vault server
. You can use any backup schedule with this directive.
EV_SITE (Enterprise Vault site) An Enterprise Vault site can contain multiple Enterprise Vault servers.
Select this directive when you want to back up multiple pieces of data
from various locations. You can use any backup schedule with this
directive.
■ Use this directive to back up all index locations and vault stores (similar
to EV_VAULT_STORE) that any Enterprise Vault server hosts in the
Enterprise Vault site that the policy client belongs to.
Table 5-2 shows the Enterprise Vault 8.0 or later directives. In the following table
a policy client has been specified and each directive applies to full, differential,
and cumulative backups. In addition, Enterprise Vault 8.0 supports multiple policy
clients (except for the EV_VAULT_STORE_DB=, EV_OPEN_PARTITION=,
EV_READY_PARTITIONS=, EV_CLOSED_PARTITIONS=, EV_FINGERPRINT_DB=,
and EV_VAULT_STORE_DB= directives).
Performing backups of Enterprise Vault 59
About Enterprise Vault directives and what data they back up
Table 5-2 Enterprise Vault 8.0 or later directives and what they back up
EV_MONITORING_DB The monitoring database is an SQL database that is associated with the
Enterprise Vault monitoring service. This database typically contains
performance and trend information about Enterprise Vault activities.
EV_AUDIT_DB The auditing database only exists if Enterprise Vault auditing is enabled.
The audit database contains audit records of various configurable
Enterprise Vault operations.
Use this directive to back up the auditing database in the Enterprise Vault
deployment if you have Audit enabled. This option is disabled by default.
■ The auditing database does not need to be hosted on the policy client.
■ This directive supports multiple policy clients in the client list. You
should add multiple clients when multiple Enterprise Vault sites have
their own auditing database.
60 Performing backups of Enterprise Vault
About Enterprise Vault directives and what data they back up
Table 5-2 Enterprise Vault 8.0 or later directives and what they back up
(continued)
EV_FSAREPORTING_DB The FSA Reporting database only exists if FSA Reporting has been
configured. The FSA Reporting database contains a history of the active
and the archived files on the file servers. This data is used to track trends
and as a summary of the archived files and active files on file servers.
Use this directive to back up the FSA Reporting database in the Enterprise
Vault deployment if you have FSA Reporting enabled. This option is
disabled by default.
■ The FSA Reporting database does not need to be hosted on the policy
client.
■ This directive supports multiple policy clients in the client list. You
should add multiple clients when multiple Enterprise Vault sites have
their own FSA Reporting database.
EV_INDEX_LOCATION=Site name Use this directive to back up all index locations in the Enterprise Vault
site, that the Site name variable specifies. You can use any backup schedule
with this directive.
EV_OPEN_PARTITION=Vault Store The open partition directive backs up the open partition and Vault Store
name database of the Vault Store that you specify when you define the Vault
Store name. The partition can be present on NTFS file system or NAS
devices.
Note: For the streamer-based open partitions, do not use this directive
as the backup would succeed partially. Instead, use the
EV_VAULT_STORE_DB directive.
Performing backups of Enterprise Vault 61
About Enterprise Vault directives and what data they back up
Table 5-2 Enterprise Vault 8.0 or later directives and what they back up
(continued)
EV_CLOSED_PARTITIONS=Vault Store The closed partitions directive backs up any closed partitions of the Vault
name Store that you specify when you define the Vault Store name. The partitions
can be present on NTFS file system or NAS devices.
■ This directive does not support multiple policy clients in the client list.
■ If Vault Store name is not specified, the job fails.
Note: Do not use this directive for streamer based closed partitions. If
some closed partitions are streamer-based , the job is completed, but the
data is not backed up by NBU. If all close partitions are streamer-based
the job fails.
EV_READY_PARTITIONS=Vault Store The ready partitions directive backs up the ready partitions of the Vault
name Store that you specify when you define the Vault Store name. The partitions
can be present on NTFS file system or NAS devices.
■ This directive does not support multiple policy clients in the client list.
■ If Vault Store name is not specified, the job fails.
Note: Do not use this directive for the streamer-based ready partitions.
If some ready partitions are streamer-based , the job is completed but the
data is not backed up by NBU. If all ready partitions are streamer-based
the job fails.
EV_VAULT_STORE_DB=Vault Store The Enterprise Vault, vault store database is an SQL database that can
name contain metadata about the vault store and archived data.
Use this directive to back up the vault store database that the Vault Store
name variable specifies in the Enterprise Vault deployment.
Table 5-2 Enterprise Vault 8.0 or later directives and what they back up
(continued)
EV_FINGERPRINT_DB=Vault Store The fingerprint database contains information about archived data in
Group name Vault Store Partitions. Use this directive to back up the fingerprint
database that is associated with the supplied Vault Store Group. The
Enterprise Vault agent can discover multiple fingerprint databases when
a Vault Store Group is configured to support multiple fingerprint
databases.
6 Select the schedule and one or more of the clients to start the backup from
the Manual Backup dialog box.
7 Click OK to begin the backup.
Figure 5-1 Job selection in the Activity Monitor for job cancelation
Chapter 6
Performing restores of
Enterprise Vault
This chapter includes the following topics:
■ Viewing backup data using the Microsoft SQL Server Management Studio
■ When you perform a disaster recovery of Enterprise Vault data, restore the
directory database first. After you successfully restore the directory database,
you can restore other Enterprise Vault components and partitions.
■ Symantec recommends that you restore the vault store database when you
attempt to restore an open partition. In addition, you should restore the open
partition when you attempt to restore the vault store database.
■ Symantec recommends that you restore individual components of Enterprise
Vault one at a time.
■ For Enterprise Vault 7.5 or later, you must stop all Enterprise Vault services
on Enterprise Vault servers when performing a restore.
See “Stopping the administrative services on Enterprise Vault servers”
on page 67.
When you restore Enterprise Vault data you select the backup images that are
displayed in the Backup, Archive, and Restore interface. These images are for
Enterprise Vault file system data or Enterprise Vault SQL databases.
See “About the Backup, Archive, and Restore interface” on page 67.
See “Restoring Enterprise Vault SQL database components” on page 82.
See “Restoring an Enterprise Vault file system component” on page 77.
Performing restores of Enterprise Vault 67
Stopping the administrative services on Enterprise Vault servers
If the images that you selected contain an object that matches the keyword you
entered, then the interface displays the content of that image.
Note: You can also begin a search using the Search for Items to Restore (binocular)
icon. When the Search Backups dialog box opens, enter a search folder, a keyword,
and a Start and an End date.
To view backup information using the Microsoft SQL Server Management Studio.
1 Open the Microsoft SQL Server Management Studio.
2 Click New Query.
Performing restores of Enterprise Vault 69
Restoring Enterprise Vault data
Select
msdb.dbo.backupset.database_name,
msdb.dbo.backupset.backup_start_date,
msdb.dbo.backupset.backup_finish_date,
CASE msdb..backupset.type
END AS backup_type
FROM msdb.dbo.backupmediafamily
ORDER BY
msdb.dbo.backupset.database_name,
msdb.dbo.backupset.backup_start_date
4 Click Execute.
Option Description
Restore everything to its Restores the selected items to the same location from which they were backed up. This
original location option is the default option.
Restore individual folders Select this option to restore any selected Enterprise Vault file system data to different
and files to different locations.
locations
The items you mark for restore appear in the Restore individual folders and files to
different locations list box. When you select a folder for restore, that folder name
appears in the list box (not the individual files in that folder). To restore individual
files to different locations, select files individually.
When you double-click on the source list, you see that content already exists. You
should remove all of the existing content and then enter a physical path of a new
destination in the Enter New Destination dialog box. You can also use the browse
feature to browse for a new destination.
Note: If you type a new destination in the Destination field, you must enter a valid
physical path.
NetBackup browses the local computer where the Backup, Archive, and Restore interface
is running. NetBackup only browses the local computer, even if you chose to redirect
a restore to a different client.
You must provide or select a file name as the destination if you change the destination
location of the file. For folders, the destination name is used as the folder name.
See “About restoring Enterprise Vault file system data” on page 76.
Overwrite existing file Overwrites the existing files and folders. The default is not to overwrite.
Restore completion After a restore completes, you can leave an SQL database in any of the following states:
state
■ Operational
■ Read-only
■ Non-operational
To bring the Enterprise Vault SQL database to the required Point in time (PIT) or end-of-log
(EOL), the SQL database restore consists of a set of restores. An example set of restores
consists of the following:
In other scenarios, the set of restores would require a subset of restores, such as a FULL or
a FULL and cumulative restore. If the set contains incremental restores, the initial restores
should leave the database in a “Restore pending” state so future restores append to the
database. Thus, you should use the Leave database operational option only in the last
restore job of the restore set. Once the database is brought online, the user cannot make
any further cumulative or differential (database differential or transaction log) restores
on that database. If you want to perform any further restores, you must start from a FULL
database restore.
Note: Given a PIT or EOL, the NetBackup SQL Agent has the capacity to find the SQL restore
set (FULL, database differential, and transaction logs). However, the Enterprise Vault agent
does not have this capability; therefore, the user must find and sequence the SQL restore
set manually.
Performing restores of Enterprise Vault 73
About the Enterprise Vault Database Settings tab
Consistency check You can check the consistency of the database after restores are complete.
after restore To check the consistency of the database, select one of the following consistency checks
when you select the Leave database operational option:
Point-in-time recovery To recover the Enterprise Vault SQL database to a PIT, select a restore set that includes
the immediate DIFFERENTIAL (transaction log) backup after the PIT. In addition, while
restoring this backup you must select the “PIT” option and specify the PIT.
You must ensure that you use the PIT option only with the last differential backup restore.
You must select the Leave database operational option in the user interface to enable you
to select the PIT option.
Redirected restore Select this option and specify the new <SQL INSTANCE\SQL database name > to restore to
an alternate client, alternate SQL instance, or alternate SQL database. You must do that
for each restore in the restore set. The destination SQL database should not be present. If
it is present, a chance of data loss in the destination database is possible.
Note: You can change the SQL INSTANCE name, however do not change the SQL database
name. If you change the SQL database name Enterprise Vault does not automatically
recognize the new name. If you chose to change the SQL database name then you must also
update your Enterprise Vault configuration.
Note: A redirected restore of an auditing database must be made to the same SQL instance
where the directory database resides.
74 Performing restores of Enterprise Vault
Specifying the server, clients, and policy type for restores
Take database offline Select this option to disconnect all the connections to the destination SQL database
(including Enterprise Vault connections) before it is restored. You should use this option
only with the full restore .
To specify the server, source client, destination client, and policy type for a restore
operation
1 Log on as Administrator.
2 Open the Backup, Archive, and Restore user interface.
3 Click File > Select Files and Folders to Restore > from Normal Backup.
4 Click File > Specify NetBackup Machines and Policy Type.
5 In the Specify NetBackup Machines and Policy Type dialog box, select the
server that you want to use for restores from the Server to use for backups
and restores list.
Performing restores of Enterprise Vault 75
Specifying the server, clients, and policy type for restores
6 From the Source client for restores list, select the source client. The source
client is the policy client in the backup policy from where the backup
happened.
7 From the Destination client for restores list, select the client that you want.
The destination client is the name of the system where you want the images
to be restored. You can determine the name of the destination client from
either the NetBackup Backup, Archive, and Restore user interface or the
Enterprise Vault Administration Console.
You interpret the destination client based on the version of Enterprise Vault
and the data type that you want to restore. The following explains how to
determine the destination client of a file system or SQL data type on either
Enterprise Vault 7.5 or 8.0 and later.
■ Interpreting the destination client for Enterprise Vault 7.5
■ File system data type, such as an Index location or an open or a closed
partition
From the NetBackup Backup, Archive, and Restore user interface,
expand the selected image to see the hierarchy of the Enterprise Vault
resources so you can view the Enterprise Vault server. The destination
client is displayed within the parenthesis along side the Enterprise
Vault server. For example, a destination client named CLIENT ONE, is
displayed as EV server (CLIENT ONE) in the hierarchy.
■ SQL data type, such as directory, monitoring, or vault store databases
The database name contains the system name in a format similar to
System name\SQL instance\SQL DB name. For example, a vault store
database on CLIENT TWO, would appear as a Vault Store DB (CLIENT
TWO\SQLINST\database). The destination client name in this example
is CLIENT TWO.
■ In the Alternate restore options dialog box, provide a physical path. However,
the user interface displays an Enterprise Vault logical path representation.
You must manually update this path to reflect the correct physical path of the
alternate location.
■ In the Backup, Archive, and Restore user interface, you can select one or more
folders under the Index location; however you cannot select individual files
inside an index folder. In addition, if you deselect an index location, all of the
files that are contained within that location are also deselected.
■ When you restore an open partition, you should also restore the vault store
database if it is available.
13 Repeat steps 7 through 12 for each image that you select to restore.
14 After the restore, return to the Enterprise Vault servers that manages the
restored Enterprise Vault file system data. Click Start > Programs >
Administrative Tools > Services and restart the Enterprise Vault services
on each of the Enterprise Vault servers.
Note: Restoring multiple Enterprise Vault images in one restore operation is not
supported in this release. Symantec recommends that you restore one backup
image at a time. Selecting multiple backup images in a single restore job may give
unpredictable results.
Review the following notes before you attempt to restore an Enterprise Vault SQL
database:
■ Restore full and incremental backups one at a time.
■ When you do a redirected restore, you must select the Redirected restore option
and specify the alternate SQL instance name and database name. (This
requirement applies to each restore in the restore set.) The SQL instance name
always contains the system name. (For default instances, the system name is
the instance name.)
■ The Enterprise Vault agent cannot restore data and log files (.MDF and .LDF
files) of an Enterprise Vault SQL database to a physical path that is different
from the original physical path. As a result, the Enterprise Vault SQL restore
is affected as follows:
80 Performing restores of Enterprise Vault
About restoring Enterprise Vault SQL databases
■ The drive ( C:/ or D:/) used by these files at backup time is available at the
restore time (in the destination client).
■ In the redirected restore, if a new path (SQL instance or database name)
already exists and it is associated with some other physical files. The
database becomes associated with the new physical files after the restore
completes. The physical files of the old database become dangling files and
are no longer associated with a database.
■ In the redirected restore, if the physical files to be restored are present and
associated with some other database, manually take the database offline.
If you do not take the database offline, the restore cannot overwrite those
files.
Note: Recovery is only possible with SQL differential (transaction log) backup
images.
■ Full backup image: A restore set starts with a full backup image.
■ Cumulative backup image: Add the last, cumulative backup image to the set.
Add this image if it occurred between when the full backup image was taken
and the time you decided to perform the restore or recovery.
■ Differential backup images: Add the differential backup images that occurred
between the last cumulative backup (or full backup if no cumulative backup
happened) and the time that you decided to perform the restore or recovery.
If you want to perform a recovery with PIT, then include the immediate
differential image after the PIT in the restore set.
The following example demonstrates how to determine a backup image restore
set in different use cases.
Performing restores of Enterprise Vault 81
About restoring Enterprise Vault SQL databases
Figure 6-2 shows a variety of backup images that were taken and the time instance
that it occurred.
T1 T2 T3 T4 T5 T6 T7 T8 T9 T10
Table 6-3 demonstrates which backup images you would select to comprise a
backup image restore set at any given time instance. Depending on the time you
want to restore or recover the database, determines which backup images you
must include in the backup image restore set.
t1 Full backup
t3 Full + Differential 1
t7 Full + Cumulative
The following examples explain which backup images you must select in the
Backup, Archive, and Restore interface:
82 Performing restores of Enterprise Vault
Restoring Enterprise Vault SQL database components
■ Example 1:
To restore an SQL database to time instance t3, your backup image restore set
must consist of the following backup images:
■ The full backup image with the options Take database offline and Leave
database Non-operational or Leave database Read-only enabled.
■ The first differential backup image with the option Leave database
operational enabled.
■ Example 2:
To recover an SQL database with PIT at time instance t8, your backup image
restore set must consist of the following backup images:
■ The full backup image with the options Take database offline and Leave
database Non-operational or Leave database Read-only enabled.
■ The last cumulative-backup image with the option Leave database
Non-operational or Leave database Read-only enabled.
■ The third differential backup image with the option Leave database
operational and Point-in-time recovery enabled.
■ Example 3:
To recover an SQL database at time instance t10 which is after the last
differential backup, you must use Microsoft's SQL tail-log mechanism. For
more information about performing a tail-log backup, visit Microsoft's Web
site and search for more information on this topic.
In this example the backup image restore set would include the following
images:
■ The full backup image with the options Take database offline and Leave
database Non-operational or Leave database Read-only enabled.
■ The last cumulative-backup image with the option Leave database
Non-operational or Leave database Read-only enabled.
■ The third differential backup image with the option Leave database
operational and Point-in-time recovery enabled.
■ Perform a tail-log backup. See Microsoft's Web site for instructions on how
to perform this type of backup.
Note: If you restore a vault store database, Symantec recommends that you
also restore the corresponding open partition if it is available.
Note: By default, a NetBackup client is not allowed to show the backup images
for which a policy client is some other NetBackup client. You may need to add
a No Restriction File on the NetBackup master server. That enables the
NetBackup client to show and restore the backup images of the Enterprise
Vault SQL database that were taken through some other NetBackup client.
See the NetBackup Administrator's Guide for Windows, Volume I for more
information about the No Restriction File.
5 In the Restore window, select the Enterprise-Vault policy type (choose File
> Specify NetBackup Machines and Policy Type).
6 Click OK.
7 In the NetBackup History pane, determine which backup images to restore.
See “About backup image restore sets” on page 80.
8 Select the backup images from the backup image restore set in the proper
sequence, then restore one image at a time. Start with the full backup image.
9 In the All Folders pane, expand Enterprise Vault Resources.
10 Select the folder(s) of the Enterprise Vault SQL components to restore. (For
example, you can restore the Enterprise Vault directory database, the
Enterprise Vault monitoring database, or the vault store database.)
11 Click Actions > Restore.
12 In the Enterprise Vault Restore dialog box, click the Database Settings tab.
13 Configure the Recovery completion state, consistency check, and other settings
for your restore.
14 Click Start Restore.
15 Repeat steps 8 through 14 for each image that you select to restore.
16 After the restore completes, start the Enterprise Vault services on all of the
Enterprise Vault systems. Select Start > Programs > Administrative Tools
> Services.
Chapter 7
Disaster recovery
This chapter includes the following topics:
■ A copy of NetBackup for Windows with a license for the Enterprise Vault agent
that is added on the master server
■ The latest backup of the Enterprise Vault server that you want to recover
■ Any service packs that have been applied to the original installation
For additional information about Enterprise Vault disaster recovery requirements,
see the Symantec Enterprise Vault Administrator’s Guide.
Note: Unless otherwise stated, do not start any Enterprise Vault service until you
complete all the steps of a recovery procedure. If you start the Enterprise vault
service to browse the Enterprise vault configuration, stop the Enterprise vault
service before you move to the next step of recovery. If you chose to not run the
Enterprise Vault recovery tools to repair consistency after the restore is complete,
a data loss can occur. In addition, Symantec recommends that you run Enterprise
Vault tools with the guidance of Enterprise Vault Support.
When a disaster occurs, there is a logical order that you should use to recover
your Enterprise Vault environment. The following list provides a high-level
summary of the process you should follow to successfully recover your data:
■ First, identify the SQL server that hosted the directory database.
■ Install the operating system and any other required applications on the SQL
server that you identified and then begin to restore the directory database.
■ Restore the directory database.
See “Recovering a directory database” on page 87.
■ Install Enterprise Vault server on one of the systems and direct Enterprise
Vault to the appropriate directory database.
■ Finally, start the admin and the directory services and open the Enterprise
Vault Administration Console. With the Enterprise Vault Administration
Console open, determine which Enterprise Vault server and SQL server to use
as the destination client for other entities.
Disaster recovery 87
Recovering a directory database
Note: If you use the Enterprise Vault Administration Console to browse for
the destination client, remember to stop the Enterprise Vault services before
starting a recovery. You must stop all Enterprise Vault services on all Enterprise
Vault servers before attempting a restore or recovery.
Note: Before starting the recovery process, see the Recovery chapter, in the
Symantec Enterprise Vault™ Administrator’s Guide for Windows.
Note: Before starting the recovery process, see the Recovery chapter, in the
Symantec Enterprise Vault™ Administrator’s Guide for Windows.
Note: Before starting the recovery process, see the Recovery chapter, in the
Symantec Enterprise Vault™ Administrator’s Guide for Windows.
Note: Before starting the recovery process, see the Recovery chapter, in the
Symantec Enterprise Vault™ Administrator’s Guide for Windows.
Note: Symantec recommends that you run the Enterprise Vault tools to verify the
consistency of Enterprise Vault indexes and database. If inconsistency exists,
rebuild the Enterprise Vault indexes. In addition, Symantec recommends that you
run Enterprise Vault tools with the guidance of Enterprise Vault Support.
5 Repeat step 4 for all of the remaining vault stores, which are a part of this
Enterprise Vault Store group.
6 Restore the fingerprint database.
See “Recovering a fingerprint database” on page 91.
Disaster recovery 91
Recovering a fingerprint database
7 After the restore is complete, run the Enterprise Vault recovery tools.
If you chose to not run the Enterprise Vault recovery tools to repair
consistency after the restore is complete, data loss can occur. In addition,
Symantec recommends that you run Enterprise Vault tools with the guidance
of Enterprise Vault Support.
8 Start the Enterprise Vault services on all Enterprise Vault servers.
6 Before restoring the fingerprint database, get the latest backup time of the
open, closed, and ready partitions, and the vault store databases that comprise
the vault store group of the fingerprint database you want to restore. (This
backup timestamp is referred to as the timestamp of the vault store backup.
This timestamp is the backup time of the images that were restored using
the Enterprise Vault agent.) All partitions and vault store database images
may not have same backup time. Therefore, you should use the most recent
backup time as the vault store backup timestamp and then start the restore
of the fingerprint database.
See “Restoring Enterprise Vault SQL database components” on page 82.
If there are multiple fingerprint databases, then you should repeat this step
for each fingerprint database.
7 Run the Enterprise Vault recovery tools to repair the consistency of the entire
vault store group. That helps to bring the partitions, the vault store database,
and the fingerprint database to a consistent state.
Note: Symantec recommends that you run Enterprise Vault tools with the
guidance of Enterprise Vault Support.
3 Install the NetBackup client on this system if it is not installed on this system
already.
4 Restore the vault store database that is associated with this vault store.
See “Restoring Enterprise Vault SQL database components” on page 82.
5 Run the Enterprise Vault recovery tools to repair the consistency of the vault
store. This step helps to bring the partitions, the vault store databases to a
consistent state.
If you chose to not run the Enterprise Vault recovery tools to repair any
inconsistency, data loss can occur.
Symantec recommends that you run Enterprise Vault tools with the guidance
of Enterprise Vault Support.
Note: Symantec recommends that you run the Enterprise Vault tools to verify the
consistency of the Enterprise Vault indexes and database. If an inconsistency
exists, rebuild the Enterprise Vault indexes. In addition, Symantec recommends
that you run Enterprise Vault tools with the guidance of Enterprise Vault Support.
Disaster recovery 95
Recovering an Enterprise Vault server
■ Run the Enterprise Vault recovery tools to repair the consistency of the
vault store. That helps to bring the partitions, and the vault store database,
to a consistent state. Symantec recommends that you run Enterprise Vault
tools with the guidance of Enterprise Vault Support.
11 Repeat Step 10 for the remaining vault stores that are a part of this Enterprise
Vault server.
12 Restore the index location data for all index locations that were a part of this
Enterprise Vault server.
See “Restoring an Enterprise Vault file system component” on page 77.
12 Repeat Step 11 for the remaining vault stores that are a part of this Enterprise
Vault server.
13 Restore the index location data for all index locations that were a part of this
Enterprise Vault server.
See “Restoring an Enterprise Vault file system component” on page 77.
Note: Symantec recommends that you run the Enterprise Vault tools to verify
the consistency of Enterprise Vault indexes and database. If an inconsistency
exists in Enterprise Vault Indexes rebuild them. In addition, Symantec
recommends that you run Enterprise Vault tools with the guidance of
Enterprise Vault Support.
98 Disaster recovery
Recovering an Enterprise Vault server on a different system
Chapter 8
Enterprise Vault Agent
support for EV 7.5, 8.0 and
later
This chapter includes the following topics:
■ Enterprise Vault agent functionality and support for EV 7.5 and later
100 Enterprise Vault Agent support for EV 7.5, 8.0 and later
Policy configuration for Enterprise Vault 8.0 and later versions
■ If the amount of data is small enough, you can combine the closed and the
ready partitions of multiple Vault Store’s in a single policy. However, if the
amount of data is large, Symantec recommends that you back up the closed
and the ready partitions in separate policies.
■ crawler-read-only
■ crawler.log
■ crawler-service.pipe
■ indexer-fatal-error
■ indexer-read-only
■ indexer.log
■ indexer-service.pipe
■ .lock
Note: File name must be enclosed with wild characters. For example, the file
*crawler-fatal-error* or *.ARCH*.
EV_INDEX_LOCATION and Symantec recommends that you use these directives more
EV_OPEN_PARTITIONS frequently that the other directives. In fact, you should
schedule these directives to run daily backups. These
directives take the backup to a more granular level to
protect Enterprise Vault. These directives should be the
most preferred backup selections when you want to protect
large deployments of Enterprise Vault.
104 Enterprise Vault Agent support for EV 7.5, 8.0 and later
About planning backup schedules
EV_VAULT_STORE and Using this directive means data that is not modified
EV_VAULT_STORE= regularly is backed up more frequently than it needs to
be. Symantec recommends that you use these directives
when you want to repair a particular Vault Store or
multiple Vault Stores.
components. In addition, this information reminds you that there are certain
backups that you should not schedule to run at the same time.
See “Configuration requirements for an Enterprise Vault backup policy”
on page 37.
Symantec has the following recommendations when you plan your backup
schedules:
■ You should perform at least one weekly full backup and daily incremental
backups for all Enterprise Vault components. In addition, Symantec
recommends that you perform one or two cumulative backups each week. You
can monitor the size of the incremental backups to help you decide how many
cumulative backups you should schedule. The greater the size of the
incremental backups, the greater the need to perform two cumulative backups.
■ As you determine the schedules of your backups, you should be careful that
you do not overlap certain backups. For example, do not allow a directory
database backup window to overlap with the backup window of an open
partition or index locations backup.
Note: For Enterprise Vault 8.0 the same client name is used across all of the policies
to protect an Enterprise Vault site.
106 Enterprise Vault Agent support for EV 7.5, 8.0 and later
About Enterprise Vault tools
For more information about Enterprise Vault site and server aliases, see the
Symantec Enterprise Vault Administrator's Guide.
■ You can however, restore the data from the Differential backup images. You
must restore all of the Differential backup images after the restore of the last
full-backup image.
To avoid this issue, Symantec recommends that you make sure the full backup
is successful before you begin a Cumulative incremental backup. Ensuring a
successful full backup before you attempt Cumulative backup guards against
a data loss scenario.
Finally, check whether you have the required privileges to create backups using
the Enterprise Vault agent.
■ For this release, Enterprise Vault agent does not support the Enterprise Vault
index locations that are based on a mapped drive. If any index location in an
Enterprise Vault site is based on a mapped drive then you should ensure that
no backup selection uses the EV_INDEX_LOCATION directive.
■ Information on supported cluster environments for Enterprise Vault is
available.
See the, Symantec Enterprise VaultTM Administrator's Guide document.
Note: An incremental backup after a full restore was allowed in the earlier versions
of NetBackup. The failure of the incremental backup failure after a full restore
has been observed in the NetBackup 7.5.
Chapter 9
Troubleshooting
This chapter includes the following topics:
■ About troubleshooting
About troubleshooting
This chapter explains the processes and resources that can help you troubleshoot
the NetBackup Enterprise Vault agent. These resources include the debug logs
and status reports for NetBackup and for the database agent to help troubleshoot
the backup and restore operations. These reports are useful for finding the errors
that are associated with those applications.
Note: When debug logging is enabled, the files can become large and can adversely
affect other backups that use the same files.
install_path\NetBackup\logs\mklogdir.bat
Table 9-1 List of the directories to create to capture various backup, restore,
and snapshot data
Table 9-1 List of the directories to create to capture various backup, restore,
and snapshot data (continued)
Table 9-2 Lists the directories to create to capture various backup, restore,
and snapshot data on the NetBackup media server
Table 9-3 Lists the VxUL logs for NetBackup Policy Execution Manager and
NetBackup Job Manager
After you create these directories all debug logging information is placed in the
separate files that are created on a date basis.
3 Click the Troubleshooting tab. By default, the Debug Levels settings are zero.
4 From the General Debug Level drop-down list, set the debug level as required.
5 Click OK to save your changes.
■ For Enterprise Vault 8.0, quiescence can fail if the Enterprise Vault component
(Vault store or Index location) or its parent component (such as, vault store
group or site) is already quiesced. The backups fail with a status 2. You should
clear the backup mode and attempt to run the backup again.
■ A backup can fail with a status 2 if the backup runs within a few minutes from
when an Enterprise Vault directory database was restored. You should browse
the Enterprise Vault configuration from Vault Administration Console and
attempt to run the backup again.
HKEY_LOCAL_MACHINE\SOFTWARE\Veritas\NetBackup\BEDS\Engine\NTFS\FsUseAsyncIo
The VSS_E_BAD_STATE message is displayed when the VSS writer is in a bad state,
as in if it is not stable. Reset the VSS state to fix this error.
The VSS_E_INSUFFICIENT_STORAGE message is displayed when there is insufficient
space on the drive to create snapshots. Pre-configure a shadow storage area on a
drive to fix this issue.
Perform the following to reset the Microsoft Volume Shadow Copy Service (VSS)
writer states and to ensure that future snapshot jobs are successful.
To reset the Microsoft Volume Shadow Copy Service (VSS) writer states
1 Run services.msc.
2 Ensure that the MS Software Shadow Copy Provider service's Startup type
is set to Manual.
3 Ensure that the Volume Shadow Copy service's Startup type is set to Manual.
4 Run cmd.exe.
5 From the command line, run vssadmin list writers.
This command shows you the state of the VSS writers. If any of them are in
a bad state (a state other than Stable) then you must manually reset the
writer's state.
Troubleshooting 119
About NetBackup status-related troubleshooting information
6 Reset the VSS writer states by running the following commands from the
command line:
net stop swprv
cd %SystemRoot%\system32
regsvr32 ole32.dll
regsvr32 oleaut32.dll
regsvr32 vss_ps.dll
vssvc /Register
regsvr32 /I swprv.dll
regsvr32 /I eventcls.dll
regsvr32 es.dll
regsvr32 stdprov.dll
regsvr32 msxml.dll
regsvr32 msxml2.dll
regsvr32 msxml3.dll
regsvr32 msxml6.dll
Note: Verify that the msxml6.dll or msxml6r.dll files are in the system32
directory. If they are not present in the directory, then run the Windows
update to get the .dll files. Finally, run the regsvr32 command again for these
DLLs after you have verified that they are in your system32 directory.
7 If you are on a Windows 2003 system, run the command, regsvr32 vssui.dll
from the command line. If your computer is not running Windows 2003, then
you can skip this step.
8 Restart your computer.
After you restart the computer you should run the following commands:
■ C:\> vssadmin list writers
The NetBackup Enterprise Vault Agent portal is a good place for more information
about the NetBackup 6.5.x and 7.0.x Enterprise Vault Agents. See the following
URL for more information.
http://www.symantec.com/business/support/index?page=content&id=TECH126523
122 Troubleshooting
About NetBackup status-related troubleshooting information
Appendix A
NetBackup Enterprise Vault
Migrator
This appendix includes the following topics:
When you use NetBackup with Enterprise Vault, archived items from Enterprise
Vault can be automatically stored and retrieved on the storage devices that
NetBackup manages. All archived items are first stored within a vault store
partition within Enterprise Vault. After Enterprise Vault archives the item, a
collection process is run and that result it is placed into a CAB file. Once the CAB
file is created, it is now ready to be migrated from Enterprise Vault to NetBackup
using a migration process. The Enterprise Vault migration process calls the
NetBackup migration process, which starts a backup of the CAB files by a
NetBackup policy. Once the backup is complete, Enterprise Vault truncates the
vault store partition copy of the CAB file. That reduces the Enterprise Vault disk
storage space and leverages the investments that were made in the NetBackup
infrastructure.
During the NetBackup migration process multiple copies can be made using inline
tape copies. Disk storage units (DSUs) and disk storage staging units (DSUs) are
also supported for the NetBackup-controlled migrations that are direct to disk.
However, Symantec recommends that you keep traditional backups separate from
Enterprise Vault data because the retention requirements are likely to be very
different.
4 In the Add a New Policy dialog box, in the Policy name field, type a unique
name for the new policy.
You can specify any name that you want. However, make a note of this name
because you may use it again when you configure Enterprise Vault in a later
step.
10 Specify backup window of schedule. Click the Start Window tab to define the
period of time during which the backup starts and ends.
The schedules should be set to allow backups and restores to happen at any
time. The Vault Store Partition configuration controls the Enterprise Vault
migration (backup) times.
11 Click OK.
128 NetBackup Enterprise Vault Migrator
About configuring a backup policy for migration
12 Specify a NetBackup client for the policy. In the Policy dialog box, click the
Clients tab.
You should use the name of the Enterprise Vault server whose data is to be
migrated in the NetBackup client for the policy.
To access the Policy dialog box, double-click the policy name in the client
list in the NetBackup Administration Console.
13 Click OK.
You do not need to specific policy directives because the file names are passed
automatically between Enterprise Vault and NetBackup.
NetBackup administrators may find the following notes helpful when configuring
a NetBackup policy for the Enterprise Vault migrator:
■ You should take additional tape drives and storage slots into consideration
when you use the NetBackup migrator feature to store Enterprise Vault data.
■ If tapes are removed from the library, timeouts can occur and you may not be
able to automatically retrieve your data.
■ Timeouts can occur if all tape drives are in use when an Enterprise Vault user
or application accesses the data that resides in a library.
■ Timeouts can occur if a migration occurs (writing to the tape) while data on
the same tape is accessed for a retrieval.
NetBackup Enterprise Vault Migrator 129
About configuring Enterprise Vault for collection and migration
3 Configure the migration properties. Select the Advanced tab within the Vault
Store Partition Properties dialog box. Set the following attributes on this
tabbed page:
■ NBU policy
The name of the NetBackup policy through which migration is expected
to take place.
■ NBU server
The name of the NetBackup master server.
■ You can modify the default values of the other settings if you deem it is
necessary.
130 NetBackup Enterprise Vault Migrator
About NetBackup Enterprise Vault migrator registration
is installed for versions of Enterprise Vault that are earlier than Enterprise Vault
8.0 SP2.
See “About NetBackup Enterprise Vault migrator registration” on page 130.
This procedure helps you identify any issues in the registration of the new
component. The following procedure steps you through this process.
To test the Enterprise Vault migrator configuration
1 Determine if any Enterprise Vault partitions exist. If previously configured
partitions exist, proceed to Step 2.
If no Enterprise Vault partitions have been configured for migration, then
Symantec recommends that you download the following white paper on
Enterprise Vault integration. This paper contains information on archiving
and migration, and how to configure Enterprise Vault with NetBackup.
(Symantec recommends that you focus your attention on the NetBackup
Configuration and Enterprise Vault Configuration sections.) After you have
finished configuring the migrator, you can proceed to Step 2.
See the following document for more information:
http://eval.symantec.com/mktginfo/products/White_Papers/Data_Protection/
ent-whitepaper_veritas_nbup_and_veritas_ev_integration_02-2006.en-us.pdf
5 Select the Advanced tab in the Vault Store Partition Properties dialog box
and click theTest option.
If the test is successful, a dialog appears that states the Migrator Configuration
Test was successful.
134 NetBackup Enterprise Vault Migrator
Setting the recommended DCOM settings
6 From the Launch Permission dialog box make sure that only the following
groups are in the Group or user names field:
■ Local administrator's group
NetBackup Enterprise Vault Migrator 135
Setting the recommended DCOM settings
■ SYSTEM group
In the Permissions for SYSTEM field, ensure that both groups are given
full permissions and click OK.
Note: Other required parameters of the command line interface need to be passed
appropriately for the restore operation to complete successfully.
■ Select File > Specify NetBackup Machines and Policy Type. (Windows
interface)
■ Select Actions > Specify NetBackup Machines and Policy Type. (Java
interface)
3 From the Specify NetBackup Machines and Policy Type dialog, perform the
following:
■ Select the server to use for backups and restores.
■ Designate the source client for the restore.
■ Designate the destination client for the restore.
■ Select DataStore in the Policy type for restores field.
See
http://entsupport.symantec.com/docs/327571.
3 Run Dtrace.exe.
4 Set verbose logging on the required processes.
Set verbose logging on the following processes when you want to collect
migrator logs:
■ StorageFileWatch
■ EVStgOffilineOpns
■ StorageManagement
This process is required to analyze logs when you want to test the
Enterprise Vault Configuration.
■ StorageDelete
This process is required when you want to analyze the logs after you delete
a partition whose data has been migrated.
Execute the following commands to set the verbose logging:
■ set StorageFileWatch verbose
Enter the command, view, to see a list of processes for which you can enable
verbose logging.
5 Set the log file. From the Command Prompt window, you can execute the
command, log log_file_name, to set the log file.
As an example, you enter the log EVLogs.txt to set the log file to
C:\EVLogs.txt.
NetBackup Enterprise Vault Migrator 143
Troubleshooting the Enterprise Vault migrator
6 Enable monitoring. From the Command prompt window, you can execute the
command, mon, to set monitoring.
7 Execute the migrator tasks for which logs are required.
Execute the tasks (Migration/Retrieval/Deletion) for which logs are required.
The Dtrace screen displays the various logs that are generated for the task.
8 Press Control-C to exit from the monitoring phase.
9 Disable logging.
You must disable the logging to ensure that all log entries are stored in the
log file. You can use the command, log, to disable logging.
After you type the log command, you are prompted to confirm that you want
to disable logging. Type,Yes.
Note: Use the following procedure as a guideline only. Even though the objectives
that are stated within the procedure remain the same, the steps to achieve them
may vary with different versions of NetBackup. The same principle also applies
to the screen shots provided.
In case of any believed discrepancy, see the Symantec NetBackup Troubleshooting
Guide UNIX, Windows, Linux for more information.
To collect the Enterprise Vault logs that were migrated to the NetBackup logs
1 Go to the NetBackup logs directory.
A logs directory resides under the NetBackup installed directory. For example,
if NetBackup is installed under the directory, C:\Program
Files\Veritas\NetBackup\, then the following logs directory also exists:
C:\Program Files\Veritas\NetBackup\logs
2 Create the required directories under the NetBackup logs folder.
You should refer to the following logs as your first point of reference when
you investigate the details of any failure:
■ vxbsa logs
■ bpbkar logs
■ tar logs
NetBackup Enterprise Vault Migrator 145
Troubleshooting the Enterprise Vault migrator
To enable the creation of these log files you must create the following
directories under the NetBackup logs folder (if they do not already exist):
■ exten_client
Executing mklogdir.bat creates several log directories. However, this
command does not create the directory, exten_client.
■ bpbkar
■ tar
The migration can fail because of any failure in the workings of NetBackup.
Therefore, even though the first point of investigation should start with the
mentioned logs, it is safest to collect all of the logs by executing the command,
mklogdir.bat.
■ bpbkar
■ tar
You should collect all the logs files by either creating a .zip file of the
NetBackup logs folder, or copying the latest file under every directory
under the NetBackup logs folder.
146 NetBackup Enterprise Vault Migrator
Troubleshooting the Enterprise Vault migrator
Index
A Configuring
Add clients to a policy 128 Local media server 36
Add new policy 38, 125 Configuring Enterprise Vault
Adding a policy for collection
client name 46 for migration 129
Allowing multiple clients 47 consistencies
alternate SQL restore 72 closed and ready partitions 100
Archive bit attribute option 53 database
fingerprint databases 100
open partition databases 100
B vault store databases 100
Backup image restore sets 80–82 directory database 101
Backup policy Index location 101
Backup schedules Consistency check 73
Backup selection 37 consistency check 72
Backup Policy Configuration Wizard 39, 125 Cummulative backup 72
Backup schedules 37, 104 Cumulative backup 80
Backup, Archive, and Restore user interface 65, 77,
80, 113, 137
All Folders pane D
NetBackup History pane 67 Datastore license 140
Backups debug logging 111
Cumulative incremental backups 42 Differential backup 72, 80
Differential Incremental backups 43 differential-incremental backups 43
full backups 42 Disaster recovery requirements 85
backups DVS files 129
back up types 42
Best practices E
Enterprise Vault agent backups 106 enable debug logging 112
Enterprise Vault agent restores 108 Enterprise Vault
bpbkar log 112 client name 105
bpfis log 112 Enterprise Vault 7.5 directives 45, 103
bppfi log 112 Enterprise Vault 8.0 directives 45
Enterprise Vault Agent
C components
client name 46 archives 13
Closed partition 57 Enterprise Vault agent functionality and support for
closed partitions directive 61 EV 7.5 and later 109
Collecting migrated Enterprise Vault logs 144 Enterprise Vault Agent policy
compatibility information 22 Backup Selections tab 43
Enterprise Vault agent user-credentials 34
Enterprise Vault auditing database 59
148 Index
T
Troubleshooting Enterprise Vault Agent
debug logs
status reports 111
Troubleshooting the Enterprise Vault migrator 138
U
Upgrade scenarios 27
Useful tips 109
V
Viewing backup data
via Backup, Archive, and Restore interface 67
via Microsoft SQL Server Management Studio 68
W
Windows interface 33