Enterprise Vault How To Guide Setting up Enterprise Vault Migrations with NetBackup

Enterprise Vault How To Guide
Setting up Enterprise Vault
Migrations with NetBackup
This document provides an overview of how to configure Enterprise
Vault and NetBackup for the migration of archived Enterprise Vault
content.
If you have any feedback or questions about this document please
email them to [email protected] stating the document title.
This document applies to the following version(s) of Enterprise Vault:
6, 7, 2007, 8, 9, and 10
This document is provided for informational purposes. All warranties relating to the information in this document,
either express or implied, are disclaimed to the maximum extent allowed by law. The information in this
document is subject to change without notice. Copyright © 2013 Symantec Corporation. All rights reserved.
Symantec, the Symantec Logo, and the Checkmark 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.
.
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Document Control
Contributors
Who
Contribution
Evan Barrett
Author
Revision History
Version
Date
Changes
1.0
July 2009
Initial Release
2.0
May 2013
Updates for NetBackup 7.1 and 7.5 and Enterprise Vault 10
3.0
August 2013
Minor changes and updated screenshots
Related Documents
Document Title
Version
Date
Backing Up Enterprise Vault
January
http://www.symantec.com/business/support/index?page=content&id=TECH147148
2013
Registering the NetBackup Migrator
February
http://www.symantec.com/docs/HOWTO70007
2012
i
/
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Table of Contents
Overview
Considerations before Setting up Migration
1
1
What Types of Data Should Be Migrated?
If Not yet at Enterprise Vault 10
1
1
Requirements
2
Enterprise Vault
NetBackup
2
2
Configuring the NetBackup Client on the Enterprise Vault Server
Installation
Post Client Installation
2
2
3
Configuring the NetBackup Master Server
5
Adding a License Key
Configuring a NetBackup Policy for Enterprise Vault Migrations
Creating a Policy
Policy Attributes
Policy Schedule
Policy Clients
Configuring Vault Store Partitions for Migration to NetBackup
Setting up Collections
Setting up Migration
5
6
6
6
7
9
9
9
10
Appendices
APPENDIX A – Settings in the Vault Store Partition Advanced Tab that Relate to NetBackup Migrations
ii
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Overview
The purpose of this document is to provide best practices on configuring migrations of Enterprise Vault
archived data to Symantec NetBackup. Topics that will be covered include considerations before setting
up migration, software requirements, Enterprise Vault Vault Store partition configurations, NetBackup
policy configurations, and NetBackup client configuration considerations.
Starting with NetBackup 7.5.0.3, enhancements have been made to the migrator. These enhancements
include greater migration speed. Previous versions of the migrator would only migrate one Enterprise
Vault collections file (.cab) at a time. The newer version of the migrator can migrate up to 25 (and in
some cases higher) .cab files per migration job. This will create less overhead on the NetBackup server
as far as backup jobs and catalog entries are concerned.
Considerations before Setting up Migration
What Types of Data Should Be Migrated?
It is highly recommended that the NetBackup Enterprise Vault migrator not be used in conjunction with
email related archives (especially when migrating to tape) due to the potential sheer volume of archived
content. If the Enterprise Vault environment will be performing numerous recalls of archived emails (such
as using EV Browser Search, Discovery Accelerator, Clearwell, exporting archived emails to PST/NSF, or
verifying Vault Store consistency using the Enterprise Vault evsvr utility), numerous restore jobs will be
created on the NetBackup Master server. Index rebuilds can also cause a mass recall of content from
NetBackup.
If the tapes that contain migrated Enterprise Vault content are not available in the tape library, the recall
of the archived content will be further delayed. Lastly, if the NetBackup environment is busy with a limited
number of tape drives, restores can also be delayed as restore jobs generally have a lower priority for
tape and disk resources compared to that of scheduled backup jobs.
If Not yet at Enterprise Vault 10
If the environment will be upgraded to Enterprise Vault 10, it is recommended that migrations be
configured after the upgrade has been performed and if 32-bit indexes will be upgraded to 64-bit. If
content has been migrated before indexes have been upgraded, content will be recalled back from
NetBackup during the index rebuild process. This process can be very slow if there has been a large
amount of content migrated to NetBackup. It should be noted that it is not immediately necessary to
upgrade 32-bit indexes to 64-bit after an upgrade to Enterprise Vault 10.
Page 1
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Requirements
Enterprise Vault
Migrations are supported with Enterprise Vault 6.0 and later. It should be noted that the necessary
software components for migration are automatically installed with versions of Enterprise Vault 8.0 SP2
and earlier.
Starting with Enterprise Vault 8.0 SP3 and later, the migration software components are included with the
NetBackup Client software (NetBackup 7.1 or later). The necessary file, NBUMigrator.exe, can be found
in the <installation_directory>\NetBackup\bin. NBUMigrator.exe is a COM-based application and must be
registered on the Enterprise Vault server. This can be done by running NBUMigrator.exe /RegServer.
NetBackup
On the NetBackup Master and Media servers, the version of NetBackup must be NetBackup Enterprise.
NetBackup Standard is not supported with NetBackup Enterprise Vault migrator.
At minimum, a NetBackup 5.1 client must be installed on the Enterprise Vault server. The client version
installed on the Enterprise Vault server must not be greater than that of the version of NetBackup
(including patches) on the master and media servers. For example, if the NetBackup master and media
servers were running NetBackup 7.1, the client version must not be at a version lower than 5.1 and no
higher than 7.1.
Configuring the NetBackup Client on the Enterprise Vault
Server
Installation
1. Install the base NetBackup Client software per the NetBackup installation instructions
2. During the installation, make sure to specify the correct name (or virtual name) of the NetBackup
Master server. Also add any NetBackup Media servers that may be used for migrations
3. For the NetBackup client name, the DNS alias (CNAME) for the Enterprise Vault server should be
used. For example, if the physical name of the Enterprise Vault server is “server1”, but the
CNAME record for the instance of Enterprise Vault is “evserver1”, specify evserver1 for the
NetBackup client name.
Page 2
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 1 - Configuring the NetBackup Client
4. After the client has been installed, apply any patches
Post Client Installation
For NetBackup 6.0 and newer clients, ensure that the system path on the Enterprise Vault server has
been updated to include the NetBackup\bin directory.
Bring up the System Properties on the EV server. Click on the Advanced tab. Click on the “Environment
Variables” button at the bottom of the screen. At the bottom of the screen is a list of System variables.
Look for “Path”. Highlight “Path” and then click on Edit. In the Edit dialog, go to the end of the line for
“Variable value” and add the following (assuming a NetBackup client installation directory of C:\Program
Files\VERITAS\NetBackup): C:\Program Files\VERITAS\NetBackup\bin.
Page 3
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 2 - Adding the NetBackup installation directory to the system path
While logged in as the Enterprise Vault Service Account (VSA) on the Enterprise Vault server, open a
command line window and type in the following command:
bpbackup
If the output is similar to what is listed in Figure 3, the system path is set properly.
Figure 3 - Verifying the system path environmental variable
Using Registry Editor, ensure that the client name for NetBackup matches the DNS alias (CNAME) for the
Enterprise Vault server. Expand out to HKLM\SOFTWARE\VERITAS\NetBackup\CurrentVersion\Config.
Look for the Client_Name value as shown in Figure 4.
Page 4
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 4 - Verifying the NetBackup client name in the Windows Registry
If any changes were made, restart all NetBackup services on the Enterprise Vault Server.
Configuring the NetBackup Master Server
Adding a License Key
In order for the “DataStore” policy type to be available, add the following license key to the master server
(NetBackup Enterprise installations only):
DEXW-PIHN-Z3IP-ZO63-PPP3-PPC6-PPRP-PPPP-PPC
After adding the key, restart the master server services/daemons. Note: it is a best practice to shutdown
services/daemons on any media servers associated with the master server before restarting
services/daemons on the master server and then restart services/daemons on media servers once the
master server is back up and running.
Page 5
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Configuring a NetBackup Policy for Enterprise Vault Migrations
Creating a Policy
Using the NetBackup Administration Console, right-click on Policies and click on New Policy. The policy
name can be any valid, unique name that conforms to NetBackup policy naming standards. Make sure
that the “Use Backup Policy Configuration Wizard” check box is NOT checked (if applicable) as show in
Figure 5
Figure 5 - Adding a new NetBackup policy
Policy Attributes
1. In the policy attributes section, change the policy type to DataStore
2. Select an appropriate policy storage unit. A disk storage unit (NetBackup 5.1) or disk storage unit
that is not set for “Enable Temporary Staging Area” (NetBackup 6.0) should not be used. A disk
staging storage unit (NetBackup 5.1), disk storage unit with “Enable Temporary Staging Area”
enabled (NetBackup 6.0), a media manager storage unit (tape), NDMP storage unit, or a storage
unit group that does not contain a regular disk storage unit can be used. Storage units that are
part of a media server deduplication pool can also be used (NBU 7.0 and later).
3. If the storage unit is tape based, select a volume pool.
“NetBackup” volume pool.
4. Set job priority levels as needed
5. Make sure that the policy is active
6. Set any other attributes as needed
Page 6
It is recommended not to use the
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 6 - Policy attributes
Policy Schedule
Depending on which version of NetBackup is being used, a schedule may be automatically configured.
With newer versions of NetBackup (7.1 and later), an application-based schedule named “DefaultApplication-Backup” will be created. With older versions of NetBackup, a schedule will need to be added.
Ensure that the schedule type is “Application Backup”.
The name of this schedule must be changed to
EV_Default_Schedule. Change the retention to “infinity (level 9)” and set the Media multiplexing to 1 as
shown in Figure 7.
Page 7
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 7 - Setting schedule attributes
Ensure that the schedule is set for 24/7 by clicking on the Start Window tab in the Change Schedule
window as shown in Figure 8.
Page 8
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 8 - Setting the start window
Policy Clients
On the Clients tab, click on New. For the client name, use the DNS alias (CNAME) for the Enterprise
Vault server.
Once the client name (or client names if multiple Enterprise Vault servers are to be
configured for migration) has been entered, click on OK at the bottom of the screen.
Configuring Vault Store Partitions for Migration to NetBackup
Setting up Collections
Before archived items can be migrated to NetBackup, collections must be first set up.
1. Using the EV Administration Console, bring up the properties on the vault store partition to be
configured for migration
2. Enable collections by going to the “Collections” tab. Click on “Use collection files”.
3. Enter appropriate values for collection times. By default, the schedule is from 10AM to 4PM daily.
4. Enter appropriate values for the “Maximum collection file size” and “Age at which files will be
collected”. It is recommended that the size be limited to 20 to 30 megabytes to ensure quicker
recalls of archived content if the need arises.
Page 9
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
5. Click on Apply.
Figure 9 - Configuring collections for a Vault Store partition
6. A prompt may appear asking if collections should be enabled. Click on Yes.
Setting up Migration
If collections have been enabled, migrations can be configured for the Vault Store partition. To set up
migration to NetBackup, perform the following steps:
1. Using the EV Administration Console, bring up the properties on the vault store partition to be
configured.
2. Click on the Migration tab.
3. Click on “Migrate collection files” or “Migrate files” depending on the version of Enterprise Vault.
A pop up window may appear explaining that enabling migrations may delay recalls of archived
items.
4. Select “VERITAS NetBackup” or “Symantec NetBackup” as the Migrator.
Page 10
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
5. Enter the desired values for “Migrate files older than” and “Remove collection files from primary
storage”.
6. Click on Apply
Figure 10 - Configuring migration of Vault Store partition
7. Click on “Yes” for “Are you sure you want to use file migrator software?”
8. Click on the “Advanced” tab.
9. For the NBU_Policy value, use the name of the NetBackup policy that was created in the
Configuring a NetBackup Policy for Enterprise Vault Migrations section (EV-Migration-Policy in
this example)
10. For the NBU_Server value, enter the name of the NetBackup master server (nbumaster in this
example).
11. See Appendix A for a definition of other settings in the Advanced tab
12. Click on the Test button to validate the configuration. If no errors are present in the Enterprise
Vault section of the Windows Event Viewer, then the configuration is set up property. Click on
OK.
Page 11
Enterprise Vault How-To – Migrating Archived Enterprise Vault Content to Symantec NetBackup
Figure 11 - Advanced settings for migrations
Page 12
APPENDIX A – Settings in the Vault Store Partition Advanced
Tab that Relate to NetBackup Migrations
NBU policy – Name of the NetBackup policy that will be used for migrations
NBU server – Name of the NetBackup master server
User wait timeout – How long, in seconds, a user will be notified that an item is being retrieved from a slow
device (default is 40 or 60 seconds depending on the version of Enterprise Vault)
System wait timeout – How long, in seconds, the Enterprise Vault system should wait for migrated file
retrieval requests before timing out (default is 600 seconds). The requested file will be removed from the
retrieval queue once the value has been reached.
Recalled file cache period – How long, in days, a retrieved collection file (.cab) will stay on the Enterprise
Vault server before being re-cached (default is 7 days)
Migrate all files – When set “Yes”, all eligible files (based on the “Migrate files older than” setting in the
Migration tab) will be collected and migrated. When set to “No”, a small number of Saveset files may remain
uncollected and therefore unmigrated. The default value is No.
About Symantec:
Symantec is a global leader in
providing storage, security and
systems management solutions to
help consumers and organizations
secure and manage their
information-driven world.
Our software and services protect
against more risks at more points,
more completely and efficiently,
enabling confidence wherever
information is used or stored.
For specific country offices and
contact numbers, please visit our
Web site: www.symantec.com
Symantec Corporation
World Headquarters
350 Ellis Street
Mountain View, CA 94043 USA
+1 (650) 527 8000
+1 (800) 721 3934
Copyright © 20123 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.